Functions
MShow_Vertex_Parameters

Functions

void MShow_Vertex_Parameters (HC_KEY key, int offset, int pcount, int *number, float *params)
 Returns the parameter settings from multiple vertices without having to open each vertex. More...
 
int MShow_Vertex_Parameters_With_Existence (HC_KEY key, int offset, int count, char *existence, int *param_width, float *user_parameters)
 Returns the parameter settings from multiple vertices without having to open each vertex. More...
 
void MShow_Specific_Vertex_Parameters (HC_KEY key, int count, const int *indices, int *number_parameters, float *user_parameters)
 Returns the parameter settings from a specific set of vertices without having to open each vertex. More...
 
int MShow_Specific_Vertex_Parameters_With_Existence (HC_KEY key, int count, const int *specific_vertices, char *existence, int *param_width, float *user_parameters)
 Returns the parameter settings from a specific set of vertices without having to open each vertex. More...
 
void MShow_Vertex_Parameter_Size (HC_KEY key, int *number)
 Returns the number of parameters that are set on each vertex of a shell or mesh. More...
 

Detailed Description

Function Documentation

void MShow_Specific_Vertex_Parameters ( HC_KEY  key,
int  count,
const int *  indices,
int *  number_parameters,
float *  user_parameters 
)

Returns the parameter settings from a specific set of vertices without having to open each vertex.

Parameters
key- Key to the piece of geometry to query.
count- Number of vertices to query.
indices- The list of vertices to query.
number_parameters- Number of parameters that are set on the vertices of this piece of geometry. Note that number is consistent for all vertices of the shell or mesh.Passed by reference. Returned to user.
user_parameters- A two dimensional array of floating-point vertex parameters. Passed by reference. Returned to user.

DETAILS

See MShow_Vertex_Parameters_With_Existence() for more details.

See also
MShow_Vertex_Parameter_Size, MSet_Vertex_Parameters, Set_Parameter, Show_Parameter, MSet_Vertex_Normals, Set_Normal, Show_Normal
int MShow_Specific_Vertex_Parameters_With_Existence ( HC_KEY  key,
int  count,
const int *  specific_vertices,
char *  existence,
int *  param_width,
float *  user_parameters 
)

Returns the parameter settings from a specific set of vertices without having to open each vertex.

Parameters
key- Key to the piece of geometry to query.
count- Number of vertices to query.
specific_vertices- The list of vertices to query.
existence- An array of size count whose values would be populated with either 0 (does not exist) or 1 (exists). Passed by reference. Returned to user.
param_width- Number of parameters that are set on the vertices of this piece of geometry. Note that number is consistent for all vertices of the shell or mesh.Passed by reference. Returned to user.
user_parameters- A two dimensional array of floating-point vertex parameters. Passed by reference. Returned to user.
Returns
The number of items that have the attribute set.

DETAILS

See MShow_Vertex_Parameters_With_Existence() for more details.

See also
MShow_Vertex_Parameter_Size, MSet_Vertex_Parameters, Set_Parameter, Show_Parameter, MSet_Vertex_Normals, Set_Normal, Show_Normal
void MShow_Vertex_Parameter_Size ( HC_KEY  key,
int *  number 
)

Returns the number of parameters that are set on each vertex of a shell or mesh.

Parameters
key- Key to the piece of geometry to query.
number- Number of parameters that are set on the vertices of this piece of geometry. Note that number is consistent for all vertices of the shell or mesh.
See also
MSet_Vertex_Parameters, Set_Parameter, Show_Parameter, MSet_Vertex_Normals, Set_Normal, Show_Normal
void MShow_Vertex_Parameters ( HC_KEY  key,
int  offset,
int  pcount,
int *  number,
float *  params 
)

Returns the parameter settings from multiple vertices without having to open each vertex.

Parameters
key- Key to the piece of geometry to query.
offset- Index of the key's point array on which to start querying values.
pcount- Number of points from offset to query.
number- Number of parameters that are set on the vertices of this piece of geometry. Note that number is consistent for all vertices of the shell or mesh.
params- A two dimensional array of floating-point vertex parameters. Passed by reference. Returned to user.
See also
MShow_Vertex_Parameter_Size, MSet_Vertex_Parameters, Set_Parameter, Show_Parameter, MSet_Vertex_Normals, Set_Normal, Show_Normal
int MShow_Vertex_Parameters_With_Existence ( HC_KEY  key,
int  offset,
int  count,
char *  existence,
int *  param_width,
float *  user_parameters 
)

Returns the parameter settings from multiple vertices without having to open each vertex.

Parameters
key- Key to the piece of geometry to query.
offset- Index of the key's point array on which to start querying values.
count- Number of points from offset to query.
existence- An array of size count whose values would be populated with either 0 (does not exist) or 1 (exists). Passed by reference. Returned to user.
param_width- Number of parameters that are set on the vertices of this piece of geometry. Note that number is consistent for all vertices of the shell or mesh.Passed by reference. Returned to user.
user_parameters- A two dimensional array of floating-point vertex parameters. Passed by reference. Returned to user.
Returns
The number of items that have the attribute set.

DETAILS

Use MShow_Vertex_Parameters_With_Existence to query vertex parameter values efficiently. Since parameter values may or may not exist, the return values gives you the total number of parameters that have been set. The existence array gives you further information about each vertex's parameter setting. For a given vertex, the existence value may be one of the following:

  • 0 : There was no parameter(s) value set.
  • 1 : Parameters were set.

See also
MShow_Vertex_Parameter_Size, MSet_Vertex_Parameters, Set_Parameter, Show_Parameter, MSet_Vertex_Normals, Set_Normal, Show_Normal