trunk/Identity/Brushes
======================

The trunk/Identity/Brushes directory exists to organize GIMP brushes used inside TCPCVI.

A brush is a pixmap or set of pixmaps used for painting through an image manipulation program like GIMP.  Inside the repository, brushes are initially created in .xcf format and later exported to any of the brush formats recognized by GIMP (e.g., .gbr or .gih) using the same name of its source file.

In order for brushes to be loaded by GIMP, they should be stored in the ~/.gimp-2.2/brushes directory. This location is out of TCAR and doesn't provide version control by itself. To be able of using version controlled brushes inside GIMP, we store brush related files inside trunk/Identity/Brushes directory and create links to them from ~/.gimp-2.2/brushes directory.

trunk/Identity/Brushes
|-- Corporate
|   `-- symbol.gbr (file) <-- ~/.gimp-2.2/brushes/corporate-symbol.gbr (link)
|-- TreeFlower
|   |-- flower.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-flower.gbr (link)
|   |-- branch.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-branch.gbr (link)
|   `-- trunk.gbr  (file) <-- ~/.gimp-2.2/brushes/treeflower-trunk.gbr  (link)
`-- Others
    `-- ...
Example: Relation between brushes inside the workstation.

The entire link preparation and maintainance of brushes inside the working copy is automated by prepare functionality of centos-art.sh script.

Inside the working copy, brushes might be created individually in different locations, but they all need to be linked from one unique location (i.e., ~/.gimp-2.2/brushes).  This configuration may provoke brush overlapping if a consistent name convenction is not implemented correctly.  In that sake, file names used for brushes are combined with the directories they are stored in order to build unique identifiers.

Brushes produced with GIMP has a description field associated that is shown in the Brushes panel of GIMP.  This description is set when the brush is created as .xcf file and can be updated when it is exported either to .gbr or .gih format. It wouldn't be too useful to have two or more brushes using the same description so, we also make description of brush files unique, too. In that sake, use the file name as description but without including the file extension (e.g., if we have the centos-flame-3.gbr brush, its description would be centos-flame-3).

More information about GIMP brushes can be found in The Gimp Manual (file:///usr/share/gimp/2.0/help/en/index.html), specifically in the section related to Brushes (file:///usr/share/gimp/2.0/help/en/gimp-concepts-brushes.html).