Material Orientations
The functions described in this section specify material orientation for surfaces, volumes, shells, solids, 2D solids, and 2D plates. These functions provide read and write access to the data and contents of Creo Simulate material orientation objects. Material orientations use the ProType field in the ProMechitem structure as PRO_SIMULATION_MATL_ORIENT.
Functions Introduced:
The function
ProMechMaterialorientDataGet() provides access to the data structure containing the properties of the material orientation item. Use the function
ProMechmaterialorientDataSet() to set the data structure containing the properties of the material orientation item.
The function
ProMechmaterialorientDescriptionGet() returns the description of the material orientation. Use the function
ProMechmaterialorientDescriptionSet() to set the description of the material orientation.
The function
ProMechmaterialorientdataObjecttypeGet() returns the type of object to which the material orientation is applied. The types of object are:
• PRO_MECH_MATLORI_MODEL—Specifies a model.
• PRO_MECH_MATLORI_SURFACE—Specifies a surface.
Use the function
ProMechmaterialorientdataObjecttypeSet() to set the type of object.
The function ProMechmaterialorientReferencesGet() returns the geometric references specified for the material orientation object.
The function
ProMechmaterialorientdataCsysdataGet() returns a handle to the data structure containing the coordinate system data for the material orientation. Use the function
ProMechmaterialorientdataCsysdataSet() to set the coordinate system data for the material orientation.
The function
ProMechmaterialorientdataTypeGet() returns the type of the material direction. The types are as follows:
• PRO_MECH_MATLORI_COORD_SYSTEM—Specifies that the material orientation direction is determined by the reference coordinate system.
• PRO_MECH_MATLORI_1_DIR—Specifies that the material orientation direction is determined by the first parametric direction of the material. Use the function
ProMechmaterialorientdataFirstdirectionSet() to set the first direction of the material as the orientation type.
• PRO_MECH_MATLORI_2_DIR—Specifies that the material orientation direction is determined by the second parametric direction of the material. Use the function
ProMechmaterialorientdataSeconddirectionSet() to set the second direction of the material as the orientation type.
• PRO_MECH_MATLORI_PROJ_VECTOR—Specifies that the material orientation direction is determined by the projection vector.
The function
ProMechmaterialorientdataProjectiondataGet() returns the structure containing the projection data for the material orientation. Use the function
ProMechmaterialorientdataProjectiondataSet() to set the projection data for the material orientation.
The function
ProMechmaterialorientdataRotationGet() returns additional rotations about one or more material directions only if the material orientation type is
PRO_MECH_MATLORI_MODEL. Use the function
ProMechmaterialorientdataRotationSet() to set the additional rotations about one or more material directions only if the material orientation type is
PRO_MECH_MATLORI_MODEL.
The function
ProMechmaterialorientdataSurfacerotationGet() returns the rotation angle for the material orientation if the orientation type is
PRO_MECH_MATLORI_SURFACE.
Use the function
ProMechmaterialorientdataSurfacerotationSet() to set the rotation angle for the material orientation if the orientation type is
PRO_MECH_MATLORI_SURFACE.
Use the function
ProMechmaterialorientdataSurfacerotationUnset() removes the rotation angle for the material orientation if the orientation type is
PRO_MECH_MATLORI_SURFACE.
The function
ProMechmaterialorientprojTypeGet() returns the type of projection assigned to the material orientation. The types of materials are:
The function
ProMechmaterialorientcsysCsysGet() returns the coordinate system used to specify the material directions. Use the function
ProMechmaterialorientcsysCsysSet() to set the coordinate system for the material directions.
The function
ProMechmaterialorientcsysProjectiontypeGet() returns the projection vector for the material orientation object. The valid projection types are as follows:
• PRO_MECH_MATLORI_CSYS_PROJ_CLOSEST—Specifies the material Direction 1 through a series of calculations.
• PRO_MECH_MATLORI_CSYS_PROJ_X—Specifies that the material direction 1 is along the direction of the X axis of the referenced coordinate system projected onto the surface.
Use the function
ProMechmaterialorientcsysProjectiontypeSet() to set the projection type for the material orientation data.
The function
ProMechmaterialorientcsysXaxisGet() returns the material direction to which the x-axis of the coordinate system is mapped. Use the function
ProMechmaterialorientcsysXaxisSet() to set the material direction to which the x-axis of the coordinate system is mapped.
The function
ProMechmaterialorientcsysYaxisGet() returns the material direction to which the y-axis of the coordinate system is mapped. Use the function
ProMechmaterialorientcsysYaxisSet() to set the material direction to which the y-axis of the coordinate system is mapped.
The function
ProMechmaterialorientcsysZaxisGet() returns the material direction to which the z-axis of the coordinate system is mapped. Use the function
ProMechmaterialorientcsysZaxisSet() to set the material direction to which the z-axis of the coordinate system is mapped.
Example 4: Creating Material Orientations Referencing a Selected Coordinate System
The sample code in the file PTMechExMatOrient.c located at <creo_toolkit_loadpoint>/protk_appls/pt_mech_examples/pt_mech_ex_src shows how to create a new material orientation item in the current model, referencing a selected coordinate system.