|
SEDRIS Reference Manual
APPENDIX A - Transmittal Access Level 0 API Functions SE PutMeshFaceTableData |
|---|
| extern SE_Return_Code | ||||
| SE_PutMeshFaceTableData | ||||
| ( | ||||
| SE_Object | mesh_face_table_object, | 1 | ||
| SE_Boolean | put_adjacent_face_table_data, | 2 | ||
| SE_Integer_Positive | start_face, | |||
| SE_Integer_Positive | number_faces, | |||
| const | SE_Integer_Unsigned | * | mesh_face_table_data, | 3 |
| const | SE_Integer_Unsigned | * | adjacent_face_table_data | 4 |
| ); | ||||
Given the <Mesh Face Table> instance specified by mesh_face_table_object, this function places the face definition data for the selected faces as specified in mesh_face_table_data into that instance. The selected faces are specified by the start_face and number_faces parameters.
In addition, if put_adjacent_face_table_data has value SE_TRUE, the adjacent face table data specified by adjacent_face_table_data is placed into the selected faces of mesh_face_table_object. If put_adjacent_face_table_data has value SE_FALSE, the adjacent face table data of mesh_face_table_object is not modified.
The array dimension specified by maximum_vertices_per_face is obtained from that field of mesh_face_table_object.
The validity of adjacent_face_table_data adjacent_face_table_data shall only be verified if put_adjacent_face_table_data has value SE_TRUE.
| SE_RETCOD_SUCCESS | and the requested data is returned. |
| SE_RETCOD_FAILURE | and the status code is set appropriately if the call failed. |
SE_Status_Code(s) when SE_RETCOD_SUCCESS is returned:
| SE_STATCODE_SUCCESS | set if valid parameters were passed in and all operations succeeded. |
SE_Status_Code(s) when SE_RETCOD_FAILURE is returned:
| SE_STATCODE_UNRESOLVED_INPUT_OBJECT | and no changes are made if mesh_face_table_object is a handle to an unresolved DRM object. |
| SE_STATCODE_DELETED_OBJECT | and no changes are made if mesh_face_table_object is a handle to a DRM object that has been removed from the transmittal in which it resided. |
| SE_STATCODE_INACTIONABLE_FAILURE |
and no changes are made if
|
1 specifies a <Mesh Face Table> instance from which the face definition data is to be retrieved
2 specifies whether the adjacent_face_table_data parameter is to be used
3 an array of [number_faces][maximum_vertices_per_face] dimensions, where maximum_vertices_per_face is obtained from the fields of mesh_face_table_object
4 if specified, an array of [number_faces][maximum_vertices_per_face] dimensions, where maximum_vertices_per_face is obtained from the fields of mesh_face_table_object
Prev: SE_PutImageData.
Next: SE_RemoveAssociateRelationship.
Up:Index.
|