NAME

       XOpenOM, XCloseOM, XSetOMValues, XGetOMValues, XDisplayOfOM, XLocaleOfOM - open output methods

SYNTAX

       XOM XOpenOM(Display *display, XrmDatabase db, char *res_name, char *res_class);

       Status XCloseOM(XOM om);

       char *XSetOMValues(XOM om, ...);

       char *XGetOMValues(XOM om, ...);

       Display *XDisplayOfOM(XOM om);

       char *XLocaleOfOM(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 application.

       res_class Specifies the full class name of the application.

       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 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 output 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  features  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  features  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 ALSO

       XCreateOC(3), XCreateFontSet(3)
       Xlib - C Language X Interface