CreateImage()

Syntax

Result = CreateImage(#Image, Width, Height [, Depth])

Create an empty image (with black background) which can be used to do rendering on it. If #PB_Any is used as '#Image' parameter, the new image number will be returned as 'Result'.

Valid 'Depth' values can be: 24 bit and 32 bit. The default is 24 bit if no depth is specified. The depth value can be combined with #PB_Image_Transparent (using bitwise or operator '|') to create an image with the alpha channel set to full transparent. This only has an effect on 32 bit images.

You can use the several other functions for acting with the created image:
StartDrawing() with ImageOutput() to draw on the created image
CopyImage() to create another image from the actual one
GrabImage() to create another image from a given area of the actual one
DrawImage() with ImageID() to draw the image on actual output channel.
ImageGadget() for displaying image on an application window
ButtonImageGadget() for creating an image button on an application window

Note: the image size is currently limited to 8192x8192 pixels (if the available memory allow it).

Supported OS

All