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

FreeBSD Manual Pages


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

       XpSetImageResolution  - Sets the	resolution for subsequent PutImage re-

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

       Bool  XpSetImageResolution   (	display,   print_context,   image_res,
       prev_res_return )
	     Display * display ;
	     XPContext	print_context ;
	     int  image_res ;
	     int * prev_res_return ;

       - display
	      Specifies	a pointer to the Display structure.

       - print_context
	      Specifies	the print context on which to set the resolution.

       - image_res
	      Specifies	the image resolution in	pixels per inch.

       - prev_res_return
	      Returns the previous image resolution in pixels per inch.

       XpSetImageResolution  returns  True  if	the printer server allowed the
       resolution to be	set, otherwise False is	returned.

       XpSetImageResolution sets the resolution	for  subsequent	 PutImage  re-
       quests  to  the	screen	of  the	specified print	context. If the	return
       value is	False, then the	print server does not  support	image  scaling
       for  the	 particular  resolution	given the current configuration	of the
       printer,	and the	application is responsible for any desired scaling. If
       the  return value is True, then the contents of any subsequent PutImage
       request to a Pixmap or to a Window on the screen	of the specified print
       context	will  automatically be scaled as part of the PutImage request.
       The scale factor	is:

	   default_printer_resolution /	image_res

       Where default_printer_resolution	is the current value of	that page  at-
       tribute.	 Only  the image itself	is scaled (meaning the effective width
       and height of the image change),	the  dst-x  and	 dst-y	parameters  to
       PutImage	are not	altered.

       As  a special case, a value of zero for image_res resets	the resolution
       to automatically	track the printer resolution; in this case  (which  is
       also the	default	setting	for a newly created print context), subsequent
       images will not be scaled.

       If the return value is True and prev_res_return is a non-NULL  pointer,
       then  the  previous image resolution that was set for the print context
       is stored in prev_res_return.

       XpSetImageResolution returns False immediately if image_res is negative
       or greater than 65535.

       XpBadContext   A	 valid print context-id	has not	been set prior to mak-
		      ing this call.

X Version 11			  libXp	1.0.3	     XpSetImageResolution(3Xp)


Want to link to this manual page? Use this URL:

home | help