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  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 making this call.