Professional Documents
Culture Documents
Readme
Readme
Readme
=============
This GIMP plug-in exports layers as separate images in any file format supported
by GIMP and third-party plug-ins.
Features:
* uses native dialogs for file formats to adjust export settings
* uses layer names as filenames for the exported images
* can treat layer groups as folders
* can use tagged layers as background or foreground layers
* can optionally export only layers whose file extension matches the specified file
extension
* can use file extensions in layer names as file formats
Requirements
------------
Installation
------------
**Windows**
Make sure you installed GIMP with support for Python scripting.
**Linux**
If necessary, make the `export_layers.py` file executable, e.g. from the terminal:
chmod +x "export_layers.py"
**OS X**
If necessary, make the `export_layers.py` file executable, e.g. from the terminal:
chmod +x "export_layers.py"
GIMP for OS X may have Python 2.6 bundled, which will not work with this plug-in,
since Python 2.7 is required.
python=/usr/bin/python
/usr/bin/python=/usr/bin/python
:Python:E::py::python:
Usage
-----
From the main menu, select "File -> Export Layers...". A dialog appears, allowing
you to specify output folder, file extension and various other settings.
Type or choose your desired file extension in the "File extension" text field.
You can still enter a file extension not in the dropdown list in case you use a
file format plug-in not recognized by this plug-in.
To export layers with the last settings used, you may want to choose
"File -> Export Layers (repeat)".
Settings
--------
**Autocrop layers**
If enabled, layers will be resized (but not scaled) to the image size. This is
useful if you want to keep the size of the image canvas and the layer position
within the image. If layers are partially outside the image canvas,
they will be cut off. If you want to export the entire layer,
leave this setting disabled.
**Save Settings**
Current settings in the Export Layers window are permanently saved to a file.
If you re-open GIMP, the saved settings will be loaded from the file when
Export Layers is first opened.
**Reset Settings**
Advanced Settings
-----------------
* *Always strip file extension* - Strip (remove) file extension from all layer
names.
* *Strip identical file extension* - Remove file extension from the layer names
that
match the "File extension" text field.
* *Never strip file extension* - Don't strip file extension from layer names.
**[Tagged] layers**
Tagged layers contain tags at the beginning of the layer names and can modify how
layers are handled. For example, a layer named "[background] Layer" can be used
as a background layer if *Treat specially* is selected.
Tags are always stripped from layer names upon their export. You can also specify
multiple tags in one layer (e.g. "[background] [foreground] Layer", despite these
two tags being a rather unusual combination).
Options:
* *Treat as normal layers* - Tagged layers will be exported as any other layer.
* *Treat specially* - Tagged layers will be processed correspondingly and will
not be exported separately.
* *Ignore* - Tagged layers will not be exported and will not be processed.
* *Ignore other layers* - All other layers will not be exported.
If enabled, each top-level layer group is merged into one layer. The name
of each merged layer is the name of the corresponding top-level layer group.
**Create folders for empty layer groups**
If enabled, the layer mode for each layer is set to Normal. This is useful for
layers
with opacity less than 100% and a layer mode different than Normal or Dissolve,
which
would normally be completely invisible if a file format supporting alpha channel
is used (such as PNG).
Known Issues
------------
Several users reported crashes on Windows and OS X when clicking on the menu
entries or when clicking on the "Advanced Settings" widget. If the crashes
occur to you, try reinstalling GIMP.
The following file formats are not working properly with this plug-in:
* colored XHTML (.xhtml) - does not save images at all,
* KISS CEL (.cel) - throws error/warning messages, but saves images anyway.
The following file formats have to display the file format dialog for each layer,
not just the first layer:
* RAW,
* FLI (.fli, .flc),
* C source (.c),
* HTML (.html, .htm).
On Windows, the following file formats don't work properly if file paths contain
Unicode characters:
* DDS (.dds),
* OpenRaster (.ora),
* X PixMap Image (.xpm).
In "Export Layers (repeat)", JPEG format displays the file format dialog for the
first layer.
License
-------
Translations
------------
If you want to provide translations for the plug-in, see the `Readme for
Translators.txt`
file in the `export_layers/locale` folder in the package.
Support, Contact
----------------
You can report issues, ask questions or request new features on the [GitHub page]
(https://github.com/khalim19/gimp-plugin-export-layers/issues) or on the [GIMP
Plugin Registry page](http://registry.gimp.org/node/28268).
You can also contact me via email: khalim19 AT gmail DOT com