"LW Bone Info"

Availability:  LightWave 6.0
Component:  Layout

The bone info global returns functions for getting bone-specific information about any of the bones in a scene. Use the item info global to get the bone list and for generic item information. The information returned by these functions is read-only.

Global Call

   LWBoneInfo *boneinfo;
   boneinfo = global( "LW Bone Info", GFUSE_TRANSIENT );

The global function returns a pointer to an LWBoneInfo.

   typedef struct st_LWBoneInfo {
      unsigned int (*flags)      (LWItemID);
      void         (*restParam)  (LWItemID, LWItemParam, LWDVector vector);
      double       (*restLength) (LWItemID);
      void         (*limits)     (LWItemID, double *inner, double *outer);
   } LWBoneInfo;

boneflags = flags( bone )

Returns a set of flag bits for the bone. The flag symbols are

LWBONEF_ACTIVE

The bone is active.

LWBONEF_LIMITEDRANGE

Limited range is turned on for the bone.

LWBONEF_SCALE_STRENGTH

Scale strength.

LWBONEF_WEIGHT_NORM

Weight norm.

restParam( bone, param, vector )

Gets vector parameters for the rest position of a given bone. Parameters of the animated bone can be read from the normal item info functions. See the item info parameter list for the values that can be passed in the param argument.

length = restLength( bone )

Returns the rest length of the bone.

limits( bone, inner_limit, outer_limit )

For limited range bones, this gets the inner and outer limit radii for the bone.