Click or drag to resize
AB4D logo

WpfModelVisual3DNode Class

WpfModelVisual3DNode represents a WPF's ModelVisual3D as a SceneNode and can render the ModelVisual3D with DXEngine.
Inheritance Hierarchy
SystemObject
  Ab3d.DirectXDXResourceBase
    Ab3d.DirectXSharedDXResource
      Ab3d.DirectXSharedDXSceneResource
        Ab3d.DirectXSceneNode
          Ab3d.DirectXObjectNode
            Ab3d.DirectX.ModelsBaseWpfObjectNode
              Ab3d.DirectX.ModelsWpfModelVisual3DNode

Namespace: Ab3d.DirectX.Models
Assembly: Ab3d.DXEngine.Wpf (in Ab3d.DXEngine.Wpf.dll) Version: 7.0.8865.1045
Syntax
C#
Copy
public class WpfModelVisual3DNode : BaseWpfObjectNode

The WpfModelVisual3DNode type exposes the following members.

Constructors
 NameDescription
Public methodWpfModelVisual3DNode(ModelVisual3D) Initializes a new instance of the WpfModelVisual3DNode class.
Public methodWpfModelVisual3DNode(ModelVisual3D, DictionaryObject, String, String, Effect) Initializes a new instance of the WpfModelVisual3DNode class.
Public methodWpfModelVisual3DNode(ModelVisual3D, DictionaryString, Object, String, Effect) Initializes a new instance of the WpfModelVisual3DNode class.
Top
Properties
 NameDescription
Public propertyStatic memberIsCheckingChildrenForChangesDefaultValue Gets or sets a static Boolean value that specifies the default value for IsCheckingChildrenForChanges. By default the IsCheckingChildrenForChanges is set to true except for all objects derived from Ab3d.Visuals.BaseModelVisual3D (BoxVisual3D, SphereVisual3D, etc.). But you can set this static field to true and manually set the IsCheckingChildrenForChanges to false on a few objects that you want to check for children changes.
Public propertyStatic memberIsPreservingHiddenObjectsInMemory Gets or sets a static Boolean value that specifies if DXEngine optimizes handling of IsVisible property for objects derived from BaseVisual3D from Ab3d.PowerToys library. In case the value is true and IsVisible property is set to false, then all the DirectX and WPF objects are preserved in the memory so that when IsVisible is set back to true this can happen instantly (without any creation of DirectX resources). Default value is true.
Public propertyMaterialEffect Gets or sets the Effect that will render this WpfGeometryModel3DNode. If null, a standard effect will be used (effect set in EffectsManager as standard effect)
Public propertyModelVisual3D Gets the WPF's ModelVisual3D that is used to initialize this WpfModelVisual3DNode
Public propertyStatic memberOptimizeWpfIsVisibleChangeProcessing Gets or sets a static Boolean value that specifies if Abd3.DXEngine optimizes handling the IsVisible property changes. When this is optimized, the 3D objects are not removed from the scene tree but are just skipped when rendering. This means that all the DirectX resources are preserved and the change from hidden to visible objects is very fast. When false, the objects that are hidden are removed from scene tree. This property do not have any effect when scene is not rendered with Abd3.DXEngine. See remarks for more info. Default value is true.
Top
Methods
 NameDescription
Public methodCollectRenderableObjects The task of the CollectRenderableObjects method is to create objects derived from RenderablePrimitiveBase and add them to the appropriate RenderingQueue. This method is called at the beginning of RenderScene method call but only when the scene was significantly changed (number of SceneNodes is changed, material is significantly changed, etc.)
(Overrides ObjectNodeCollectRenderableObjects)
Public methodUpdate Update method is called on each update phase (before render phase)
(Overrides SceneNodeUpdate)
Top
Fields
 NameDescription
Public fieldIsCheckingChildrenForChanges Gets or sets a Boolean that specifies if on each Update call (on each WPF's Rendering event) WpfModelVisual3DNode is checking if ModelVisual3D.Children has changed. By default all checking is disabled for all objects derived from the Ab3d.Visuals.BaseModelVisual3D (BoxVisual3D, SphereVisual3D, etc.).
Top
Extension Methods
 NameDescription
Public Extension MethodGetGeometryModel3D Returns a WPF's GeometryModel3D that was used to create the specified sceneNode. If the sceneNode does not define a GeometryModel3D object, then null is returned.
(Defined by Extensions)
Public Extension MethodGetModel3D Returns a WPF's Model3D that was used to create the specified sceneNode. If the sceneNode does not define a Model3D object, then null is returned.
(Defined by Extensions)
Public Extension MethodGetModelVisual3D Returns a WPF's ModelVisual3D that was used to create the specified sceneNode or any parent SceneNode (in case searchParentSceneNodes is true). If a SceneNode that defines a ModelVisual3D is not found, then null is returned.
(Defined by Extensions)
Public Extension MethodGetVisual3D Returns a WPF's Visual3D that was used to create the specified sceneNode or any parent SceneNode (in case searchParentSceneNodes is true). If a SceneNode that defines a Visual3D is not found, then null is returned.
(Defined by Extensions)
Top
See Also