Function

Gimpfile_load_layers

Declaration [src]

GimpLayer**
gimp_file_load_layers (
  GimpRunMode run_mode,
  GimpImage* image,
  GFile* file,
  gint* num_layers
)

Description [src]

Loads an image file as layers for an existing image.

This procedure behaves like the file-load procedure but opens the specified image as layers for an existing image. The returned layers needs to be added to the existing image with gimp_image_insert_layer().

Available since:2.4

Parameters

run_mode GimpRunMode
 

The run mode.

image GimpImage
 

Destination image.

 The data is owned by the caller of the function.
file GFile
 

The file to load.

 The data is owned by the caller of the function.
num_layers gint*
 

The number of loaded layers.

 The argument will be set by the function.

Return value

Returns: An array of GimpLayer*
 
     The list of loaded layers.
     The returned value must be freed with g_free().
 The length of the array is in the num_layers argument.
 The caller of the function takes ownership of the data container, but not the data inside it.