Constructor
GimpLayernew_from_surface
since: 2.8
Declaration [src]
GimpLayer*
gimp_layer_new_from_surface (
GimpImage* image,
const gchar* name,
cairo_surface_t* surface,
gdouble progress_start,
gdouble progress_end
)
Description [src]
Create a new layer from a #cairo_surface_t.
This procedure creates a new layer from the given
cairo_surface_t. The image has to be an RGB image and just like
with gimp_layer_new() you will still need to add the layer to it.
If you pass progress_end > progress_start to this function,
gimp_progress_update() will be called for. You have to call
gimp_progress_init() beforehand then.
Available since: 2.8
Parameters
image-
Type:
GimpImageThe RGB 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 data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. surface-
Type:
cairo_surface_tA Cairo image surface.
The data is owned by the caller of the function. progress_start-
Type:
gdoubleStart of progress.
progress_end-
Type:
gdoubleEnd of progress.
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. |