History: Gorilla

• «
• »

            {img fileId="2021" thumb="y" alt="" width="300" imalign="right" rel="box[g]"}
__Current Maintainer__: ((User:Betajaen))
__Project__: External OGRE Project
__Type__: OGRE Library
__License__: MIT
__Supported Platforms__: Windows / Linux / Mac OS X
__Sources__: [http://github.com/betajaen/gorilla|Github Repository] | [http://github.com/betajaen/gorilla/zipball/master|Direct Source Download]
__Status and bug reports__: [http://github.com/betajaen/gorilla|Github] | [http://www.ogre3d.org/forums/viewtopic.php?f=11&t=59984|OGRE Forum Topic]

---
Gorilla is a 2D drawing engine for Ogre, which can be projected into 3D space, or onto the screen as a 2D overlay, it comes in two files Gorilla.cpp and Gorilla.h. Gorilla is intended to substitute the Ogre overlay system, and to provide a good framework and basis for any Ogre programmer to build their HUD or GUI system upon.

!!Features

Gorilla is designed for speed, thus it uses Texture Atlases, Caching and tries to render everything in one batch. Gorilla screens can be either in an ((-overlay|overlay)) form (2D), or attached to a ((-SceneNode|SceneNode)) (3D).

Gorilla can draw the following types of shapes:

* Filled (Solid, Gradient or Sprite-based) Rectangles (Canvas Rectangles)
* Outlined Rectangles (Canvas Boxes)
* Lines with n-thickness (Canvas Lines)
* Sprites (SpriteLayer Sprites)
* Plain and formatted text (Canvas Captions and Text)

Gorilla only uses Ogre as a dependency, and is developed with Ogre 1.7 in mind; but should work with any 1.x version.

Gorilla is released under the MIT licence.

!!Eyecandy

{YOUTUBE(movie="http://www.youtube.com/watch?v=e78Hfo5rIyU",allowFullScreen="n")}{YOUTUBE}


!!Utility

__BFG (Bitmap Font Generator)__

The BFG (Bitmap Font Generator) was originally created by Calder (Author of QuickGUI). This modified version allows to create fonts ready for Gorilla as well as tighly pack multiple font in the same bitmap and .gorilla data file.

You can download both a Win32 binary exe, and the source from bitbucket: [https://bitbucket.org/c6burns/bfg]

The following command line arguments are available:
{CODE(wrap="1", colors="c++")}
-a <file> : specify an alphabet file. alphabet needs to be ASCII code ascending order.
-t <size> : Specify the output square texture size (ex: 256)
-f <format> : Specify the output data file format ("none", "quickgui", "gorilla")
-o <width> : Outline width. Leave to 0 for no outline
-i <intensity> : Intensity modifier
-c <color> : Main glyph color (ex: "0 1 0")
-C <color> : Outline color (ex: "0 1 1")
-s <size> : Font point size
<fontfile> : Specify input font file
{CODE}

A bitmap and data file containing a unique font can be generated like these two example:
{CODE(wrap="1", colors="c++")}
fontgen -i 2 -C "1 0 1" -o 3 -c "0 0 1" -f gorilla -s 24 segoepr.ttf
fontgen -c "0 0 1" -f gorilla -s 18 segoepr.ttf
{CODE}

In order to generate multiple font type/size packed in the same bitmap and data file, a first command line must be entered to instruct BFG that we will generate multiple font. The first command line requires only the following 2 arguments:
{CODE(wrap="1", colors="c++")}
fontgen -f gorilla -t 512
{CODE}

Once the first command line is entered, BFG will ask to enter each argument list for each font. Enter a final carriage return on empty line to finish and generate the file.
Here is some example font argument list:
{CODE(wrap="1", colors="c++")}
-o 2 -i 1 -s 18 -c "1 1 0" -C "1 0 0" segoepr.ttf
-o 1 -i 2 -s 24 -c "0 0 1" -C "1 0 1" carolingia.ttf
-o 2 -i 3 -s 36 -c "1 1 1" -C "0 0 0" courbd.ttf
{CODE}

Once you have your new generated PNG and gorilla files, just copy them to one of your Ogre3d resource directory and you are ready to use them in gorilla.