System. Windows. Media. Media3D Пространство имен

Содержит типы, поддерживающие трехмерное представление в приложениях Windows Presentation Foundation (WPF). Contains types that support 3-D presentation in Windows Presentation Foundation (WPF) applications.

Классы

Базовый класс, от которого наследуются все аффинные трехмерные преобразования, включая параллельный перенос, вращение и растяжение. Base class from which all concrete affine 3-D transforms — translations, rotations, and scale transformations — derive.

Объект Light, который использует источник света однородно, независимо от их формы. Light object that applies light to objects uniformly, regardless of their shape.

Представляет 3-D-поворот на заданный угол относительно указанной оси. Represents a 3-D rotation of a specified angle about a specified axis.

Определяет часть 3-сцены, отображаемой элементом Viewport3DVisual или Viewport3D. Specifies what portion of the 3D scene is rendered by the Viewport3DVisual or Viewport3D element.

Представляет контейнер для объектов Visual3D. Represents a container for Visual3D objects.

Позволяет применять двумерную кисть, например SolidColorBrush или TileBrush, к трехмерной модели с рассеянным освещением. Allows the application of a 2-D brush, like a SolidColorBrush or TileBrush, to a diffusely-lit 3-D model.

Объект Light, который проецирует свое влияние вдоль направления, заданного параметром Vector3D. Light object that projects its effect along a direction specified by a Vector3D.

Применяет Brush к трехмерной модели таким образом, чтобы она участвовала в вычислениях освещения, как если бы объект Material испускал свет, равный цвету Brush. Applies a Brush to a 3-D model so that it participates in lighting calculations as if the Material were emitting light equal to the color of the Brush.

Обеспечивает поддержку преобразования 2D в 3D. Provides 2-D to 3-D transformation support.

Обеспечивает обобщенную поддержку преобразования для объектов 3-D. Provides generalized transformation support for 3-D objects.

Представляет упорядоченную коллекцию объектов GeneralTransform3D. Represents an ordered collection of GeneralTransform3D objects.

Представляет объект GeneralTransform3D, являющийся композицией преобразований в его объекте GeneralTransform3DCollection. Represents a GeneralTransform3D that is a composite of the transforms in its GeneralTransform3DCollection.

Обеспечивает поддержку преобразования 3-D в 2-D. Provides 3-D to 2-D transformation support.

Классы, производные от этого абстрактного базового класса, определяют геометрические фигуры 3D. Classes that derive from this abstract base class define 3D geometric shapes. Класс объектов Geometry3D может использоваться для проверки попадания курсора и отрисовки данных 3D-графики. The Geometry3D class of objects can be used for hit-testing and rendering 3D graphic data.

Отображает объект Geometry3D с указанным содержимым Material. Renders a Geometry3D with the specified Material.

Абстрактный класс, представляющий параметры проверки попадания курсора 3D. Abstract class that represents the parameters of a 3D hit test.

Объект Model3D, который представляет освещение, используемое для трехмерной сцены. Model3D object that represents lighting applied to a 3-D scene.

Абстрактный базовый класс для материалов. Abstract base class for materials.

Коллекция объектов Material. Collection of Material objects.

Представляет объект Material, являющийся совокупностью материалов в его коллекции. Represents a Material that is a composite of the Materials in its collection.

Преобразует экземпляры других типов в экземпляры Matrix3D, и наоборот. Converts instances of other types to and from instances of Matrix3D.

Камера, которая задает представление и преобразования проекций в качестве объектов Matrix3D. Camera which specifies the view and projection transforms as Matrix3D objects.

Создает преобразование, заданное объектом Matrix3D, которое используется для управления объектами или системами координат в трехмерном мировом пространстве. Creates a transformation specified by a Matrix3D, used to manipulate objects or coordinate systems in 3-D world space.

Примитив треугольника для построения трехмерной фигуры. Triangle primitive for building a 3-D shape.

Предоставляет функциональные возможности для трехмерных моделей. Provides functionality for 3-D models.

Представляет упорядоченную коллекцию объектов Model3D. Represents an ordered collection of Model3D objects.

Позволяет использовать ряд трехмерных моделей как единое целое. Enables using a number of 3-D models as a unit.

Прорисовывает 3-D-модель, которая поддерживает ввод, фокус и события. Renders a 3-D model that supports input, focus, and events.

Предоставляет объект Visual3D, отображающий объекты Model3D. Provides a Visual3D that renders Model3D objects.

Представляет камеру ортогональной проекции. Represents an orthographic projection camera.

Представляет камеру проекции перспективы. Represents a perspective projection camera.

Представляет упорядоченную коллекцию объектов Point3D. Represents an ordered collection of Point3D objects.

Преобразует экземпляры других типов в экземпляры Point3DCollection, и наоборот. Converts instances of other types to and from Point3DCollection instances.

Преобразует экземпляры других типов в структуру Point3D и выполняет обратное преобразование. Converts instances of other types to and from a Point3D structure.

Преобразует экземпляры других типов в структуру Point4D и выполняет обратное преобразование. Converts instances of other types to and from a Point4D structure.

Представляет источник света, имеющий заданное положение в пространстве и проецирующий свой свет во всех направлениях. Represents a light source that has a specified position in space and projects its light in all directions.

Абстрактный базовый класс, представляющий объект источника света, который имеет положение в пространстве и проецирует свой свет во всех направлениях. Abstract base class that represents a light object that has a position in space and projects its light in all directions.

Абстрактный базовый класс для камер с перспективной и ортогональной проекцией. An abstract base class for perspective and orthographic projection cameras.

Преобразует экземпляры других типов в экземпляры Quaternion, и наоборот. Converts instances of other types to and from instances of Quaternion.

Представляет преобразование поворота, определенное как кватернион. Represents a rotation transformation defined as a quaternion.

Задает параметры проверки нажатия вдоль луча. Specifies the parameters of a hit test along a ray.

Представляет результат проверки нажатия вдоль луча. Represents the result of a hit test along a ray.

Представляет пересечение между проверкой попадания курсора в луч и объектом MeshGeometry3D. Represents an intersection between a ray hit test and a MeshGeometry3D.

Преобразует экземпляры других типов в экземпляры Rect3D, и наоборот. Converts instances of other types to and from instances of Rect3D.

Задает преобразование поворота. Specifies a rotation transformation.

Указывает трехмерный поворот для использования в преобразовании. Specifies the 3-D rotation to be used in a transformation.

Масштабирует объект в трехмерной плоскости x-y-z начиная с определенной центральной точки. Scales an object in the three-dimensional x-y-z plane, starting from a defined center point. Коэффициенты масштабирования определяются в направлениях x, y и z от этой центральной точки. Scale factors are defined in x-, y-, and z- directions from this center point.

Преобразует экземпляры других типов в структуру Size3D и выполняет обратное преобразование. Converts instances of other types to and from a Size3D structure.

Позволяет применять двумерную кисть, например SolidColorBrush или TileBrush, к зеркально освещенной трехмерной модели. Allows a 2-D brush, like a SolidColorBrush or TileBrush, to be applied to a specularly-lit 3-D model.

Объект Light, который проецирует свое влияние в конусообразной области в заданном направлении. Light object that projects its effect in a cone-shaped area along a specified direction.

Предоставляет родительский класс для всех трехмерных преобразований, включая преобразование, поворот и масштабирование. Provides a parent class for all three-dimensional transformations, including translation, rotation, and scale transformations.

Представляет упорядоченную коллекцию объектов Transform3D. Represents an ordered collection of Transform3D objects.

Представляет преобразование, которое состоит из дочерних объектов Transform3D в его Transform3DCollection. Represents a transformation that is a composite of the Transform3D children in its Transform3DCollection.

Преобразует объект в трехмерную плоскость X-Y-Z. Translates an object in the three-dimensional x-y-z plane.

Коллекция объектов Vector3D. Collection of Vector3D objects.

Преобразует экземпляры других типов в экземпляры Vector3DCollection, и наоборот. Converts instances of other types to and from instances of Vector3DCollection.

Преобразует экземпляры других типов в структуру Vector3D и выполняет обратное преобразование. Converts instances of other types to and from a Vector3D structure.

Прорисовывает дочерний объект 2-D в указанных границах просмотра объекта 3-D. Renders the 2-D children within the specified 3-D viewport bounds.

Прорисовывает дочерний объект Visual3D в указанных двумерных границах просмотра. Renders the Visual3D children within the specified 2D viewport bounds.

Предоставляет общие для всех визуальных 3D-объектов службы и свойства, включая проверку нажатия, преобразование координат и вычисление ограничивающих прямоугольников. Provides services and properties that are common to visual 3-D objects, including hit-testing, coordinate transformation, and bounding box calculations.

Представляет упорядоченную коллекцию объектов Visual3D. Represents an ordered collection of Visual3D objects.

Структуры

Выполняет перечисление элементов Material в объекте MaterialCollection. Enumerates Material items in a MaterialCollection.

Представляет матрицу 4 х 4, используемую для преобразований в трехмерном пространстве. Represents a 4 x 4 matrix used for transformations in 3-D space.

Перечисляет элементы в коллекции. Enumerates items in a collection.

Представляет координаты x, y и z в трехмерном пространстве. Represents an x-, y-, and z-coordinate point in 3-D space.

Перечисляет элементы в коллекции Point3DCollection. Enumerates items in a Point3DCollection.

Представляет координаты x, y, z и w для точки в мировом пространстве, используемые при выполнении преобразований с помощью неаффинных трехмерных матриц. Represents an x-, y-, z-, and w-coordinate point in world space used in performing transformations with non-affine 3-D matrices.

Структура, представляющая поворот в трех измерениях. Structure that represents a rotation in three dimensions.

Представляет прямоугольник 3-D: например, куб. Represents a 3-D rectangle: for example, a cube.

Структура данных, описывающая размер трехмерного объекта. Data structure that describes the size of a three-dimensional object.

Выполняет перечисление элементов Transform3D в объекте Transform3DCollection. Enumerates Transform3D items in a Transform3DCollection.

Представляет смещение в трехмерном пространстве. Represents a displacement in 3-D space.

Выполняет перечисление элементов Vector в объекте VectorCollection. Enumerates Vector items in a VectorCollection.

Выполняет перечисление элементов Visual3D в объекте Visual3DCollection. Enumerates Visual3D items in a Visual3DCollection.

Visual Класс

Определение

Обеспечивает поддержку отрисовки в WPF, в том числе проверку нажатия, преобразование координат и расчеты ограничивающих прямоугольников. Provides rendering support in WPF, which includes hit testing, coordinate transformation, and bounding box calculations.

Комментарии

VisualКласс является базовой абстракцией, из которой FrameworkElement наследуется каждый объект. The Visual class is the basic abstraction from which every FrameworkElement object derives. Он также выступает в качестве точки входа для написания новых элементов управления в WPF, и во многих отношениях может рассматриваться как эквивалент дескриптора окна (HWND) в модели приложения Win32. It also serves as the entry point for writing new controls in WPF, and in many ways can be thought of as an equivalent of a window handle (HWND) in the Win32 application model.

VisualОбъект является основным объектом WPF, первичной ролью которого является предоставление поддержки отрисовки. The Visual object is a core WPF object, whose primary role is to provide rendering support. Элементы управления пользовательского интерфейса, такие как Button и TextBox , являются производными от Visual класса и используют Visual определенные свойства для сохранения данных отрисовки. User interface controls, such as Button and TextBox, derive from the Visual class, and use the Visual defined properties for persisting their rendering data. VisualОбъект обеспечивает поддержку следующих объектов: The Visual object provides support for the following:

Отображение выходных данных: визуализация сохраненного, сериализованного содержимого визуального элемента. Output display: Rendering the persisted, serialized drawing content of a visual.

Преобразование: поддерживает преобразование визуального элемента. Transformations: Performing transformations on a visual.

Отсечение: позволяет указать область отсечения для визуального элемента. Clipping: Providing clipping region support for a visual.

Проверка нажатия: определение того, содержится ли заданная координата (точка) или геометрия внутри границ визуального элемента. Hit testing: Determining whether a specified coordinate (point) or geometry is contained within the bounds of a visual.

Вычисление ограничивающего прямоугольника: определение ограничивающего прямоугольника визуального объекта. Bounding box calculations: Determining the bounding rectangle of a visual.

В архитектуре Visual объект не включает поддержку других требований к разработке приложений и функций WPF, которые не связаны непосредственно с его отрисовкой, например следующие: Architecturally, the Visual object does not include support for other application development requirements / WPF features that are not immediately related to its rendering, such as the following:

Обработка событий Event handling

привязка данных, Data binding

Visual предоставляется в виде открытого абстрактного класса, от которого могут быть производными другие классы. Visual is provided as a public abstract class from which further classes can be derived. На следующем рисунке показана иерархия существующих визуальных объектов, определенных в архитектуре WPF. The following illustration shows the hierarchy of the existing visual objects that are defined in the WPF architecture.

Иерархия класса Visual Visual class hierarchy

В некоторых случаях члены, определенные как защищенные, Visual предоставляются как более легко доступные члены с одинаковыми именами в производном UIElement классе. In some cases, members that are defined as protected in Visual are exposed as more readily accessible members with similar names in the derived UIElement class.

VisualИмеет ограниченное количество уровней. A Visual has a limited number of levels. В предыдущих версиях платформа .NET Framework эта максимальная глубина была 255. In previous versions of the .NET Framework, this maximum depth was 255. Это ограничение не подходит для некоторых макетов, имеющих много уровней в визуальном дереве. This limit is inadequate for some layouts that have many levels in the visual tree.

В платформа .NET Framework 4 максимальная глубина Visual — 2047, что позволяет создавать более глубокие визуальные деревья. In .NET Framework 4, the maximum depth of a Visual is 2047, which enables much deeper visual trees. В большинстве приложений недостаточно места в стеке для обхода такого количества уровней, а результат — StackOverflowException во время компоновки. In most applications, there is not enough stack space to traverse so many levels, and the result is a StackOverflowException during layout. Для размера стека по умолчанию это исключение обычно возникает, когда глубина дерева составляет приблизительно 800, что соответствует примерно 190 вложенным TreeViewItem объектам. For the default stack size, this exception is usually thrown when the tree depth is approximately 800, which corresponds to about 190 nested TreeViewItem objects.

Если это исключение создается приложением и требуется более глубокое визуальное дерево, можно увеличить размер стека приложения. If this exception is thrown by your application and you need to have a deeper visual tree, you can increase the application’s stack size. Размер стека можно увеличить с помощью параметра/STACK во время компиляции или с помощью служебной программы EDITBIN. You can increase the size of the stack by using the /STACK option at compile time or by using the EDITBIN utility. Увеличение размера стека может повлиять на производительность приложения. Increasing the stack size may affect your application’s performance. Дополнительные сведения см. в разделе выделения стека и Параметры EDITBIN. For more information, see Stack Allocations and EDITBIN Options.

Конструкторы

Предоставляет базовую инициализацию объектов, производных от класса Visual. Provides the base initialization for objects derived from the Visual class.

Свойства

Возвращает объект DependencyObjectType , который заключает в оболочку тип CLR данного экземпляра. Gets the DependencyObjectType that wraps the CLR type of this instance.

(Унаследовано от DependencyObject) Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject. Gets the Dispatcher this DispatcherObject is associated with.

(Унаследовано от DispatcherObject) IsSealed

Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения). Gets a value that indicates whether this instance is currently sealed (read-only).

(Унаследовано от DependencyObject) VisualBitmapEffect

Получает или задает значение BitmapEffect для объекта Visual. Gets or sets the BitmapEffect value for the Visual.

Получает или задает значение BitmapEffectInput для объекта Visual. Gets or sets the BitmapEffectInput value for the Visual.

Возвращает или задает BitmapScalingMode для объекта Visual. Gets or sets the BitmapScalingMode for the Visual.

Получает или задает кэшированное представление объекта Visual. Gets or sets a cached representation of the Visual.

Получает число дочерних элементов для объекта Visual. Gets the number of child elements for the Visual.

Получает или задает объект ClearTypeHint, который определяет способ отображения ClearType в Visual. Gets or sets the ClearTypeHint that determines how ClearType is rendered in the Visual.

Возвращает или задает отсеченную область объекта Visual в виде значения Geometry. Gets or sets the clip region of the Visual as a Geometry value.

Возвращает или задает края объекта Visual в виде значения EdgeMode. Gets or sets the edge mode of the Visual as an EdgeMode value.

Получает или задает эффект растрового изображения, который применяется к объекту Visual. Gets or sets the bitmap effect to apply to the Visual.

Возвращает или задает значение смещения визуального объекта. Gets or sets the offset value of the visual object.

Получает или задает значение прозрачности для объекта Visual. Gets or sets the opacity of the Visual.

Возвращает или задает значение Brush, которое представляет маску непрозрачности объекта Visual. Gets or sets the Brush value that represents the opacity mask of the Visual.

Получает для визуального объекта родительский объект визуального дерева. Gets the visual tree parent of the visual object.

Получает или задает обрезанную прокручиваемую область для объекта Visual. Gets or sets a clipped scrollable area for the Visual.

Получает или задает TextHintingMode объекта Visual. Gets or sets the TextHintingMode of the Visual.

Получает или задает TextRenderingMode объекта Visual. Gets or sets the TextRenderingMode of the Visual.

Получает или задает значение Transform для объекта Visual. Gets or sets the Transform value for the Visual.

Получает или задает коллекцию направляющих по оси X (по вертикали). Gets or sets the x-coordinate (vertical) guideline collection.

Получает или задает коллекцию горизонтальных направляющих (по оси Y). Gets or sets the y-coordinate (horizontal) guideline collection.

Методы

Определяет связь «родитель-потомок» между двумя визуальными объектами. Defines the parent-child relationship between two visuals.

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. Determines whether the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject) ClearValue(DependencyProperty)

Очищает локальное значение свойства. Clears the local value of a property. Очищаемое свойство задается идентификатором DependencyProperty. The property to be cleared is specified by a DependencyProperty identifier.

(Унаследовано от DependencyObject) ClearValue(DependencyPropertyKey)

Очищает локальное значение доступного только для чтения свойства. Clears the local value of a read-only property. Очищаемое свойство задается ключом DependencyPropertyKey. The property to be cleared is specified by a DependencyPropertyKey.

(Унаследовано от DependencyObject) CoerceValue(DependencyProperty)

Приводит значение указанного свойства зависимостей. Coerces the value of the specified dependency property. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject. This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Унаследовано от DependencyObject) Equals(Object)

Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject. Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Унаследовано от DependencyObject) FindCommonVisualAncestor(DependencyObject)

Возвращает общего предка двух визуальных объектов. Returns the common ancestor of two visual objects.

Возвращает хэш-код для данного объекта DependencyObject. Gets a hash code for this DependencyObject.

(Унаследовано от DependencyObject) GetLocalValueEnumerator()

Создает специализированный перечислитель для определения свойств зависимостей, которые локально установили значения для данного DependencyObject. Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Унаследовано от DependencyObject) GetType()

Возвращает объект Type для текущего экземпляра. Gets the Type of the current instance.

(Унаследовано от Object) GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject. Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Унаследовано от DependencyObject) GetVisualChild(Int32)

Возвращает указанный объект Visual в родительскую коллекцию VisualCollection. Returns the specified Visual in the parent VisualCollection.

Определяет, находится ли значение, соответствующее геометрии, в пределах границ визуального объекта. Determines whether a geometry value is within the bounds of the visual object.

Определяет, находится ли значение, соответствующее координате точки, в пределах границ визуального объекта. Determines whether a point coordinate value is within the bounds of the visual object.

Повторно вычисляет действующее значение для указанного свойства зависимостей. Re-evaluates the effective value for the specified dependency property.

(Унаследовано от DependencyObject) IsAncestorOf(DependencyObject)

Определяет, является ли визуальный объект предком потомка визуального объекта. Determines whether the visual object is an ancestor of the descendant visual object.

Определяет, является ли визуальный объект потомком для предка визуального объекта. Determines whether the visual object is a descendant of the ancestor visual object.

Создает неполную копию текущего объекта Object. Creates a shallow copy of the current Object.

(Унаследовано от Object) OnDpiChanged(DpiScale, DpiScale)

Вызывается, когда изменяется параметр «точек на дюйм», по которому определяется разрешение представления. Called when the DPI at which this View is rendered changes.

Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного DependencyObject. Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Конкретное измененное свойство зависимостей сообщается в данных события. The specific dependency property that changed is reported in the event data.

(Унаследовано от DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject)

Вызывается при изменении коллекции VisualCollection визуального объекта. Called when the VisualCollection of the visual object is modified.

Вызывается при изменении родительского объекта визуального объекта. Called when the parent of the visual object is changed.

Преобразовывает объект Point в экранных координатах в объект Point, представляющий текущую систему координат Visual. Converts a Point in screen coordinates into a Point that represents the current coordinate system of the Visual.

Преобразовывает объект Point, представляющий текущую систему координат объекта Visual, в объект Point в экранных координатах. Converts a Point that represents the current coordinate system of the Visual into a Point in screen coordinates.

Возвращает локальное значение свойства зависимостей, если таковое существует. Returns the local value of a dependency property, if it exists.

(Унаследовано от DependencyObject) RemoveVisualChild(Visual)

Удаляет связь «родитель-потомок» между двумя визуальными объектами. Removes the parent-child relationship between two visuals.

Задает значение свойства зависимостей, не меняя источник значения. Sets the value of a dependency property without changing its value source.

(Унаследовано от DependencyObject) SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства. Sets the local value of a dependency property, specified by its dependency property identifier.

(Унаследовано от DependencyObject) SetValue(DependencyPropertyKey, Object)

Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей. Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Унаследовано от DependencyObject) ShouldSerializeProperty(DependencyProperty)

Возвращает значение, которое указывает, следует ли процессам сериализации выполнять сериализацию значения для предоставленного свойства зависимостей. Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Унаследовано от DependencyObject) ToString()

Возвращает строку, представляющую текущий объект. Returns a string that represents the current object.

(Унаследовано от Object) TransformToAncestor(Visual)

Возвращает преобразование, которое может использоваться для преобразования координат этого объекта Visual в координаты заданного предка визуального объекта Visual. Returns a transform that can be used to transform coordinates from the Visual to the specified Visual ancestor of the visual object.

Возвращает преобразование, которое может использоваться для преобразования координат этого объекта Visual в координаты заданного предка визуального объекта Visual3D. Returns a transform that can be used to transform coordinates from the Visual to the specified Visual3D ancestor of the visual object.

Возвращает преобразование, которое может использоваться для преобразования координат этого объекта Visual в координаты заданного потомка визуального объекта. Returns a transform that can be used to transform coordinates from the Visual to the specified visual object descendant.

Возвращает преобразование, которое может использоваться для преобразования координат этого объекта Visual в координаты заданного визуального объекта. Returns a transform that can be used to transform coordinates from the Visual to the specified visual object.

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject. Enforces that the calling thread has access to this DispatcherObject.