@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}.