Name
CreateBGPic -- create a blank background picture (V1.5)
Synopsis
[id] = CreateBGPic(id, width, height[, color])
Function
This function creates a new background picture with the specified width and height and initializes it to the specified color. If no color is specified, the background picture is initialized to black. If you specify Nil in the id argument, CreateBGPic() will choose a vacant identifier for this background picture automatically and return it to you.

Inputs
id
id for the new background picture
width
width for the background picture
height
height for the background picture
color
optional: RGB color for background (defaults to #BLACK)
Results
id
optional: identifier of the BGPic; will only be returned when you pass Nil as argument 1 (see above)
Example
CreateBGPic(2, 640, 480)
The above code creates a new black BGPic with the id 2 and the dimension of 640x480.

Show TOC