This manual page is for Mac OS X version 10.6.3

Reading manual pages

XpSetContext(3Xp)                             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... ]
             #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 associ-ated associated
       ated with display. If there was no previously associated print context, no action is taken. The  con-tent content
       tent of the formerly associated print context is not affected by this call, and other display connec-tions connections
       tions may continue to use the print context.

       Since font capabilities can vary from printer to printer, XpSetContext may modify the list of  avail-able available
       able  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  List-FontsWithInfo ListFontsWithInfo
       FontsWithInfo  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 xp-listfontsmodes
       modes  attribute  is  provided  so  that applications can control the behavior of ListFonts and List-FontsWithInfo ListFontsWithInfo
       FontsWithInfo 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.0                               XpSetContext(3Xp)