XpSetImageResolution(3Xp)XPRINT FUNCTIONXpSetImageResolution(3Xp)



NAME
       XpSetImageResolution  - Sets the resolution for subsequent
       PutImage requests

SYNOPSIS
             cc [ flag... ] file... -lXp [ library... ]
             #include 

       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 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  automati-
       cally 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 resolu-
       tion; 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.



X Version 11               libXp 1.0.0  XpSetImageResolution(3Xp)