1XOpenOM(3)                      XLIB FUNCTIONS                      XOpenOM(3)
2
3
4

NAME

6       XOpenOM,  XCloseOM, XSetOMValues, XGetOMValues, XDisplayOfOM, XLocaleO‐
7       fOM - open output methods
8

SYNTAX

10       XOM XOpenOM(Display *display,  XrmDatabase  db,  char  *res_name,  char
11              *res_class);
12
13       Status XCloseOM(XOM om);
14
15       char *XSetOMValues(XOM om, ...);
16
17       char *XGetOMValues(XOM om, ...);
18
19       Display *XDisplayOfOM(XOM om);
20
21       char *XLocaleOfOM(XOM om);
22

ARGUMENTS

24       display   Specifies the connection to the X server.
25
26       db        Specifies a pointer to the resource database.
27
28       res_name  Specifies the full resource name of the application.
29
30       res_class Specifies the full class name of the application.
31
32       om        Specifies the output method.
33
34       ...       Specifies the variable length argument list to set or get XOM
35                 values.
36

DESCRIPTION

38       The XOpenOM function opens an output method matching the current locale
39       and  modifiers  specification.   The  current  locale and modifiers are
40       bound to the output method when XOpenOM is called.  The locale  associ‐
41       ated with an output method cannot be changed.
42
43       The specific output method to which this call will be routed is identi‐
44       fied on the basis of the current locale and  modifiers.   XOpenOM  will
45       identify  a  default output method corresponding to the current locale.
46       That default can be modified using XSetLocaleModifiers to set the  out‐
47       put method modifier.
48
49       The  db  argument  is  the  resource  database to be used by the output
50       method for looking up resources that are private to the output  method.
51       It  is  not  intended that this database be used to look up values that
52       can be set as OC values in an output context.  If db is NULL, no  data‐
53       base is passed to the output method.
54
55       The  res_name  and  res_class  arguments  specify the resource name and
56       class of the application.  They are intended to be used as prefixes  by
57       the output method when looking up resources that are common to all out‐
58       put contexts that may be created for this output method.   The  charac‐
59       ters  used  for  resource  names  and classes must be in the X Portable
60       Character Set.  The resources looked up  are  not  fully  specified  if
61       res_name or res_class is NULL.
62
63       The  res_name  and  res_class arguments are not assumed to exist beyond
64       the call to XOpenOM.  The specified resource database is assumed to ex‐
65       ist for the lifetime of the output method.
66
67       XOpenOM returns NULL if no output method could be opened.
68
69       The XCloseOM function closes the specified output method.
70
71       The XSetOMValues function presents a variable argument list programming
72       interface for setting properties or features of  the  specified  output
73       method.   This  function returns NULL if it succeeds; otherwise, it re‐
74       turns the name of the first argument that could not be set.  Xlib  does
75       not  attempt  to  set  arguments from the supplied list that follow the
76       failed argument; all arguments in the list preceding the  failed  argu‐
77       ment have been set correctly.
78
79       No standard arguments are currently defined by Xlib.
80
81       The XGetOMValues function presents a variable argument list programming
82       interface for querying properties or features of the  specified  output
83       method.   This  function returns NULL if it succeeds; otherwise, it re‐
84       turns the name of the first argument that could not be obtained.
85
86       The XDisplayOfOM function returns the display associated with the spec‐
87       ified output method.
88
89       The XLocaleOfOM returns the locale associated with the specified output
90       method.
91

SEE ALSO

93       XCreateOC(3), XCreateFontSet(3)
94       Xlib - C Language X Interface
95
96
97
98X Version 11                     libX11 1.8.1                       XOpenOM(3)
Impressum