Constructor

GimpLayernew_from_surface

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 GimpImage
 

The RGB image to which to add the layer.

 The data is owned by the caller of the function.
name 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 cairo_surface_t
 

A Cairo image surface.

 The data is owned by the caller of the function.
progress_start gdouble
 

Start of progress.

progress_end gdouble
 

End of progress.

Return value

Returns: GimpLayer
 

The newly created layer. The object belongs to libgimp and you should not free it.

 The data is owned by the called function.