file_load_layer

Loads an image file as a layer for an existing image.

This procedure behaves like the file-load procedure but opens the specified image as a layer for an existing image. The returned layer needs to be added to the existing image with insert_layer.

Parameters:

run_mode	The run mode.
image	Destination image.
file	The file to load.

Returns:

The layer created when loading the image file.