XOpenOM(3X11) XLIB FUNCTIONS XOpenOM(3X11)NAME
XOpenOM, XCloseOM, XSetOMValues, XGetOMValues, XDisplay-
OfOM, XLocaleOfOM - open output methods
SYNTAX
XOM XOpenOM(display, db, res_name, res_class)
Display *display;
XrmDatabase db;
char *res_name;
char *res_class;
Status XCloseOM(om)
XOM om;
char * XSetOMValues(om, ...)
XOM om;
char * XGetOMValues(om, ...)
XOM om;
Display * XDisplayOfOM(om)
XOM om;
char * XLocaleOfOM(om)
XOM om;
ARGUMENTS
display Specifies the connection to the X server.
db Specifies a pointer to the resource database.
res_name Specifies the full resource name of the applica-
tion.
res_class Specifies the full class name of the applica-
tion.
om Specifies the output method.
... Specifies the variable length argument list to
set or get XOM values.
DESCRIPTION
The XOpenOM function opens an output method matching the
current locale and modifiers specification. The current
locale and modifiers are bound to the output method when
XOpenOM is called. The locale associated with an output
method cannot be changed.
The specific output method to which this call will be
routed is identified on the basis of the current locale
and modifiers. XOpenOM will identify a default output
method corresponding to the current locale. That default
can be modified using XSetLocaleModifiers to set the
X Version 11 Release 6.4 1
XOpenOM(3X11) XLIB FUNCTIONS XOpenOM(3X11)
output method modifier.
The db argument is the resource database to be used by the
output method for looking up resources that are private to
the output method. It is not intended that this database
be used to look up values that can be set as OC values in
an output context. If db is NULL, no database is passed
to the output method.
The res_name and res_class arguments specify the resource
name and class of the application. They are intended to
be used as prefixes by the output method when looking up
resources that are common to all output contexts that may
be created for this output method. The characters used
for resource names and classes must be in the X Portable
Character Set. The resources looked up are not fully
specified if res_name or res_class is NULL.
The res_name and res_class arguments are not assumed to
exist beyond the call to XOpenOM. The specified resource
database is assumed to exist for the lifetime of the out-
put method.
XOpenOM returns NULL if no output method could be opened.
The XCloseOM function closes the specified output method.
The XSetOMValues function presents a variable argument
list programming interface for setting properties or fea-
tures of the specified output method. This function
returns NULL if it succeeds; otherwise, it returns the
name of the first argument that could not be set. Xlib
does not attempt to set arguments from the supplied list
that follow the failed argument; all arguments in the list
preceding the failed argument have been set correctly.
No standard arguments are currently defined by Xlib.
The XGetOMValues function presents a variable argument
list programming interface for querying properties or fea-
tures of the specified output method. This function
returns NULL if it succeeds; otherwise, it returns the
name of the first argument that could not be obtained.
The XDisplayOfOM function returns the display associated
with the specified output method.
The XLocaleOfOM returns the locale associated with the
specified output method.
SEE ALSOXCreateOC(3X11), XCreateFontSet(3X11)
Xlib - C Language X Interface
X Version 11 Release 6.4 2