蔡军生先生第二人生的源码分析(五十九)字体类LLFont的实现

最新推荐文章于 2023-10-15 23:37:33 发布

转载最新推荐文章于 2023-10-15 23:37:33 发布 · 675 阅读

本文介绍了第二人生游戏中使用的LLFont类，该类负责通过FreeType库加载和管理字体资源。主要内容包括初始化FreeType库、打开字体文件、设置字体大小、生成位图及纹理等。此外还详细说明了LLFont类的各种成员函数及其作用。

上面已经介绍到第二人生里是使用FreeType来显示字体的，因此需要使用一个类来封装这些操作，这类就叫做LLFont。在这个类里基本的任务，就是：

1）初始化FreeType的库。

2）打开字体文件。

3）设置字体每点或者每个像素的大小。

4）加载一个字符的笔画，并生成位图。

5）把位图数据生成RAW图片的格式。

6）最后变成纹理贴图让OpenGL输出。

在类LLFontManager里就已经调用函数FT_Init_FreeType来实始化FreeType库了，调用函数FT_Done_FreeType来删除FreeType库。

#001 class LLFont

#002 {

#003 public:

#004 LLFont(LLImageRaw *imagep = NULL);

#005 virtual ~LLFont();

#006

#007 // is_fallback should be true for fallback fonts that aren't used to render directly (Unicode backup, primarily)

下面函数实现打开字体文件，主要调用FT_New_Face函数来打开字体文件，然后调用函数FT_Set_Char_Size来设置字体点或像素大小。同时也创建LLImageRaw对象。

#008 virtual BOOL loadFace(const std::string& filename,

#009 const F32 point_size,

#010 const F32 vert_dpi,

#011 const F32 horz_dpi,

#012 const S32 components,

#013 BOOL is_fallback);

下面函数设置字体列表。

#014 void setFallbackFont(LLFontList *fontp) { mFallbackFontp = fontp; }

#015

#016 void setCharToGlyphMap(llwchar wch, U32 glyph_index) const;

下面函数设置字体生成的图片对象。

#017 void setRawImage( LLImageRaw *imagep );

#018

下面函数获取字体属性。

#019 // Global font metrics - in units of pixels

#020 virtual F32 getLineHeight() const;

#021 virtual F32 getAscenderHeight() const;

#022 virtual F32 getDescenderHeight() const;

#023

#024

#025 // For a lowercase "g":

#026 //

#027 // ------------------------------

#028 // ^ ^

#029 // | |

#030 // xxx x |Ascender

#031 // x x | |

#032 // --------- xxxx-------------- Baseline

#033 // ^ x | |

#034 // | descender x | |

#035 // v xxxx v |LineHeight

#036 // ----------------------- |

#037 // v

#038 // ------------------------------

#039

#040 enum

#041 {

#042 FIRST_CHAR = 32,

#043 NUM_CHARS = 127 - 32,

#044 LAST_CHAR_BASIC = 127,

#045

#046 // Need full 8-bit ascii range for spanish

#047 NUM_CHARS_FULL = 255 - 32,

#048 LAST_CHAR_FULL = 255

#049 };

#050

#051 const LLFontGlyphInfo &getMetrics(const llwchar wc) const;

#052 F32 getXAdvance(const llwchar wc) const;

#053 F32 getXKerning(const llwchar char_left, const llwchar char_right) const; // Get the kerning between the two characters

#054 protected:

#055 virtual BOOL hasGlyph(const llwchar wch) const; // Has a glyph for this character

下面函数添加一个字符到字体文件。

#056 virtual BOOL addChar(const llwchar wch); // Add a new character to the font if necessary

#057 virtual BOOL addGlyph(const llwchar wch, const U32 glyph_index); // Add a new glyph to the existing font

下面函数从一个字符生成RAW格式的位图对象。

#058 virtual BOOL addGlyphFromFont(LLFont *fontp, const llwchar wch, const U32 glyph_index); // Add a glyph from this font to the other (returns the glyph_index, 0 if

#059 not found)

#060

#061 virtual LLFontGlyphInfo* getGlyphInfo(const llwchar wch) const;

#062

#063 void insertGlyphInfo(llwchar wch, LLFontGlyphInfo* gi) const;

下面函数获取字体的位图。

#064 void renderGlyph(const U32 glyph_index);

#065

#066 void resetBitmap(); // Reset bitmap to contain only the null glyph

#067 protected:

#068 std::string mName;

#069 F32 mAscender;

#070 F32 mDescender;

#071 F32 mLineHeight;

#072

#073 S32 mNumComponents;

#074 S32 mBitmapWidth;

#075 S32 mBitmapHeight;

#076 S32 mMaxCharWidth;

#077 S32 mMaxCharHeight;

#078 S32 mCurrentOffsetX;

#079 S32 mCurrentOffsetY;

#080

#081 LLFT_Face mFTFace;

#082

#083 BOOL mIsFallback;

#084 LLFontList *mFallbackFontp; // A list of fallback fonts to look for glyphs in (for Unicode chars)

#085

#086 typedef std::map<llwchar, LLFontGlyphInfo*> char_glyph_info_map_t;

#087 mutable char_glyph_info_map_t mCharGlyphInfoMap; // Information about glyph location in bitmap

#088

#089 BOOL mValid;

#090 void setSubImageLuminanceAlpha(const U32 x,

#091 const U32 y,

#092 const U32 width,

#093 const U32 height,

#094 const U8 *data,

#095 S32 stride = 0);

#096

#097 private:

#098 LLPointer<LLImageRaw> mRawImagep; // Bitmaps of glyphs are stored here.

#099 };

尽管点阵字体在时间和空间性能上都有较佳的表现，但是由于缺乏灵活性，无法改变字体的大小和风格，除了在一些嵌入式设备中仍然在使用外，大多数系统都使用矢量字体了。矢量字体不像点阵字体那样直接记录字符的字模数据，而是记录字体描述信息，其中最重要的两部分是outline和hint。

标签

#character #fonts #components #string #basic