gimp-image-new

Spencer Kimball & Peter Mattis

Description

Creates a new image with the specified width, height, and type.

Help

Creates a new image, undisplayed, with the specified extents and type. A layer should be created and added before this image is displayed, or subsequent calls to 'gimp-display-new' with this image as an argument will fail. Layers can be created using the 'gimp-layer-new' commands. They can be added to an image using the 'gimp-image-insert-layer' command. If your image's type if INDEXED, a colormap must also be added with 'gimp-image-set-colormap'. An indexed image without a colormap will output unexpected colors.


Type

unknown

Parameters

Type Name Description
PF_INT width The width of the image (1 <= width <= 524288)
PF_INT height The height of the image (1 <= height <= 524288)
PF_INT type The type of image { RGB (0), GRAY (1), INDEXED (2) }

Return

Type Name Description
PF_IMAGE image The ID of the newly created image