ImportedMeshVisual Properties

Returns all the aspects for this Visual.

Gets all connectors.

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>

Return all ancestor visuals above this point in the Visual hierarchy.

Angular damping threshold for physics-based rotations

The world-space axes in which the rigid body is permitted to rotate. Values of one and zero specify that rotation is disabled and enabled respectively.

The current angular velocity of the Visual in radians/second.

Determine if any animations are currently in progress for this Visual.

The global application object.

When attaching to a conveyor snap with the X axis align Forwards, Reverse or Nearest where Nearest means snap either way favoring the current relative orientation of the object.

The offset to snap to on a conveyor, useful for building vehicles which track the inner side of a conveyor loop.

If True, then the object will snap itself to the center line of a conveyor surface.

If True, then the body will disable itself after a certain period of inactivity. This is a physics optimization; inactive bodies will appear red in the physics view (press F8 to see physics view).

Recreate mesh when any dimensions change. If true, you don't need a PropertiesUpdated() call

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.

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.

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

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.

The time the sensor was last blocked.

The amount of time to wait from a blocking event until the OnBlockedTimeout occurs. The event is not raised if the sensor is cleared during the timeout period.

'Visual Only' is just the graphics. 'Load' will be available to load creators and be affected by gravity. 'Vehicle' is like a load but isn't transient and remains in the scene after a Reset. 'Deflector' is fixed in space and will deflect other objects. 'Sensor' is fixed in space but will fire scripts when other objects come into contact with it.

Get the bounding box of this visual including all its children.

Get the bounding sphere of this visual, including its children.

Shows whether this object casts a shadow or not. Useful for large objects such as warehouses where the walls shouldn't cast shadows on the conveyors.

The distance in one time step above which continuous collision detection is enabled. Setting this to zero disables continuous collision detection for the body.

Return the collection of child Visuals.

The time the sensor was last cleared.

The amount of time to wait from a clearing event until the OnClearedTimeout occurs. The event is not raised if the sensor is blocked during the timeout period.

The diffuse color of the first mesh material on the mesh object.

The diffuse colors of the all the mesh materials on the mesh object.

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>

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>

All pairs of connectors from this visual.

If True, then the object will fire the OnContact event when another object collides with it. Objects usually bounce against other objects, so this property is set False after the event is raised.

The amount of time to wait from a contact event until the OnContactTimeout is fired.

A white list of control points that should be shown and editable.

A black list of control points that should be hidden and not editable.

Parameters that control the fidelity when decomposing the mesh into a set of convex-hulls.

(Inherited from MeshObject.)

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.

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.

Information about the current transfer in progress for this visual using the Transfer Protocol. This is normally set for loads.

The collection of CustomProperty objects for this Visual.

If true then the deflector is able to block and clear sensors. Useful when attached to a moving conveyor or vehicle to see when it reaches a certain position.

Whether the object should be deleted on reset or not.

If this is true and the body type is set to 'Load' and the load touches the floor at any time it will be deleted after the number of seconds defined by the 'Delete Loads After' setting for the project.

The depth of the bounding box of the imported 3D model.

Return all visuals below this point in the Visual hierarchy .

Return all visuals below this point in the Visual hierarchy .

A description of the Visual.

The document that this Visual belongs to.

Whether the visual be dragged using the mouse.

Number of triangular faces in the mesh

Number of faces in Mesh for Visual and all its children.

The first child visual of this visual, or null if this visual has no children.

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.

'Visual Only' is just the graphics. 'Load' will be available to load creators and be affected by gravity. 'Vehicle' is like a load but isn't transient and remains in the scene after a Reset. 'Deflector' is fixed in space and will deflect other objects. 'Sensor' is fixed in space but will fire scripts when other objects come into contact with it.

The full name of this Visual, including the names of all Parent Visual separated by '.' characters.

Whether the object is affected by gravity or not.

Determine if this Visual has any children or not.

Determine if this Visual has any siblings or not.

The height of the bounding box of the imported 3D model.

(Inherited from Visual.)

A unique identifier for this Visual.

When right clicking on the object should child objects menu items be included. Default is false.

The InitialLocation of the Visual in meters from the Origin of the Parent Visual.

The InitialLocation and InitialRotation in Matrix form.

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. Note this is only applied if InitialPositionOnReset is set to True.

Moves the visual back to its initial location and rotation when Reset is pressed.

The InitialRotation of the Visual in degrees relative to the Rotation of Parent Visual.

The InitialRotation in Matrix form.

The InitialRotation of the Visual in radians relative to the Rotation of Parent Visual.

The InitialLocation of this Visual and all its Parent Visuals in Matrix form.

The InitialLocation and InitialRotation of this Visual and all its Parent Visuals in Matrix form.

Is this visual a floor visual.

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.

There is a mesh and the properties are set to visible.

Whether this visual and all its ancestor visuals are Static.

If True and BodyType is Vehicle, then this body may be animated (with MoveTo, for example) such that it will interact correctly with loads. This is useful for building lift platforms, shuttles, etc.

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.

The percentage of the rigid body's linear velocity that is lost per second. This can be used to simulate air resistance.

The world-space axes in which the rigid body is permitted to rotate. Values of one and zero specify that rotation is disabled and enabled respectively.

The local-space offset that is applied to the rigid body's center of gravity. Not supported by ODE.

The visual's X, Y, and Z coordinates relative to its parent.

The visual's X coordinate relative to its parent.

The visual's Y coordinate relative to its parent.

The visual's Z coordinate relative to its parent.

Keep the ratios of the width, height and depth the same as the 3D model is scaled.

Set the mass of the body. Setting this changes the density according to the bounding box.

The main material for the imported mesh.

A list of colors and optional textures associated with parts of the 3D model.

The current matrix transform of the Visual local to its Parent Visual.

The accuracy with which to draw the mesh. When set to 1.0 the full mesh is rendered. Lower will attempt to reduce the face and vertex count to reduce the burden on the graphics card.

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>

The name of the Visual.

The native C# scripting class instance for this visual

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)

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.

The next sibling of this visual, or null if this visual has no siblings.

Occurs after a property of the parent visual is updated.

Occurs after a property of the visual is updated.

Occurs after a property of a visual that has this visual in its PropertyUpdatedSubscribers list is updated.

Occurs when an animator completes.

Occurs 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.

Occurs when the physics object is attached to a conveyor.

Occurs before a property of the parent visual is updated.

Occurs before a property of the visual is updated.

Occurs when the sensor is blocked.

Occurs when the sensor has been blocked for BlockedTimeout seconds (BodyType must be Sensor).

Occurs when a child is parented to this visual after the reparenting has been performed.

Occurs when a child is unparented from this visual after the reparenting has been performed.

Occurs when the sensor is cleared (BodyType must be Sensor).

Occurs when the sensor has been cleared for ClearedTimeout seconds (BodyType must be Sensor).

Occurs when the visual is clicked on in demonstration/navigation mode.

Occurs when this visual is connected to another visual

Occurs when BodyType is Deflector and something collides with the object.

Occurs when BodyType is Deflector and the OnContactTimeout occurs.

Occurs after a custom property of the visual is renamed.

Occurs after a custom property of the visual is updated.

Occurs when the physics object is detached from a conveyor.

Occurs when this visual is disconnected from another visual

Occurs when a visual has finished being dragged to a new location.

Occurs when a visual is about to be dragged to a new location.

Occurs at the end of each experiment. This allows finalization of any data collection, for example.

Occurs 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.

Occurs at the start of each experiment. This allows for initialization of any data collection, for example.

Occurs when Export is called from the Tag Browser. This allows custom information to be written about each tag in addition to the default data.

Occurs when Play is pressed at time 0.

Occurs when a key is pressed or released and this visual is selected.

Occurs when a key is pressed and this visual is selected.

Occurs when the document is loaded.

Occurs when a message is sent from another visual's MessageListeners list.

Occurs when the mouse moves away from the visual.

Occurs when the mouse moves over the visual.

Occurs when the mouse enters the visual.

Occurs when a mouse button is released after being pressed on the visual.

Occurs when a visual has moved or rotated. NOTE: For fast moving objects like loads this can be a performance hit.

Occurs when a MoveTo or TurnTo has finished.

Occurs 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.

Occurs when the parent for the visual changes.

Occurs before OnInitialize is called. The OnPreInitialize is called for every visual in one pass. Then a second pass calls OnInitialize for every visual.

Occurs when processing volumetric physics contact points. Arguments are the sender, the load visual and the contact details (of type ContactInfo). Implementing this handler can severely impact performance.

Occurs 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.

Reports collision impulses. Reporting of impulses must be enabled on the Scene. Implementing this handler can severely impact performance.

Occurs when Reset is pressed.

(Inherited from Visual.)

Occurs when the status of the "Show Direction Arrows" configuration is changed.

Occurs when the document is unloaded

Occurs when this visual is added to the model. The scene's "OnVisualAdded" is also called for each visual that is added.

Occurs when this visual is removed from the model. The scene's "OnVisualRemoved" script is also called whenever any visual is removed.

The parent Visual for this Visual.

The default collision margin for physics collision geometry belonging to the visual's PhysicsBody.

Whether the physics for the visual is enabled or not.

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>

The rotation of the Visual (in degrees) relative to ts Parent Visual.

The rotation of this Visual relative to its Parent in Matrix form.

The rotation of the Visual (in radians) relative to its Parent Visual.

The X rotation of the Visual (in degrees) relative to its Parent Visual.

The X rotation of the Visual (in radians) relative to its Parent Visual.

The Y rotation of the Visual (in degrees) relative to its Parent Visual.

The Y rotation of the Visual (in radians) relative to its Parent Visual.

The Z rotation of the Visual (in degrees) relative to its Parent Visual.

The Z rotation of the Visual (in radians) relative to its Parent Visual.

A scale factor for the whole 3D model. The ratios of the width, depth and height and maintained.

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.

If true the OnBlocked and OnCleared are called for every load that blocks or clears the sensor. If false the events are only fired for the first load that blocks the sensor. Subsequent touching loads keep it blocked and the OnCleared occurs for the first load when the last load is cleared.

Enter a non-empty name for each property that should be shown in the Simple Properties view.

How tolerant this object is to penetration from other objects.

The current speed of the visual.

Surface area of shape - for certain shapes (e.g. box, sphere, cylinder) this is overridden and it is accurate Otherwise it is the surface area of the triangular faces in the mesh. This requires a "closed" mesh, that the mesh does not have both front and back faces, and any overlap in the mesh will be counted multiple times.

Surface area of Visual and all its children.

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.

The format string for the tooltip that appears for an object.

Get the top level visual, the one which has no parent.

The properties to allow the object to track along and/or from side to side on a conveyor it is attached to. This allows vehicle movements like sorters, magic shoes, palletizers, etc.

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).

Whether this visual supports the Transfer Protocol. This is normally set for transfer enabled equipment (not loads).

A type string for the Visual.

When true, this visual will not create a rigid body of its own, but add its geom to its parent. This is useful for creating components from several visuals that must remain internally stable.

A 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.

A dictionary of user key value pairs that can be used to store any custom data about the visual.

The current linear velocity of the Visual in meters/second.

Number of vertices in the mesh

Number of vertices in Mesh for Visual and all its children.

Indicates if the built-in visual is drawn. If not visible, the component will still operate as normal, allowing it to be grouped with an imported graphic for custom component types.

The object becomes visible when it's center is this distance from the camera or greater. The default is 0. Useful for level of detail control.

The object becomes invisible when it's center is this distance from the camera or greater. The default is Infinity. Useful for level of detail control, such as hiding small objects like bolts when they get far from the camera.

Return all ancestor visuals above this point in the Visual hierarchy, including the Visual itself.

Return all visuals below this point in the Visual hierarchy including the Visual itself.

Volume of material in shape - for certain shapes (e.g. box, sphere, cylinder) this is overridden and it is accurate Otherwise it is the volume enclosed by the triangular faces in the mesh. This requires a "closed" mesh, that the mesh does not have both front and back faces, and any overlap in the mesh will be counted multiple times.

Volume of Visual and all its children.

The width of the bounding box of the imported 3D model.

The world axis aligned bounding box of this Visual including the bounding boxes of all the child visuals and their children.

The world axis aligned bounding box of this Visual only (excluding any children).

Get the bounding sphere of this visual, including its children, in world space relative to the Scene.

Get the bounding sphere of this visual, excluding its children, in world space relative to the Scene.

The visual's world X, Y, and Z coordinates relative to the Scene.

The visual's world X coordinate relative to the Scene.

The visual's world Y coordinate relative to the Scene.

The visual's world Z coordinate relative to the Scene.

The Location and Rotation of this Visual in Matrix form.

The world rotation of the Visual (in degrees) relative to the Scene.

The rotation of this Visual relative to the Scene in Matrix form.

The world rotation of the Visual (in radians) relative to the Scene.

The world X rotation of the Visual (in degrees) relative to the Scene.

The world X rotation of the Visual (in radians) relative to the Scene.

The world Y rotation of the Visual (in degrees) relative to the Scene.

The world Y rotation of the Visual (in radians) relative to the Scene.

The world Z rotation of the Visual (in degrees) relative to the Scene.

The world Z rotation of the Visual (in radians) relative to the Scene.

The world X-Axis for the visual

The world Y-Axis for the visual

The world Z-Axis for the visual