Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XpSetContext(3Xp)	       XPRINT FUNCTIONS		     XpSetContext(3Xp)

NAME
       XpSetContext  -	Sets or	unsets a print context with the	specified dis-
       play 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 sub-
       sequent 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	 XpDe-
       stroyContext is called. The print context can be	set and	used on	multi-
       ple jobs, if not	destroyed.

       If print_context	is None, XpSetContext will  unset  (disassociate)  the
       print  context previously associated with display. If there was no pre-
       viously 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	behav-
       ior of ListFonts	and ListFontsWithInfo is to list all of	the fonts nor-
       mally 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, List-
       Fonts 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 mak-
		      ing this call.

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

X Version 11			  libXp	1.0.3		     XpSetContext(3Xp)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | DIAGNOSTICS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XpSetContext&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help