Click or drag to resize

Visual Properties

The Visual type exposes the following members.

Properties
  NameDescription
Public propertyAllConnectors
Gets all connectors.
Public propertyAllowWaitOnMove

Field Value

Type: 
When true, allows scripting to wait for the OnMoved event. This is false by default to avoid performance degradation for visuals that move frequently. <p> Example scripting: <pre> sender.AllowWaitOnMove = true; Wait( sender.OnMoved ); </pre>
Public propertyAngularVelocity
The current angular velocity of the Visual in radians/second.
Public propertyAnimatorInProgress
Determine if any animations are currently in progress for this Visual.
Public propertyApp
The global application object.
Public propertyBillboard

Field Value

Type: 
If true, then the visual will always face the camera. This is useful for text that should always face the user, for example. <p> Note that the visual's Rotation property will be set automatically, and so will overwrite any updates made from scripting or from the property grid.
Public propertyBillOfMaterialsCodeExpr

Field Value

Type: 
The catalog order code of the component as it appears in the bill of materials, e.g. "'XYZ-203-37.TZ1'". If this is blank there will be no entry in the bill of materials for this component.
Public propertyBillOfMaterialsCostExpr

Field Value

Type: 
The cost of the component as it appears in the bill of materials, e.g. "1595.95".
Public propertyBillOfMaterialsDescriptionExpr

Field Value

Type: 
The description of the component as it appears in the bill of materials, e.g. "Driven Roller Module". If this is blank there will be no entry in the bill of materials for this component.
Public propertyBoundingBox
Get the bounding box of this visual including all its children.
Public propertyBoundingBoxExcludingChildren
Get the bounding box of the visual excluding children.
Public propertyBoundingSphere
Get the bounding sphere of this visual, including its children.
Public propertyBoundingSphereExcludingChildren
Get the bounding sphere of this visual, excluding its children.
Public propertyChildren
Return the collection of child Visuals.
Public propertyConnectAllowed

Field Value

Type: 
A list of visual Types that are allowed to connect to this visual. If empty, then all visuals are allowed to connect, provided they are not specified in the ConnectDisallowed list, and that the connector-specific rules also allow the connection. <p> See also: <ul> <li>Demo3D.Visuals.Visual.ConnectDisallowed <li>Demo3D.Visuals.Connector.Allowed <li>Demo3D.Visuals.Connector.Disallowed </ul>
Public propertyConnectDisallowed

Field Value

Type: 
A list of visual Types that are not allowed to connect to this visual. If a Type appears in both ConnectAllowed and ConnectDisallowed, then ConnectDisallowed takes priority and the connection is not allowed. <p> See also: <ul> <li>Demo3D.Visuals.Visual.ConnectAllowed <li>Demo3D.Visuals.Connector.Allowed <li>Demo3D.Visuals.Connector.Disallowed </ul>
Public propertyConnectorPairs
All pairs of connectors from this visual.
Public propertyControlPointsAllowed

Field Value

Type: 
A white list of control points that should be shown and editable.
Public propertyControlPointsDisallowed

Field Value

Type: 
A black list of control points that should be hidden and not editable.
Public propertyCurrentRoutingTarget
The current destination for this visual (usually a load). This can be used by equipment to decide which direction to transfer a load, or it can be ignored. It is specific to the equipment processing the load.
Public propertyCurrentStation
The Visual that the load is current at waiting to be ordered. Any Visual can be a Station but LoadCreatorVisual the first station set when calling LoadCreatorVisual.OrderLoad(). This is normally set for loads.
Public propertyCurrentTransfer
Information about the current transfer in progress for this visual using the Transfer Protocol. This is normally set for loads.
Public propertyCustomProperties
The collection of CustomProperty objects for this Visual.
Public propertyDescendants
Return all visuals below this point in the Visual hierarchy .
Public propertyDescendantsDepthFirst
Return all visuals below this point in the Visual hierarchy .
Public propertyDescription
A description of the Visual.
Public propertyDocument
The document that this Visual belongs to.
Public propertyDraggable
Whether the visual be dragged using the mouse.
Public propertyFaceCount
Number of faces in Mesh for Visual.
Public propertyFaceCountDeep
Number of faces in Mesh for Visual and all its children.
Public propertyFirstChild
The first child visual of this visual, or null if this visual has no children.
Public propertyFixToParent

Field Value

Type: 
For a load or vehicle this will create a fixed joint between it and its parent unless there is another joint in the way. This should be true for creating composite loads or vehicles or false where there is just a logical connection to the parent, e.g. boxes in a tote.
Public propertyFullName
The full name of this Visual, including the names of all Parent Visual separated by '.' characters.
Public propertyHasChildren
Determine if this Visual has any children or not.
Public propertyHasNextSibling
Determine if this Visual has any siblings or not.
Public propertyHideAdvancedProperties
Public propertyId
A unique identifier for this Visual.
Public propertyIncludeChildContextMenus

Field Value

Type: 
When right clicking on the object should child objects menu items be included. Default is false.
Public propertyInitialLocation
The InitialLocation of the Visual in meters from the Origin of the Parent Visual.
Public propertyInitialMatrix
The InitialLocation and InitialRotation in Matrix form.
Public propertyInitialParentOnReset

Field Value

Type: 
The parent that should be assigned upon reset. This is useful for vehicle-type components that should reset their position to a particular track section, for example.
Public propertyInitialPositionOnReset

Field Value

Type: 
Moves the visual back to its initial location and rotation when Reset is pressed.
Public propertyInitialRotationDegrees
The InitialRotation of the Visual in degrees relative to the Rotation of Parent Visual.
Public propertyInitialRotationMatrix
The InitialRotation in Matrix form.
Public propertyInitialRotationRadians
The InitialRotation of the Visual in radians relative to the Rotation of Parent Visual.
Public propertyInitialWorldLocation
The InitialLocation of this Visual and all its Parent Visuals in Matrix form.
Public propertyInitialWorldMatrix
The InitialLocation and InitialRotation of this Visual and all its Parent Visuals in Matrix form.
Public propertyIsVisible
Determines whether the Visual is currently visible given the state of layers, etc.
Public propertyLayer

Field Value

Type: 
The layer for this object. If (As Parent) it inherits its layer from its parent, which may in turn inherit the layer from its parent, etc.
Public propertyLocation
The visual's X, Y, and Z coordinates relative to its parent.
Public propertyLocationX
The visual's X coordinate relative to its parent.
Public propertyLocationY
The visual's Y coordinate relative to its parent.
Public propertyLocationZ
The visual's Z coordinate relative to its parent.
Public propertyMatrix
The current matrix transform of the Visual local to its Parent Visual.
Public propertyMeshBoundingBox
Get the bounding box of the mesh for this visual.
Public propertyMeshBoundingSphere
Get the bounding sphere for the mesh of this visual.
Public propertyMoveToEventsEnabled

Field Value

Type: 
If True, then MoveTo, TurnTo will issue events that indicate when the visual has started accelerating, cruising, decelerating and has stopped. <p> When enabled, the events are issued as OnAnimatorEvent. <p>An example function that will handle these events is: <pre> function Box_OnAnimatorEvent( sender : Visual, args : AnimatorEventArgs ) { switch (args.EventType) { case AnimatorEventType.Accelerate: print("Accelerating"); break; case AnimatorEventType.Cruise: print("Cruising"); break; case AnimatorEventType.Decelerate: print("Decelerating"); break; case AnimatorEventType.Stop: print("Stopped"); break; } } </pre>
Public propertyName
The name of the Visual.
Public propertyNativeObject
The native C# scripting class instance for this visual
Public propertyNativeTypeName

Field Value

Type: 
The namespace and class name to instantiate for this Visual, e.g. Demo3D.Components.Component (in this case Demo3D.Components.dll will be loaded to try to find the class)
Public propertyNewNameExpr

Field Value

Type: 
The string used to format the new name of this component if it is copied or added to the project from a catalog. The variable name "ID" will generate a unique number for that type of component in the current project.
Public propertyNextSibling
The next sibling of this visual, or null if this visual has no siblings.
Public propertyOnAfterParentPropertyUpdated
Public propertyOnAfterPropertyUpdated
Public propertyOnAfterSubscribedPropertyUpdated
Public propertyOnAnimatorCompleted

Field Value

Type: 
Undocumented
Public propertyOnAnimatorEvent

Field Value

Type: 
Call this script when the visual starts to accelerate, cruise, decelerate and stop during a MoveTo or TurnTo command. Note that this event will only be issued if MoveToEventsEnabled is set to True. <p> See also: <ul> <li>MoveToEventsEnabled </ul>
Public propertyOnBeforeParentPropertyUpdated
Public propertyOnBeforePropertyUpdated
Public propertyOnChildAdded

Field Value

Type: 
Call this script when a child is parented to this visual after the reparenting has been performed.
Public propertyOnChildRemoved

Field Value

Type: 
Call this script when a child is unparented from this visual after the reparenting has been performed.
Public propertyOnClick

Field Value

Type: 
Call this script when the visual is clicked on in demonstration/navigation mode.
Public propertyOnConnected

Field Value

Type: 
Call this script whenever this visual is connected to another visual
Public propertyOnCustomPropertyUpdated
Public propertyOnDisconnected

Field Value

Type: 
Call this script when this visual is disconnected from another visual
Public propertyOnDragEnd

Field Value

Type: 
Call this script when a visual has finished being dragged to a new location.
Public propertyOnDragStart

Field Value

Type: 
Call this script when a visual is about to be dragged to a new location.
Public propertyOnExperimentFinished

Field Value

Type: 
Call this script at the end of each experiment. This allows finalization of any data collection, for example. <p> See also: <ul> <li>OnExperimentStarted</li> </ul>
Public propertyOnExperimentStarted

Field Value

Type: 
Call this script at the start of each experiment. This allows for initialization of any data collection, for example. <p> See also: <ul> <li>OnExperimentFinished</li> </ul>
Public propertyOnExportBindableItem

Field Value

Type: 
Undocumented
Public propertyOnInitialize

Field Value

Type: 
The script to run when Play is pressed at time 0.
Public propertyOnKey

Field Value

Type: 
Call this script when a key is pressed and this visual is selected.
Public propertyOnLoaded

Field Value

Type: 
Undocumented
Public propertyOnMessage

Field Value

Type: 
Call this script when a message is received from another visual. <p> To receive messages, this visual must be included in the other visual's MessageListeners list. <p> See also: <ul> <li>MessageListenersEnabled</li> </ul>
Public propertyOnMouseLeave

Field Value

Type: 
Undocumented
Public propertyOnMouseOver

Field Value

Type: 
Undocumented
Public propertyOnMouseUp

Field Value

Type: 
Undocumented
Public propertyOnMoved

Field Value

Type: 
Call this script when a visual has moved or rotated. NOTE: For fast moving objects like loads this can be a performance hit.
Public propertyOnMoveToCompleted

Field Value

Type: 
Call this script when a MoveTo or TurnTo has finished.
Public propertyOnParentMoved

Field Value

Type: 
Call this script when a parent or parent's parent, etc. has moved or rotated. NOTE: For fast moving objects like loads this can be a performance hit.
Public propertyOnParentUpdated

Field Value

Type: 
Undocumented
Public propertyOnPreInitialize
Public propertyOnRenderType

Field Value

Type: 
Call this script whenever the render status of a visual type is changed. This is usually in response to the user pressing one of the "Show X" buttons on the toolbar; for example, "Show Lights", "Show Support Stands", etc.
Public propertyOnReset

Field Value

Type: 
The script to be run when Reset is pressed.
Public propertyOnShowDirections

Field Value

Type: 
Call this script when the status of the "Show Direction Arrows" configuration is changed.
Public propertyOnUnloaded

Field Value

Type: 
Undocumented
Public propertyOnVisualAdded

Field Value

Type: 
Call this script when this visual is added to the model. The scene's "OnVisualAdded" is also called for each visual that is added.
Public propertyOnVisualRemoved

Field Value

Type: 
Call this script when this visual is removed from the model. The scene's "OnVisualRemoved" script is also called whenever any visual is removed.
Public propertyParent
The parent Visual for this Visual.
Public propertyPhysicsEnabled
Whether the physics for the visual is enabled or not.
Public propertyPropertyUpdatedSubscribers

Field Value

Type: 
Visuals that will be notified when any custom property on this visual is updated. Each visual will be notified via its "OnAfterSubscribedPropertyUpdated" script. <p> See also: <ul> <li>OnAfterSubscribedPropertyUpdated </ul>
Public propertyRotationDegrees
The rotation of the Visual (in degrees) relative to ts Parent Visual.
Public propertyRotationMatrix
The rotation of this Visual relative to its Parent in Matrix form.
Public propertyRotationRadians
The rotation of the Visual (in radians) relative to its Parent Visual.
Public propertyRotationXDegrees
The X rotation of the Visual (in degrees) relative to its Parent Visual.
Public propertyRotationXRadians
The X rotation of the Visual (in radians) relative to its Parent Visual.
Public propertyRotationYDegrees
The Y rotation of the Visual (in degrees) relative to its Parent Visual.
Public propertyRotationYRadians
The Y rotation of the Visual (in radians) relative to its Parent Visual.
Public propertyRotationZDegrees
The Z rotation of the Visual (in degrees) relative to its Parent Visual.
Public propertyRotationZRadians
The Z rotation of the Visual (in radians) relative to its Parent Visual.
Public propertySelectParentWhenPicked

Field Value

Type: 
If this component is clicked on or is included in a selection rectangle then the parent is selected instead and its properties are shown instead. Once this is set the properties can only be changed from the Project Explorer Window.
Public propertyShowControlPoints
Whether the control points for this visual should be rendered.
Public propertySimpleProperties

Field Value

Type: 
Enter a non-empty name for each property that should be shown in the Simple Properties view.
Public propertySurfaceArea
Surface area of Visual.
Public propertySurfaceAreaDeep
Surface area of Visual and all its children.
Public propertyTags

Field Value

Type: 
List of names that can be used to provide multiple categories of components in a catalog. The catalog can show only components with tag "Pallets", for example.
Public propertyToolTipExpr

Field Value

Type: 
The format string for the tooltip that appears for an object.
Public propertyTopParent
Get the top level visual, the one which has no parent.
Public propertyTransferState
The current state of transfers in or out of this visual using the Transfer Protocol. This is normally set for transfer enabled equipment (not loads).
Public propertyTransferStateEnabled
Whether this visual supports the Transfer Protocol. This is normally set for transfer enabled equipment (not loads).
Public propertyType
A type string for the Visual.
Public propertyUserData
Public propertyUserVars
Public propertyVelocity
The current linear velocity of the Visual in meters/second.
Public propertyVertexCount
Number of vertices in Mesh for Visual.
Public propertyVertexCountDeep
Number of vertices in Mesh for Visual and all its children.
Public propertyVolume
Volume of Visual.
Public propertyVolumeDeep
Volume of Visual and all its children.
Public propertyWorldBoundingBox
The world axis aligned bounding box of this Visual including the bounding boxes of all the child visuals and their children.
Public propertyWorldBoundingBoxExcludingChildren
The world axis aligned bounding box of this Visual only (excluding any children).
Public propertyWorldBoundingSphere
Get the bounding sphere of this visual, including its children, in world space relative to the Scene.
Public propertyWorldBoundingSphereExcludingChildren
Get the bounding sphere of this visual, excluding its children, in world space relative to the Scene.
Public propertyWorldLocation
The visual's world X, Y, and Z coordinates relative to the Scene.
Public propertyWorldLocationX
The visual's world X coordinate relative to the Scene.
Public propertyWorldLocationY
The visual's world Y coordinate relative to the Scene.
Public propertyWorldLocationZ
The visual's world Z coordinate relative to the Scene.
Public propertyWorldMatrix
The Location and Rotation of this Visual in Matrix form.
Public propertyWorldRotationDegrees
The world rotation of the Visual (in degrees) relative to the Scene.
Public propertyWorldRotationMatrix
The rotation of this Visual relative to the Scene in Matrix form.
Public propertyWorldRotationRadians
The world rotation of the Visual (in radians) relative to the Scene.
Public propertyWorldRotationXDegrees
The world X rotation of the Visual (in degrees) relative to the Scene.
Public propertyWorldRotationXRadians
The world X rotation of the Visual (in radians) relative to the Scene.
Public propertyWorldRotationYDegrees
The world Y rotation of the Visual (in degrees) relative to the Scene.
Public propertyWorldRotationYRadians
The world Y rotation of the Visual (in radians) relative to the Scene.
Public propertyWorldRotationZDegrees
The world Z rotation of the Visual (in degrees) relative to the Scene.
Public propertyWorldRotationZRadians
The world Z rotation of the Visual (in radians) relative to the Scene.
Public propertyWorldXAxis
The world X-Axis for the visual
Public propertyWorldYAxis
The world Y-Axis for the visual
Public propertyWorldZAxis
The world Z-Axis for the visual
Top
See Also