Y-directions
Several types of items require a Y-direction (indicating a direction governing the properties of the item). In , Y-directions are represented using the opaque handle ProMechYDirection. The functions described in this section provide access to the y-direction handle.
Functions Introduced:
The function
ProMechydirectionAlloc() allocates memory for the y-direction handle.
The function
ProMechydirectionTypeGet() returns the type of the y-direction. Pass the y-direction handle as the input to this function. The output value
type can have the following values:
• PRO_MECH_YDIR_VECTOR—Specifies a direction vector.
• PRO_MECH_YDIR_REF—Specifies a referenced coordinate system.
• PRO_MECH_YDIR_CSYS—Specifies a world coordinate system.
The function
ProMechydirectionCsysGet() returns the coordinate system if the specified y-direction handle is of type
PRO_MECH_YDIR_CSYS.
The function
ProMechydirectionCsysSet() sets the coordinate system for the specified y-direction handle. Calling this function changes the Y-direction type to the appropriate type and discards any data related to its previous type.
The function
ProMechydirectionReferenceGet() returns the reference entity if the specified y-direction handle is of type
PRO_MECH_YDIR_REF.
The function
ProMechydirectionReferenceSet() sets the reference entity for the specified y-direction handle. Calling this function changes the Y-direction type to the appropriate type and discards any data related to its previous type.
The function
ProMechydirectionVectorGet() returns the vector direction if the specified y-direction handle is of type
PRO_MECH_YDIR_VECTOR.
The function
ProMechydirectionVectorSet() sets the vector for the specified y-direction handle. Calling this function changes the Y-direction type to the appropriate type and discards any data related to its previous type.
Use the function
ProMechydirectionFree() to free the y-direction handle.