@node Identity Brushes
@section @file{Identity/Brushes}
@cindex Identity brushes

The @file{Identity/Brushes} directory exists to organize GIMP
brushes used inside @value{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 @file{.xcf} format and later exported to any
of the brush formats recognized by GIMP (e.g., @file{.gbr} or
@file{.gih}) using the same name of its source file.

The @file{Identity/Brushes} directory is under version control.

The @file{Identity/Brushes} directory contains no file, but the
following organizational directories:

@c -- <[centos-art(SeeAlso)
@itemize
@end itemize
@c -- ]>

Content rendition inside @file{Identity/Brushes} directory is
not supported. 

In order for brushes to be loaded by GIMP, they should be stored in
the @file{~/.gimp-2.2/brushes} directory. This location is out of
@value{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 @file{Identity/Brushes} directory and
create links to them from @file{~/.gimp-2.2/brushes} directory.

@float Example,identity-brushes-1
@verbatim
Identity/Brushes
|-- Corporate
|   |-- symbol.xcf
|   `-- symbol.gbr (file) <-- ~/.gimp-2.2/brushes/corporate-symbol.gbr (link)
|-- TreeFlower
|   |-- flower.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-flower.gbr (link)
|   |-- flower.xcf
|   |-- branch.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-branch.gbr (link)
|   |-- branch.xcf
|   |-- trunk.gbr  (file) <-- ~/.gimp-2.2/brushes/treeflower-trunk.gbr  (link)
|   `-- trunk.xcf
`-- Others
    `-- ...
@end verbatim
@caption{Relation between brushes inside the workstation.}
@end float

The entire link preparation and maintenance of brushes inside the
working copy is automated by @code{prepare} functionality of
@command{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., @file{~/.gimp-2.2/brushes}).  This configuration may
provoke brushes to overlap one another if a consistent name convention
is not implemented correctly.  In that sake, the brushes file names
are build using their directory and file names as reference in order
to build unique names that can be used as 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 @file{.xcf} file and can be updated when it is
exported either to @file{.gbr} or @file{.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 @file{centos-flame-3.gbr} brush, its description
would be @code{centos-flame-3}).

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