|
SAA_ctrlVertexGetIndices
Retrieves the array indices of control vertex coordinates.
Given an array of control vertices, you use SAA_ctrlVertexGetIndices to
index into an array containing the coordinates of those control vertices.
For polygons, you use SAA_polygonGetCtrlVerticesto
get an array of control vertices, and SAA_modelGetVertices
to get the array of vertex coordinates. For triangles, you use SAA_triangleGetCtrlVertices and SAA_modelGetTriVertices.
set scene [SAA_AllocScene]
set element [SAA_AllocElem]
set ctrl_vertices [SAA_AllocSubElem $nb_vtx]
.
.
.
vtx_idx [SAA_AllocInteger $nb_vtx]
SAA_ctrlVertexGetIndices $scene $element $nb_vtx $ctrl_vertices $vtx_idx
element
- The model whose control vertices are stored in the
ctrl_vertices array.
nb_vtx
- Size of the
ctrl_vertices array.
ctrl_vertices
- Array of control vertices. To get an array of polygon control vertices, use
SAA_polygonGetCtrlVertices. For
triangles, use SAA_triangleGetCtrlVertices.
vtx_idx
- Returns an array containing the index of each control vertex in the
ctrl_vertices
array.
- The calling function is responsible for allocating this array. The required size is
given by
nb_vtx.
Return Value
Return correct usage if incorrect parameters are passed
"SI_ERR_INVALID_SELEM" if one or more (but not all) control
vertices caused an error. Use SAA_subelementGetError
to determine which control vertices caused the errors.
For example, a control vertex causes an error if it is of the wrong types. Valid types
are polygon, triangle, NURBS curve and surface, spline, and patch control vertices.
"SI_ERR_SUBELEM_TOTAL_FAILURE" if every control vertex caused an
error.
|