X Version 11
Release 6.4
X Print Service Extension Library
11
Use
XpSetImageResolution to set the resolution for subsequent PutImage requests.
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 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 res-
olution given the current configuration of the printer, and the application is responsible for any desired scal-
ing. 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 reso-
lution; 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.
XpSetImageResolution can generate an XPBadContext error.
Use
XpGetImageResolution to get the current image resolution for a print context.
int XpGetImageResolution (display, print_context)
Display *display;
XPContext print_context;
display
Specifies a pointer to the Display structure.
print_context
Specifies the print context on which to get the resolution.
XpGetImageResolution returns the current image resolution for the specified print context. A value of zero
means the resolution automatically tracks the printer resolution. If the request fails in some way, a negative
value is returned.
XpGetImageResolution can generate an XpBadContext error.