Blame Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/brushes.texinfo

4c9448
@node Identity Brushes
4c9448
@section @file{Identity/Brushes}
035705
@cindex Identity brushes
0dc09e
4c9448
The @file{Identity/Brushes} directory exists to organize GIMP
0dc09e
brushes used inside @value{TCPCVI}. 
0dc09e
0dc09e
A brush is a pixmap or set of pixmaps used for painting through an
0dc09e
image manipulation program like GIMP.  Inside the repository, brushes
0dc09e
are initially created in @file{.xcf} format and later exported to any
0dc09e
of the brush formats recognized by GIMP (e.g., @file{.gbr} or
0dc09e
@file{.gih}) using the same name of its source file.
0dc09e
4c9448
The @file{Identity/Brushes} directory is under version control.
0dc09e
4c9448
The @file{Identity/Brushes} directory contains no file, but the
0dc09e
following organizational directories:
0dc09e
0dc09e
@c -- <[centos-art(SeeAlso)
0dc09e
@itemize
0dc09e
@end itemize
0dc09e
@c -- ]>
0dc09e
4c9448
Content rendition inside @file{Identity/Brushes} directory is
0dc09e
not supported. 
0dc09e
0dc09e
In order for brushes to be loaded by GIMP, they should be stored in
0dc09e
the @file{~/.gimp-2.2/brushes} directory. This location is out of
0dc09e
@value{TCAR} and doesn't provide version control by itself. To be able
0dc09e
of using version controlled brushes inside GIMP, we store brush
4c9448
related files inside @file{Identity/Brushes} directory and
0dc09e
create links to them from @file{~/.gimp-2.2/brushes} directory.
0dc09e
035705
@float Example,identity-brushes-1
0dc09e
@verbatim
4c9448
Identity/Brushes
0dc09e
|-- Corporate
0dc09e
|   |-- symbol.xcf
0dc09e
|   `-- symbol.gbr (file) <-- ~/.gimp-2.2/brushes/corporate-symbol.gbr (link)
0dc09e
|-- TreeFlower
0dc09e
|   |-- flower.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-flower.gbr (link)
0dc09e
|   |-- flower.xcf
0dc09e
|   |-- branch.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-branch.gbr (link)
0dc09e
|   |-- branch.xcf
0dc09e
|   |-- trunk.gbr  (file) <-- ~/.gimp-2.2/brushes/treeflower-trunk.gbr  (link)
0dc09e
|   `-- trunk.xcf
0dc09e
`-- Others
0dc09e
    `-- ...
0dc09e
@end verbatim
0dc09e
@caption{Relation between brushes inside the workstation.}
0dc09e
@end float
0dc09e
035705
The entire link preparation and maintenance of brushes inside the
0dc09e
working copy is automated by @code{prepare} functionality of
0dc09e
@command{centos-art.sh} script.
0dc09e
0dc09e
Inside the working copy, brushes might be created individually in
0dc09e
different locations, but they all need to be linked from one unique
0dc09e
location (i.e., @file{~/.gimp-2.2/brushes}).  This configuration may
035705
provoke brushes to overlap one another if a consistent name convention
035705
is not implemented correctly.  In that sake, the brushes file names
035705
are build using their directory and file names as reference in order
035705
to build unique names that can be used as identifiers.
0dc09e
0dc09e
Brushes produced with GIMP has a description field associated that is
0dc09e
shown in the Brushes panel of GIMP.  This description is set when the
0dc09e
brush is created as @file{.xcf} file and can be updated when it is
0dc09e
exported either to @file{.gbr} or @file{.gih} format. It wouldn't be
0dc09e
too useful to have two or more brushes using the same description so,
0dc09e
we also make description of brush files unique, too. In that sake, use
0dc09e
the file name as description but without including the file extension
0dc09e
(e.g., if we have the @file{centos-flame-3.gbr} brush, its description
0dc09e
would be @code{centos-flame-3}).
0dc09e
0dc09e
More information about GIMP brushes can be found in
0dc09e
@url{file:///usr/share/gimp/2.0/help/en/index.html,The Gimp Manual},
0dc09e
specifically in the section related to
0dc09e
@url{file:///usr/share/gimp/2.0/help/en/gimp-concepts-brushes.html,
0dc09e
Brushes}.