Functions
Set_Conditional_Action

Functions

void Set_Conditional_Action (const char *options, const char *condition)
 Allows the user to associated specific action(s) with a set of conditions. More...
 
void UnSet_Conditional_Actions (void)
 Removes all the actions in the current segment. More...
 
void UnSet_One_Conditional_Action (const char *which)
 Removes a given action established by a previous call to Set_Conditional_Actions(). More...
 

Detailed Description

Function Documentation

void Set_Conditional_Action ( const char *  options,
const char *  condition 
)

Allows the user to associated specific action(s) with a set of conditions.

Parameters
options- A quoted string or a string variable containing a list of the actions to associate with a condition.
condition- A quoted string or a string variable containing the condition(s) to trigger the action.

DETAILS

Use Set_Conditional_Action to trigger a specific action or actions called options based on a group of conditions. The conditions list and how it can be specified is discussed in detail in Set_Conditions().

The options parameter to Set_Conditional_Action is a comma-separated list of settings which can include the following:

prune segment= ([segment|segment tree], [replace|merge])

The default values are segment and replace. Thus "prune segment" is the same as "prune segment = (segment, replace)". When this action is triggered, HOOPS acts as though the segment and subtree was culled and does not defer.

If you specify "segment tree", the test will remain in effect for the subtree and will be evaluated when new conditions are set while "segment" means that the test will be evaluated only once at the location defined after and local conditions are processed.

If you specify "merge", existing conditions for this action will remain and logically OR with newly specified conditions while "replace" means that existing conditions will be removed and only the newly specified conditions will remain.

See also
Set_Conditions, Show_Conditional_Action_Types
void UnSet_Conditional_Actions ( void  )

Removes all the actions in the current segment.

DETAILS

No additional details. See Set_Conditional_Actions()

void UnSet_One_Conditional_Action ( const char *  which)

Removes a given action established by a previous call to Set_Conditional_Actions().

Parameters
which- A quoted string or a string variable containing the desired action to be unset.

DETAILS

No additional details. See Set_Conditions()