Chapter Contents

Previous

Next
PRINT

PRINT



Prints an image


Syntax
Details
Examples

Syntax

rc = IMGOP(task-id, 'PRINT'<, x, y<, width, height<, type>>>);

x
is the X coordinate (on the page) of the top left corner of the image.

Type: Numeric

y
is the Y coordinate (on the page) of the top left corner of the image.

Type: Numeric

width
specifies either the actual width in pixels or a scaling factor for the width.

Type: Numeric

height
specifies either the actual height in pixels or a scaling factor for the height.

Type: Numeric

type
specifies the type to convert the image to before the image is printed. You can specify one of the following:
CMAP color mapped image (maximum of 256 colors)
GRAY gray-scale image
MONOCHROME two-color (black and white) image
RGBA true-color image.

Type: Character


Details

By default, PRINT centers the image. If you do not specify the width and height, PRINT fills the page.

If you want to specify either x or y, you must specify both. Also, if you want to specify either width or height, you must specify both. If you specify only one option in either of these pairs, PRINT uses the default values for both options in the pair. For example, if you specify the width but not the height, PRINT uses the default values for both the width and the height.

Use options x and y to position the image on the page. To center an image, specify -1 for the dimension in which you want to center the image (either x or y, or both). For example, if x is 0 and y is 999999, then the image will be printed in the lower left corner. If both x and y are 0, then the image will be printed in the upper left corner. If both x and y are -1, then the image will be printed in the center of the page.

To specify the actual width or height that you want to use to print the image, specify a positive number. To use the actual image size, specify 0 for both width and height. To scale the image, specify the scaling factor as a negative number. A scaling factor of -100 prints the image without scaling it up or down. A scaling factor of -150 is a scaling factor of 150 percent, and -50 is a scaling factor of 50 percent.

To keep the same aspect ratio, specify 0 for either width or height. For example, if you specify -75 for one option and 0 for the other, PRINT scales the image by 75 percent while keeping the same aspect ratio. You cannot specify 0 for both width and height.

If the scaling factor that you specify is larger than the easel, PRINT reduces the factor to the size of the easel. If the combination of options that you specify would postion the image off the page, then the width and height options take priority, and the position is adjusted so that the image fits on the page.


Examples


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.