Brief Index      Full Index      Events Index      I.M. Reference

Set_Conditional_Action


Functions

void Set_Conditional_Action (const char *options, const char *condition)
void UnSet_Conditional_Actions (void)
void UnSet_One_Conditional_Action (const char *which)

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()

Brief Index      Full Index      Events Index      I.M. Reference