Command: rasdraw

Syntax

rasdraw <file> {,<file> ... }

Description

Display an image file in a graphic window.

Parameters

• <file>
  The image file(s) to be displayed.

Switches

• -ang=<num>
  Rotation angle, measured anticlockwise. Currently only increments of 90 degrees are permitted.

• -clip=<nums>
  Restrict the displayed portion of the image to a defined rectangle. nums should be a 4-element numeric array specifying a rectangle in image co-ordinates, left x, top y, right x, bottom y, where Y values run top to bottom starting at 0.

• -j=<just>
  The justification used to place the image within the display window. If omitted, M (middle) is assumed.

• -op=<text>
  A raster operation to use when combining the image with the current screen contents. Possible values are:

• set - Overwrite the current screen contents (the default operation)

• xor - Exclusive-or with screen contents

• or - Or with screen contents

• -ow=<window>
  The window in which to display and clip the image. If omitted, the current graphic window is used.

• -pos=<screen_xy>
  Two values indicating where in the window to place the top left corner of the image file. The values are in pixels relative to the top-left corner of the graphic window canvas, with Y values running from top to bottom. This option will override any justification indication (-j), setting it to TL.

• -res=<num>
  The pixel resolution at which to display the image. Each pixel of the image will occupy <num> screen pixels.The default resolution is1.

• -trans
  Display the image through a stencil. This will result in only non-background pixels being displayed.

Notes

The rasdraw command can display all image types supported by Fire, see Image File Support.

Images displayed using rasdraw are transient and disappear on the next re-paint of the graphic window, although they are maintained in a window's save-under.

Examples

Display an image file in the current graphic window, with the top-left corner of the image placed at pixel (10,10) of the window canvas.

rasdraw myfile.ras, -pos=<10,10>

Display an image file in graphic window win4, justified top-right within the window. Exclusive-or the image with the current window contents.

rasdraw myfile.ras, -ow=win4, -j="TR", -op=xor

Display part of an image file at half its normal resolution.

rasdraw domjolly.jpg, -ow=win4, -clip=<10,10,300,200>, -res=0.5, -j="TL"

See Also