XpSetImageResolution(3Xp) XPRINT FUNCTIONS XpSetImageResolution(3Xp)NAMEXpSetImageResolution - Sets the resolution for subsequent PutImage
requests
SYNOPSIS
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 ;
ARGUMENTS
- 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.
DESCRIPTIONXpSetImageResolution returns True if the printer server allowed the
resolution to be set, otherwise False is returned.
XpSetImageResolution sets the resolution for subsequent PutImage
requests 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
attribute. 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.
DIAGNOSTICS
XpBadContext A valid print context-id has not been set prior to mak‐
ing this call.
X Version 11 libXp 1.0.2 XpSetImageResolution(3Xp)
