System State Operators

The operator xgl_open() creates and initializes a System State object.

Xgl_sys_state xgl_open (<attribute-list>);

If the call is successful, a handle to the System State object is returned to the application. As with many XGL operators, xgl_open() takes a NULL-terminated attribute list as one of its input parameters. It may have as few as

zero attribute-value pairs or as many as the total number of XGL system state attributes, but in all cases it must be terminated with a NULL character, where NULL is defined as in stdio.h. Each attribute-value pair consists of an attribute name followed by its value.

The operator xgl_close() ends an XGL session.

void xgl_close (Xgl_sys_state system_state);

This operator is invoked using the handle to the XGL System State object previously created by the xgl_open() call. This operator destroys the XGL System State object and all its associated resources, and then terminates the XGL session.