Blame Manuals/Tcar-fs/en_US/Trunk/identity-brushes.texinfo

887153
@node Trunk Identity Brushes
ec1938
@section @file{trunk/Identity/Brushes}
74636e
@cindex Trunk identity brushes
887153
a6fcb1
The @file{trunk/Identity/Brushes} directory exists to organize GIMP
a6fcb1
brushes used inside @value{TCPCVI}. 
a6fcb1
a6fcb1
A brush is a pixmap or set of pixmaps used for painting through an
a6fcb1
image manipulation program like GIMP.  Inside the repository, we've
a6fcb1
organized brushes in @emph{common brushes} and @emph{theme-specific
a6fcb1
brushes}.  In both cases, brushes are initially created in @file{.xcf}
a6fcb1
format and later exported to any of the brush formats recognized by
a6fcb1
GIMP (e.g., @file{.gbr} or @file{.gih}) using the same name of its
a6fcb1
source file.
a6fcb1
a6fcb1
In order for brushes to be loaded by GIMP, they must be store
a6fcb1
@file{~/.gimp-2.2/brushes} directory. This location is out of
a6fcb1
@value{TCAR} and doesn't provide version control by itself. To be able
a6fcb1
of using version controlled brushes inside GIMP, we store brush
a6fcb1
related files inside @file{trunk/Identity/Brushes} directory and
a6fcb1
create links to them from @file{~/.gimp-2.2/brushes} directory.
a6fcb1
a6fcb1
@verbatim
a6fcb1
trunk/Identity/Brushes
a6fcb1
|-- Corporate
a6fcb1
|   `-- symbol.gbr   (file) <-- ~/.gimp-2.2/brushes/corporate-symbol.gbr (link)
a6fcb1
|-- TreeFlower
a6fcb1
|   |-- flower-1.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-flower-1.gbr (link)
a6fcb1
|   |-- branch-1.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-branch-1.gbr (link)
a6fcb1
|   |-- branch-2.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-branch-2.gbr (link)
a6fcb1
|   `-- trunk-1.gbr  (file) <-- ~/.gimp-2.2/brushes/treeflower-trunk-1.gbr  (link)
a6fcb1
`-- Others
a6fcb1
    `-- ...
a6fcb1
@end verbatim
a6fcb1
a6fcb1
The entire link preparation and maintainance of brushes inside the
a6fcb1
working copy is automated by @code{prepare} functionality of
a6fcb1
@command{centos-art.sh} script.
a6fcb1
a6fcb1
Inside the working copy, brushes might be created individually in
a6fcb1
different locations, but they all need to be linked from one unique
a6fcb1
location (i.e., @file{~/.gimp-2.2/brushes}).  This configuration may
a6fcb1
provoke brush overlapping if a consistent name convenction is not
a6fcb1
implemented correctly.  In that sake, file names used for brushes
a6fcb1
are combined with the directories they are stored in order to build
a6fcb1
unique identifiers.
a6fcb1
a6fcb1
Brushes produced with GIMP has a description field associated that is
a6fcb1
shown in the Brushes panel of GIMP.  This description is set when the
a6fcb1
brush is created as @file{.xcf} file and can be updated when it is
a6fcb1
exported either to @file{.gbr} or @file{.gih} format. It wouldn't be
a6fcb1
too useful to have two or more brushes using the same description so,
a6fcb1
we also make description of brush files unique, too. In that sake, use
a6fcb1
the file name as description but without including the file extension
a6fcb1
(e.g., if we have the @file{centos-flame-3.gbr} brush, its description
a6fcb1
would be @code{centos-flame-3}).
a6fcb1
a6fcb1
More information about GIMP brushes can be found in
a6fcb1
@url{file:///usr/share/gimp/2.0/help/en/index.html,The Gimp Manual},
a6fcb1
specifically in the section related to
a6fcb1
@url{file:///usr/share/gimp/2.0/help/en/gimp-concepts-brushes.html,
a6fcb1
Brushes}.