This manual page is for Mac OS X version 10.6.3

Reading manual pages

XpSetImageResolution(3Xp)                     XPRINT FUNCTIONS                     XpSetImageResolution(3Xp)



NAME
       XpSetImageResolution - 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.

DESCRIPTION
       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 speci-fied specified
       fied  print context. If the return value is False, then the print server does not support image scal-ing scaling
       ing 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 subse-quent subsequent
       quent 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  parame-ters parameters
       ters 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  con-text), context),
       text), 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 reso-lution resolution
       lution 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 making this call.



X Version 11                                     libXp 1.0.0                       XpSetImageResolution(3Xp)