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
88355d
image manipulation program like GIMP.  Inside the repository, brushes
88355d
are initially created in @file{.xcf} format and later exported to any
88355d
of the brush formats recognized by GIMP (e.g., @file{.gbr} or
88355d
@file{.gih}) using the same name of its source file.
a6fcb1
e9fca7
The @file{trunk/Identity/Brushes} directory is under version control.
e9fca7
e9fca7
The @file{trunk/Identity/Brushes} directory contains no file, but the
e9fca7
following organizational directories:
e9fca7
e9fca7
@c -- <[centos-art(SeeAlso)
e9fca7
@itemize
2780c3
@item @ref{Trunk Identity Brushes Corporate}
e9fca7
@end itemize
e9fca7
@c -- ]>
e9fca7
e9fca7
Content rendition inside @file{trunk/Identity/Brushes} directory is
e9fca7
not supported. 
e9fca7
b4d413
In order for brushes to be loaded by GIMP, they should be stored in
b4d413
the @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
66126f
@float Example,trunk-identity-brushes-1
a6fcb1
@verbatim
a6fcb1
trunk/Identity/Brushes
a6fcb1
|-- Corporate
e9fca7
|   |-- symbol.xcf
a7804a
|   `-- symbol.gbr (file) <-- ~/.gimp-2.2/brushes/corporate-symbol.gbr (link)
a6fcb1
|-- TreeFlower
a7804a
|   |-- flower.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-flower.gbr (link)
e9fca7
|   |-- flower.xcf
a7804a
|   |-- branch.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-branch.gbr (link)
e9fca7
|   |-- branch.xcf
e9fca7
|   |-- trunk.gbr  (file) <-- ~/.gimp-2.2/brushes/treeflower-trunk.gbr  (link)
e9fca7
|   `-- trunk.xcf
a6fcb1
`-- Others
a6fcb1
    `-- ...
a6fcb1
@end verbatim
66126f
@caption{Relation between brushes inside the workstation.}
66126f
@end float
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
0a595e
provoke brushes to overlap one another if a consistent name
0a595e
convenction is not implemented correctly.  In that sake, the brushes
0a595e
file names are build using their directory and file names as reference
b415a4
in order to build unique names that can be used as 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}.