Introduction

Getting Started

Programming Guides

API Reference

Additional Resources

MSet_Face_Visibilities

Functions

void MSet_Face_Visibilities (HC_KEY key, int offset, int count, const char *settings)
 Sets the visibility of a range of faces at once. More...
 
void MSet_Face_Visibilities_By_Index (HC_KEY key, int size, const int *count, const char *settings)
 Similar to MSet_Specific_Face_Visibilities() which sets the visibility on precise faces by referencing the face index list. More...
 
void MSet_Specific_Face_Visibilities (HC_KEY key, int count, const int *indices, const char *settings)
 Sets the visibility of a list of specific of faces at once. More...
 
void MUnSet_Face_Visibilities (HC_KEY key, int offset, int count)
 Removes the per-face visibility settings of a range of faces at once. This allows the shell or mesh to inherit segment-level visibility settings. More...
 
void MUnSet_Face_Visibilities_By_Index (HC_KEY key, int size, const int *count)
 Similar to MSet_Face_Visibilities_By_Index() but removes the per-face visibility settings for the specified faces, rather than setting them either on or off. This allows the shell or mesh to inherit the segment-level visibility settings. More...
 
void MUnSet_Specific_Face_Visibilities (HC_KEY key, int count, const int *indices)
 Removes the per-face visibility settings of a list of faces at once. This allows the shell or mesh to inherit segment-level visibility settings. More...
 

Detailed Description

Function Documentation

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

Sets the visibility of a range of faces at once.

Parameters
key- Key of a shell or mesh.
offset- First face number.
count- Number of faces on which to set visibility.
settings- Visibility setting per face, zero (0) for off, non-zero for on.

DETAILS

This function is equivalent to the following:

for (i=0; i<count; i++) {
Open_Face (offset + i);
if (settings[i])
else
Set_Visibility ("off");
}

...except that tristrip adjustment is done once at the end instead of once per face.

See also
MShow_Specific_Face_Visibilities, MSet_Face_Colors_By_FIndex, MSet_Face_Colors_By_Value, MSet_Face_Regions, MShow_Face_Colors_By_FIndex, MShow_Face_Colors_By_Value, MShow_Face_Regions
void MSet_Face_Visibilities_By_Index ( HC_KEY  key,
int  size,
const int *  offsets,
const char *  settings 
)

Similar to MSet_Specific_Face_Visibilities() which sets the visibility on precise faces by referencing the face index list.

Parameters
key- Key of a shell or mesh.
size- Number of items in offsets.
offsets- Indices of faces on which to set visibility.
settings- Visibility setting per face, zero (0) for off, non-zero for on.

DETAILS

settings is a character array with a 0 or non 0 value in each character.

See also
MShow_Specific_Face_Visibilities, MSet_Face_Colors_By_FIndex, MSet_Face_Colors_By_Value, MSet_Face_Regions, MShow_Face_Colors_By_FIndex, MShow_Face_Colors_By_Value, MShow_Face_Regions
void MSet_Specific_Face_Visibilities ( HC_KEY  key,
int  count,
const int *  indices,
const char *  settings 
)

Sets the visibility of a list of specific of faces at once.

Parameters
key- Key of a shell or mesh.
count- The length of indices array.
indices- List of face numbers on which to set visibility.
settings- Visibility setting per face, zero (0) for off, non-zero for on.

DETAILS

settings is a character array with a 0 or non 0 value in each character.

See also
MShow_Specific_Face_Visibilities, MSet_Face_Colors_By_FIndex, MSet_Face_Colors_By_Value, MSet_Face_Regions, MShow_Face_Colors_By_FIndex, MShow_Face_Colors_By_Value, MShow_Face_Regions
void MUnSet_Face_Visibilities ( HC_KEY  key,
int  offset,
int  count 
)

Removes the per-face visibility settings of a range of faces at once. This allows the shell or mesh to inherit segment-level visibility settings.

Parameters
key- Key of a shell or mesh.
offset- First face number.
count- Number of faces on which to set visibility.

DETAILS

This function is equivalent to MUnSet_Specific_Face_Visibilities.

See also
MShow_Specific_Face_Visibilities, MSet_Face_Colors_By_FIndex, MSet_Face_Colors_By_Value, MSet_Face_Regions, MShow_Face_Colors_By_FIndex, MShow_Face_Colors_By_Value, MShow_Face_Regions
void MUnSet_Face_Visibilities_By_Index ( HC_KEY  key,
int  size,
const int *  offsets 
)

Similar to MSet_Face_Visibilities_By_Index() but removes the per-face visibility settings for the specified faces, rather than setting them either on or off. This allows the shell or mesh to inherit the segment-level visibility settings.

Parameters
key- Key of a shell or mesh.
size- Number of items in offsets.
offsets- Indices of faces on which to set visibility.

DETAILS

No additional details. See MSet_Face_Visibilities_By_Index().

See also
MShow_Specific_Face_Visibilities, MSet_Face_Colors_By_FIndex, MSet_Face_Colors_By_Value, MSet_Face_Regions, MShow_Face_Colors_By_FIndex, MShow_Face_Colors_By_Value, MShow_Face_Regions
void MUnSet_Specific_Face_Visibilities ( HC_KEY  key,
int  count,
const int *  indices 
)

Removes the per-face visibility settings of a list of faces at once. This allows the shell or mesh to inherit segment-level visibility settings.

Parameters
key- Key of a shell or mesh.
count- Number of faces in the indices array.
indices- The list of faces to remove the visibility setting.

DETAILS

No additional details. See MSet_Specific_Face_Visibilities().

See also
MShow_Specific_Face_Visibilities, MSet_Face_Colors_By_FIndex, MSet_Face_Colors_By_Value, MSet_Face_Regions, MShow_Face_Colors_By_FIndex, MShow_Face_Colors_By_Value, MShow_Face_Regions