Brief Index      Full Index      I.M. Reference

MSet_Face_Visibilities


Functions

void MSet_Specific_Face_Visibilities (HC_KEY key, int count, int *indices, const char *settings)
void MUnSet_Specific_Face_Visibilities (HC_KEY key, int count, int *indices)
void MSet_Face_Visibilities_By_Index (HC_KEY key, int size, const int *count, const char *settings)
void MUnSet_Face_Visibilities_By_Index (HC_KEY key, int size, const int *count)
void MSet_Face_Visibilities (HC_KEY key, int offset, int count, const char *settings)
void MUnSet_Face_Visibilities (HC_KEY key, int offset, int count)

Function Documentation

void MSet_Specific_Face_Visibilities ( HC_KEY  key,
int  count,
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_Specific_Face_Visibilities ( HC_KEY  key,
int  count,
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

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 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 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:

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

...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 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

Main Index
Brief Index      Full Index      I.M. Functions