MakeBitmap

Description: Loads an image file of types BMP, EMF, WMF, APM, CUT, PCX, JPG, PNG, or TIF into memory and returns a handle to the result. Returns Invalid upon failure.

Returns: Image

Usage: Script or Steady State

Format: MakeBitmap(FileName [, Transparent1, Transparent2])

Parameters: FileName { text } { required } { no default }

Any text expression giving the name of the file containing the image.

Transparent1 { numeric } { optional } { no default }

An optional parameter that is any numeric expression giving the first color value to make transparent (0 - 255). If this value is negative 1 (-1), this parameter is ignored and no first color is made transparent.

Transparent2 { numeric } { optional } { no default }

An optional parameter that is any numeric expression giving the second color value to make transparent (0 - 255). If this value is -1, this parameter is ignored and no second color is made transparent.

Comments: This function creates and returns a bitmap value by loading an image from a file. All images are rendered in 32-bit color. An indexed color must translate into an exact 32-bit match in order to cause transparency. Colors may have their own transparency data via alpha values. Using a bitmap value can improve speed and reduce memory requirements over using a file name directly in a function or statement.

Example:

Image = MakeBitmap("C:\Bitmaps\dial.bmp");

This will create a bitmap value storing the image from the file "C:\Bitmaps\dial.bmp".