Constructor
GimpLayernew
Declaration [src]
GimpLayer*
gimp_layer_new (
GimpImage* image,
const gchar* name,
gint width,
gint height,
GimpImageType type,
gdouble opacity,
GimpLayerMode mode
)
Description [src]
Create a new layer.
This procedure creates a new layer with the specified width
,
height
and type
. If name
is NULL
, a default layer name will be
used. opacity
and mode
are also supplied parameters.
The new layer still needs to be added to the image as this is not
automatic. Add the new layer with the gimp_image_insert_layer()
method.
Other attributes such as layer mask modes and offsets should be set with explicit procedure calls.
Parameters
image
-
Type:
GimpImage
The image to which to add the layer.
The data is owned by the caller of the function. name
-
Type:
const gchar*
The layer name.
The argument can be NULL
.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. width
-
Type:
gint
The layer width.
height
-
Type:
gint
The layer height.
type
-
Type:
GimpImageType
The layer type.
opacity
-
Type:
gdouble
The layer opacity.
mode
-
Type:
GimpLayerMode
The layer combination mode.
Return value
Type: GimpLayer
The newly created layer. The object belongs to libgimp and you should not free it.
The data is owned by the called function. |