NAME

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

SYNOPSIS

             cc [ flag... ] file... -lXp [ library... ]
             #include <X11/extensions/Print.h>

       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 connection. 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 (disassociate) 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 available 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 internal printer fonts defined for the printer. The xp-listfonts-modes
       attribute is provided so that applications can control the behavior of  ListFonts  and  ListFontsWithInfo
       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 associated with them. If the  value  of
       xp-listfonts-modes  includes  xp-list-internal-printer-fonts,  then  ListFonts and ListFontsWithInfo 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)

X Version 11                                       libXp 1.0.2                                 XpSetContext(3Xp)