IMAGE Mnemonic - Draw Bitmapped Image (SYSGUI)

Syntax

'IMAGE'(x1,y1,x2,y2,filename{,grabpalette})

Description

The 'IMAGE' mnemonic draws a bitmapped image onto the window in the current context. The x1,y1 parameters specify the location of the upper-left corner of the image in world coordinates. The x2,y2 parameters specify the location of the lower right corner. If x2,y2 equals x1,y1, the image is not scaled to fit the specified rectangle but is instead drawn in its intrinsic size, starting from the position specified. This means that one pixel in the original image equals one pixel in the SYSGUI window, regardless of any current scaling. The Windows .bmp format is guaranteed to be supported on all future platforms. If the grabpalette parameter is present and nonzero, colors required to display the image are placed into the current palette, possibly replacing colors used by other applications.

Parameter

Description

x1

Upper-left corner of the image in world coordinates.

y1

Upper-left corner of the image in world coordinates.

x2

Lower right corner of the image in world coordinates.

y2

Lower right corner of the image in world coordinates.

filename

Name and path of the bitmap image to display in the window.

grabpalette

Replaces the current palette with one specified by an image.

See Also

Mnemonics - Alphabetical Listing

Mnemonics - Group Listing