Download EnSight Interface Manual

Transcript
2.4 USERD_rigidbody_values
/*--------------------------------------------------------------------
USERD_rigidbody_values
*
(Version 2.05 and later)
*
(Modified at 2.08 as described below)
*-------------------------------------------------------------------*
* Gets the rigid body values for each part
*
* (IN) part_number
= The part number
*
*
(1-based index of part table, namely:
*
*
1 ... Numparts_available.
*
*
It is NOT the part_id that is
*
loaded in USERD_get_gold_part_build_info)
*
* (OUT) values
values[0] = IX
(x location)
*
values[1] = IY
(y location)
*
values[2] = IZ
(z location)
*
values[3] = E0
(e0 euler value)
*
values[4] = E1
(e1 euler value)
*
values[5] = E2
(e2 euler value)
*
values[6] = E3
(e3 euler value)
*
*
The next 3 are for an optional cg offset. If none
*
is needed or desired (namely the first 7 values
*
above contain all that is needed), then these
*
should be set to 0.0
*
*
values[7] = xoff
(initial cg x offset)
*
values[8] = yoff
(initial cg y offset)
*
values[9] = z0ff
(initial cg z offset)
*
* Starting at Version 2.08
* ========================
*
The next 4 values are for and optional initial yaw,
*
pitch, roll operation. This is useful to get parts
*
from one standard layout to a different standard
*
layout.
*
(example, flex body parts computed in an axis system
*
different than that of rigid body parts manipulation)
*
If not needed or desired, set these to 0.0
*
*
values[10] = rot_order (order the roations are applied
*
0.0 = no rotations
*
1.0 = xyz order
*
2.0 = xzy order
*
3.0 = yxz order
*
4.0 = yzx order
*
5.0 = zxy order
*
6.0 = zyx order)
*
values[11] = xrot
(initial x rotation - degrees)
*
values[12] = yrot
(initial y rotation - degrees)
*
values[13] = zrot
(initial z rotation - degrees)
*
* returns: Z_OK
if rigid body values sent for this part
*
Z_UNDEF if no rigid body values exist for this part
*
Z_ERR
if an error
*
*
2-146
EnSight Interface Manual