include/vrvGraphics/DtFont.h

Go to the documentation of this file.

/******************************************************************************
** Copyright (c) 2010 MAK Technologies, Inc.
** All rights reserved.
******************************************************************************/


#pragma once

#include <vrvGraphics/vrvGraphics.h>
#include <vector>
#include <string>
#include <vrvGraphics/DtBoundingBox.h>
#include <vrvUtil/DtUnicode.h>

namespace makVrv
{
   class DtUnicode;
   class DtPen;
   class DtGlyph;
   class DtGlyphRenderer;
   class DtFontManager;

   class DT_DLL_VRVGRAPHICS DtFont
   {      
   public:

      enum TextAlignement
      {
         AlignLeft,
         AlignCenter,
         AlignRight,
         AlignJustify
      };

      ~DtFont();

      const std::string& fontName() const;

      bool attachFile(const char* fontFilePath);

      void setFreeTypeLoadFlags(unsigned int flags);

      bool setCharacterMap(unsigned int encoding);   

      const unsigned int* characterMaps();

      unsigned int characterMapCount() const;

      // Set the Character face size.
      bool setFaceSize(const unsigned int size);

      // Get the character face size.
      unsigned int faceSize() const;

      // Get the global ascender height for the face.
      float globalAscender() const;

      // Gets the global descender height for the face.
      float globalDescender() const;

      // Gets the line spacing for the font.
      float lineHeight() const;

      DtBoundingBox calculateBoundingBox(const DtPen& pen, 
         const DtUnicode& string, unsigned int pos = 0, int len = -1);

      DtPoint calculateGlyphSize(const DtPen& pen, 
         const DtUnicode& string, unsigned int pos = 0, int len = -1);

      // Get the advance for a string.
      float calculateAdvance(const DtPen& pen, const DtUnicode& string, 
         unsigned int pos = 0, int len = -1);

      // Render the string.
      void renderString(DtGlyphRenderer& renderer, DtPen& pen, 
         const DtUnicode& string, unsigned int pos = 0, int len = -1);

      // Render the string, with an allignment and a line width for wrapping.
      void renderString(DtGlyphRenderer& renderer, DtPen& pen, 
         TextAlignement alignment, unsigned int lineWidth,
         const DtUnicode& string, unsigned int pos = 0, int len = -1);

      // Release any font resources.
      void releaseResources();

      class FontPrivate;

   protected:

      friend class DtFontManager;

      DtFont(DtFontManager& fm, const std::string& fontFilePath);

   protected:

      FontPrivate* myImpl;
   };
}