In french: ChargeImage
Loads an image in memory so that it can be used later by gImage
<Result> = LoadImage(<Image identifier> , <Image name> [, <Number of rows> [, <Number of columns> [, <Border>]]])
- True if the image was loaded in memory,
- False otherwise.
<Image identifier>: Integer
Identifier of image loaded in memory (included between 1 and 9). If this identifier is already used, the loaded image replaces the previous image. This identifier will be used by gImage.
<Image name>: Character string
Name and full (or relative) path of image to load. A UNC path can be used.
<Number of rows>: Optional integer
Number of drawings rows found in the image (up to 255 rows).
<Number of columns>: Optional integer
Number of drawings columns found in the image (up to 255 columns).
<Border>: Optional character
"C" if no border must be displayed around each drawing. By default, a 1-pixel border is displayed around each drawing.
An image can contain several drawings organized in rows and columns. All these drawings must have the same size and they can be enclosed in a 1-pixel border.
Drawings are numbered from 1 to <Number of rows> * <Number of columns> from left to right and from top to bottom.
When adding a drawing to the image, the call to LoadImage has to be modified to specify the new number of drawings horizontally and vertically.
- LoadImageSheet simplifies the additions of drawings into the image. It is recommended to use this function.
- gImageExists is used to find out whether an image was loaded in memory by LoadImage or LoadImageSheet.
LoadImage must not be used in the project code. Indeed, this function must be used in the window where the image must be handled.
This page is also available for…