| @node Trunk Identity Brushes |
| @section @file{trunk/Identity/Brushes} |
| @cindex Trunk identity brushes |
| |
| The @file{trunk/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{trunk/Identity/Brushes} directory is under version control. |
| |
| The @file{trunk/Identity/Brushes} directory contains no file, but the |
| following organizational directories: |
| |
| @c -- <[centos-art(SeeAlso) |
| @itemize |
| @end itemize |
| @c -- ]> |
| |
| Content rendition inside @file{trunk/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{trunk/Identity/Brushes} directory and |
| create links to them from @file{~/.gimp-2.2/brushes} directory. |
| |
| @float Example,trunk-identity-brushes-1 |
| @verbatim |
| trunk/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 maintainance 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 brush overlapping if a consistent name convenction is not |
| implemented correctly. In that sake, file names used for brushes |
| are combined with the directories they are stored in order to build |
| unique 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}. |