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>
  A rotation angle, measured anticlockwise.

• -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.

• -hot=<x,y>
  The hotspot of the image, used for positioning. If this is omitted the justification (-j) is used. If there is no justification specified then the hotspot within the file is used, or 0,0 if no hotspot is available. The Y coordinate system of an image has zero at the top-left corner.

• -j=<just>
  The justification used to place the image within the display window. If omitted, M (middle) is assumed. If a hotspot is provided (-hot) the hotspot is located at the corresponding window point. If the hospot is not provided and no angle has been specified (-ang)the image is placed at this window justification to make whole image is visible.

• -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).

• -s=<num>
  A uniform scaling factor to be applied to both axes, equivalent to -x=< num>,-y=<num>.

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

• -x=<num> and -y=<num>
  Stretch factors to be applied to one or more axes. The default values are 1,1. Negative value mirror pixels in the relevant axis.

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. Show it transparent.

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

Display part of an image file in the middle of a window at half its normal resolution.

rasdraw domjolly.jpg, -ow=win4, -clip=<10,10,300,200>, -s=0.5

See Also