GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XPSETIMAGERESOLUTION (3)

NAME

XpSetImageResolution - Sets the resolution for subsequent PutImage requests

CONTENTS

Synopsis
Arguments
Description
Diagnostics

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.
Search for    or go to Top of page |  Section 3 |  Main Index


X Version 11 XPSETIMAGERESOLUTION (3Xp) libXp 1.0.3

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.