kc3-lang/ftgl/include/FTLayout.h

• Show log

  Commit

• Hash : d6a2d851
  Author :
  Date : 2008-04-13T21:14:44
  

  * Merged trunk commits [664], [665], [666], [667], [669], [670], [671], [672] and [684], by patrick and henry: + Added FTLayout.h, FTSimpleLayout.h and FTSimpleLayout.cpp to implement a framework for layout managers and an implementation of a simple layout manager. + Updated FTGLDemo to use the new FTSimpleLayout. Changes include: - Added a font origin to specify the location to render the font. - The default text is now blatantly plagarized from the back cover of the OGL red book. - The font size is much smaller. - Font metrics are rendered differently depending on the current layout manager. - The FTSimpleLayout alignment mode is now output with other font information. - The space bar no longer cycles through the fonts. The cursor up/down keys do. - The cursor left/right keys increment/decrement the size of the current font. - The page up/page down keys cycle through the layout managers. - The home/end keys increment and decrement the line length of a simple layout - The tab key cycles through the alignment modes of a simple layout. + Fixed a bug where the trackball rotation was applied after translation. + Minor reformatting and enabled texture fonts to be selected + Un-inlined private methods...because they are called by other private inlined methods + Minor formatting changes + Adding FTLayout

Download

• include/FTLayout.h

• #ifndef    __FTLayout__
  #define    __FTLayout__
  
  #include "FTGL.h"
  #include "FTPoint.h"
  #include "FTFont.h"
  
  /**
   * FTLayout is the interface for layout managers that render text.
   *
   * Specific layout manager classes are derived from this class. This class
   * is abstract and deriving classes must implement the protected
   * <code>Render</code> methods to render formatted text and 
   * <code>BBox</code> methods to determine the bounding box of output text.
   *
   * @see     FTFont
   */
  class FTGL_EXPORT FTLayout {
      public:        
          /**
           * Get the bounding box for a formatted string.
           *
           * @param string    a char string
           * @param llx       lower left near x coord
           * @param lly       lower left near y coord
           * @param llz       lower left near z coord
           * @param urx       upper right far x coord
           * @param ury       upper right far y coord
           * @param urz       upper right far z coord
           */
          virtual void BBox(const char* String,float& llx,float& lly,float& llz,float& urx,float& ury,float& urz) = 0;
  
          /**
           * Get the bounding box for a formatted string.
           *
           * @param string    a wchar_t string
           * @param llx       lower left near x coord
           * @param lly       lower left near y coord
           * @param llz       lower left near z coord
           * @param urx       upper right far x coord
           * @param ury       upper right far y coord
           * @param urz       upper right far z coord
           */
          virtual void BBox(const wchar_t* String,float& llx,float& lly,float& llz,float& urx,float& ury,float& urz) = 0;
              
          /**
           * Render a string of characters
           * 
           * @param string    'C' style string to be output.   
           */
          virtual void Render(const char *String) = 0;
  
          /**
           * Render a string of characters
           * 
           * @param string    wchar_t string to be output.     
           */
          virtual void Render(const wchar_t *String) = 0;
     protected:
          /**
           * Current pen or cursor position;
           */
          FTPoint pen;
  
          /**
           * Expose <code>FTFont::DoRender</code> method to derived classes.
           * 
           * @param font 		 The font that contains the glyph.
           * @param chr       current character
           * @param nextChr   next character
           * @see FTFont::DoRender
           */
          void DoRender(FTFont *font,const unsigned int chr,const unsigned int nextChr)
              { font->DoRender(chr,nextChr,pen); }
          
          /**
           * Expose <code>FTFont::CheckGlyph</code> method to derived classes.
           *
           * @param font The font that contains the glyph.
           * @param chr  character index
           */
          void CheckGlyph(FTFont *font,const unsigned int Chr)
              { font->CheckGlyph(Chr); }
              
           /**
            * Expose the FTFont <code>glyphList</code> to our derived classes.
            * 
            * @param font The font to perform the query on.
            * @param Char The character corresponding to the glyph to query.
            *
            * @return A pointer to the glyphList of font.
            */ 
           FTGlyphContainer *GetGlyphs(FTFont *font)
              { return(font->glyphList); }
              
           /** 
            * Expose the FTFont <code>charSize</code> to our derived classes.
            *
            * @param The font to perform the query on.
            *
            * @return A reference to the charSize object of font.
            */
           FTSize &GetCharSize(FTFont *font)
              { return(font->charSize); }
  }; /* class FTLayout */
  #endif  /* __FTLayout__ */
  
  

Download