Manual Pages for UNIX Operating System command usage for man XpSetContext

XPRINT FUNCTIONS                                XpSetContext(3Xp)



NAME
     XpSetContext -  Sets or unsets  a  print  context  with  the
     specified display connection to the X Print Server.

SYNOPSIS
     cc [ flag... ] file... -lXp [ library... ]
           cc [ flag... ] file... -lXp [ library... ]
           #include 

     void XpSetContext ( display, print_context )
           Display *display;
           XPContext print_context;

ARGUMENTS
     display
          Specifies a pointer to the Display structure;  returned
          from XOpenDisplay.

     print_context
          A pre-existing print context on the same X Server.

DESCRIPTION
     XpSetContext sets the print context for  a  display  connec-
     tion. All subsequent print operations that do not explicitly
     take a print context-id (for example, XpStartJob) on display
     will  use  and  act upon the print context set by this call,
     until the print context  is  unset  or  XpDestroyContext  is
     called.  The  print  context can be set and used on multiple
     jobs, if not destroyed.

     If print_context is None, XpSetContext will unset  (disasso-
     ciate) the print context previously associated with display.
     If there was no  previously  associated  print  context,  no
     action  is  taken.  The  content  of the formerly associated
     print context is  not  affected  by  this  call,  and  other
     display connections may continue to use the print context.

     Since font capabilities can vary from  printer  to  printer,
     XpSetContext  may  modify  the  list of available fonts (see
     XListFonts) on display, and the actual set of  usable  fonts
     (see XLoadFont). A unique combination of fonts may be avail-
     able from within a given print context; a client should  not
     assume that all the fonts available when no print context is
     set will be available when a print context is set.

     When a print context is set on  a  display  connection,  the
     default  behavior  of  ListFonts and ListFontsWithInfo is to
     list all of the fonts normally associated with the  X  print
     server  (i.e. fonts containing glyphs) as well as any inter-
     nal  printer  fonts  defined  for  the  printer.   The   xp-
     listfonts-modes  attribute  is provided so that applications
     can control the behavior of ListFonts and  ListFontsWithInfo



X Version 11        Last change: libXp 1.0.0                    1






XPRINT FUNCTIONS                                XpSetContext(3Xp)



     and  is  typically used to show just internal printer fonts.
     Using only internal printer fonts is useful for  performance
     reasons;  the  glyphs associated with the font are contained
     within the printer and do not have to be downloaded.

     If the value of xp-listfonts-modes  includes  xp-list-glyph-
     fonts,  ListFonts  and ListFontsWithInfo will include all of
     the fonts available to the server that have  glyphs  associ-
     ated  with them. If the value of xp-listfonts-modes includes
     xp-list-internal-printer-fonts,  then  ListFonts  and  List-
     FontsWithInfo  will  include  all  of  the  fonts defined as
     internal printer fonts.

     When the print  context  is  unset  or  XpDestroyContext  is
     called,  the  available fonts on display revert back to what
     they were previously.

DIAGNOSTICS
     XPBadContext   A valid print context-id  has  not  been  set
                    prior to making this call.

SEE ALSO
     XpDestroyContext(3Xp), XpStartJob(3Xp)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libxp           |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|
















X Version 11        Last change: libXp 1.0.0                    2