Brief Index      Full Index      Events Index      I.M. Reference

MShow_Vertex_Visibilities

Functions

void MShow_Vertex_Visibilities (HC_KEY key, int offset, int count, char *settings)
 
int MShow_Vertex_Visibilities_With_Existence (HC_KEY key, int offset, int count, char *existence, char *visibilities)
 
void MShow_Specific_Vertex_Visibilities (HC_KEY key, int count, const int *indices, char *settings)
 
int MShow_Specific_Vertex_Visibilities_With_Existence (HC_KEY key, int count, const int *indices, char *existence, char *visibilities)
 

Detailed Description

Function Documentation

void MShow_Vertex_Visibilities ( HC_KEY  key,
int  offset,
int  count,
char *  settings 
)

Shows per-vertex visibility settings for a range of vertices at once.

Parameters
key- Key of a shell or mesh.
offset- First vertex number.
count- Number of vertices on which to show visibility.
settings- Visibility setting per vertex, zero (0) for off, non-zero for on. Returned to user.
See Also
MSet_Vertex_Visibilities, Set_Visibility
int MShow_Vertex_Visibilities_With_Existence ( HC_KEY  key,
int  offset,
int  count,
char *  existence,
char *  visibilities 
)

Shows per-vertex visibility settings for a range of vertices at once.

Parameters
key- Key of a shell or mesh.
offset- First vertex number.
count- Number of vertices on which to show visibility.
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.
visibilities- Visibility setting per vertex, zero (0) for off, non-zero for on. Returned to user.
Returns
The number of items that have the attribute set.

DETAILS

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

  • 0 : There was no visiblity value set.
  • 1 : The visibility setting exists.
See Also
MSet_Vertex_Visibilities, Set_Visibility
void MShow_Specific_Vertex_Visibilities ( HC_KEY  key,
int  count,
const int *  indices,
char *  settings 
)

Sets per-vertex visibility settings on several individual vertices at once. This overrides the visibility settings inherited from the segment-level.

Parameters
key- Key of a shell or mesh.
count- Number of vertices on which to set visibility.
indices- Indices into the point list on which to show the visibility.
settings- Visibility setting per vertex, zero (0) for off, non-zero for on. Returned to user.
See Also
MSet_Vertex_Visibilities, Set_Visibility
int MShow_Specific_Vertex_Visibilities_With_Existence ( HC_KEY  key,
int  count,
const int *  indices,
char *  existence,
char *  visibilities 
)

Sets per-vertex visibility settings on several individual vertices at once. This overrides the visibility settings inherited from the segment-level.

Parameters
key- Key of a shell or mesh.
count- Number of vertices on which to show visibility.
indices- 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.
visibilities- Visibility setting per vertex, zero (0) for off, non-zero for on. Returned to user.
Returns
The number of items that have the attribute set.

DETAILS

See MShow_Vertex_Visibility_With_Existence() for more details.

See Also
MSet_Vertex_Visibilities, Set_Visibility

Brief Index      Full Index      Events Index      I.M. Reference