Click or drag to resize

Visual Properties

The Visual type exposes the following members.

Properties
 NameDescription
Public propertyAllConnectorsGets all connectors.
Public propertyAllowWaitOnMoveWhen 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 propertyAncestors Return all ancestor visuals above this point in the Visual hierarchy.
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 propertyBillboardIf 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 propertyBillOfMaterialsCodeExprThe 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 propertyBillOfMaterialsCostExprThe cost of the component as it appears in the bill of materials, e.g. "1595.95".
Public propertyBillOfMaterialsDescriptionExprThe 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 propertyClientOwnerUsername 
Public propertyConnectAllowedA 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 propertyConnectDisallowedA 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 propertyControlPointsAllowedA white list of control points that should be shown and editable.
Public propertyControlPointsDisallowedA 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 propertyFixToParentFor 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 propertyHierarchyColorThe background color of the Visual in the hierarchy
Public propertyId A unique identifier for this Visual.
Public propertyIncludeChildContextMenusWhen 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 propertyInitialParentOnResetThe 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. Note this is only applied if InitialPositionOnReset is set to True.
Public propertyInitialPositionOnResetMoves 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 propertyIsSimulationTransferInProgress 
Public propertyIsStatic Can this visual change its Location/Rotation relative to its parent at runtime. This is used to improve simulation and graphical performance by analyzing what can and can't move during a model run.
Public propertyIsVisible Determines whether the Visual is currently visible given the state of layers, etc.
Public propertyIsWorldStatic Whether this visual and all its ancestor visuals are Static.
Public propertyKinematic Whether the visual's body is kinematic.
Public propertyLayerThe 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 propertyMoveToEventsEnabledIf 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 propertyNativeTypeNameThe 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 propertyNewNameExprThe 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 propertyOnAfterParentPropertyUpdatedOccurs after a property of the parent visual is updated.
Public propertyOnAfterPropertyUpdatedOccurs after a property of the visual is updated.
Public propertyOnAfterSubscribedPropertyUpdatedOccurs after a property of a visual that has this visual in its PropertyUpdatedSubscribers list is updated.
Public propertyOnAnimatorCompletedOccurs when an animator completes.
Public propertyOnAnimatorEventOccurs 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.
Public propertyOnAspectRenamedOccurs after an aspect on the visual is renamed.
Public propertyOnBeforeParentPropertyUpdatedOccurs before a property of the parent visual is updated.
Public propertyOnBeforePropertyUpdatedOccurs before a property of the visual is updated.
Public propertyOnChildAddedOccurs when a child is parented to this visual after the reparenting has been performed.
Public propertyOnChildRemovedOccurs when a child is unparented from this visual after the reparenting has been performed.
Public propertyOnClickOccurs when the visual is clicked on in demonstration/navigation mode.
Public propertyOnConnectedOccurs when this visual is connected to another visual
Public propertyOnCustomPropertyCreatedOccurs after a new custom property is added to the visual.
Public propertyOnCustomPropertyRenamedOccurs after a custom property of the visual is renamed.
Public propertyOnCustomPropertyUpdatedOccurs after a custom property of the visual is updated.
Public propertyOnDisconnectedOccurs when this visual is disconnected from another visual
Public propertyOnDragEndOccurs when a visual has finished being dragged to a new location.
Public propertyOnDragStartOccurs when a visual is about to be dragged to a new location.
Public propertyOnExperimentFinishedOccurs at the end of each experiment. This allows finalization of any data collection, for example.
Public propertyOnExperimentPreInitializeOccurs at the before each experiment starts running but after the current experiment row variables have been set. This allows initialization of the model to be done before OnInitialize has been called.
Public propertyOnExperimentStartedOccurs at the start of each experiment. This allows for initialization of any data collection, for example.
Public propertyOnExportBindableItemOccurs when Export is called from the Tag Browser. This allows custom information to be written about each tag in addition to the default data.
Public propertyOnInitializeOccurs when Play is pressed at time 0.
Public propertyOnKeyOccurs when a key is pressed or released and this visual is selected.
Public propertyOnKeyPressOccurs when a key is pressed and this visual is selected.
Public propertyOnLoadedOccurs when the document is loaded.
Public propertyOnMessageOccurs when a message is sent from another visual's MessageListeners list.
Public propertyOnMouseLeaveOccurs when the mouse moves away from the visual.
Public propertyOnMouseMoveOccurs when the mouse moves over the visual.
Public propertyOnMouseOverOccurs when the mouse enters the visual.
Public propertyOnMouseUpOccurs when a mouse button is released after being pressed on the visual.
Public propertyOnMovedOccurs when a visual has moved or rotated. NOTE: For fast moving objects like loads this can be a performance hit.
Public propertyOnMoveToCompletedOccurs when a MoveTo or TurnTo has finished.
Public propertyOnNameChangedOccurs when this visual's name is changed.
Public propertyOnParentMovedOccurs 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 propertyOnParentUpdatedOccurs when the parent for the visual changes.
Public propertyOnPreInitializeOccurs before OnInitialize is called. The OnPreInitialize is called for every visual in one pass. Then a second pass calls OnInitialize for every visual.
Public propertyOnRenderTypeOccurs 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 propertyOnResetOccurs when Reset is pressed.
Public propertyOnShortcut
Public propertyOnShowDirectionsOccurs when the status of the "Show Direction Arrows" configuration is changed.
Public propertyOnUnloadedOccurs when the document is unloaded
Public propertyOnVisualAddedOccurs when this visual is added to the model. The scene's "OnVisualAdded" is also called for each visual that is added.
Public propertyOnVisualRemovedOccurs 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 propertyPhysicsCollisionMargin The default collision margin for physics collision geometry belonging to the visual's PhysicsBody.
Public propertyPhysicsEnabled Whether the physics for the visual is enabled or not.
Public propertyPropertyUpdatedSubscribersVisuals 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 propertySelectParentWhenPickedIf 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 propertySimplePropertiesEnter 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 propertyTagsList 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 propertyToolTipExprThe 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 propertyUserDataA string that can be used to store any custom data about the visual. This is passed to the WebGL and VR renderers to be used in remote applications.
Public propertyUserVarsA dictionary of user key value pairs that can be used to store any custom data about the visual.
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 propertyVisualAndAncestors Return all ancestor visuals above this point in the Visual hierarchy, including the Visual itself.
Public propertyVisualAndDescendants Return all visuals below this point in the Visual hierarchy including the Visual itself.
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