XPRINT SCALE statement  

Purpose

Define a custom world coordinate system for the client (printable) area of the host printer page.

Syntax

XPRINT SCALE (x1!, y1!)-(x2!, y2!)
XPRINT SCALE PIXELS

Remarks

XPRINT SCALE lets you define your own world coordinate system for all subsequent XPRINT statements.  The custom coordinates remain until XPRINT SCALE is repeated, or the printer is detached.  World coordinates may be floating-point values, with the only requirement that x1! not equal x2!, and y1! not equal y2!.  If either is equal, an error 5 is generated.

If x2! is greater than x1!, coordinates grow larger as they move to the right.  Otherwise, they grow larger as they move to the left.

If y2! is greater than y1!, coordinates grow larger as they move downward. Otherwise, they grow larger as they move upward.

XPRINT SCALE PIXELS resets the coordinate system to the original default pixel coordinates.

See also

XPRINT ATTACH, XPRINT GET SCALE

Example

' Attach the default Windows printer

XPRINT ATTACH DEFAULT

' Retreive the client size (printable area) of the printer page

XPRINT GET CLIENT TO ncWidth!, ncHeight!

' Retreive the resoltuion (points per inch) of the attached printer

XPRINT GET PPI TO x&, y&

' Width in inches of the printable area

ncWidth!  = ncWidth!/x&

' Height in inches of the printable area

ncHeight! = ncHeight!/y&

' Set the scale to inches, for American letter-size paper

' in portrait mode. This is the equivalent to 8.5x11 minus the margins.

XPRINT SCALE (0,0)-(ncWidth!,ncHeight!)