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... | |
void Set_Conditional_Action | ( | const char * | options, |
const char * | condition | ||
) |
Allows the user to associated specific action(s) with a set of conditions.
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. |
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.
void UnSet_Conditional_Actions | ( | void | ) |
void UnSet_One_Conditional_Action | ( | const char * | which | ) |
Removes a given action established by a previous call to Set_Conditional_Actions().
which | - A quoted string or a string variable containing the desired action to be unset. |
No additional details. See Set_Conditions()