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,
constSE_Integer_Unsigned *mesh_face_table_data,3
constSE_Integer_Unsigned *adjacent_face_table_data4
);

Definition

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.


Returns

SE_RETCOD_SUCCESS and the requested data is returned.
SE_RETCOD_FAILURE and the status code is set appropriately if the call failed.

Status Codes

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

Parameters Notes

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.

Last updated: July 26, 2006 Copyright © 2006 SEDRIS