Loads a bitmap from an image file in the current folder.
Parameters:
BMAP*
Bitmap pointer .
name
file name in .jpg, .png, .bmp, .tga, dds, or .dib format; char* or STRING*.
mode
0 = clip to old bmap size, 1 = change bmap size.
Remarks:
The file must exist in the game folder. It can not be directly read
from a resource or from the folder path.
The original image can be restored by bmap_purge().
If mode is set at 0, the bmap size is unchanged. If the image file
size is different, or is not a power of 2, parts of the image can be clipped away or filled
with black.
If mode is set at 1, the bmap is changed to the new size. It must be a power of two in size.