Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: orxonox.OLD/trunk/src/lib/graphics/text_engine/font.h @ 8261

Last change on this file since 8261 was 7450, checked in by bensch, 19 years ago

orxonox/trunk: added MultiLineText a Text for multiple line-input, that should automatically shilft position

File size: 3.4 KB
RevLine 
[4838]1/*!
[5343]2 * @file font.h
3 * brief Definition of the FONT-loading class
[5344]4 *
5 * !! IMPORTANT !! When using ttf fonts clear the license issues prior to
6 * adding them to orxonox. This is really important, because we do not want
7 * to offend anyone.
[5343]8 */
[1853]9
[5343]10#ifndef _FONT_H
11#define _FONT_H
[1853]12
[5768]13#include "texture.h"
[1853]14
[5343]15#include "glincl.h"
16
17
18#ifdef HAVE_SDL_TTF_H
19#include <SDL_ttf.h>
20#else
21#include <SDL/SDL_ttf.h>
22#endif
23
24/* some default values */
[5369]25#define FONT_NUM_COLORS              256           //!< number of colors.
[5343]26
[5369]27#define FONT_HIGHEST_KNOWN_CHAR      128           //!< The highest character known to the textEngine.
28#define FONT_DEFAULT_RENDER_SIZE     50            //!< At what Resolution to render fonts.
[4838]29// FORWARD DECLARATION
[3543]30
[5343]31//! A struct for handling glyphs
32/**
[5347]33 * a Glyph is one letter of a certain font
[5343]34 */
35struct Glyph
36{
37  // Glyph-specific (size and so on)
38  Uint16   character;         //!< The character
[5368]39  float    minX;              //!< The minimum distance from the origin in X
40  float    maxX;              //!< The maximum distance from the origin in X
41  float    minY;              //!< The minimum distance from the origin in Y
42  float    maxY;              //!< The maximum distance from the origin in Y
43  float    width;             //!< The width of the Glyph
44  float    height;            //!< The height of the Glyph
45  float    bearingX;          //!< How much is right of the Origin
46  float    bearingY;          //!< How much is above the Origin
47  float    advance;           //!< How big a Glyph would be in monospace-mode
[3543]48
[5367]49  GLfloat texCoord[4];        //!< Texture coordinates: 0:left, 1:right, 2: top, 3: bottom.
[5343]50};
[2036]51
[1853]52
[5347]53//! A class to handle a Font of a certain ttf-File/image-file, Size.
[5768]54class Font : public Texture
[5343]55{
56  public:
[7221]57    Font(const std::string& fontFile,
[5368]58         unsigned int renderSize);
[7221]59    Font(const std::string& imageFile);
[5343]60    Font(char** xpmArray);
61    virtual ~Font();
[3245]62
[5768]63  //  font
[7221]64    bool loadFontFromTTF(const std::string& fontFile);
[5343]65    bool loadFontFromSDL_Surface(SDL_Surface* surface);
66
[7221]67    void setStyle(const std::string& renderStyle);
[5343]68
69    /** @returns a Pointer to the Array of Glyphs */
70    inline Glyph** getGlyphArray() const { return this->glyphArray; };
[5767]71    /** @returns the a pointer to the TTF */
72    inline TTF_Font* getTTF() const { return this->fontTTF; };
[5343]73
[7450]74    int getMaxHeight() const;
75    int getMaxAscent() const;
76    int getMaxDescent() const;
77
[5768]78    /** @returns the default Font */
79    inline static Font* getDefaultFont() { if (Font::defaultFont == NULL) initDefaultFont(); return Font::defaultFont; };
80
[7221]81    void createAsciiImage(const std::string& fileName, unsigned int size) const;
[5343]82    static void initDefaultFont();
83    static void removeDefaultFont();
84
85  private:
[7449]86    void init();
[7430]87    bool getGlyphMetrics(Glyph* glyph, Uint16 character);
[5343]88
[5768]89    bool createFastTexture();
[5343]90
91    void initGlyphs(Uint16 from, Uint16 count);
92    int findOptimalFastTextureSize();
93
94    void debug();
95
96  private:
97    static Font*  defaultFont;         //!< a default font, that is used, if other fonts were unable to be loaded.
[5347]98    // information about the Font
[5368]99    TTF_Font*     fontTTF;             //!< The font we use for this.
[5343]100    int           renderStyle;         //!< The Renderstyle
[5368]101    unsigned int  renderSize;          //!< How big the Font should be rendered.
[5343]102
103    Glyph**       glyphArray;          //!< An Array of all the Glyphs stored in the Array of Glyphs.
[1853]104};
105
[5343]106#endif /* _FONT_H */
Note: See TracBrowser for help on using the repository browser.