Constants

Action Constants

Action Types

Name Description
VC_ACTION_WORK Work for a specific time or using specific RSL sequence.
VC_ACTION_TRANSPORT Transport component to target component.
VC_ACTION_MOVE Move resource component to the specific component (and location).
VC_ACTION_LOAD Load component to the resource.
VC_ACTION_UNLOAD Unload component from resource to given component.

Python keyword Notation and Arguments

VC_ACTION_WORK

Work for a specific time or using specific RSL sequence at current place or location defined by component or vcMatrix.

Work action can use Python keyword notation or arguments alone (using keyword argument order).

Name Type Required Description
Worktime Real Always Defines work time in seconds.
Place vcComponent Optional Defines component where work takes place.

If Place is not defined, work is executed at resources current location.

If Place is defined together with Location, Location is used as resource location.

If only Place argument is defined, then resource location is defined by locating frame feature named ResourceLocation in the Place component.

If ResourceLocation frame feature is not defined, then component origin is used as resource location.

Location vcMatrix Optional Defines resource position during work in world coordinate system.
Sequence String Optional Defines work animation/rsl sequence name.

VC_ACTION_TRANSPORT

Transport moves part using resource to the world location, specified node or to the component container. Transporting can define optional FromComponent and FromLocation parameters to define the place where part can be loaded for transportation. If FromComponent is not defined, then part owner component is used instead. Transporting requires Part and any of the ToComponent, ToContainer, ToConnector parameters to define the place where part is transported. Optional PartLocation parameter defines exact part location.

Transporting to the specific component requires ToComponent and optional ToLocation to specify the exact resource location at component, otherwise the resource will use a frame called ResourceLocation as default location. Transporting to container can be expressed using ToContainer or ToConnector parameter. ToContainer parameter can use PartLocation to define the exact location.

Transport action can use Python keyword notation or parameters alone (using keyword parameter order).

Name Type Required Description
Part vcComponent Always Defines the component to be delivered.
FromComponent vcComponent Optional Defines the component where to pick up Part.
ToComponent vcComponent Optional Defines the component where to deliver Part.
ToContainer vcContainer Optional Defines the container type behavior Part is attached to in the 3D world.

Optional ToLocation can define position in relation to container node coordinate system.

ToLocation vcMatrix Optional Defines resource location. ToLocation used together with ToComponent uses world coordinate system to define the exact location.
ToConnector vcConnector Optional Defines (input) connector where Part will be transferred. If Part cannot be transferred immediately due capacity, then action will wait until capacity is available.
PartLocation vcMatrix Optional Defines the part location in the target component. PartLocation used together with ToContainer uses container owner node coordinate system to define the exact location.
FromLocation vcMatrix Optional Defines resource location from where it will transport. FromLocation uses world coordinate system.

VC_ACTION_MOVE

Move resource to the specified component place or vcMatrix defined location. Action must include either Place or Location argument or both.

Move action can use Python keyword notation or parameters alone (using keyword parameter order).

Name Type Required Description
Place vcComponent Optional Defines resource movement target.

If Place is defined together with Location, Location is used as target location. If only Place argument is defined, then target location is defined by locating frame feature named ResourceLocation in the Place component.

If ResourceLocation frame feature is not defined, then component origin is used as target location.

Location vcMatrix Optional Defines resource movement target location in world coordinate system.

VC_ACTION_LOAD

Load component to resource which can then move with it to other location or unload it to some other place.

Load action can use Python keyword notation or parameters alone (using keyword parameter order).

Name Type Required Description
Part vcComponent Always Defines component to be loaded.

Resource component defines independently where the component is loaded, e.g. human worker carries component with one or two hands or a forklift carries the component using forks.

VC_ACTION_UNLOAD

Unloads carried part component to the world, specified node or to the component container. Unloading to world requires only Part to be defined. Unloading to the specific node requires ToNode and optional ToNodeLocation to specify the exact part location at node. Unloading to container can be expressed either using ToContainer or ToConnector parameter. ToContainer parameter can use ToNodeLocation to define the exact location.

Unload action can use Python keyword notation or parameters alone (using keyword parameter order).

Name Type Required Description
Part vcComponent Always Defines component to be unloaded.
ToNode vcNode Optional Defines node where Part will be attached.
ToContainer vcContainer Optional Defines container behavior where part will be grabbed. Optional ToNodeLocation can define position in relation to container node coordinate system.
ToNodeLocation vcMatrix Optional Defines exact position where part will be grabbed. Defines part origin position relative to ToNode or ToContainer owner node coordinate system.
ToConnector vcConnector Optional Defines (input) connector where Part will be transferred. If Part cannot be transferred immediately due capacity, then action will wait until capacity is available.

Approach Axis Constants

Name Description
VC_APPROACH_AXIS_POSITIVE_Z Approach from positive Z-axis direction.
VC_APPROACH_AXIS_NEGATIVE_Z Approach from negative Z-axis direction.
VC_APPROACH_AXIS_POSITIVE_Y Approach from positive Y-axis direction.
VC_APPROACH_AXIS_NEGATIVE_Y Approach from negative Y-axis direction.
VC_APPROACH_AXIS_POSITIVE_X Approach from positive X-axis direction.
VC_APPROACH_AXIS_NEGATIVE_X Approach from negative X-axis direction.

Behavior Constants

Name Object
VC_ACTIONCONTAINER vcActionContainer
VC_ARTICULATEDKINEMATICS (Deprecated) vcBehaviour
VC_ARTICULATEDKINEMATICS2 vcBehaviour
VC_BASECONTAINER vcBehaviour
VC_BEHAVIOURSIGNAL vcSignal
VC_BOOLEANPROPERTYCREATOR vcFlow
VC_BOOLEANSIGNAL vcBoolSignal
VC_BOOLEANSIGNALMAP vcBooleanSignalMap
VC_BUCKETPATH vcContainer
VC_CAPACITYCONTROLLER vcBehaviour
VC_CARTESIANKINEMATICS vcBehaviour
VC_COMPONENTCONTAINER vcContainer
VC_COMPONENTCREATOR vcComponentCreator
VC_COMPONENTFLOWPROXY vcComponentFlowProxy
VC_COMPONENTGRABBER (Deprecated) vcBehaviour
VC_COMPONENTPATHSENSOR vcBehaviour
VC_COMPONENTSIGNAL vcComponentSignal
VC_CONTAINER vcBehaviour
VC_CONTAINERFILLER vcFlow
VC_DELTAKINEMATICS vcBehaviour
VC_DOCUMENTLINK vcBehaviour
VC_FLOW vcFlow
VC_FRAMESIGNAL vcSignal
VC_INTEGERPROPERTYCREATOR vcFlow
VC_INTEGERSIGNAL vcIntegerSignal
VC_JOGINFO vcBehaviour
VC_KINEMATICS vcKinematics
VC_MATRIXSIGNAL vcMatrixSignal
VC_NODELIST vcNodeList
VC_NOTE vcBehaviour
VC_ONEDIRECTIONALPATH (Deprecated) vcContainer
VC_ONETOMANYINTERFACE vcSimInterface
VC_ONETOONEINTERFACE vcSimInterface
VC_ONEWAYPATH vcMotionPath
VC_PARALLELLOGRAMKINEMATICS vcBehaviour
VC_PARTICLESYSTEM (Deprecated) vcBehaviour
VC_PATTERNCONTAINER vcPatternContainer
VC_PROCESSEXECUTOR vcProcessExecutor
VC_PROCESSPOINT vcProcessPointSensor

VC_PRODUCTCREATOR

vcProductCreator

VC_PYTHONKINEMATICS vcBehaviour
VC_PYTHONPROCESSHANDLER vcRslProcessHandler

VC_PYTHONTRANSPORTCONTROLLER

vcPythonTransportController
VC_RAYCASTSENSOR vcBehaviour
VC_REALPROPERTYCREATOR vcFlow
VC_REALSIGNAL vcRealSignal
VC_REALSIGNALMAP vcBehaviour
VC_ROBOTCONTROLLER vcRobotController
VC_ROBOTEXECUTOR vcExecutor
VC_ROUTINGRULE vcRoutingRule
VC_RRSROBOTCONTROLLER vcRrsRobotController

VC_RSLEXECUTOR

(Deprecated) vcRslProgramExecutor

VC_SCARAKINEMATICS (Deprecated) vcBehaviour
VC_SCARAKINEMATICS2 vcBehaviour
VC_SCRIPT vcScript
VC_SERVOCONTROLLER vcServoController
VC_STATISTICS vcStatistics
VC_STRINGPROPERTYCREATOR vcFlow
VC_STRINGSIGNAL vcStringSignal
VC_TOOLCONTAINER vcBehaviour
VC_TRANSPORT vcBehaviour
VC_TRANSPORTNODE vcTransportNode
VC_TWODIRECTIONALPATH (Deprecated) vcContainer
VC_TWOWAYPATH vcMotionPath
VC_VEHICLE vcBehaviour
VC_VOLUMESENSOR vcBehaviour

Path

Name Description
VC_PATH_NO_TRIGGER Sensor is not triggered at all by the component.
VC_PATH_LEADING_EDGE_TRIGGER Sensor is triggered by the leading edge of the component.
VC_PATH_ORIGIN_TRIGGER Sensor is triggered by the origin of the component.
VC_PATH_TRAILING_EDGE_TRIGGER Sensor is triggered by the trailing edge of the component.

Bitmap Constants

Name Description
VC_BITMAP_RGB Bitmap format of red green blue color model.
VC_BITMAP_RGBA Bitmap format of red green blue alpha color model; uses RGB color model and allows for Alpha compositing (opacity and transparency).

Boolean Feature Constants

Name Python Class
VC_BOOLEAN_UNION vcFeature
VC_BOOLEAN_INTERSECTION vcFeature
VC_BOOLEAN_SUBTRACTION vcFeature

Collider Constants

Name Description
VC_PHYSICSCOLLIDER_UNSPECIFIED Collider is not defined nor created for feature.
VC_PHYSICSCOLLIDER_NONE Collider not created for feature, for example root feature of node.
VC_PHYSICSCOLLIDER_BOX Collider is a bounding box encompassing all geometry of feature and its subfeatures.
VC_PHYSICSCOLLIDER_BOXES Collider is a set of bounding boxes, one for each geometry set of feature and its subfeatures.
VC_PHYSICSCOLLIDER_PRECISE Collider is convex hull encompassing all geometry of feature and its subfeatures.

Collision Detector Constants

A collision test detects a collision between one or more objects. A volume detector detects if a component collides with a box defined by two corner points, for example a safety zone. A collision detector detects if a component collides with another component.

A collision test uses node lists. Each node list contains one or more entries. Each entry is a node in a component, its scope, and whether or not the node is included/excluded in the test. For example, you could detect a collision between the arm of a robot and a positioner, ignore a collision between the tip of a welding torch and workpiece, and whether or not a human walks too close to a robot executing its program.

Collision Scope

Scope defines what a node represents, for example all nodes in the same component as that node.

Name Description
VC_NODELIST_NODE Adds only the node not its child nodes.

VC_NODELIST_COMPONENT Adds all nodes in the same component.

VC_NODELIST_TREE Adds the node and its child nodes.

Inclusion Type

Inclusion defines if a node is active or ignored in collision test. Be aware the inclusion filter affects the node as well as its scope.

Name Description
VC_NODELIST_INCLUDE Includes the node in test.
VC_NODELIST_EXCLUDE Excludes the node in test.

Testing Method

Testing defines how to check for collisions when using a volume detector. You can detect a collision using either the geometry or bound box of a node.

Name Description
VC_INTERSECT Checks if specified node(s) intersects the surface of volume detector. This is similar to using a collision detector that detects the collision of geometry.

VC_CENTER_INSIDE Checks if center of bounding box of specified node(s) is inside volume detector.

VC_INSIDE Checks if bounding box of specified node(s) is completely inside volume detector.

Command Constants

Name Description
VC_COMMAND_NORMAL Abort all active commands when this command starts.
VC_COMMAND_TOOL Executes this command on top of all active commands. Any previously active commands are suspended, which resume when command execution is complete.
VC_COMMAND_MODE Abort all active commands that also are of type VC_COMMAND_MODE, and execute on top of the others. The camera control commands that implement panning, orbiting and zooming all have this type.
VC_COMMAND_OVERRIDE Abort only the topmost command before executing this command. When command execution is completed any command that was aborted initially is restarted (only if the aborted command supports override activation).

Command Event Constants

Shift State

(Deprecated)

Name Description
VC_SHIFTSTATE_SHIFT A shift key is pressed.
VC_SHIFTSTATE_ALT An Alt key is pressed.
VC_SHIFTSTATE_CTRL A control key is pressed.
VC_SHIFTSTATE_MOUSELEFT The left mouse button is pressed.
VC_SHIFTSTATE_MOUSEMIDDLE The middle mouse button is pressed. In some instances this can be the scroll button on a mouse.
VC_SHIFTSTATE_MOUSERIGHT The right mouse button is pressed.
VC_SHIFTSTATE_CLICK A single click has been detected.
VC_SHIFTSTATE_DOUBLECLICK A double click has been detected.

Type

(Deprecated)

Name Description
VC_EVENT_MOUSE_DOWN A mouse button has been pressed in the 3D window.
VC_EVENT_MOUSE_UP A mouse button has been released in the 3D window.
VC_EVENT_MOUSE_MOVE The mouse has been moved over the 3D window.
VC_EVENT_MOUSE_WHEEL The mouse when has been moved over the 3D window.
VC_EVENT_KEY_DOWN A key has been pressed.
VC_EVENT_KEY_UP A key has been released.

Component Constants

Back Face Mode

Name Description
VC_USE_FEATURE_BACKFACE_MODE Backfaces of component geometry are visible or invisible based on the ShowBackfaces property of each Geometry feature.
VC_FORCE_BACKFACE_OFF Backfaces of component geometry are invisible.
VC_FORCE_BACKFACE_ON Backfaces of component geometry are visible.

Node Configuration Change

Name Description
VC_NODE_REBUILD The component node tree is rebuilt.
VC_NODE_UPDATE_NODE Node1 is updated.
VC_NODE_ADD_FIRST_CHILD Node2 is added as first child for node1.
VC_NODE_ADD_LAST_CHILD Node2 is added as last child for node1.
VC_NODE_REMOVE_NODE Node1 is removed.
VC_NODE_INSERT_FIRST_SIBLING Node2 is added as first sibling for node1.
VC_NODE_INSERT_LAST_SIBLING Node2 is added as last sibling for node1.
VC_NODE_INSERT_AFTER_SIBLING Node2 is added as sibling after node1.
VC_NODE_INSERT_BEFORE_SIBLING Node2 is added as sibling before node1.
VC_NODE_REPLACE_NODE Node1 is replaced by node2.

PDF Export Level

Name Description
VC_EXPORT_NONE Component geometry is not exported into the 3D PDF document.
VC_EXPORT_COMPLETE Component geometry is fully exported into the 3D PDF document.
VC_EXPORT_GEOMETRY_BOUND Component geometry sets are exported as blocks.
VC_EXPORT_NODE_BOUND Component links are exported as blocks.
VC_EXPORT_COMPONENT_BOUND Component is exported as a block.

Simulation Level

Name Integer Description

VC_SIMULATION_DETAILED

0 Use this mode to simulate component movements as accurate as possible, thereby simulating full range of motion for component.

VC_SIMULATION_BALANCED

1

Use this mode to simulate component movements in a way that is balanced with performance of simulation, thereby component may move from point to point without simulating unnecessary joint motions.

VC_SIMULATION_FAST

2

Use this mode to simulate component movements as quickly as possible, thereby component may snap to joint configuration or jump from point to point.

Transportation

Name Description
VC_NOT_AVAILABLE Target is not available for transportation, e.g. no capacity.
VC_AVAILABLE Target is available.
VC_REDIRECTED Target is available as redirected. For example, a machine has a buffer where it places components instead of allowing the component to be transported directly to the machine.

Connector Constants

Capacity Test Location

Name Description
VC_CONNECTOR_CAPACITY_LEADING Test before component's leading edge can transfer.
VC_CONNECTOR_CAPACITY_ORIGIN Test before component's origin can transfer.
VC_CONNECTOR_CAPACITY_TRAILING Test before component's trailing edge can transfer.

Connection Type

Name Description
VC_CONNECTOR_NONE Connection cannot receive or send components.
VC_CONNECTOR_INPUT Connection can receive components.
VC_CONNECTOR_OUTPUT Connection can send components.
VC_CONNECTOR_INPUT_OUTPUT Connection can receive and send components.

Container Constants

Conveyor Direction Modes

Name Description
VC_PATH_FORWARD Conveyor contents are moved forwards from the first frame to the last frame.
VC_PATH_BACKWARD Conveyor contents are moved backwards from the last frame to the first frame.
VC_PATH_FORWARD_AUTO Similar to VC_PATH_FORWARD. However, the conveyor automatically changes direction to VC_PATH_BACKWARD_AUTO if a component is transferred in from the conveyor's second connector (InOut2).
VC_PATH_BACKWARD_AUTO Similar to VC_PATH_BACKWARD. However, the conveyor automatically changes direction to VC_PATH_FORWARD_AUTO if a component is transferred in from the conveyor's first connector (InOut1).

Conveyor Interpolation Modes

Name Description
VC_PATH_STEP No interpolation is performed between frames, so a component's position changes from one frame to the next without any movement in between frames.
VC_PATH_LINEAR The path is interpolated as straight lines between the frames.
VC_PATH_CUBIC A cubic spline is used to interpolate the path from one frame to the next.

Context Constants

Name Description
VC_CONTEXT_AUTHOR "Author" context for modeling components.
VC_CONTEXT_CONFIGURE "Configure" context for building a layout.
VC_CONTEXT_DRAWING "Drawing" context for creating drawings.
VC_CONTEXT_TEACH "Teach" context for teaching robots.
VC_CONTEXT_PROCESS "Process" context for process modelling.

Controller Constants

Name Description
VC_CONTROLLER_START Event type for a controller.
VC_CONTROLLER_RUNNING Event type for a controller.
VC_CONTROLLER_END Event type for a controller.
VC_CONTROLLER_STOP Event type for a controller.
VC_CONTROLLER_UNREACHABLE Event type for a controller.
VC_CONTROLLER_COLLISIONS Event type for a controller.

Track World Frame Modes

Name Description
VC_TRACKWORLDFRAME_TRACKORIGIN The origin of track component is used as Robot World Frame.
VC_TRACKWORLDFRAME_ROBOTWORLD The Robot World Frame of robot is used not the track origin.

Entity Constants

Name Description
VC_PHYSICS_INPHYSICS Object affected by physics, including internal and external forces.
VC_PHYSICS_OUTOFPHYSICS Object not affected by physics.
VC_PHYSICS_KINEMATIC Object affected by physics, excluding internal forces such as gravity.
VC_PHYSICS_INCONTAINER Object affected by physics, and system monitors transition of object into and out of containers.

Feature Constants

Name Feature Python Class
VC_ANGULARCLONE Angular Clone vcFeature
VC_BLOCK Block vcFeature
VC_BOOLEAN Boolean vcFeature
VC_CONE Cone vcFeature
VC_CYLINDER Cylinder vcFeature
VC_EXTRUDE Extrude vcFeature
VC_FRAME Frame vcFeature
VC_GEOMETRY Geometry vcGeometryFeature
VC_LINEARCLONE Linear Clone vcFeature
VC_MIRROR Mirror vcFeature
VC_PLANE Plane vcFeature
VC_PYTHONFEATURE Python feature vcFeature
VC_REVOLVE Revolve vcFeature
VC_SPHERE Sphere vcFeature
VC_SWITCH Switch vcFeature
VC_TEXT Text vcFeature
VC_TRANSFORM Transform vcFeature
VC_WEDGE Wedge vcFeature

Frame Set Visualization Constants

Frame Display Mode

Name Description
VC_FRAMEDISPLAY_DOT Frames rendered as dots.
VC_FRAMEDISPLAY_COLOR_AXIS Frames rendered using individually colored axis lines.

Red
X-axis

Green
Y-axis

Blue
Z-axis

VC_FRAMEDISPLAY_AXIS Frames rendered using axis lines with the same material as the frame set.
VC_FRAMEDISPLAY_CUSTOM Frames rendered using the icon defined in CustomIcon property.

Line Display Mode

Name Description
VC_LINEDISPLAY_LINE Connecting lines rendered as a single line.
VC_LINEDISPLAY_EXTRUDE Connecting lines rendered by extruding the icon specified by CustomIcon along the lines.

Geometry Constants

Name Description
VC_COMPACTLINESET Contains line sets.
VC_FRAMESET Contains frame sets.
VC_LINESET Contains line primitives. (Deprecated) Use VC_COMPACTLINESET.

VC_POINTSET

Contains point sets.

VC_POLYGONSET Contains polygonal primitives. (Deprecated) Use VC_TRIANGLESET.
VC_TEXT2DSET Contains 2D text geometry sets.
VC_TEXT3DSET Contains 3D text geometry sets.
VC_TRIANGLESET Contains triangle sets.
VC_AMBIENT_OCCLUSION_NONE Ambient occlusion rendering is not used.
VC_AMBIENT_OCCLUSION_VERTEX Geometry uses vertex ambient occlusion values. Ambient occlusion value is located in the point texture coordinate U parameter. Ambient occlusion value is defined by a range of 0 - 1.0 in which 0 defines the point is fully occluded and 1.0 means the point is fully visible for lighting.
VC_VERTEXCOLOR Vertex color overrides the lighting calculations.
VC_VERTEXCOLOR_LIGHTED Lighting calculation is blended with the color of the vertex.

Color Formats

Name Description
VC_COLOR_CONFIGURATION_BGRA A BGRA color format.
VC_COLOR_CONFIGURATION_RGBA A RGBA color format.

 

Edge Types

Name Description
VC_EDGE_BOUNDARY The edge is shared with one polygon.
VC_EDGE_CO_PLANAR The angle between neighboring polygons is near zero.
VC_EDGE_HARD The angle between neighboring polygons is greater than the CreaseAngle of the vcPolygonSet.
VC_EDGE_INTERSECTION (Currently not implemented)
VC_EDGE_LINE (Currently not implemented)
VC_EDGE_NON_MANIFOLD The edge is shared with more than one polygon.
VC_EDGE_SOFT The angle between neighboring polygons is less than the CreaseAngle of the vcPolygonSet.

Grab Constants

Name Description
VC_GRAB_ASSEMBLY_DELETE_IF_EMPTY If the detected product is the last product inside an assembly, the product will be grabbed and the empty assembly will be deleted and the product will be grabbed but rest of the assembly is left untouched.
VC_GRAB_ASSEMBLY_KEEP If the detected product is inside an assembly, the product will be grabbed but rest of the assembly is left untouched.
VC_GRAB_ASSEMBLY_GRAB If the detected product is inside an assembly, the whole assembly will be grabbed.

Interface Constants

Name Integer Description
VC_FLOWFIELD 0 Delivers material flow between two behaviors.
VC_HIERARCHYFIELD 1 Attaches this component into the hierarchy of the other component.
VC_SIGNALFIELD 2 Delivers signals to behaviors that the signal is connected to. Allows communication between components.

VC_RSLFIELD

3

(Deprecated) Publishes/subscribes vcRslRoutine objects of RSL programs between components.

VC_JOINTEXPORTFIELD 4 Exports the joint definitions allowing connected component to drive external joints.
VC_TOOLEXPORTFIELD 5 Exports/Imports joint definitions allowing connected component to use external tools.
VC_BASEEXPORTFIELD 6 Exports/Imports base definitions allowing connected components to use external bases.
VC_INTEGERCOMPATIBILITYFIELD 7 Used for controlling what interfaces can connect to. In order to connect, the opposing interface needs to have a matching integer compatibility field definition.
VC_ACTIONFIELD 8 Used for sending and receiving actions associated with an Action Container, e.g. a robot and tool grasp and release action.
VC_TRANSPORTFIELD 9 Used for input/output of transportation tasks via a Transport Protocol, e.g. two conveyors send pickup requests and the request is outputted to a resource.
VC_PROCESSORFIELD 10 Used for parent/child connection and interaction with path and sensor behaviors contained in separate components.

Interpolation Constants

Name Description
VC_INTERPOLATION_MODE_NONE A base or tool frame has no effect on external configuration.
VC_INTERPOLATION_MODE_BASE The External TCP property is set to false (base) or true (tool).
VC_INTERPOLATION_MODE_TCP The External TCP property is set to true (base) or false (tool).

Joint Axis Constants

Name Description
VC_JOINTAXIS_MINUS_X Negative x-axis.
VC_JOINTAXIS_MINUS_Y Negative y-axis.
VC_JOINTAXIS_MINUS_Z Negative z-axis.
VC_JOINTAXIS_PLUS_X Positive x-axis.
VC_JOINTAXIS_PLUS_Y Positive y-axis.
VC_JOINTAXIS_PLUS_Z Positive z-axis.

Joint Constants

Link Types

Name Description
VC_JOINTTYPE_CUSTOM A joint defined by an expression.
VC_JOINTTYPE_FIXED A static joint, which has no DOF object.
VC_JOINTTYPE_ROTATIONAL A rotational joint.
VC_JOINTTYPE_ROTATIONAL_FOLLOWER A rotational joint that is dependent on the value of another joint.
VC_JOINTTYPE_TRANSLATIONAL A linear joint.
VC_JOINTTYPE_TRANSLATIONAL_FOLLOWER A linear joint that is dependent on the value of another joint.

Servo Types

Name Description
VC_JOINT_ROTATIONAL Defines a joint assigned to a controller as a rotational joint.
VC_JOINT_TRANSLATIONAL Defines a joint assigned to a controller as a linear joint.

Layout Item Constants

Name Type Python Class
VC_LAYOUTITEM_IT_3DICON 3D Icon vc3DIcon
VC_LAYOUTITEM_IT_ANNOTATION Annotation vcAnnotation
VC_LAYOUTITEM_IT_COLLISIONDETECTOR Collision Detector vcCollisionDetector
VC_LAYOUTITEM_IT_DIMENSION Dimension vcDimension
VC_LAYOUTITEM_IT_LAYOUTPROPERTYLIST Layout Property List/Container vcLayoutPropertyList
VC_LAYOUTITEM_IT_LAYOUTSCHEMAPROPERTYLIST Layout Schema Property List/Container vcLayoutSchemaPropertyList

VC_LAYOUTITEM_IT_LAYOUTPACKFOLDER

Pack Folder for Layout File

vcPackFolder

VC_LAYOUTITEM_IT_PATHOBJECT Path Object/Data Container vcPathObject
VC_LAYOUTITEM_IT_REPORTCHART Report/Chart vcReport
VC_LAYOUTITEM_IT_SWEPTVOLUME Swept Volume vcSweptVolume
ViewAnimation View Animator vcViewAnimation

Light Constants

Name Description
VC_LIGHT_AMBIENT Ambient type of  light.
VC_LIGHT_DIRECTIONAL Directional type of light.
VC_LIGHT_POINT Point type of light.
VC_LIGHT_SPOT Spot type of light.

Material Constants

Color Mask

Name Description
VC_MATERIAL_COLORMASK_RED Color used to render a RGB or RGBA color mask.
VC_MATERIAL_COLORMASK_GREEN Color used to render a RGB or RGBA color mask.
VC_MATERIAL_COLORMASK_BLUE Color used to render a RGB or RGBA color mask.
VC_MATERIAL_COLORMASK_ALPHA Color used to render a RGBA color mask with opacity.

Depth Comparison

Name Description
VC_MATERIAL_DEPTH_NEVER Testing never passes, so geometry pixels are not rendered.
VC_MATERIAL_DEPTH_ALWAYS Depth testing passes always, so geometry pixels are rendered.
VC_MATERIAL_DEPTH_LESS Testing passes if geometry pixel distance is less than Z buffer stored value.
VC_MATERIAL_DEPTH_LEQUAL Testing passes if geometry pixel distance is less than or equal to Z buffer stored value.
VC_MATERIAL_DEPTH_EQUAL Testing passes if geometry pixel distance is equal to Z buffer stored value.
VC_MATERIAL_DEPTH_GEQUAL Testing passes if geometry pixel distance is greater than or equal to Z buffer stored value.
VC_MATERIAL_DEPTH_GREATER Testing passes if geometry pixel distance is greater than Z buffer stored value.
VC_MATERIAL_DEPTH_NOTEQUAL Testing passes if geometry pixel distance is not equal to Z buffer stored value.

Opacity Type

Name Description
VC_MATERIAL_TRANSPARENCY_NONE Defines opacity not be used in the material.
VC_MATERIAL_TRANSPARENCY_CONSTANT Opacity is constant using an Opacity value.
VC_MATERIAL_TRANSPARENCY_MAP Opacity uses a texture alpha map to define what areas are opaque.

Alpha value of 0.5 is used as a threshold.

Render Order

Name Description
VC_MATERIAL_PRE_ORDER Renders geometry before normal rendering.
VC_MATERIAL_NORMAL_ORDER Renders geometry during normal pass.
VC_MATERIAL_POSTSORT_ORDER Renders geometry using sorted order after normal rendering.
VC_MATERIAL_POST_ORDER Renders geometry after normal pass.

Texture Mapping

Name Description
VC_MATERIAL_MAP_NORMAL Uses geometry texture coordinates U and V to map textures/project them.
VC_MATERIAL_MAP_SPHERICAL Uses spherical projection which calculates automatically texture coordinates.

Name Description
VC_MENU_DRAWING When Drawing tab is active, context menu of drawing world.
VC_MENU_FEATURE When Modeling tab is active, context menu of node feature tree in Component Graph panel.
VC_MENU_HOME When Home tab is active, context menu of 3D world.
VC_MENU_MODELING_TOOLGALLERY_FEATURE On Modeling tab, in Geometry group, Tools menu, Feature Tools section.
VC_MENU_MODELING_WIZARDS On the Modeling tab, in the Extra group, Wizards menu. This requires a string that designates an existing or new section in the Wizards menu.

VC_MENU_MODELING_WIZARDS + '/<SectionName>'

VC_MENU_PROGRAM_EXPORT_PROGRAMS On the Program tab, in the Program Modules group, Export menu. This requires a string that designates an existing or new section in the Export menu.

VC_MENU_PROGRAM_EXPORT_PROGRAMS + '/<SectionName>'

VC_MENU_PROGRAM_IMPORT_PROGRAMS On the Program tab, in the Program Modules group, Import menu. This requires a string that designates an existing or new section in the Import menu.

VC_MENU_PROGRAM_IMPORT_PROGRAMS + '/<SectionName>'

VC_MENU_PROGRAM_STATEMENT When the Program tab is active, context menu of statements in robot program displayed in Program Editor panel.

Appearance

Name Description
VC_TOOLSIZE_IMAGE_AND_TEXT_LARGE The tool image is shown as large with text.
VC_TOOLSIZE_IMAGE_AND_TEXT_NORMAL The tool image is shown as normal with text.
VC_TOOLSIZE_IMAGE_ONLY Only the tool image is shown.

You can also use the following string ids.

Context Menu

Name Description
VcAuthor3DContextMenu When Modeling tab is active, context menu of 3D world.
VcAuthorTreeViewBasesContextMenu In Component Graph panel, context menu of Bases collection for Robot Controller and Base Container behaviors.
VcAuthorTreeViewBehaviorsContextMenu In Component Graph panel, context menu of behavior.
VcAuthorTreeViewFeaturesContextMenu In Component Graph panel, context menu of feature.
VcAuthorTreeViewNodesContextMenu In Component Graph panel, context menu of node/link.
VcAuthorTreeViewPropertiesContextMenu In Component Graph panel, context menu of property in root node.
VcAuthorTreeView In Component Graph panel, context menu of Tools collection for Robot Controller and Tool Container behaviors.
VcConfigure3DContextMenu When Home tab is active, context menu of 3D world.
VcTeach3DContextMenu When Program tab is active, context menu of 3D world.

Quick Menu

Name Description
VcConfigureQuickmenu When Home tab is active, mini toolbar for a selected component.

Ribbon Group

Name Description
VcTabAuthor/<group name> On the Modeling tab, in a new or existing Ribbon group.
VcTabDrawing/<group name> On the Drawing tab, in a new or existing Ribbon group.
VcTabHome/<group name> On the Home tab, in a new or existing Ribbon group.
VcTabTeach/<group name> On the Program tab, in a new or existing Ribbon group.

Message

Buttons

Name Integer Description
VC_MESSAGE_BUTTONS_ABORTRETRYIGNORE 0 Displays Abort, Retry and Ignore buttons.
VC_MESSAGE_BUTTONS_OK 1 Displays OK button.
VC_MESSAGE_BUTTONS_OKCANCEL 2 Displays OK and Cancel buttons.
VC_MESSAGE_BUTTONS_RETRYCANCEL 3 Displays Retry and Cancel buttons.
VC_MESSAGE_BUTTONS_YESNO 4 Displays Yes and No buttons.
VC_MESSAGE_BUTTONS_YESNOCANCEL 5 Displays Yes, No and Cancel buttons.

Result

Name Integer Description
VC_MESSAGE_RESULT_ABORT 0 Returns Abort message, e.g. Abort button clicked.
VC_MESSAGE_RESULT_CANCEL 1 Returns Cancel message.
VC_MESSAGE_RESULT_IGNORE 2 Returns Ignore message.
VC_MESSAGE_RESULT_NO 3 Returns No message.
VC_MESSAGE_RESULT_OK 4 Returns OK message.
VC_MESSAGE_RESULT_RETRY 5 Returns Retry message.
VC_MESSAGE_RESULT_YES 6 Returns Yes message.

Type

Name Integer Description
VC_MESSAGE_TYPE_INFO 0 Displays Information type message.
VC_MESSAGE_TYPE_QUESTION 1 Displays Question type message.
VC_MESSAGE_TYPE_WARNING 2 Displays Warning type message.
VC_MESSAGE_TYPE_ERROR 3 Displays Error type message.
VC_MESSAGE_TYPE_CUSTOM 4 Displays Custom type message.

Motion Constants

Motion Type

Name Description
VC_MOTION_JOINT Joint type of movement executed by robot. See also Motion Target Constants.
VC_MOTION_LINEAR Linear motion executed by robot.

Orientation Interpolation Mode

Name Description
VC_MATRIXMODE_AXISX Rotates with minimal movement around X-axis.
VC_MATRIXMODE_AXISY Rotates with minimal movement around Y-axis.
VC_MATRIXMODE_AXISZ Rotates with minimal movement around Z-axis.
VC_MATRIXMODE_AXISWPR Interpolates yaw, pitch and roll angles separately for movement.
VC_MATRIXMODE_AXISZYZ Interpolates Euler angles separately for movement.
VC_MATRIXMODE_ONEAXIS Rotates around axis of shortest rotation for movement.
VC_MATRIXMODE_WRIST Rotates by directly interpolating wrist joints for movement.

Motion Path Constants

Path Axis Mode

The following constants specify how component space utilization is calculated for paths.

Name Description
VC_PATH_AXIS_AUTOMATIC The general direction of the path is determined and the most appropriate axis is selected automatically. If the axis cannot be determined to a reasonable tolerance, VC_PATH_AXIS_GENERIC is used.
VC_PATH_AXIS_X_POSITIVE The distance from the origin to the maximum X axis extent of the component bound box is used to space the component. This corresponds to the behavior of the old conveyor types.
VC_PATH_AXIS_Y_POSITIVE The distance from the origin to the maximum Y axis extent of the component bound box is used to space the component.
VC_PATH_AXIS_Z_POSITIVE The distance from the origin to the maximum Z axis extent of the component bound box is used to space the component.
VC_PATH_AXIS_X_NEGATIVE The distance from the origin to the minimum X axis extent of the component bound box is used to space the component.
VC_PATH_AXIS_Y_NEGATIVE The distance from the origin to the minimum Y axis extent of the component bound box is used to space the component.
VC_PATH_AXIS_Z_NEGATIVE The distance from the origin to the minimum Z axis extent of the component bound box is used to space the component.
VC_PATH_AXIS_GENERIC A worst-case maximum extent value is calculated from the component bound box, and used to space the component.

Path Motion State

The following constants define the motion state of a component on a path.

Name Description
VC_MOTION_STOPPED The component is stopped, either because the conveyor or the component itself has been explicitly stopped.
VC_MOTION_MOVING The component is moving on the conveyor.
VC_MOTION_BLOCKED The component has been stopped because it is being blocked by a component or conveyor in front of it.
VC_MOTION_FAILURE The component has been stopped as a result of the conveyor entering a failure state.

Motion Target Constants

Accuracy Method

Name Description
VC_MOTIONTARGET_AM_DISTANCE Defines the accuracy for a motion target based on distance, e.g. 5 mm.
VC_MOTIONTARGET_AM_TIME Defines the accuracy for a motion target based on time, e.g. a time limit for reachability. An accuracy method that utilizes time should be considered if, for example, a user sets a Cycle Time for a particular motion.
VC_MOTIONTARGET_AM_VELOCITY Defines the accuracy for a motion target based on velocity.

Configuration Mode

These constants refer to linear interpolation.

Name Description
VC_MOTIONTARGET_CM_FIXED A robot's configuration does not change (no change).
VC_MOTIONTARGET_CM_FOLLOW_FRAME A robot's configuration changes slightly to minimize joint value difference between its previous configuration (small change).
VC_MOTIONTARGET_CM_INTERPOLATE_JOINT_VALUES A robot's configuration is determined by point to point interpolation of its joint values.

Configuration Warnings

Name Description
VC_MOTIONTARGET_KW_OK Motion target can be reached.
VC_MOTIONTARGET_KW_UNREACHABLE Motion target cannot be reached.
VC_MOTIONTARGET_KW_JOINTLIMIT Motion target cannot be reached due to joint limit constraints.
VC_MOTIONTARGET_KW_SINGULAR Motion target, or the position creates a singularity, i.e. infinite solutions when one or two joints no longer represent independent controlling variables. For example, joints have a 0º value and become parallel.

Joint Turn Mode

Name Description
VC_MOTIONTARGET_TURN_NEAREST_WITHIN_LIMITS A joint's turn behavior is based on a solution nearest to the target position and within the joint's limits.
VC_MOTIONTARGET_TURN_NEAREST Similar to turning within limits, except solution is not restricted to limitations of joints.
VC_MOTIONTARGET_TURN_ZERO A joint's turn behavior is based on a solution within -180º to 180º and within the joint's limits.

Some robots can perform motions ± 360 degrees.

Motion Type

Name Description
VC_MOTIONTARGET_MT_JOINT Joint type of motion a robot controller uses to move to a target, i.e. motion is based on joint values and tolerance.
VC_MOTIONTARGET_MT_LINEAR Linear type of motion a robot controller uses to move to a target. For example, the motion itself is a straight or linear motion based on a vector from a start point to target position.

Target Mode

Name Description
VC_MOTIONTARGET_TM_NORMAL The target matrix uses a default or normal type of relationship with a robot.
VC_MOTIONTARGET_TM_ROBOTROOT The target matrix relates to a robot's root node.
VC_MOTIONTARGET_TM_STATICTOOL The target matrix relates to a robot's static tool.
VC_MOTIONTARGET_TM_EXTERNALBASE The target matrix relates to an external base in relation to a robot.
VC_MOTIONTARGET_TM_WORLDTARGET The target matrix relates to a world target in relation to a robot.

Node Constants

Material Inheritance

Name Description
VC_MATERIAL_DISABLED Never use node's material.
VC_MATERIAL_INHERIT Inherit node's material to geometries in the node and its child nodes that do not have VC_MATERIAL_FORCE set.
VC_MATERIAL_FORCE_INHERIT Inherit node's material to geometries in the node and all its child nodes.
VC_MATERIAL_INHERIT_NODE Inherit node's material to all geometries in the node that do not have VC_MATERIAL_FORCE set.
VC_MATERIAL_FORCE_INHERIT_NODE Inherit node's material to all geometries in this node.
VC_MATERIAL_INHERIT_LEVEL Inherit node's material to all geometries on the same level that do not VC_MATERIAL_FORCE set. If node is world root then all the nodes in the world will be affected. If node is a component then all the nodes inside the component will be affected. Otherwise, only the node itself will be affected.
VC_MATERIAL_FORCE_INHERIT_LEVEL Inherit node's material to all geometries on the same level. If node is world root then all the nodes in the world will be affected. If node is a component then all the nodes inside the component will be affected. Otherwise, only the node itself will be affected.

Type

Name Description
VC_WORLD Node is world root.
VC_COMPONENT Node is vcComponent.
VC_NODE Node is vcNode. Node can never exist without a component.

Path Object Constants

Name Type Python Class
VC_PATHOBJECT_NT_ANY Node (Deprecated) Any type of node called with this constant.
VC_PATHOBJECT_NT_ACTION Action (Deprecated) Path Object type to vcPathObjectActionNode
VC_PATHOBJECT_NT_MOTION Motion (Deprecated) Path Object type to vcPathObjectMotionNode
VC_PATHOBJECT_NT_PARAMETER Parameter (Deprecated) Path Object type to vcPathObjectParameterNode
VC_PATHOBJECT_NT_REFERENCE Reference (Deprecated) Path Object type to vcPathObjectReferenceNode

Product Matcher Constants

Match States

Name Description
VC_MATCH_STATE_CREATED This is the initial state where the match has been created.
VC_MATCH_STATE_CANCELLED The match has been cancelled before it was finalized.
VC_MATCH_STATE_FINALIZED The match has been committed to, and the product can be sent to the next process.
VC_MATCH_STATE_DISPOSED The match has been finished or cancelled. The matched vcProductNeed and vcProductFeed are released, so that they van be re-used and matched again.

Match Types

Name Description
VC_MATCH_MODE_INDEPENDENT The match is independent of process requirements.
VC_MATCH_MODE_PROCESS_SOLVER The match needs to meet particular process requirements.

Process Modeling Constants

Boolean Comparison Operator

Name Description
VC_COMPARISONOPERATION_EQUAL Equal operation within property filter
VC_COMPARISONOPERATION_NOTEQUAL Not equal operation
VC_COMPARISONOPERATION_LESSTHAN Less than operation
VC_COMPARISONOPERATION_LESSOREQUAL Less or equal operation
VC_COMPARISONOPERATION_GREATERTHAN Greater than operation
VC_COMPARISONOPERATION_GREATEROREQUAL Greater or equal operation

BufferMode Enumeration

Name Description

VC_BUFFERMODE_FIFO

First-In, First-Out order, like a queue.
VC_BUFFERMODE_LIFO Last-In, First-Out order, like a stack.

CombinationBooleanOperation enumeration

Name Description
VC_FILTEROPERATION_AND And operation within combination filter
VC_FILTEROPERATION_OR Or operation within combination filter

CompareMode enumeration

Name Description
VC_COMPAREMODE_COMPARETOANY Compare to any product within a list
VC_COMPAREMODE_COMPAREINORDER Compare one product after another in the list

FilterDiagnosticsMode enumeration

Name Description
VC_FILTERDIAGNOSTICMODE_GLOBAL As global configuration specifies
VC_FILTERDIAGNOSTICMODE_DISABLED Disable additional diagnostic messages
VC_FILTERDIAGNOSTICMODE_ENABLED Enable additional diagnostic messages

Flow Step Process Mode

Name Description
VC_PROCESSMODE_ALLINANYORDER All process groups must be visited, before moving to next step.
VC_PROCESSMODE_FIRSTMATCH Only one of process groups must be visited, before moving to next step.

NodeVisibilityState Enumeration

Name Description

VC_NODEVISIBILITYSTATE_TOGGLE

Toggle between visible and invisible.
VC_NODEVISIBILITYSTATE_VISIBLE Make the node visible.
VC_NODEVISIBILITYSTATE_INVISIBLE Make the node invisible.

ObservableList

Name Description
VC_LIST_ADD Adds an element to the list
VC_LIST_REMOVE Removes an element from the list
VC_LIST_REPLACE Replaces an element from the list
VC_LIST_RESET Resets the list

ProductFilterType enumeration

Name Description
VC_FILTER_ACCEPTALL Accept all filter
VC_FILTER_COMBINATION Combination filter
VC_FILTER_PRODUCTPROPERTY Product property filter
VC_FILTER_PRODUCTTYPE Product type filter
VC_FILTER_CONFIGURABLEPRODUCTTYPE Configurable product filter
VC_FILTER_SPECIFICPRODUCT Specific product filter
VC_FILTER_EXPRESSION Expression filter
VC_FILTER_ACCEPTALL Accept all filter

StatisticsFlowDirection Enumeration

Name Description

VC_STATISTICSFLOWDIRECTION_ENTER

Product enters.
VC_STATISTICSFLOWDIRECTION_LEAVE Product leaves.

TargetProcessMode enumeration

Defines the selection of processes that will be affected by vcSetProductVisitStateStatement.

Name Description
VC_TARGETPROCESSMODE_ALLPROCESSES The statement will affect all previously visited process groups.
VC_TARGETPROCESSMODE_SPECIFICPROCESSES The statement will affect all selected processes from Processes property.
VC_TARGETPROCESSMODE_CURRENTPROCESS The statement will affect the process group the product instance is currently in.

TimeSource Enumeration

Name Value Description

VC_TIMESOURCE_DISTRIBUTION

0 Sample from a distribution.
VC_TIMESOURCE_EXPRESSION 1 Evaluate an expression.

TransportInType

Name Description
VC_TRANSPORTINTYPE_PREVIOUSPROCESS Reserve a product instance and use the transport system to transport it.
VC_TRANSPORTINTYPE_CONTAINER Wait for a matching product to arrive to a component container.

TransportOutType Enumeration

Name Description

VC_TRANSPORTOUTTYPE_NEXTPROCESS

Send the product to the next process by using the transport system.
VC_TRANSPORTOUTTYPE_CONTAINER Place the product to a component container.
VC_TRANSPORTOUTTYPE_TRANSPORTNODE Send the product to a transport node using the transport system.

ValueMode enumeration

Defines how the result of vcSetProductVisitStateStatement.VisitCount will be applied.

Name Description
VC_VALUEMODE_ABSOLUTE The value is set as the current visit count.
VC_VALUEMODE_RELATIVE The value is added to the current visit count.

Process Point Constants

Name Description
VC_PROCESSPOINT_OWNER Owner component of the behavior used.
VC_PROCESSPOINT_PROCESSED Component being processed is used.
VC_PROCESSPOINT_STOP_PATH Processing stops all components in the path.
VC_PROCESSPOINT_STOP_COMPONENT Processing stops only processed component at path.

Property Constants

Constraints

Name Description
VC_PROPERTY_DEFAULT No constraints used.
VC_PROPERTY_LIMIT Property will have upper and lower limits.
VC_PROPERTY_STEP Property will have defined steps.

Types

Name Description Works with vcCommand Works with vcComponent
List<Ref<Behaviour>> A vcBehaviour reference list property. Yes Yes
List<Ref<Component>> A vcComponent reference list property. Yes Yes
List<Ref<ComponentGroup> A reference list property to multiple sets of grouped components in the 3D world. Yes No
List<Ref<Feature>> A vcFeature reference list property. No Yes
List<Ref<Node>> A vcNode reference list property. Yes Yes
List<Ref<Parameter>> A vcProperty reference list property. Yes Yes
  List<Ref<ProcessFlowGroup>>   A vcProcessFlowGroup reference list property.
  List<Ref<Product>>   A vcProduct reference list property.
  List<Ref<ProductType>>   A vcProductType reference list property.
  List<Ref<TransportNode>>   A vcTransportNode reference list property.
  List<Ref<TransportLink>>   A vcTransportLink reference list property.
Ref<BaseFrame> A vcBaseFrame reference property. Yes No
Ref<Behaviour> A vcBehaviour reference property. Yes Yes
Ref<Component> A vcComponent reference property. Yes Yes
Ref<ComponentGroup> A reference property to a set of grouped components in the 3D world. Yes No
Ref<Feature> A vcFeature reference property. No Yes
Ref<Material> A vcMaterial reference property. Yes Yes
Ref<Node> A vcNode reference property. Yes Yes
Ref<Parameter> A vcProperty reference property. Yes Yes
  Ref<Product>   A vcProduct reference property.
  Ref<ProductType>   A vcProductType reference property.
  Ref<TransportNode>   A vcTransportNode reference property.
  Ref<TransportLink>   A vcTransportLink reference property.
Ref<ToolFrame> A vcToolContainer reference property. Yes No
VC_BOOLEAN A boolean property. Yes Yes
VC_DISTRIBUTION A real distribution property. Yes Yes
VC_INTEGER An integer property. Yes Yes
VC_REAL A real property. Yes Yes
VC_STRING A string property. Yes Yes
VC_VECTOR A vector property. Yes Yes
VC_MATRIX A matrix property. Yes Yes
VC_EXPRESSION An expression property. Yes Yes
VC_URI An Uri property. Yes Yes
VC_BUTTON A button property. Yes Yes

Quantity Constants

Name Description
VC_QUANTITY_SCALAR Creates a scalar quantity.
VC_QUANTITY_VECTOR Create a vector quantity.

RCS Constants

Name Description
VC_RCS_KUKA RCS DLL for KUKA robots.

Recording Constants

Name Description
VC_RECORDER_PDF Records a PDF file for a simulation.
VC_RECORDER_VIDEO Records a video file for a simulation.

Routing Constants

Name Description
VC_ROUTING_OWNER Owner component of the behavior is used for rule processing.
VC_ROUTING_PROCESSED Component being routed is used for rule processing.

Signal Map Constants

Name Description
VC_SIGNALMAP_DIRECTION_UNDEFINED Sets the signal map direction to Undefined.
VC_SIGNALMAP_DIRECTION_INPUT Sets the signal map direction to Input.
VC_SIGNALMAP_DIRECTION_OUTPUT Sets the signal map direction to Output.

Selection Constants

Name Type Python Class
VC_SELECTION_ANNOTATION Annotation Selection type to vcAnnotation
VC_SELECTION_COMPONENT Component Selection type to vcComponent
VC_SELECTION_DIMENSION Dimension Selection type to vcDimension
VC_SELECTION_FEATURE Feature Selection type to vcFeature
VC_SELECTION_GEOMETRYSET Geometry Set Selection type to vcGeometrySet
VC_SELECTION_NODE Node Selection type to vcNode
VC_SELECTION_PARENTNODE Node Selection type to vcNode
VC_SELECTION_ROBOTBASE Base Selection type to vcBaseFrame
VC_SELECTION_ROBOTTOOL Tool Selection type to vcBaseFrame
VC_SELECTION_STATEMENT Robot Statement Selection type to vcStatement

Solution Constants

Name Integer Description
VC_SOLUTION_REACHABLE 0 Indicates solution target is reachable.
VC_SOLUTION_UNREACHABLE 1 Indicates solution target is unreachable.
VC_SOLUTION_JOINT_LIMIT 2 Indicates joint values for solution exceed limits.
VC_SOLUTION_SINGULARITY 4 Indicates solution causes joint singularity.
VC_SOLUTION_NOT_CALCULATED 8 Indicates joint values have not been calculated for solution.

Statement Constants

Statements constants are used for adding new statements in vcScope.

Common statements

Name Description
VC_STATEMENT_BREAK Ends the execution of a loop statement.
VC_STATEMENT_COMMENT Creates a user defined message.
VC_STATEMENT_CONTINUE Jumps to the next iteration in a loop statement.
VC_STATEMENT_HALT Halts a simulation until a user defined event triggers the continuation of the simulation.
VC_STATEMENT_SETPROPERTY (Assign statement). Defines the value of a property either in the same routine, program, component or robot executor.

Process statements

Name Description
VC_STATEMENT_APPENDTOLIST Joins content of source variable to end of the target variable.
VC_STATEMENT_ATTACHPRODUCT

Attaches one product to another.

VC_STATEMENT_BUFFERPRODUCTS

Buffer statement creates a temporary storage for products in a grid pattern. Multiple products can be coming in and leaving the buffer in parallel.

VC_STATEMENT_CHANGEPRODUCTTYPE

Change Type statement changes one or more product instances to be of another product type both logically and visually.

VC_STATEMENT_CREATEPRODUCT

Create product statement waits for free capacity at the target Container and then creates a new product instance.

VC_STATEMENT_FINDFLOWSTEP

Finds next or previous process flow steps relative to an existing flow step.

VC_STATEMENT_DETACHPRODUCT

Detach statement detaches one or more components of one or more products from the component of a common parent product.

VC_STATEMENT_GETPROPERTY

Get Property statement creates a runtime variable that acts as a proxy to a property. The proxy variable’s value and the targeted property’s value are tied together such that changing one means changing the other as well. The targeted property can be a static component’s property or a static component’s behavior’s property.

VC_STATEMENT_GETFLOWSTEP

A GetFlowStatement gets information about a step in a process sequence to a ProcessFlowInfo process variable.

VC_STATEMENT_MOVEJOINT

Move Joint statement uses a servo controller behavior to move a joint to given value and waits until the motion completes.

VC_STATEMENT_PRINT A Print statement allows you to print feedback in the Output panel.
VC_STATEMENT_PROCESSDELAY Delay statement waits for a specified amount of simulation time.
VC_STATEMENT_PROCESSIF Creates a conditional statement for executing a collection of statements if a given expression evaluates as True.
VC_STATEMENT_PROCESSWHILE While statement executes Scope in a loop as long as Condition evaluates to True.
VC_STATEMENT_PROPERTYCONDITION

Creates a process requirement based on a property value. The targeted property can be a static component’s property or a static component’s behavior’s  property.

Note: This is a requirement statement and thus can be only added to the Requirements routine of a process routine.

VC_STATEMENT_RELEASEPRODUCTRESERVATION

Release Product Reservation statement releases reserved product instances which are reserved by ReserveProduct one or more statements. Reservation cannot be released after a product’s transport has started.

VC_STATEMENT_REMOVEPRODUCT Remove statement deletes one or more product instances and resets value of the variable.
VC_STATEMENT_RESERVEPRODUCT

Reserve Product statement creates a process requirement for a matching product to be available and reserves it for this process.

Note: This is a requirement statement and thus can be only added to the Requirements routine of a process routine.

VC_STATEMENT_RUNROBOTROUTINE

Waits until the robot is idle, then evaluates the given RoutineName expression and tries to find the routine, then start the routine, and waits until the routine has been executed to completion.

VC_STATEMENT_SELECTPRODUCTS

Copies product instance references from one list to another variable. Product type filtering can be applied to only copy some product references.

VC_STATEMENT_SENDSIGNAL

Send Signal statement sends a simulation signal, i.e. triggers a vcSignal behavior, with a given value.

VC_STATEMENT_SETNEXTFLOWSTEP Overwrites the next process information in product instances, enabling jumps and loops.
VC_STATEMENT_SETNODEMATERIAL

Set Node Material statement changes the material of a node in one or more product instances’ components.

VC_STATEMENT_SETNODEVISIBILITY Changes the visibility of a node in one or more product instances’ components.
VC_STATEMENT_SETPRODUCTVISITSTATE A process statement that assigns (and resets) the state of how many times a product instance has visited some process.
VC_STATEMENT_SETSTATISTICSFLOW

Flow statement updates statistics behavior and it records one or more products’ components transferring in or out. If more than one product is given as input, they are all recorded at once.

VC_STATEMENT_SETSTATISTICSSTATE Sets the current state of a statistics behavior.
VC_STATEMENT_STARTTRANSPORTIN

Start Transport In statement transports one or more products into the process. More than one pre-reserved product can be transported in, otherwise transports only a single product.

The statement execution is asynchronous, meaning that next statements may execute before the transport is finished. Must be used in combination with the Wait Transport statement.

VC_STATEMENT_STARTTRANSPORTOUT

Transports one or more products out from the process in parallel. The statement execution is asynchronous, meaning that next statements may execute before the transport is finished. Must be used in combination with the Wait Transport statement.

VC_STATEMENT_SWITCHCASE

Switch Case statement executes the first vcCaseScope for which the value of its CaseCondition property matches that of statement’s Condition property.

VC_STATEMENT_TRANSPORTIN

Transport In statement sequentially transports one or more products into the process and waits until they have arrived. More than one pre-reserved product can be transported in, otherwise transports only a single product.

VC_STATEMENT_TRANSPORTOUT Defines a transport node where to send the products using the transport system.
VC_STATEMENT_TRANSPORTPATTERNIN

Sequentially transports products into a regular grid pattern and waits until they have arrived.

VC_STATEMENT_WAITPROPERTYCONDITION

Waits for a variable’s value to pass a specified condition.

VC_STATEMENT_WAITSIGNAL

Wait Signal statement waits for signal to be triggered with a value that matches a given condition or until an optional timeout is reached.

VC_STATEMENT_WAITTRANSPORT

Wait Transport statement waits for one or more transport operations started with StartTransportIn or StartTransportOut statements to complete.

VC_STATEMENT_WORK

Sends a work request to a transport controller and waits until the work is complete.

Robot statements

Name Description
VC_STATEMENT_BREAK Creates a break statement which is used to terminate the loop immediately when it is encountered.
VC_STATEMENT_CALL Calls a subroutine sequence/program.
VC_STATEMENT_CUSTOM Creates a template for executing a user-defined statement.
VC_STATEMENT_COMMENT Creates a comment statement.
VC_STATEMENT_CONTINUE Creates a continue statement which is used to skip the current iteration of the loop and move to the next iteration.
VC_STATEMENT_DELAY Creates a user defined delay measured in seconds.
VC_STATEMENT_GRASP

(Deprecated) Creates a Grasp action for a robot's tool.

VC_STATEMENT_HALT

Creates a halt statement which is used to stop the simulation.

VC_STATEMENT_HOME

(Deprecated) Returns to default robot state pre-simulation.

VC_STATEMENT_IF Creates a conditional statement for executing a collection of statements if a given expression evaluates as True.
VC_STATEMENT_LINMOTION Creates a linear motion for a robot to a position; similar to VC_MOTION_LINEAR.
VC_STATEMENT_PATH Creates a statement for executing a path of positions.
VC_STATEMENT_PRINT Prints feedback to the Output panel.
VC_STATEMENT_PROCESS Creates a position statement of type vcPositionStatement that is implemented as a process statement.
VC_STATEMENT_PTPMOTION Creates a point to point motion using a robot's joints; similar to VC_MOTION_JOINT.
VC_STATEMENT_RELEASE

(Deprecated) Creates a Release action for a robot's tool.

VC_STATEMENT_REMOTECALL

(Deprecated) Triggers a remote robotic action via a subscriber to a publisher, i.e. parent robot triggers child sequence/program.

VC_STATEMENT_REMOTEWAIT

(Deprecated) Defines if a robot waits for remote action to finish or to receive IO in a parent-child relationship.

VC_STATEMENT_RETURN Ends the execution of a called subroutine and returns to caller of that routine.
VC_STATEMENT_SETBIN Creates an output signal map (bool), e.g. pick up and retain a box with a robot's tool.
VC_STATEMENT_SETPROPERTY  
VC_STATEMENT_SETROBOTSTATISTICSSTATE Creates a statement that sets a statistics state for the robot.
VC_STATEMENT_SWITCHCASE Creates a statement which executes a specific case based on a condition.
VC_STATEMENT_WAITBIN Creates an input signal map (bool), e.g. a robot waits to receive a signal from another component before executing other statements.
VC_STATEMENT_WHILE Creates a conditional statement for executing a collection of statements in a loop while a given expression evaluates as True.
VC_STATEMENT_DEFINE_BASE Defines a base location for RSL programming.
VC_STATEMENT_DEFINE_TOOL Defines a tool location for RSL programming.
VC_STATEMENT_PROG_SYNC Creates a method for synchronizing robotic motions with two or more robots.

Notes:

  • Statements marked as deprecated are not supported by new robot executor.

Statistics Constants

Chart Types

Name Description
VC_CHARTTYPE_NONE Empty chart.
VC_CHARTTYPE_LINE Line chart.
VC_CHARTTYPE_COLUMN Column chart.
VC_CHARTTYPE_BAR Bar chart.
VC_CHARTTYPE_AREA Area chart.
VC_CHARTTYPE_PIE Pie chart.

Chart Tile Type

Name Description
VC_TILETYPE_DUMMY Location is used for grid layout purposes only.
VC_TILETYPE_PLACEHOLDER Location is empty.
VC_TILETYPE_ACTUALTILE Location is not empty.

Data Types

Constants for defining the data type of statistics chart.

Name Description
VC_DATATYPE_ONESAMPLEDVALUE Used for interval-based statistics. For example, discrete values reported for a recorded interval.
VC_DATATYPE_MINMAXAVERAGEVALUES Used for cumulative statistics. For example, values that accumulate over time.

States

Constants for defining the state of Statistics behavior.

Name Integer Description
VC_STATISTICS_WARMUP 1 Reports when a component is in a warm up state.
VC_STATISTICS_BREAK 2 Reports when a component is in a break state.
VC_STATISTICS_IDLE 3 Reports when a component is in an idle state.
VC_STATISTICS_BUSY 4 Reports when a component is in a busy state.
VC_STATISTICS_BLOCKED 5 Reports when a component is in a blocked state.
VC_STATISTICS_BROKEN 6 Reports when a component is in a broken state.
VC_STATISTICS_REPAIR 7 Reports when a component is in a repair state.
VC_STATISTICS_SETUP 8 Reports when a component is in a setup state.

Swept Volume Constants

Decomposition Modes

Name Integer Description
VC_CONVEXHULL 0 One convex hull with no decomposition.
VC_DECOMPOSITION 1 Convex decomposition with one or more convex hulls.
VC_CONVEXHULL_TRIMESH 2 One convex hull for each triangle mesh

Swept Generation

Name Integer Description
VC_SWEPT_LOFTING 0 Uses lofting to generate swept geometry.
VC_SWEPT_HULL_FROM_HULLS 1 Uses hull from hulls method to generate geometry.
VC_SWEPT_HULL_FROM_SILHOUETTES 2 Uses hull from silhouettes method to generate geometry.

Topology Constants

Name Description
VC_CURVE_TESSELLATED A tessellated line or polyline.
VC_CURVE_POLYLINE A polyline curve (spline of degree 1).
VC_CURVE_SPLINE A spline curve.
VC_FACE_TESSELATED A tessellated face without mathematical representation.
VC_FACE_PLANAR A mathematical planar face.
VC_FACE_NURBS A mathematical NURBS face.
VC_FACEDISPLAY_OUTER_CURVELOOP Display only surface outer curved loop.
VC_FACEDISPLAY_INNER_CURVELOOPS Display only inner curved loop(s).
VC_FACEDISPLAY_ALL_CURVELOOPS Display all surface curved loops.
VC_FACEDISPLAY_FACE Display shaded surface.

Unit Constants

Name Description
VC_QUANTITY_SCALAR Quantity type in which a magnitude or numerical value is given.
VC_QUANTITY_VECTOR Quantity type in which both a magnitude or numerical value and direction are given.