XpSetImageResolution(3)

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 mak-
                      ing this call.

X Version 11                      libXp 1.0.0        XpSetImageResolution(3Xp)