Synopsis
void OMset_verbose (
unsigned int mask,
int state,
FILE *fp );
Description
OMset_verbose sets the verbose mode for the events specified by mask .
Arguments
mask
One or more events whose verbose mode is to be set. Modes that are omitted are unaffected.
You can specify any of the following symbolic constants, which are defined in <avs/om.h>:
|
Verbose mode
|
Meaning
|
|
OM_VERBOSE_FUNC |
Prints a message before executing any function objects. The message indicates the function object's name, the argument's name, and the event that caused the function to execute. |
|
OM_VERBOSE_EVENT |
Prints a message when an event is queued. If an object is modified while a context has been pushed, the event is queued. The message indicates the name of the function (and/or argument) of the function that is being queued, the name of the object that caused the event, and the type of the object that caused this function to be queued (e.g., a value-changed event). |
|
OM_VERBOSE_SORT |
Prints a message when a function has been bypassed for another function on which it has a dependency. This is useful for detemining why functions are perhaps executing in the wrong order. |
|
OM_VERBOSE_CTX |
Prints a message when a context is pushed or popped. This is useful for determining which events are being generated by asynchronous events such as the user interface. |
|
OM_VERBOSE_FILES |
Prints a message before and after loading each V file. |
state
Whether to turn the specified modes on or off:
|
State
|
Meaning
|
|
0 |
Turn the specified modes off. |
|
1 |
Turn the specified modes on. |
fp
A file pointer indicating where the output should be directed. The default if fp is NULL is standard out.
Example
/* Turn on verbose mode for OM_VERBOSE_FUNC and
OM_VERBOSE_EVENT. The output is sent to std out. */
OMset_verbose(OM_VERBOSE_FUNC | OM_VERBOSE_EVENT, 1, NULL);