TriggeredForces Result

Description
Returns force and torque for a force guide object when force-related end conditions are achieved.

Usage
FGGet Sequence.Object.TriggeredForces, rArray()

• Sequence
  Force guide sequence name
• Object
  Force guide object name
• rArray
  Real array variable with six or more elements showing returned values

Values
rArray()

Element number	Element number constant	Description
0	FG_FX	Acquires force in Fx direction when force-related end conditions are achieved.
1	FG_FY	Acquires force in Fy direction when force-related end conditions are achieved.
2	FG_FZ	Acquires force in Fz direction when force-related end conditions are achieved.
3	FG_TX	Acquires torque in Tx direction when force-related end conditions are achieved.
4	FG_TY	Acquires torque in Ty direction when force-related end conditions are achieved.
5	FG_TZ	Acquires torque in Tz direction when force-related end conditions are achieved.

Detailed Explanation
Returns force and torque for a force guide object when force-related end conditions are achieved.
Returns “0” for all values when force-related end conditions are not achieved or end conditions are invalid.
If the number of elements in a specified array variable is less than six, returns force and torque in each direction for the defined element numbers. Also, if the number of elements in the array variable exceeds six, returns force and torque in each direction from element number 0 to 5, while making no change to element number 6 and above.

Usage Example
The following is an example of a simple program that acquires a result with FGGet.

Function TriggeredForcesTest
  Double dArray(6)

  Motor On

  FGRun Sequence1
  FGGet Sequence1.Contact01.TriggeredForces, dArray()
    ' Acquisition of TriggeredForces
  Print dArray(FG_FX)

Fend

See Also
FGGet, Contact object, Relax object, SurfaceAlign object, PressProbe object, ContactProbe object, Press object, PressMove object, Paste object, ScrewTighten object, HeightInspect object, Insert object, TensileTest object