Brief Index      Full Index      I.M. Reference

Set_Conditions


Functions

void Set_Conditions (const char *list)
void QSet_Conditions (const char *segment, const char *list)
void UnSet_Conditions (void)
void UnSet_One_Condition (const char *condition)
void QUnSet_Conditions (const char *segment)
void QUnSet_One_Condition (const char *segment, const char *condition)

Function Documentation

void Set_Conditions ( const char *  list  ) 

Allows the user to set conditions on a segment that will be used to determine whether or not a Conditional Style or Conditional Include should be applied.

Parameters:
list - A quoted string or a string variable containing a list of the desired conditions along with optional logical expressions.

DETAILS

In certain cases it is required that the styling or inclusion of geometry into a segment be independent of its ancestry. A model of an automobile may include a single wheel assembly into four separate segments, however the brake pad may need to be highlighted in only one of the four instances. To do this one can conditionally style the particular segment that contains the highlighting colors. To do this, use Set_Condition() and Conditional_Style() together on the segment that includes the wheel. For instance:

     HC_Set_Conditions("front_left");
     HC_Conditional_Style("/include library/styles/highlight","front_left");

where "front left" is the condition and "/include library/styles/highlight" is the segment containing the highlight colors. When the condition is set and unset, the styling is activated and deactivated, respectively.

This example is simplistic but demonstrates that users can toggle the properties of their scene based on some predefined setup that has a name, rather than having to loop through geometry and keep track of large numbers of view attributes. This saves time and bookkeeping in large models.

Conditions can be aggregated and controlled with the logical expressions AND, OR and NOT or &&, || and !. In other words, a segment such as "/include library/styles/highlight" can be associated with numerous conditions, and the containing segment can activate an Include segment or a Style segment under many different conditions.

See also:
Conditional_Include, Conditional_Style, Show_Conditional_Style, Show_Conditional_Include, Show_Conditions

void QSet_Conditions ( const char *  segment,
const char *  list 
)

Similar to Set_Conditions() but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment to be changed.
list - A quoted string or a string variable containing a list of the desired conditions.

DETAILS

No additional details. See Set_Conditions()

void UnSet_Conditions ( void   ) 

Removes all the conditions established by a previous call to Set_Conditions().

DETAILS

No additional details. See Set_Conditions()

void UnSet_One_Condition ( const char *  condition  ) 

Removes a given condition established by a previous call to Set_Conditions().

Parameters:
condition - A quoted string or a string variable containing the desired condition to be changed.

DETAILS

No additional details. See Set_Conditions()

void QUnSet_Conditions ( const char *  segment  ) 

Similar to UnSet_Conditions() but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment to be changed.

DETAILS

No additional details. See Set_Conditions()

void QUnSet_One_Condition ( const char *  segment,
const char *  condition 
)

Removes a given condition established by a previous call to Set_Conditions(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment to be changed.
condition - A quoted string or a string variable containing the desired condition to be changed.

DETAILS

No additional details. See Set_Conditions()

Main Index
Brief Index      Full Index      I.M. Functions