ICAM Virtual Machine V19 - Kxcad.net

ICAM Virtual Machine ® Virtual Machine Reference, Model Customization
Simulation Macro Variables, Virtual Machine Variables
$VMPRCOD Probe cycle return code
Type: Numeric, Read/Write
When probing is active (set using the $FMSPROB function) the $VMPRCOD variable will be
updated at the end of each model motion to indicate the status of the probe device (set using the
$FMSPRID function). The following states are defined:
–1 The probe device was already in a triggered state (i.e., already colliding) at the start of
the motion. No probing data has been returned.
0 The probe device was not triggered (i.e., did not collide) during the last motion. No
probing data has been returned.
1 The probe device was triggered (i.e., collided) during the last motion. $VMXFER
contains collision status information.
2 Same as #1 except that the probe device was triggered against 2 or more objects
simultaneously.
$VMXFER Collision/over-travel return code
Type: Numeric, Read/Write
This variable contains collision and over-travel event information resulting from the last model
motion, including collision information resulting from a probe trigger event. $VMXFER is a
sequence of length 7 as follows:
1 The number of separate collision and/or over-travel events that occurred on the last
motion. Zero if there were no collisions or over-travel events.
2 The time at the start of the motion.
3 The time at the end of the motion.
4 The time at which the first collision or over-travel event occurred during the current
motion. If $VMXFER(1)=0, then $VMXFER(4)=$VMXFER(3).
5 The current feed rate in model units per minute or units per revolution. Zero if the motion
was at rapid.
6 The collision event number of a probe trigger, otherwise -1.
7 The collision pair number of a probe trigger, otherwise -1.
When probing is active (set using the $FMSPROB function), and the probe was triggered (i.e.,
$VMPRCOD>0), then information about the object that was touched by the probe can be obtained
by calling:
$FMSPDAT($VMXFER(6),$VMXFER(7))
208 ICAM Technologies Corporation – Proprietary