ModelRotatorVisual3D Class


ModelRotatorVisual3D Class

ModelRotatorVisual3D is a ModelVisual3D object that shows 3 circles that can be used by user to rotate a 3D model with dragging the circles with the mouse.

Inheritance Hierarchy

SystemObject
  System.Windows.ThreadingDispatcherObject
    System.WindowsDependencyObject
      System.Windows.Media.Media3DVisual3D
        System.Windows.Media.Media3DModelVisual3D
          Ab3d.VisualsModelRotatorVisual3D

Namespace: Ab3d.Visuals
Assembly: Ab3d.PowerToys (in Ab3d.PowerToys.dll) Version: 11.1.8864.1045

Syntax

Copy

public class ModelRotatorVisual3D : ModelVisual3D

The ModelRotatorVisual3D type exposes the following members.

Constructors

	Name	Description
	ModelRotatorVisual3D	Initializes a new instance of the ModelRotatorVisual3D class.
	ModelRotatorVisual3D(Vector3D, Vector3D, Vector3D, String)	Initializes a new instance of the ModelRotatorVisual3D class with providing custom axes.

Top

Properties

	Name	Description
	CircleSegmentsCount	Gets or sets the number of segments that are used to create the circle 3D model. Default value is 30.
	CircleWidth	Gets or sets the width of the rotation circle model. When the value is not set (is double.NaN), then circle width is calculated as 0.05 * OuterRadius (this is the default value).
	CreateCustomCircleModelCallback	Gets or sets a callback delegate that can be used to provide custom 3D model of the circle. See remarks for a sample that shows the code to create the default 3D model.
	InnerRadius	Gets or sets the inner radius of rotation circles. Default value is 30.
	IsXAxisRotationCircleShown	Gets or sets a Boolean that specifies if rotation circle for X axis is shown. Default value is true.
	IsYAxisRotationCircleShown	Gets or sets a Boolean that specifies if rotation circle for Y axis is shown. Default value is true.
	IsZAxisRotationCircleShown	Gets or sets a Boolean that specifies if rotation circle for Z axis is shown. Default value is true.
	OuterRadius	Gets or sets the outer radius of rotation circles. Default value is 50.
	Position	Gets or sets Point3D that specifies the position of the ModelMover axis origin.
	SelectedCursor	Gets or sets a Cursor that is shown when mouse is over the arrow. If set to null, cursor is not changed. Default value is Hand.
	SelectedMaterial	Gets or sets a Material that is used when mouse is over the arrow. If set to null, the arrow material is not changed. Default value is Yellow DiffuseMaterial.
	XAxisRotationCircleColor	Gets or sets the color of rotation circle for X axis.
	YAxisRotationCircleColor	Gets or sets the color of rotation circle Y axis.
	ZAxisRotationCircleColor	Gets or sets the color of rotation circle Z axis.

Top

Methods

	Name	Description
	OnRotatingCallback	OnRotatingCallback
	OnRotatingEndedCallback	OnRotatingEndedCallback
	OnRotatingStartedCallback	OnRotatingStartedCallback
	SetRotation	SetRotation rotates the ModelMoverVisual3D by the specified RotateTransform3D. When set to null, then rotation is removed from the ModelMoverVisual3D.
	SubscribeWithEventManager3D	SubscribeWithEventManager3D method can be used to use EventManager3D for mouse events processing instead of using UIElement3D for mouse events. This can be used when ModelMoverVisual3D is used inside Ab3d.DXEngine that does not support processing events on UIElement3D objects. In this case the CustomEventsSourceElement on EventManager3D must be set.

Top

Events

	Name	Description
	ModelRotated	ModelRotating event is fired when model is rotated.
	ModelRotateEnded	ModelMoveEnded event is fired when moving of the model is stopped.
	ModelRotateStarted	ModelRotatingStarted event is fired when rotating of the model is started.

Top

Fields

	Name	Description
	CircleSegmentsCountProperty	CircleSegmentsCountProperty
	CircleWidthProperty	CircleWidthProperty
	InnerRadiusProperty	InnerRadiusProperty
	IsXAxisRotationCircleShownProperty	IsXAxisRotationCircleShownProperty
	IsYAxisRotationCircleShownProperty	IsYAxisRotationCircleShownProperty
	IsZAxisRotationCircleShownProperty	IsZAxisRotationCircleShownProperty
	OuterRadiusProperty	OuterRadiusProperty
	PositionProperty	PositionProperty
	XAxisRotationCircleColorProperty	XAxisRotationCircleColorProperty
	XRotationAxis	XRotation axis that is used by the default constructor (without any parameters or when defined in XAML).
	YAxisRotationCircleColorProperty	YAxisRotationCircleColorProperty
	YRotationAxis	YRotation axis that is used by the default constructor (without any parameters or when defined in XAML).
	ZAxisRotationCircleColorProperty	ZAxisColorProperty
	ZRotationAxis	ZRotation axis that is used by the default constructor (without any parameters or when defined in XAML).

Top

Extension Methods

	Name	Description
	DumpHierarchy	Display details about the hierarchy of Visual3D children to Debug console (for example to Visual Studio's Immediate window). (Defined by Extensions)
	ForEachGeometryModel3D	Performs the specified action on each GeometryModel3D inside the rootModelVisual3D. (Defined by Extensions)
	ForEachVisual3D	Performs the specified action on each ModelVisual3D inside the rootModelVisual3D. (Defined by Extensions)
	GetName	Gets name of the Visual3D that was previously set by SetName extension method. (Defined by Extensions)
	SetName	Sets Name property to Visual3D. Note that if name is not correct for WPF, it can be corrected (name must start with a letter or the underscore character (_), and must contain only letters, digits, or underscores). In this case the SetName method will set the corrected name to the object and return false (in this case you can call GetName to get the corrected name). True is returned when the original name is set to the object. (Defined by Extensions)

Top

Reference

Ab3d.Visuals Namespace