FreeType2中文手册

《FreeType Glyph Conventions》中译版 

FreeType字形约定 

一、基本印刷概念 
1、字体文件、格式和信息 
字体是一组可以被显示和打印的多样的字符映像,在单个字体中共享一些共有的特性,包括外表、风格、衬线等。按印刷领域的说法,它必须区别一个字体 家族和多种字体外观,后者通常是从同样的模板而来,但是风格不同。例如,Palatino Regular 和 Palatino Italic是两种不同的外观,但是属于同样的家族Palatino。 

单个字体术语根据上下文既可以指家族也可指外观。例如,大多文字处理器的用户用字体指不同的字体家族,然而,大多这些家族根据它们的格式会通过多 个数据文件实现。对于 TrueType来讲,通常是每个外观一个文件(arial.ttf对应Arial Regular外观,ariali.ttf对应Arial Italic外观)这个文件也叫字体,但是实际上只是一个字体外观。 

数字字体是一个可以包含一个和多个字体外观的数据文件,它们每个都包含字符映像、字符度量,以及其他各种有关文本布局和特定字符编码的重要信息。 对有些难用的格式,像Adobe的Type1,一个字体外观由几个文件描述(一个包含字符映象,一个包含字符度量等)。在这里我们忽略这种情况,只考虑一 个外观一个文件的情况,不过在FT2.0中,能够处理多文件字体。 

为了方便说明,一个包含多个外观的字体文件我们叫做字体集合,这种情况不多见,但是多数亚洲字体都是如此,它们会包含两种或多种表现形式的映像,例如横向和纵向布局。 

2、字符映象和图 
字符映象叫做字形,根据书写、用法和上下文,单个字符能够有多个不同的映象,即多个字形。多个字符也可以有一个字形(例如Roman??)。字符 和字形之间的关系可能是非常复杂,本文不多述。而且,多数字体格式都使用不太难用的方案存储和访问字形。为了清晰的原因,当说明FT时,保持下面的观念 

* 一个字体文件包含一组字形,每个字形可以存成位图、向量表示或其他结构(更可缩放的格式使用一种数学表示和控制数据/程序的结合方式)。这些字形可以以任意顺序存在字体文件中,通常通过一个简单的字形索引访问。 

* 字体文件包含一个或多个表,叫做字符图,用来为某种字符编码将字符码转换成字形索引,例如ASCII、Unicode、Big5等等。单个字体文件可能包 含多个字符图,例如大多TrueType字体文件都会包含一个Apple特定的字符图和Unicode字符图,使它在Mac和Windows平台都可以使 用。 

3、字符和字体度量 
每个字符映象都关联多种度量,被用来在渲染文本时,描述如何放置和管理它们。在后面会有详述,它们和字形位置、光标步进和文本布局有关。它们在渲染一个文本串时计算文本流时非常重要。 

每个可缩放的字体格式也包含一些全局的度量,用概念单位表示,描述同一种外观的所有字形的一些特性,例如最大字形外框,字体的上行字符、下行字符和文本高度等。 

虽然这些度量也会存在于一些不可缩放格式,但它们只应用于一组指定字符维度和分辨率,并且通常用象素表示。 


二、字形轮廓 
1、象素、点和设备解析度 
当处理计算机图形程序时,指定象素的物理尺寸不是正方的。通常,输出设备是屏幕或打印机,在水平和垂直方向都有多种分辨率,当渲染文本是要注意这些情况。 

定义设备的分辨率通常使用用dpi(每英寸点(dot)数)表示的两个数,例如,一个打印机的分辨率为300x600dpi表示在水平方向,每英 寸有300 个象素,在垂直方向有600个象素。一个典型的计算机显示器根据它的大小,分辨率不同(15’’和17’’显示器对640x480象素大小不同),当然图 形模式分辨率也不一样。 

所以,文本的大小通常用点(point)表示,而不是用设备特定的象素。点是一种简单的物理单位,在数字印刷中,一点等于1/72英寸。例如,大多罗马书籍使用10到14点大小印刷文字内容。 

可以用点数大小来计算象素数,公式如下: 

象素数 = 点数*分辨率/72 

分辨率用dpi表示,因为水平和垂直分辨率可以不同,单个点数通常定义不同象素文本宽度和高度。 

2、向量表示 
字体轮廓的源格式是一组封闭的路径,叫做轮廓线。每个轮廓线划定字形的外部或内部区域,它们可以是线段或是Bezier曲线。 

曲线通过控制点定义,根据字体格式,可以是二次(conic Beziers)或三次(cubic Beziers)多项式。在文献中,conic Bezier通常称为quadratic Beziers。因此,轮廓中每个点都有一个标志表示它的类型是一般还是控制点,缩放这些点将缩放整个轮廓。 

每个字形最初的轮廓点放置在一个不可分割单元的网格中,点通常在字体文件中以16位整型网格坐标存储,网格的原点在(0,0),它的范围是-16384到-16383(虽然有的格式如Type1使用浮点型,但为简便起见,我们约定用整型分析)。 

网格的方向和传统数学二维平面一致,x轴从左到右,y轴从下到上。 

在创建字形轮廓时,一个字体设计者使用一个假想的正方形,叫做EM正方形。他可以想象成一个画字符的平面。正方形的大小,即它边长的网格单元是很重要的,原因是 

* 它是用来将轮廓缩放到指定文本尺寸的参考,例如在300x300dpi中的12pt大小对应12*300/72=50象素。从网格单元缩放到象素可以使用下面的公式 

象素数 = 点数 × 分辨率/72 
象素坐标= 网格坐标*象素数/EM大小 

* EM尺寸越大,可以达到更大的分辨率,例如一个极端的例子,一个4单元的EM,只有25个点位置,显然不够,通常TrueType字体之用2048单元的EM;Type1 PostScript字体有一个固定1000网格单元的EM,但是点坐标可以用浮点值表示。 

注意,字形可以自由超出EM正方形。网格单元通常交错字体单元或EM单元。上边的象素数并不是指实际字符的大小,而是EM正方形显示的大小,所以不同字体,虽然同样大小,但是它们的高度可能不同。 

3、Hinting和位图渲染 
存储在一个字体文件中的轮廓叫“主”轮廓,它的点坐标用字体单元表示,在它被转换成一个位图时,它必须缩放至指定大小。这通过一个简单的转换完成,但是总会产生一些不想要的副作用,例如像字母E和H,它们主干的宽度和高度会不相同。 

所以,优秀的字形渲染过程在缩放“点”是,需要通过一个网格对齐(grid-fitting)的操作(通常叫hinting),将它们对齐到目标 设备的象素网格。这主要目的之一是为了确保整个字体中,重要的宽度和高度能够一致。例如对于字符I和T来说,它们那个垂直笔划要保持同样象素宽度。另外, 它的目的还有管理如stem和overshoot的特性,这在小象素字体会引起一些问题。 

有若干种方式来处理网格对齐,多数可缩放格式中,每种字形轮廓都有一些控制数据和程序。 

* 显式网格对齐 

TrueType格式定义了一个基于栈的虚拟机(VM),可以借助多于200中操作码(大多是几何操作)来编写程序,每个字形都由一个轮廓和一个控制程序组成,后者可以处理实际的网格对齐,他由字体设计者定义。 

* 隐式网格对齐(也叫hinting) 

Type1格式有一个更简单的方式,每个字形由一个轮廓以及若干叫hints的片断组成,后者用来描述字形的某些重要特性,例如主干的存在、某些宽度匀称性等诸如此类。没有多少种hint,要看渲染器如何解释hint来产生一个对齐的轮廓。 

* 自动网格对齐 

有些格式很简单,没有包括控制信息,将字体度量如步进、宽度和高度分开。要靠渲染器来猜测轮廓的一些特性来实现得体的网格对齐。 

下面总结了每种方案的优点和缺点 

方案 优点 缺点 

显式 质量:对小字体有很好的结果,这对屏幕显示非常重要。 速度:如果程序很复杂,解释字节码很慢 
一致性:所有渲染器产生同样的字形位图。 大小:字形程序会很长。 
技术难度:编写优秀的hinting程序非常难,没有好的工具支持。 

隐式 大小:Hint通常比显式字形程序小的多 质量:小字体不好,最后结合反走样 
速度:网格对齐会非常快 不一致:不同渲染器结果不同,甚至同一引擎不同版本也不同。 

自动 大小:不需要控制信息,导致更小的字体文件 质量:小字体不好,最后结合反走样 
速度:依赖对齐算法,通常比显式对齐快。 速度:依赖算法 
不一致:不同渲染器结果不同,甚至同一引擎不同版本也不同。 


三、字形度量 
1、基线(baseline)、笔(pen)和布局(layout) 
基线是一个假想的线,用来在渲染文本时知道字形,它可以是水平(如Roman)和是垂直的(如中文)。而且,为了渲染文本,在基线上有一个虚拟的点,叫做笔位置(pen position)或原点(origin),他用来定位字形。 

每种布局使用不同的规约来放置字形: 

* 对水平布局,字形简单地搁在基线上,通过增加笔位置来渲染文本,既可以向右也可以向左增加。 

两个相邻笔位置之间的距离是根据字形不同的,叫做步进宽度(advance width)。注意这个值总是正数,即使是从右往左的方向排列字符,如Arabic。这和文本渲染的方式有些不同。 

笔位置总是放置在基线上。 


* 对垂直布局,字形在基线上居中放置: 


2、印刷度量和边界框 
在指定字体中,定义了多种外观度量。 

* 上行高度(ascent)。从基线到放置轮廓点最高/上的网格坐标,因为Y轴方向是向上的,所以它是一个正值。 

* 下行高度(descent)。从基线到放置轮廓点最低/下的网格坐标,因为Y轴方向是向上的,所以它是一个负值。 

* 行距(linegap)。两行文本间必须的距离,基线到基线的距离应该计算成 

上行高度 - 下行高度 + 行距 

* 边界框(bounding box,bbox)。这是一个假想的框子,他尽可能紧密的装入字形。通过四个值来表示,叫做xMin、yMin、xMax、yMax,对任何轮廓都可以计 算,它们可以是字体单元(测量原始轮廓)或者整型象素单元(测量已缩放的轮廓)。注意,如果不是为了网格对齐,你无需知道这个框子的这个值,只需知道它的 大小即可。但为了正确渲染一个对齐的字形,需要保存每个字形在基线上转换、放置的重要对齐。 

* 内部leading。这个概念从传统印刷业而来,他表示字形出了EM正方形空间数量,通常计算如下 

internal leading = ascent – descent – EM_size 

* 外部leading。行距的别名。 

3、跨距(bearing)和步进 
每个字形都有叫跨距和步进的距离,它们的定义是常量,但是它们的值依赖布局,同样的字形可以用来渲染横向或纵向文字。 

* 左跨距或bearingX。从当前笔位置到字形左bbox边界的水平距离,对水平布局是正数,对垂直布局大多是负值。 

* 上跨距或bearingY。从基线到bbox上边界的垂直距离,对水平布局是正值,对垂直布局是负值。 

* 步进宽度或advanceX。当处理文本渲染一个字形后,笔位置必须增加(从左向右)或减少(从右向左)的水平距离。对水平布局总是正值,垂直布局为null。 

* 步进高度或advanceY。当每个字形渲染后,笔位置必须减少的垂直距离。对水平布局为null,对垂直布局总是正值。 

* 字形宽度。字形的水平长度。对未缩放的字体坐标,它是bbox.xMax-bbox.xMin,对已缩放字形,它的计算要看特定情况,视乎不同的网格对齐而定。 

* 字形高度。字形的垂直长度。对未缩放的字体坐标,它是bbox.yMax-bbox.yMin,对已缩放字形,它的计算要看特定情况,视乎不同的网格对齐而定。 

* 右跨距。只用于水平布局,描述从bbox右边到步进宽度的距离,通常是一个非负值。 

advance_width – left_side_bearing – (xMax-xMin) 

下图是水平布局所有的度量 


下图是垂直布局的度量 


4、网格对齐的效果 
因为hinting将字形的控制点对齐到象素网格,这个过程将稍稍修改字符映象的尺寸,和简单的缩放有所区别。例如,小写字母m的映象在主网格中 有时是一个正方形,但是为了使它在小象素大小情况下可以辨别,hinting试图扩大它已缩放轮廓,以让它三条腿区分开来,这将导致一个更大的字符位图。 

字形度量也会受网格对齐过程的影响: 

* 映象的宽度和高度改变了,即使只是一个象素,对于小象素大小字形区别都很大; 

* 映象的边界框改变了,也改变了跨距; 

* 步进必须更改,例如如果被hint的位图比缩放的位图大时,必须增加步进宽度,来反映扩大的字形宽度。 

这有一些含义如下, 

* 因为hinting,简单缩放字体上行或下行高度可能不会有正确的结果,一个可能的方法时保持被缩放上行高度的顶和被缩放下行高度的底。 

* 没有容易的方法去hint一个范围内字形并步进它们宽度,因为hinting对每个轮廓工作都不一样。唯一的方法时单独hint每个字形,并记录返回值。有些格式,如TrueType,包含一些表对一些通用字符预先计算出它们的象素大小。 

* hinting依赖最终字符宽度和高度的象素值,意味着它非常依赖分辨率,这个特性使得正确的所见即所得布局非常难以实现。 

在FT 中,对字形轮廓处理2D变换很简单,但是对一个已hint的轮廓,需要注意专有地使用整型象素距离(意味着FT_Outline_Translate() 函数的参数应该都乘以64,因为点坐标都是26.6固定浮点格式),否则,变换将破坏hinter的工作,导致非常难看的位图。 

5、文本宽度和边界框 
如上所示,指定字形的原点对应基线上笔的位置,没有必要定位字形边界框的某个角,这不像多数典型的位图字体格式。有些情况,原点可以在边界框的外边,有时,也可以在里边,这要看给定的字形外形了。 

同样,字形的步进宽度是在布局时应用于笔位置的增量,而不是字形的宽度,那是字形边界的宽度。对文本串,具有相同的规约,这意味着: 

* 指定文本串的边界框没有必要包含文本光标,也不需要后边的字形放置在它的角上。 

* 字符串的步进宽度和它的边界框大小无关,特别时它在开始和最后包含空格或tab。 

* 最后,附加的处理如间距调整能够创建文本串,它的大小不直接依赖单独字形度量并列排列。例如,VA的步进宽度不是V和A各自的步进之和。 


四、字距调整 
字距调整这个术语指用来在一个文本串中调整重合字形的相对位置的特定信息。 

1、字距调整对 
字距调整包括根据相邻字形的轮廓修改它们之间的距离。例如T和y可以贴得更近一点,因为y的上缘正好在T的右上角一横的下边。 

当仅仅根据字形的标准宽度来布局文本,一些连续的字符看上去有点太挤和太松,例如下图中A和V的就显得距离太远。 


比较一下下图,同样的单词,A和V的距离拉近些 


可以看到,这个调整可以导致很大的区别。有的字体外观包含一个表,它包含文本布局所需的指定字形对的字距距离。 

* 这个对是顺序的,AV对的距离和VA对不一定一致; 

* 依据布局或书写,字距可以表示水平或垂直方向。 

* 字距表示成网格单元,它们通常是X轴方向的,意味着负值表示两个字形需要在水平方向放的更近一点。 

2、应用字距调整 
在渲染文本时应用字据调整是一个比较简单的过程,只需要在写下一个字形时,将缩放的字距加到笔位置即可。然而,正确的渲染器要考虑的更细一点。 

“滑动点”问题是一个很好的例子:很多字体外观包括一个大写字符(如T、F)和一个点.之间的字距调整,以将点正好放置在前者的主腿的右侧。 


根据字符的外形,有时候需要在点和随后的字符间作附加的调整,当应用“标准”的字距调整,上面的句子如下 


这显然太紧凑了。一个方案是,只在需要时滑动点,当然这需要对文本的意思有了解。如果当我们在渲染特定段落的最后一个点时,上面的调整就不适合了。这只是一个例子,还有很多其他例子显示一个真正的印刷工人需要恰当地布局文本。 

有一个很简单地算法,可以避免滑动点问题。 

1. 在基线上放置第一个字形; 
2. 将笔位置保存到pen1; 
3. 根据第一个和第二个字形的字距距离调整笔位置; 
4. 放置第二个字形,并计算下个笔位置,放到pen2; 
5. 如果pen1大于pen2,使用pen1作为下个笔位置,否则使用pen2。 


五、文本处理 
1、书写简单文本串 
在第一个例子中,我们将生成一个简单的Roman文字串,即采用水平的自左向右布局,使用专有的象素度量,这个过程如下: 

1. 将字符串转换成一系列字形索引; 
2. 将笔放置在光标位置; 
3. 获得或装入字形映象; 
4. 平移字形以使它的原点匹配笔位置; 
5. 将字形渲染到目标设备; 
6. 根据字形的步进象素增加笔位置; 
7. 对剩余的字形进行第三步; 
8. 当所有字形都处理了,在新的笔位置设置文本光标。 

注意字距调整不在这个算法中。 

2、子象素定位 
在渲染文本时使用子象素定位有时很有用。这非常重要,例如为了提供半所见即所得的文本布局,文本渲染的算法和上一节很相似,但是有些区别: 

* 笔位置表示成小数形式的象素; 
* 因为将一个已经hint过的轮廓平移一个非整型距离将破坏网格对齐,字形原点的位置在渲染字符映象前必须取整; 
* 步进宽度表示成小数形式的象素,没有必要是整型。 

这里是算法的改进版本: 

1. 将字符串转换成一系列字形索引; 
2. 将笔放置在光标位置,这可以是一个非整型点; 
3. 获得或装入字形映象; 
4. 平移字形以使它的原点匹配取整后的笔位置; 
5. 将字形渲染到目标设备; 
6. 根据字形的步进象素宽度增加笔位置,这个宽度可以是小数形式; 
7. 对剩余的字形进行第三步; 
8. 当所有字形都处理了,在新的笔位置设置文本光标。 

注意使用小数象素定位后,两个指定字符间的空间将不是固定的,它右先前的取整操作堆积的数决定。 

3、简单字距调整 
在基本文本渲染算法上增加字距调整非常简单,当一个字距调整对发现了,简单地在第4步前,将缩放后的调整距离增加到笔位置即可。淡然,这个距离在算法1需要被取整,算法2不必要。 

4、自右向左布局 
布局Arabic或Heberw文字的过程非常相似,区别只是在字形渲染前,笔位置需要减少(记住步进宽度总是正值) 

5、垂直布局 
布局垂直文字也是同样的过程,重要的区别如下: 

* 基线是垂直的,使用垂直的度量而不是水平度量; 
* 左跨距通常是负的,但字形原点必须在基线上; 
* 步进高度总是正值,所以笔位置必须减少以从上至下书写; 

6、所见即所得布局 


六、FT轮廓 
1、FT轮廓描述和结构 
a. 轮廓曲线分解 
一个轮廓是2D平面上一系列封闭的轮廓线。每个轮廓线由一系列线段和Bezier弧组成,根据文件格式不同,曲线可以是二次和三次多项式,前者叫quadratic或conic弧,它们在TrueType格式中用到,后者叫cubic弧,多数用于Type1格式。 

每条弧由一系列起点、终点和控制点描述,轮廓的每个点有一个特定的标记,表示它用来描述一个线段还是一条弧。这个标记可以有以下值: 

FT_Curve_Tag_On 当点在曲线上,这对应线段和弧的起点和终点。其他标记叫做“Off”点,即它不在轮廓线上,但是作为Bezier弧的控制点。 
FT_Curve_Tag_Conic 一个Off点,控制一个conic Bezier弧 
FT_Curve_Tag_Cubic 一个Off点,控制一个cubic Bezier弧 

下面的规则应用于将轮廓点分解成线段和弧 

* 两个相邻的“on”点表示一条线段; 
* 一个conic Off点在两个on点之间表示一个conic Bezier弧,off点是控制点,on点是起点和终点; 
* 两个相邻的cubic off点在两个on点之间表示一个cubic Bezier弧,它必须有两个cubic控制点和两个on点。 
* 最后,两个相邻的conic off点强制??在它们正中间创建一个虚拟的on点。这大大方便定义连续的conic弧。TrueType规范就是这么定义的。 

注意,在单个轮廓线中可以混合使用conic和cubic弧,不过现在没有那种字体驱动产生这样的轮廓。 



b. 轮廓描述符 
FT轮廓通过一个简单的结构描述 

FT_Outline 
n_points 轮廓中的点数 
n_contours 轮廓中轮廓线数 
points 点坐标数组 
contours 轮廓线端点索引数组 
tags 点标记数组 

这里,points是一个FT_Vector记录数组的指针,用来存储每个轮廓点的向量坐标。它表示为一个象素1/64,也叫做26.6固定浮点格式。 

contours是一组点索引,用来划定轮廓的轮廓线。例如,第一个轮廓线总是从0点开始,以contours[0]点结束。第二个轮廓线从contours[0]+1点开始,以contours[1]结束,等等。 

注意,每条轮廓线都是封闭的,n_points应该和contours[n_controus-1]+1相同。最后,tags是一组字节,用来存放每个轮廓的点标记。 

2、边界和控制框计算 
边界框(bbox)是一个完全包含指定轮廓的矩形,所要的是最小的边界框。因为弧的定义,bezier的控制点无需包含在轮廓的边界框中。例如轮 廓的上缘是一个Bezier弧,一个off点就位于bbox的上面。不过这在字符轮廓中很少出现,因为大多字体设计者和创建工具都会在每个曲线拐点处放一 个on点,这会使hinting更加容易。于是我们定义了控制框(cbox),它是一个包含轮廓所有点的最小矩形,很明显,它包含bbox,通常它们是一 样的。不想 bbox,cbox计算起来非常快。 


控制框和边界框可以通过函数FT_Outline_Get_CBox()和 FT_Outline_Get_BBox()自动计算,前者总是非常快,后者在有外界控制点的情况下会慢一点,因为需要找到conic和cubic弧的末 端,如果不是这种情况,它和计算控制框一样快。 

注意,虽然大多字形轮廓为易于hint具有相同的cbox和bbox,这在它们进行变换以后,如旋转,就不再是这种情况了。 

3、坐标、缩放和网格对齐 
轮廓点的向量坐标表示为26.6格式,即一个象素的1/64。因此,坐标(1.0,-2.5)存放整型对(x:64,y:-192)。 

在主字形轮廓从EM网格缩放到当前字符大小后,hinter负责对齐重要的轮廓点到象素网格。虽然这个过程很难几句话说清楚,但是它的目的也就是取整点的位置,以保持字形重要的特性,如宽度、主干等。下面的操作可以用来将26.6格式的向量距离取整到网格: 

round(x) == (x + 32) & -64 
floor(x) == x & -64 
ceiling(x) == (x + 63) & -64 

一旦一个字形轮廓经过对齐或变换,在渲染之前通常要计算字形的映象象素大小。做到这一点,必须考虑如下: 

扫描线转换器画出所有中心在字形形状中的象素,他也可以检测drop-outs??? 

这导致如下的计算: 

* 计算bbox; 
* 对齐bbox如下: 
xmin = floor(bbox.xMin) 
xmax = ceiling(bbox.xMax) 
ymin = floor(bbox.yMin) 
ymax = ceiling(bbox.yMax) 
* 返回象素尺寸,即 
width = (xmax-xmin) / 64 
和 
height = (ymax-ymin) / 64 

通过对齐bbox,可以保证所有的象素中心将画到,包括那些从drop-out控制来的,将在调整后的框子之中。接着,框子的象素尺寸可以计算出来。 

同时注意,当平移一个对齐的轮廓,应该总是使用整型距离来移动。否则,字形的边缘将不再对齐象素网格,hinter的工作将无效,产生非常难看的位图。 


七、FT位图 
1、向量坐标和象素坐标对比 
这里阐述了向量坐标的象素坐标的区别,为了更清楚的说明,使用方括号来表示象素坐标,使用圆括号表示向量坐标。 

在象素坐标中,我们使用Y轴向上的规约,坐标[0,0]总是指位图左下角象素,坐标[width-1, rows-1]是右上角象素。在向量坐标中,点坐标用浮点单位表示,如(1.25, -2.3),这个位置并不是指一个特定象素,而是在2D平面上一个非实质性的点。 

象素其实在2D平面上是一个方块,它的中心是象素坐标值的一半,例如位图的左下角象素通过方块(0,0)-(1,1)界定,它的中心位于 (0.5,0.5)。注意这儿用的是向量坐标表示。这对计算距离就会发生一些区别。例如,[0,0]-[10.0]一条线的象素长度是11,然而, (0,0)-(10,0)的向量程度覆盖了10个象素,因此它的长度是10。 


2、FT位图和象素图描述符 
一个位图和象素图通过一个叫FT_Bitmap的单一结构描述,他定义在<freetype/ftimage.h>中,属性如下 

FT_Bitmap 
rows 行数,即位图中的水平线数 
width 位图的水平象素数 
pitch 它的绝对值是位图每行占的字节数,根据位图向量方向,可以是正值或是负值 
buffer 一个指向位图象素缓冲的无类型指针 
pixel_mode 一个枚举值,用来表示位图的象素格式;例如ft_pixel_mode_mono表示1位单色位图,ft_pixel_mode_grays表示8位反走样灰度值 
num_grays 这只用于灰度象素模式,它给出描述反走样灰度级别的级数,FT缺省值为255。 

pitch 属性值的正负符号确定象素缓冲中的行是升序还是降序存放。上面说道FT在2D平面上使用Y轴向上的规约,这意味着(0,0)总是指向位图的左下角。如果 picth是正值,按照向量减少的方向存储行,即象素缓冲的第一个字节表示位图最上一行的部分。如果是负值,第一个字节将表示位图最下一行的部分。对所有 的情况,pitch可以看作是在指定位图缓冲中,跳到下一个扫描行的字节增量。 


通常都使用正pitch,当然有的系统会使用负值。 

3、轮廓转换到位图和象素图 
使用FT从一个向量映象转换到位图和象素图非常简单,但是,在转换前,必须理解有关在2D平面上放置轮廓的一些问题: 

* 字形转载器和hinter在2D平面上放置轮廓时,总将(0,0)匹配到字符原点,这意味着字形轮廓,及对应的边界框,可以在平面中放置于任何地方。 

* 目标位图映射到2D平面上,左下角在(0,0)上,这就是说一个[w,h]大小的位图和象素图将被映射到(0,0)-(w,h)界定的2D矩形窗口。 

* 当扫描转换轮廓,所有在这个位图窗口的部分将被渲染,其他的被忽略。 

很多使用FT的开发者都会有个误解,认为一个装入的轮廓可以直接渲染成一个适当大小的位图,下面的图像表明这个问题。 

* 第一个图表明一个2D平面上一个装入的轮廓; 

* 第二个表示一个任意大小[w,h]维护的目标窗口; 

* 第三个表示在2D平面上轮廓和窗口的合并; 

* 最后一个表示位图实际被渲染的部分。 


实际上,几乎所有的情况,装入或变换过的轮廓必须在渲染成目标位图之前作平移操作,以调整到相对目标窗口的位置。 

例如,创建一个单独的字形位图正确的方法如下: 

* 计算字形位图的大小,可以直接从字形度量计算出来,或者计算它的边界框(这在经过变换后非常有用,此时字形度量不再有效)。 

* 根据计算的大小创建位图,别忘了用背景色填充象素缓冲; 

* 平移轮廓,使左下角匹配到(0,0)。别忘了为了hinting,应该使用整型。通常,这就是说平移一个向量(-ROUND(xMin), -ROUND(yMin))。 

* 调用渲染功能,例如FT_Outline_Render()函数。 

在将字形映象直接写入一个大位图的情况,轮廓必须经过平移,以将它们的向量位置对应到当前文本光标/字符原点上。 
----
良好的沟通能力 和 积极的行动 是成功的钥匙。
[Original] [Print] [Top]
Subject[精华] Re: FreeType 2开发文档 [中译版] 
Authorgogoliu    Posted2006-01-23 19:14    Length15,143 byte(s)
[Original] [Print] [Top]
《The design of FreeType 2》中译版 

FreeType 2的设计 

介绍 
这份文档提供了FreeType 2函数库设计与实现的细节。本文档的目标是让开发人员更好的理解FreeType 2是如何组织的,并让他们扩充、定制和调试它。 
首先,我们先了解这个库的目的,也就是说,为什么会写这个库: 
* 它让客户应用程序方便的访问字体文件,无论字体文件存储在哪里,并且与字体格式无关。
* 方便的提取全局字体数据,这些数据在平常的字体格式中普遍存在。(例如:全局度量标准,字符编码/字符映射表,等等) 
* 方便的提取某个字符的字形数据(度量标准,图像,名字,其他任何东西) 
* 访问字体格式特定的功能(例如,SFNT表,多重控制,OpenType轮廓表) 
Freetype 2的设计也受如下要求很大的影响: 
* 高可移植性。这个库必须可以运行在任何环境中。这个要求引入了一些非常激烈的选择,这些是FreeType2的低级系统界面的一部分。 
* 可扩展性。新特性应该可以在极少改动库基础代码的前提下添加。这个要求引入了非常简单的设计:几乎所有操作都是以模块的形式提供的。 
* 可定制。它应该能够很容易建立一个只包含某个特定项目所需的特性的版本。当你需要集成它到一个嵌入式图形库的字体服务器中时,这是非常重要的。 
* 简洁高效。这个库的主要目标是只有很少cpu和内存资源的嵌入式系统。 
这份文档的其他部分分为几个部分。首先,一些章节介绍了库的基本设计以及Freetype 2内部对象/数据的管理。 
接下来的章节专注于库的定制和与这个话题相关的系统特定的界面,如何写你自己的模块和如何按需裁减库初始化和编译。 


一、组件和API 
FT可以看作是一组组件,每个组件负责一部分任务,它们包括 

* 客户应用程序一般会调用FT高层API,它的功能都在一个组件中,叫做基础层。 
* 根据上下文和环境,基础层会调用一个或多个模块进行工作,大多数情况下,客户应用程序不知道使用那个模块。 
* 基础层还包含一组例程来进行一些共通处理,例如内存分配,列表处理、io流解析、固定点计算等等,这些函数可以被模块随意调用,它们形成了一个底层基础API。 

如下图,表明它们的关系 


另外, 

* 为了一些特殊的构建,基础层的有些部分可以替换掉,也可以看作组件。例如ftsystem组件,负责实现内存管理和输入流访问,还有ftinit,负责库初始化。 
* FT还有一些可选的组件,可以根据客户端应用灵活使用,例如ftglyph组件提供一个简单的API来管理字形映象,而不依赖它们内部表示法。或者是访问特定格式的特性,例如ftmm组件用来访问和管理Type1字体中Multiple Masters数据。 
* 最后,一个模块可以调用其他模块提供的函数,这对在多个字体驱动模块中共享代码和表非常有用,例如truetype和cff模块都使用sfnt模块提供的函数。 

见下图,是对上图的一个细化。 


请注意一些要点: 

* 一个可选的组件可以用在高层API,也可以用在底层API,例如上面的ftglyph; 
* 有些可选组件使用模块特定的接口,而不是基础层的接口,上例中,ftmm直接访问Type1模块来访问数据; 
* 一个可替代的组件能够提供一个高层API的函数,例如,ftinit提供FT_Init_FreeType() 


二、公共对象和类 


1、FT中的面向对象 
虽然FT是使用ANSI C编写,但是采用面向对象的思想,是这个库非常容易扩展,因此,下面有一些代码规约。 

1. 每个对象类型/类都有一个对应的结构类型和一个对应的结构指针类型,后者称为类型/类的句柄类型 

设想我们需要管理FT中一个foo类的对象,可以定义如下 

typedef struct FT_FooRec_* FT_Foo; 

typedef struct FT_FooRec_ 



// fields for the foo class 

… 

}FT_FooRec; 

依照规约,句柄类型使用简单而有含义的标识符,并以FT_开始,如FT_Foo,而结构体使用相同的名称但是加上Rec后缀。Rec是记录的缩写。每个类类型都有对应的句柄类型; 

2. 类继承通过将基类包装到一个新类中实现,例如,我们定义一个foobar类,从foo类继承,可以实现为 

typedef struct FT_FooBarRec_ * FT_FooBar; 

typedef struct FT_FooBarRec_ 

FT_FooRec root; //基类 

}FT_FooBarRec; 

可以看到,将一个FT_FooRec放在FT_FooBarRec定义的开始,并约定名为root,可以确保一个foobar对象也是一个foo对象。 

在实际使用中,可以进行类型转换。 

后面 

2、FT_Library类 
这个类型对应一个库的单一实例句柄,没有定义相应的FT_LibraryRec,使客户应用无法访问它的内部属性。 

库对象是所有FT其他对象的父亲,你需要在做任何事情前创建一个新的库实例,销毁它时会自动销毁他所有的孩子,如face和module等。 

通常客户程序应该调用FT_Init_FreeType()来创建新的库对象,准备作其他操作时使用。 

另一个方式是通过调用函数FT_New_Library()来创建一个新的库对象,它在<freetype/ftmodule.h>中定义,这个函数返回一个空的库,没有任何模块注册,你可以通过调用FT_Add_Module()来安装模块。 

调用FT_Init_FreeType()更方便一些,因为他会缺省地注册一些模块。这个方式中,模块列表在构建时动态计算,并依赖ftinit部件的内 容。(见ftinit.c[l73]行,include FT_CONFIG_MODULES_H,其实就是包含ftmodule.h,在ftmodule.h中定义缺省的模块,所以模块数组 ft_default_modules的大小是在编译时动态确定的。) 

3、FT_Face类 
一个外观对象对应单个字体外观,即一个特定风格的特定外观类型,例如Arial和Arial Italic是两个不同的外观。 

一个外观对象通常使用FT_New_Face()来创建,这个函数接受如下参数:一个FT_Library句柄,一个表示字体文件的C文件路径名,一个决定从文件中装载外观的索引(一个文件中可能有不同的外观),和FT_Face句柄的地址,它返回一个错误码。 

FT_Error FT_New_Face( FT_Library library, 
const char* filepathname, 
FT_Long face_index, 
FT_Face* face); 

函数调用成功,返回0,face参数将被设置成一个非NULL值。 

外观对象包含一些用来描述全局字体数据的属性,可以被客户程序直接访问。例如外观中字形的数量、外观家族的名称、风格名称、EM大小等,详见FT_FaceRec定义。 

4、FT_Size类 
每个FT_Face对象都有一个或多个FT_Size对象,一个尺寸对象用来存放指定字符宽度和高度的特定数据,每个新创建的外观对象有一个尺寸,可以通过face->size直接访问。 

尺寸对象的内容可以通过调用FT_Set_Pixel_Sizes()或FT_Set_Char_Size()来改变。 

一个新的尺寸对象可以通过FT_New_Size()创建,通过FT_Done_Size()销毁,一般客户程序无需做这一步,它们通常可以使用每个FT_Face缺省提供的尺寸对象。 

FT_Size 公共属性定义在FT_SizeRec中,但是需要注意的是有些字体驱动定义它们自己的FT_Size的子类,以存储重要的内部数据,在每次字符大小改变时 计算。大多数情况下,它们是尺寸特定的字体hint。例如,TrueType驱动存储CVT表,通过cvt程序执行将结果放入TT_Size结构体中,而 Type1驱动将scaled global metrics放在T1_Size对象中。 

5、FT_GlyphSlot类 
字形槽的目的是提供一个地方,可以很容易地一个个地装入字形映象,而不管它的格式(位图、向量轮廓或其他)。理想的,一旦一个字形槽创建了,任何字形映象 可以装入,无需其他的内存分配。在实际中,只对于特定格式才如此,像TrueType,它显式地提供数据来计算一个槽地最大尺寸。 

另一个字形槽地原因是他用来为指定字形保存格式特定的hint,以及其他为正确装入字形的必要数据。 

基本的FT_GlyphSlotRec结构体只向客户程序展现了字形metics和映象,而真正的实现回包含更多的数据。 

例如,TrueType特定的TT_GlyphSlotRec结构包含附加的属性,存放字形特定的字节码、在hint过程中暂时的轮廓和其他一些东西。 

最后,每个外观对象有一个单一字形槽,可以用face->glyph直接访问。 

6、FT_CharMap类 
FT_CharMap类型用来作为一个字符地图对象的句柄,一个字符图是一种表或字典,用来将字符码从某种编码转换成字体的字形索引。 

单个外观可能包含若干字符图,每个对应一个指定的字符指令系统,例如Unicode、Apple Roman、Windows codepages等等。 

每个FT_CharMap对象包含一个platform和encoding属性,用来标识它对应的字符指令系统。每个字体格式都提供它们自己的FT_CharMapRec的继承类型并实现它们。 

7、对象关系 


三、内部对象和类 
1、内存管理 
所有内存管理操作通过基础层中3个特定例程完成,叫做FT_Alloc、FT_Realloc、 FT_Free,每个函数需要一个 FT_Memory句柄作为它的第一个参数。它是一个用来描述当前内存池/管理器对象的指针。在库初始化时,在FT_Init_FreeType中调用函 数FT_New_Memory创建一个内存管理器,这个函数位于ftsystem部件当中。 

缺省情况下,这个管理器使用ANSI malloc、realloc和free函数,不过ftsystem是基础层中一个可替换的部分,库的特定构建可以提供不同的内存管理器。即使使用缺省的 版本,客户程序仍然可以提供自己的内存管理器,通过如下的步骤,调用FT_Init_FreeType实现: 

1. 手工创建一个FT_Memory对象,FT_MemoryRec位于公共文件<freetype/ftsystem.h>中。

2. 使用你自己的内存管理器,调用FT_New_Library()创建一个新的库实例。新的库没有包含任何已注册的模块。 

3. 通过调用函数FT_Add_Default_Modules()(在ftinit部件中)注册缺省的模块,或者通过反复调用FT_Add_Module手工注册你的驱动。 

2、输入流 
字体文件总是通过FT_Stream对象读取,FT_StreamRec的定义位于公共文 件<freetype/ftsystem.h>中,可以允许客户开发者提供自己的流实现。FT_New_Face()函数会自动根据他第二个 参数,一个C路径名创建一个新的流对象。它通过调用由 ftsystem部件提供的FT_New_Stream()完成,后者时可替换的,在不同平台上,流的实现可能大不一样。 

举例来说,流的缺省实现位于文件src/base/ftsystem.c并使用ANSI fopen/fseek和fread函数。不过在FT2的Unix版本中,提供了另一个使用内存映射文件的实现,对于主机系统来说,可以大大提高速度。 

FT区分基于内存和基于磁盘的流,对于前者,所有数据在内存直接访问(例如ROM、只写静态数据和内存映射文件),而后者,使用帧(frame)的概念从字体文件中读出一部分,使用典型的seek/read操作并暂时缓冲。 

FT_New_Memory_Face 函数可以用来直接从内存中可读取的数据创建/打开一个FT_Face对象。最后,如果需要客户输入流,客户程序能够使用FT_Open_Face()函数 接受客户输入流。这在压缩或远程字体文件的情况下,以及从特定文档抽取嵌入式字体文件非常有用。 

注意每个外观拥有一个流,并且通过FT_Done_Face被销毁。总的来说,保持多个FT_Face在打开状态不是一个很好的主意。 

3、模块 
FT2 模块本身是一段代码,库调用FT_Add_Moudle()函数注册模块,并为每个模块创建了一个FT_Module对象。FT_ModuleRec的定 义对客户程序不是公开的,但是每个模块类型通过一个简单的公共结构FT_Module_Class描述,它定义在< freetype/ftmodule.h>中,后面将详述。 

当调用FT_Add_Module是,需要指定一个FT_Module_Class结构的指针,它的声明如下: 

FT_Error FT_Add_Module( FT_Library library, 

const FT_Module_Class* clazz); 

调用这个函数将作如下操作: 

* 检查库中是否已经有对应FT_Module_Class指名的模块对象; 

* 如果是,比较模块的版本号看是否可以升级,如果模块类的版本号小于已装入的模块,函数立即返回。当然,还要检查正在运行的FT版本是否满足待装模块所需FT的版本。 

* 创建一个新的FT_Module对象,使用模块类的数据的标志决定它的大小和如何初始化; 

* 如果在模块类中有一个模块初始器,它将被调用完成模块对象的初始化; 

* 新的模块加入到库的“已注册”模块列表中,对升级的情况,先前的模块对象只要简单的销毁。 

注意这个函数并不返回FT_Module句柄,它完全是库内部的事情,客户程序不应该摆弄他。最后,要知道FT2识别和管理若干种模块,这在后面将有详述,这里列举如下: 

* 渲染器模块用来将原始字形映象转换成位图或象素图。FT2自带两个渲染器,一个是生成单色位图,另一个生成高质量反走样的象素图。 

* 字体驱动模块用来支持多种字体格式,典型的字体驱动需要提供特定的FT_Face、FT_Size、FT_GlyphSlot和FT_CharMap的实现; 

* 助手模块被多个字体驱动共享,例如sfnt模块分析和管理基于SFNT字体格式的表,用于TrueType和OpenType字体驱动; 

* 最后,auto-hinter模块在库设计中有特殊位置,它不管原始字体格式,处理向量字形轮廓,使之产生优质效果。 

注意每个FT_Face对象依据原始字体文件格式,都属于相应的字体驱动。这就是说,当一个模块从一个库实例移除/取消注册后,所有的外观对象都被销毁(通常是调用FT_Remove_Module()函数)。 

因此,你要注意当你升级或移除一个模块时,没有打开FT_Face对象,因为这会导致不预期的对象删除。 

4、库 
现在来说说FT_Library对象,如上所述,一个库实例至少包含如下: 

* 一个内存管理对象(FT_Memory),用来在实例中分配、释放内存; 

* 一个FT_Module对象列表,对应“已安装”或“已注册”的模块,它可以随时通过FT_Add_Module()和FT_Remove_Module()管理; 

* 记住外观对象属于字体驱动,字体驱动模块属于库。 

还有一个对象属于库实例,但仍未提到:raster pool 

光栅池是一个固定大小的一块内存,为一些内存需要大的操作作为内部的“草稿区域”,避免内存分配。例如,它用在每个渲染器转换一个向量字形轮廓到一个位图时(这其实就是它为何叫光栅池的原因)。 

光栅池的大小在初始化的时候定下来的(缺省为16k字节),运行期不能修改。当一个瞬时操作需要的内存超出这个池的大小,可以另外分配一块作为例外条件,或者是递归细分任务,以确保不会超出池的极限。 

这种极度的内存保守行为是为了FT的性能考虑,特别在某些地方,如字形渲染、扫描线转换等。 

5、总结 
最后,下图展示的上面所述内容,他表示FT基本设计的对象图 


四、模块类 

在FT中有若干种模块 

* 渲染模块,用来管理可缩放的字形映象。这意味这转换它们、计算边框、并将它们转换成单色和反走样位图。FT可以处理任何类型的字形映像,只要为它提供了一个渲染模块,FT缺省带了两个渲染器 

raster 支持从向量轮廓(由FT_Outline对象描述)到单色位图的转换 

smooth 支持同样的轮廓转换到高质量反走样的象素图,使用256级灰度。这个渲染器也支持直接生成span。 

* 字体驱动模块,用来支持一种或多种特定字体格式,缺省情况下,FT由下列字体驱动 

truetype 支持TrueType字体文件 

type1 支持PostScript Type1字体,可以是二进制(.pfb)和ASCII(.pfa)格式,包括Multiple Master字体 

cid 支持Postscript CID-keyed字体 

cff 支持OpenType、CFF和CEF字体(CEF是CFF的一个变种,在Adobe的SVG Viewer中使用 

winfonts 支持Windows位图字体,.fon和.fnt 


字体驱动可以支持位图和可缩放的字形映象,一个特定支持Bezier轮廓的字体驱动通过FT_Outline可以提供他自己的hinter,或依赖FT的autohinter模块。 

* 助手模块,用来处理一些共享代码,通常被多个字体驱动,甚至是其他模块使用,缺省的助手如下 

sfnt 用来支持基于SFNT存储纲要的字体格式,TrueType和OpenType字体和其他变种 

psnames 用来提供有关字形名称排序和Postscript编码/字符集的函数。例如他可以从一个Type1字形名称字典中自动合成一个Unicode字符图。 

psaux 用来提供有关Type1字符解码的函数,type1、cid和cff都需要这个特性 


* 最后,autohinter模块在FT中是特殊角色,当一个字体驱动没有提供自己的hint引擎时,他可以在字形装载时处理各自的字形轮廓。 

我们现在来学习模块是如何描述以及如何被FreeType2库管理的。 
1 FT_Module_Class结构 


2 FT_Module类型 

----
良好的沟通能力 和 积极的行动 是成功的钥匙。
[Original] [Print] [Top]
Subject[精华] FreeType 2开发文档 [中译版] 
Authorgogoliu    Posted2006-01-23 19:18    Length492 byte(s)
[Original] [Print] [Top]
下面3份文档是FreeType 2文档的 中译版,包括《FreeType Glyph Conventions》、《The design of FreeType 2》、和《The FreeType 2 Tutorial》。其中,前两者是在网上找到的,译者不详,并且有些部分没有翻译。我翻译了第三份文档的第一部分,由于翻译水平低,翻译得很死板、机 械,大家凑合着看。第二部分要是没人翻译的话,我会在年后翻译。这3份文档的中译版都有待完善,希望有空余时间和能力的朋友可以帮忙完善它们。
----
良好的沟通能力 和 积极的行动 是成功的钥匙。
[Original] [Print] [Top]
Subject[精华] Re: FreeType 2开发文档 [中译版] 
Authorgogoliu    Posted2006-01-23 19:18    Length25,574 byte(s)
[Original] [Print] [Top]
《The FreeType 2 Tutorial》第一部分中译版 

FreeType 2 教程 

第一步 -- 简易的字形装载 

介绍 

这是“FreeType2 教程”的第一部分。它将教会你如何: 

* 初始化库 
* 通过创建一个新的 face 对象来打开一个字体文件 
* 以点或者象素的形式选择一个字符大小 
* 装载一个字形(glyph)图像,并把它转换为位图 
* 渲染一个简单的字符串 
* 容易地渲染一个旋转的字符串 

1.头文件 

下面的内容是编译一个使用了FreeType2库的应用程序所需要的指令。请谨慎阅读,自最近一次版本更新后我们已经更改了少许东西。 

1.FreeType2 include 目录 

你必须把FreeType2头文件的目录添加到编译包含(include)目录中。 

注意,现在在Unix系统,你可以运行freetype-config脚本加上--cflags选项来获得正确的编译标记。这个脚本也可以用来检查安装在你系统中的库的版本,以及需要的库和连接标记。 

2. 包含名为ft2build.h的文件 

Ft2build.h包含了接下来要#include的公共FreeType2头文件的宏声明。 

3. 包含主要的FreeType2 API头文件 

你要使用FT_FREETYPE_H宏来完成这个工作,就像下面这样: 

#include <ft2build.h> 
#include FT_FREETYPE_H 

FT_FREETYPE_H是在ftheader.h中定义的一个特别的宏。Ftheader.h包含了一些安装所特定的宏,这些宏指名了FreeType2 API的其他公共头文件。 

你可以阅读“FreeType 2 API参考”的这个部分来获得头文件的完整列表。 

#include语句中宏的用法是服从ANSI的。这有几个原因: 

* 这可以避免一些令人痛苦的与FreeType 1.x公共头文件的冲突。 

* 宏名字不受限于DOS的8.3文件命名限制。象FT_MULTIPLE_MASTERS_H或FT_SFNT_NAMES_H这样的名字比真实的文件名ftmm.h和fsnames.h更具可读性并且更容易理解。 

* 它允许特别的安装技巧,我们不在这里讨论它。 

注意:从FreeType 2.1.6开始,旧式的头文件包含模式将不会再被支持。这意味着现在如果你做了象下面那样的事情,你将得到一个错误: 

#include <freetype/freetype.h> 
#include <freetype/ftglyph.h> 
. . . 

2. 初始化库 

简单地创建一个FT_Library类型的变量,例如library,然后象下面那样调用函数FT_Init_FreeType: 

#include <ft2build.h> 
#include FT_FREETYPE_H 

FT_LIBRARY library; 

. . . 

Error = FT_Init_FreeType ( &library ); 
If ( error ) 

. . . 当初始化库时发生了一个错误 . . . 


这个函数负责下面的事情: 

* 它创建一个FreeType 2库的新实例,并且设置句柄library为它。 

* 它装载库中FreeType所知道的每一个模块。除了别的以外,你新建的library对象可以优雅地处理TrueType, Type 1, CID-keyed 和OpenType/CFF字体。 

就像你所看到的,这个函数返回一个错误代码,如同FreeType API的大部分其他函数一样。值为0的错误代码始终意味着操作成功了,否则,返回值指示错误,library设为NULL。 

3.装载一个字体face 

a.从一个字体文件装载 

应用程序通过调用FT_New_Face创建一个新的face对象。一个face对象描述了一个特定的字样和风格。例如,’Times New Roman Regular’和’Times New Roman Italic’对应两个不同的face。 

FT_Library library; /* 库的句柄 */ 
FT_Face face; /* face对象的句柄 */ 

error = FT_Init_FreeType( &library ); 
if ( error ) { ... } 

error = FT_New_Face( library, 
"/usr/share/fonts/truetype/arial.ttf", 
0, 
&face ); 
if ( error == FT_Err_Unknown_File_Format ) 

... 可以打开和读这个文件,但不支持它的字体格式 

else if ( error ) 

... 其它的错误码意味着这个字体文件不能打开和读,或者简单的说它损坏了... 


就如你所想到的,FT_NEW_Face打开一个字体文件,然后设法从中提取一个face。它的参数为:

Library 
一个FreeType库实例的句柄,face对象从中建立 

Filepathname 
字体文件路径名(一个标准的C字符串) 

Face_index 
某些字体格式允许把几个字体face嵌入到同一个文件中。 
这个索引指示你想装载的face。 
如果这个值太大,函数将会返回一个错误。Index 0总是正确的。 

Face 
一个指向新建的face对象的指针。 
当失败时其值被置为NULL。 

要知道一个字体文件包含多少个face,只要简单地装载它的第一个face(把face_index设置为0),face->num_faces的值就指示出了有多少个face嵌入在该字体文件中。 

b.从内存装载 

如果你已经把字体文件装载到内存,你可以简单地使用FT_New_Memory_Face为它新建一个face对象,如下所示: 

FT_Library library; /* 库的句柄 */ 
FT_Face face; /* face对象的句柄 */ 


error = FT_Init_FreeType( &library ); 
if ( error ) { ... } 

error = FT_New_Memory_Face( library, 
buffer, /* 缓存的第一个字节 */ 
size, /* 缓存的大小(以字节表示) */ 
0, /* face索引 */ 
&face ); 
if ( error ) { ... } 

如你所看到的,FT_New_Memory_Face简单地用字体文件缓存的指针和它的大小(以字节计算)代替文件路径。除此之外,它与FT_New_Face的语义一致。 

c.从其他来源装载(压缩文件,网络,等) 

使用文件路径或者预装载文件到内存是简单的,但还不足够。FreeType 2可以支持通过你自己实现的I/O程序来装载文件。 

这是通过FT_Open_Face函数来完成的。FT_Open_Face可以实现使用一个自定义的输入流,选择一个特定的驱动器来打开,乃至当创建该对象时传递外部参数给字体驱动器。我们建议你查阅“FreeType 2参考手册”,学习如何使用它。 

4.访问face内容 

一个face对象包含该face的全部全局描述信息。通常的,这些数据可以通过分别查询句柄来直接访问,例如face->num_glyphs。 

FT_FaceRec结构描述包含了可用字段的完整列表。我们在这里详细描述其中的某些: 

Num_glyphs
这个值给出了该字体face中可用的字形(glyphs)数目。简单来说,一个字形就是一个字符图像。但它不一定符合一个字符代码。 

Flags 
一个32位整数,包含一些用来描述face特性的位标记。例如,标记FT_FACE_FLAG_SCALABLE用来指示该face的字体格式是 可伸缩并且该字形图像可以渲染到任何字符象素尺寸。要了解face标记的更多信息,请阅读“FreeType 2 API 参考”。 

Units_per_EM 
这个字段只对可伸缩格式有效,在其他格式它将会置为0。它指示了EM所覆盖的字体单位的个数。

Num_fixed_size 
这个字段给出了当前face中嵌入的位图的个数。简单来说,一个strike就是某一特定字符象素尺寸下的一系列字形图像。例如,一个字体face可以包含象素尺寸为10、12和14的strike。要注意的是即使是可伸缩的字体格式野可以包含嵌入的位图! 

Fixed_sizes 
一个指向FT_Bitmap_Size成员组成的数组的指针。每一个FT_Bitmap_Size指示face中的每一个strike的水平和垂直字符象素尺寸。 
注意,通常来说,这不是位图strike的单元尺寸。 

5.设置当前象素尺寸 

对于特定face中与字符大小相关的信息,FreeType 2使用size对象来构造。例如,当字符大小为12点时,使用一个size对象以1/64象素为单位保存某些规格(如ascender或者文字高度)的值。 

当FT_New_Face或它的亲戚被调用,它会自动在face中新建一个size对象,并返回。该size对象可以通过face->size直接访问。 

注意:一个face对象可以同时处理一个或多个size对象,但只有很少程序员需要用到这个功能,因而,我们决定简化该API,(例如,每个face对象只拥有一个size对象)但是这个特性我们仍然通过附加的函数提供。 

当一个新的face对象建立时,对于可伸缩字体格式,size对象默认值为字符大小水平和垂直均为10象素。对于定长字体格式,这个大小是未定义的,这就是你必须在装载一个字形前设置该值的原因。 

使用FT_Set_Char_Size完成该功能。这里有一个例子,它在一个300x300dpi设备上把字符大小设置为16pt。 

error = FT_Set_Char_Size( 
face, /* face对象的句柄 */ 
0, /* 以1/64点为单位的字符宽度 */ 
16*64, /* 以1/64点为单位的字符高度 */ 
300, /* 设备水平分辨率 */ 
300 ); /* 设备垂直分辨率 */ 

注意: 

* 字符宽度和高度以1/64点为单位表示。一个点是一个1/72英寸的物理距离。通常,这不等于一个象素。 

* 设备的水平和垂直分辨率以每英寸点数(dpi)为单位表示。显示设备(如显示器)的常规值为72dpi或96dpi。这个分辨率是用来从字符点数计算字符象素大小的。 

* 字符宽度为0意味着“与字符高度相同”,字符高度为0意味着“与字符宽度相同”。对于其他情况则意味着指定不一样的字符宽度和高度。 

* 水平或垂直分辨率为0时表示使用默认值72dpi。 

* 第一个参数是face对象的句柄,不是size对象的。 

这个函数计算对应字符宽度、高度和设备分辨率的字符象素大小。然而,如果你想自己指定象素大小,你可以简单地调用FT_Set_Pixel_Sizes,就像这样: 

error = FT_Set_Pixel_Sizes( 
face, /* face对象句柄 */ 
0, /* 象素宽度 */ 
16 ); /* 象素高度 */ 

这个例子把字符象素设置为16x16象素。如前所说的,尺寸中的任一个为0意味着“与另一个尺寸值相等”。 

注意这两个函数都返回错误码。通常,错误会发生在尝试对定长字体格式(如FNT或PCF)设置不在face->fixed_size数组中的象素尺寸值。 

6.装载一个字形图像 

a.把一个字符码转换为一个字形索引 

通常,一个应用程序想通过字符码来装载它的字形图像。字符码是一个特定编码中代表该字符的数值。例如,字符码64代表了ASCII编码中的’A’。 

一个face对象包含一个或多个字符表(charmap),字符表是用来转换字符码到字形索引的。例如,很多TrueType字体包含两个字符 表,一个用来转换Unicode字符码到字形索引,另一个用来转换Apple Roman编码到字形索引。这样的字体既可以用在Windows(使用Unicode)和Macintosh(使用Apple Roman)。同时要注意,一个特定的字符表可能没有覆盖完字体里面的全部字形。 

当新建一个face对象时,它默认选择Unicode字符表。如果字体没包含Unicode字符表,FreeType会尝试在字形名的基础上模拟 一个。注意,如果字形名是不标准的那么模拟的字符表有可能遗漏某些字形。对于某些字体,包括符号字体和旧的亚洲手写字体,Unicode模拟是不可能的。 

我们将在稍后叙述如何寻找face中特定的字符表。现在我们假设face包含至少一个Unicode字符表,并且在调用FT_New_Face时已经被选中。我们使用FT_Get_Char_Index把一个Unicode字符码转换为字形索引,如下所示: 

glyph_index = FT_Get_Char_Index( face, charcode ); 

这个函数会在face里被选中的字符表中查找与给出的字符码对应的字形索引。如果没有字符表被选中,这个函数简单的返回字符码。 

注意,这个函数是FreeType中罕有的不返回错误码的函数中的一个。然而,当一个特定的字符码在face中没有字形图像,函数返回0。按照约定,它对应一个特殊的字形图像――缺失字形,通常会显示一个框或一个空格。 

b.从face中装载一个字形 

一旦你获得了字形索引,你便可以装载对应的字形图像。在不同的字体中字形图像存储为不同的格式。对于固定尺寸字体格式,如FNT或者PCF,每一 个图像都是一个位图。对于可伸缩字体格式,如TrueType或者Type1,使用名为轮廓(outlines)的矢量形状来描述每一个字形。一些字体格 式可能有更特殊的途径来表示字形(如MetaFont――但这个格式不被支持)。幸运的,FreeType2有足够的灵活性,可以通过一个简单的API支 持任何类型的字形格式。 

字形图像存储在一个特别的对象――字形槽(glyph slot)中。就如其名所暗示的,一个字形槽只是一个简单的容器,它一次只能容纳一个字形图像,可以是位图,可以是轮廓,或者其他。每一个face对象都 有一个字形槽对象,可以通过face->glyph来访问。它的字段在FT_GlyphSlotRec结构的文档中解释了。 

通过调用FT_Load_Glyph来装载一个字形图像到字形槽中,如下: 

error = FT_Load_Glyph( 
face, /* face对象的句柄 */ 
glyph_index, /* 字形索引 */ 
load_flags ); /* 装载标志,参考下面 */ 

load_flags的值是位标志集合,是用来指示某些特殊操作的。其默认值是FT_LOAD_DEFAULT即0。 

这个函数会设法从face中装载对应的字形图像: 

* 如果找到一个对应该字形和象素尺寸的位图,那么它将会被装载到字形槽中。嵌入的位图总是比原生的图像格式优先装载。因为我们假定对一个字形,它有更高质量的版本。这可以用FT_LOAD_NO_BITMAP标志来改变。 

* 否则,将装载一个该字形的原生图像,把它伸缩到当前的象素尺寸,并且对应如TrueType和Type1这些格式,也会完成hinted操作。 

字段face->glyph->format描述了字形槽中存储的字形图像的格式。如果它的值不是FT_GLYPH_FORMAT_BITMAP,你可以通过FT_Render_Glyph把它直接转换为一个位图。如下: 

error = FT_Render_Glyph( face->glyph, /* 字形槽 */ 
render_mode ); /* 渲染模式 */ 

render_mode参数是一个位标志集合,用来指示如何渲染字形图像。把它设为FT_RENDER_MODE_NORMAL渲染出一个高质量的抗锯齿(256级灰度)位图。这是默认情况,如果你想生成黑白位图,可以使用FT_RENDER_MODE_MONO标志。 

一旦你生成了一个字形图像的位图,你可以通过glyph->bitmap(一个简单的位图描述符)直接访问,同时用glyph->bitmap_left和glyph->bitmap_top来指定起始位置。 

要注意,bitmap_left是从字形位图当前笔位置到最左边界的水平距离,而bitmap_top是从笔位置(位于基线)到最高边界得垂直距离。他么是正数,指示一个向上的距离。 

下一部分将给出字形槽内容的更多细节,以及如何访问特定的字形信息(包括度量)。 

c.使用其他字符表 

如前面所说的,当一个新face对象创建时,它会寻找一个Unicode字符表并且选择它。当前被选中的字符表可以通过 face->charmap访问。当没有字符表被选中时,该字段为NULL。这种情况在你从一个不含Unicode字符表的字体文件(这种文件现在 非常罕见)创建一个新的FT_Face对象时发生。 

有两种途径可以在FreeType 2中选择不同的字符表。最轻松的途径是你所需的编码已经有对应的枚举定义在FT_FREETYPE_H中,例如FT_ENCODING_BIG5。在这种情况下,你可以简单地调用FT_Select_CharMap,如下: 

error = FT_Select_CharMap( 
face, /* 目标face对象 */ 
FT_ENCODING_BIG5 ); /* 编码 */ 

另一种途径是手动为face解析字符表。这通过face对象的字段num_charmaps和charmaps(注意这是复数)来访问。如你想到 的,前者是face中的字符表的数目,后者是一个嵌入在face中的指向字符表的指针表(a table of pointers to the charmaps)。 

每一个字符表有一些可见的字段,用来更精确地描述它,主要用到的字段是charmap->platform_id和charmap->encoding_id。这两者定义了一个值组合,以更普 
通的形式用来描述该字符表。 

每一个值组合对应一个特定的编码。例如组合(3,1)对应Unicode。组合列表定义在TrueType规范中,但你也可以使用文件FT_TRUETYPE_IDS_H来处理它们,该文件定义了几个有用的常数。 

要选择一个具体的编码,你需要在规范中找到一个对应的值组合,然后在字符表列表中寻找它。别忘记,由于历史的原因,某些编码会对应几个值组合。这里是一些代码: 

FT_CharMap found = 0; 
FT_CharMap charmap; 
int n; 


for ( n = 0; n < face->num_charmaps; n++ ) 

charmap = face->charmaps[n]; 
if ( charmap->platform_id == my_platform_id && 
charmap->encoding_id == my_encoding_id ) 

found = charmap; 
break; 



if ( !found ) { ... } 

/* 现在,选择face对象的字符表*/ 
error = FT_Set_CharMap( face, found ); 
if ( error ) { ... } 

一旦某个字符表被选中,无论通过FT_Select_CharMap还是通过FT_Set_CharMap,它都会在后面的FT_Get_Char_Index调用使用。 

d.字形变换 

当字形图像被装载时,可以对该字形图像进行仿射变换。当然,这只适用于可伸缩(矢量)字体格式。 

简单地调用FT_Set_Transform来完成这个工作,如下: 

error = FT_Set_Transform( 
face, /* 目标face对象 */ 
&matrix, /* 指向2x2矩阵的指针 */ 
&delta ); /* 指向2维矢量的指针 */ 

这个函数将对指定的face对象设置变换。它的第二个参数是一个指向FT_Matrix结 
构的指针。该结构描述了一个2x2仿射矩阵。第三个参数是一个指向FT_Vector结构的指针。该结构描述了一个简单的二维矢量。该矢量用来在2x2变换后对字形图像平移。 

注意,矩阵指针可以设置为NULL,在这种情况下将进行恒等变换。矩阵的系数是16.16形式的固定浮点单位。 

矢量指针也可以设置为NULL,在这种情况下将使用(0, 0)的delta。矢量坐标以一个象素的1/64为单位表示(即通常所说的26.6固定浮点格式)。 

注意:变换将适用于使用FT_Load_Glyph装载的全部字形,并且完全独立于任何hinting处理。这意味着你对一个12象素的字形进行2倍放大变换不会得到与24象素字形相同的结果(除非你禁止hints)。 

如果你需要使用非正交变换和最佳hints,你首先必须把你的变换分解为一个伸缩部分和一个旋转/剪切部分。使用伸缩部分来计算一个新的字符象素大小,然后使用旋转/剪切部分来调用FT_Set_Transform。这在本教程的后面部分有详细解释。 

同时要注意,对一个字形位图进行非同一性变换将产生错误。 

7. 简单的文字渲染 

现在我们将给出一个非常简单的例子程序,该例子程序渲染一个8位Latin-1文本字符串,并且假定face包含一个Unicode字符表。 

该程序的思想是建立一个循环,在该循环的每一次迭代中装载一个字形图像,把它转换为一个抗锯齿位图,把它绘制到目标表面(surface)上,然后增加当前笔的位置。 

a.基本代码 

下面的代码完成我们上面提到的简单文本渲染和其他功能。 

FT_GlyphSlot slot = face->glyph; /* 一个小捷径 */ 
int pen_x, pen_y, n; 


... initialize library ... 
... create face object ... 
... set character size ... 

pen_x = 300; 
pen_y = 200; 

for ( n = 0; n < num_chars; n++ ) 

FT_UInt glyph_index; 


/* 从字符码检索字形索引 */ 
glyph_index = FT_Get_Char_Index( face, text[n] ); 

/* 装载字形图像到字形槽(将会抹掉先前的字形图像) */ 
error = FT_Load_Glyph( face, glyph_index, FT_LOAD_DEFAULT ); 
if ( error ) 
continue; /* 忽略错误 */ 

/* 转换为一个抗锯齿位图 */ 
error = FT_Render_Glyph( face->glyph, ft_render_mode_normal ); 
if ( error ) 
continue; 

/* 现在,绘制到我们的目标表面(surface) */ 
my_draw_bitmap( &slot->bitmap, 
pen_x + slot->bitmap_left, 
pen_y - slot->bitmap_top ); 

/* 增加笔位置 */ 
pen_x += slot->advance.x >> 6; 
pen_y += slot->advance.y >> 6; /* 现在还是没用的 */ 


这个代码需要一些解释: 

* 我们定义了一个名为slot的句柄,它指向face对象的字形槽。(FT_GlyphSlot类型是一个指针)。这是为了便于避免每次都使用face->glyph->XXX。 

* 我们以slot->advance增加笔位置,slot->advance符合字形的步进宽度(也就是通常所说的走格(escapement))。步进矢量以象素的1/64为单位表示,并且在每一次迭代中删减为整数象素。 

* 函数my_draw_bitmap不是FreeType的一部分,但必须由应用程序提供以用来绘制位图到目标表面。在这个例子中,该函数以一个FT_Bitmap描述符的指针和它的左上角位置为参数。 

* Slot->bitmap_top的值是正数,指字形图像顶点与pen_y的垂直距离。我们假定my_draw_bitmap采用的坐标使用一样的约定(增加Y值对应向下的扫描线)。我们用pen_y减它,而不是加它。 

b.精练的代码 

下面的代码是上面例子程序的精练版本。它使用了FreeType 2中我们还没有介绍的特性和函数,我们将在下面解释: 

FT_GlyphSlot slot = face->glyph; /* 一个小捷径 */ 
FT_UInt glyph_index; 
int pen_x, pen_y, n; 


... initialize library ... 
... create face object ... 
... set character size ... 

pen_x = 300; 
pen_y = 200; 

for ( n = 0; n < num_chars; n++ ) 

/* 装载字形图像到字形槽(将会抹掉先前的字形图像) */ 
error = FT_Load_Char( face, text[n], FT_LOAD_RENDER ); 
if ( error ) 
continue; /* 忽略错误 */ 

/* 现在,绘制到我们的目标表面(surface) */ 
my_draw_bitmap( &slot->bitmap, 
pen_x + slot->bitmap_left, 
pen_y - slot->bitmap_top ); 

/* 增加笔位置 */ 
pen_x += slot->advance.x >> 6; 


我们简化了代码的长度,但它完成相同的工作: 

* 我们使用函数FT_Loac_Char代替FT_Load_Glyph。如你大概想到的,它相当于先调用GT_Get_Char_Index然后调用FT_Get_Load_Glyph。 

* 我们不使用FT_LOAD_DEFAULT作为装载模式,使用FT_LOAD_RENDER。它指示了字形图像必须立即转换为一个抗锯齿位图。这是一个捷径,可以取消明显的调用FT_Render_Glyph,但功能是相同的。 
注意,你也可以指定通过附加FT_LOAD_MONOCHROME装载标志来获得一个单色位图。 

c.更高级的渲染 

现在,让我们来尝试渲染变换文字(例如通过一个环)。我们可以用FT_Set_Transform来完成。这里是示例代码: 

FT_GlyphSlot slot; 
FT_Matrix matrix; /* 变换矩阵 */ 
FT_UInt glyph_index; 
FT_Vector pen; /* 非变换原点 */ 
int n; 


... initialize library ... 
... create face object ... 
... set character size ... 

slot = face->glyph; /* 一个小捷径 */ 

/* 准备矩阵 */ 
matrix.xx = (FT_Fixed)( cos( angle ) * 0x10000L ); 
matrix.xy = (FT_Fixed)(-sin( angle ) * 0x10000L ); 
matrix.yx = (FT_Fixed)( sin( angle ) * 0x10000L ); 
matrix.yy = (FT_Fixed)( cos( angle ) * 0x10000L ); 

/* 26.6 笛卡儿空间坐标中笔的位置,以(300, 200)为起始 */ 
pen.x = 300 * 64; 
pen.y = ( my_target_height - 200 ) * 64; 

for ( n = 0; n < num_chars; n++ ) 

/* 设置变换 */ 
FT_Set_Transform( face, &matrix, &pen ); 

/* 装载字形图像到字形槽(将会抹掉先前的字形图像) */ 
error = FT_Load_Char( face, text[n], FT_LOAD_RENDER ); 
if ( error ) 
continue; /* 忽略错误 */ 

/* 现在,绘制到我们的目标表面(变换位置) */ 
my_draw_bitmap( &slot->bitmap, 
slot->bitmap_left, 
my_target_height - slot->bitmap_top ); 

/* 增加笔位置 */ 
pen.x += slot->advance.x; 
pen.y += slot->advance.y; 


一些说明: 

* 现在我们使用一个FT_Vector类型的矢量来存储笔位置,其坐标以象素的1/64为单位表示,并且倍增。该位置表示在笛卡儿空间。 

* 不同于系统典型的对位图使用的坐标系(其最高的扫描线是坐标0),FreeType中,字形图像的装载、变换和描述总是采用笛卡儿坐标系(这意味着增加Y对应向上的扫描线)。因此当我们定义笔位置和计算位图左上角时必须在两个系统之间转换。 

* 我们对每一个字形设置变换来指示旋转矩阵以及使用一个delta来移动转换后的图像到当前笔位置(在笛卡儿空间,不是位图空间)。结 果,bitmap_left和bitmap_top的值对应目标空间象素中的位图原点。因此,我们在调用my_draw_bitmap时不在它们的值上加 pen.x或pen.y。 

* 步进宽度总会在变换后返回,这就是它可以直接加到当前笔位置的原因。注意,这次它不会四舍五入。 

一个例子完整的源代码可以在这里找到。 

要很注意,虽然这个例子比前面的更复杂,但是变换效果是完全一致的。因此它可以作为一个替换(但更强大)。 

然而该例子有少许缺点,我们将在本教程的下一部分中解释和解决。 

结论 

在这个部分,你已经学习了FreeType2的基础以及渲染旋转文字的充分知识。 

下一部分将深入了解FreeType 2 API更详细的资料,它可以让你直接访问字形度量标准和字形图像,还能让你学习到如何处理缩放、hinting、自居调整,等等。 

第三部分将讨论模块、缓存和其他高级主题,如如何在一个face中使用多个尺寸对象。【这部分还没有编写】
----
良好的沟通能力 和 积极的行动 是成功的钥匙。
[Original] [Print] [Top]
SubjectRe: FreeType 2开发文档 [中译版] 
Authorgogoliu    Posted2006-03-13 23:39    Length37,333 byte(s)
[Original] [Print] [Top]
《The FreeType 2 Tutorial》第二部分中译版 

FreeType 2 教程 

第二步 -- 管理字形 

介绍 

这是“FreeType2 教程”的第二部分。它将教会你如何: 

* 检索字形度量 
* 容易地管理字形图像 
* 检索全局度量(包括字距调整) 
* 渲染一个简单的字符串(采用字距调整) 
* 渲染一个居中的字符串(采用字距调整) 
* 渲染一个变换的字符串(采用居中) 
* 在需要时以预设字体单位的格式获取度量,以及把它们缩放到设备空间 

1.字形度量 

从字形度量这个名字可以想到,字形度量是关联每一个字形的确定距离,以此描述如何使用该距离来排版文本。 

通常一个字形有两个度量集:用来排版水平文本排列的字形(拉丁文、西里尔文、阿拉伯文、希伯来文等等)和用来排版垂直文本排列的字形(中文、日文、韩文等等)。 

要注意的是只有很少的字体格式提供了垂直度量。你可以使用宏FT_HAS_VERTICAL测试某个给出的face对象是否包含垂直度量,当结果为真时表示包含。 

个别的字形度量可以先装载字形到face的字形槽,然后通过face->glyph->metrics结构访问,其类型为FT_Glyph_Metrics。我们将在下面详细讨论它,现在,我们只关注该结构包含如下的字段: 

Width 
这是字形图像的边框的宽度。它与排列方向无关。 

Height 
这是字形图像的边框的高度。它与排列方向无关。 

horiBearingX 
用于水平文本排列,这是从当前光标位置到字形图像最左边的边界的水平距离。 

horiBearingY 
用于水平文本排列,这是从当前光标位置(位于基线)到字形图像最上边的边界的水平距离。 

horiAdvance 
用于水平文本排列,当字形作为字符串的一部分被绘制时,这用来增加笔位置的水平距离。 

vertBearingX 
用于垂直文本排列,这是从当前光标位置到字形图像最左边的边框的垂直距离。 

vertBearingY 
用于垂直文本排列,这是从当前光标位置(位于基线)到字形图像最上边的边框的垂直距离。 

vertAdvance 
用于垂直文本排列,当字形作为字符串的一部分被绘制时,这用来增加笔位置的垂直距离。 

注意:因为不是所有的字体都包含垂直度量,当FT_HAS_VERTICAL为假时,vertBearingX,vertBearingY和vertAdvance的值是不可靠的。 

下面的图形更清楚地图解了度量。第一个图解了水平度量,其基线为水平轴: 
FreeType2中文手册_第1张图片 

对于垂直文本排列,基线是垂直的,与垂直轴一致: 
FreeType2中文手册_第2张图片 

Face->glyph->metrics中的度量通常以26.6象素格式(例如1/64象素)表示,除非你在调用FT_Load_Glyph或FT_Load_Char时使用了FT_LOAD_NO_SCALE标志,这样的话度量会用原始字体单位表示。 

字形槽(glyph slot)对象也有一些其他有趣的字段可以减轻开发者的工作。你可以通过face->glyph->xxx访问它们,其中xxx是下面字段之一: 

Advance 
这个字段是一个FT_Vector,保存字形的变换推进。当你通过FT_Set_Transform使用变换时,这是很有用的,这在第一部分的循 环文本例子中已经展示过了。与那不同,这个值是默认的(metrics.horiAdvance,0),除非你在装载字形图像时指定 FT_LOAD_VERTICAL,那么它将会为(0,metrics.vertAdvance)。 

linearHoriAdvance 
这个字段包含字形水平推进宽度的线性刻度值。实际上,字形槽返回的metrics.horiAdvance值通常四舍五入为整数象素坐标(例如, 它是64的倍数),字体驱动器用它装载字形图像。linearHoriAdvance是一个16.16固定浮点数,提供了以1/65536象素为单位的原 始字形推进宽度的值。它可以用来完成伪设备无关文字排版。 

linearVertAdvance 
这与linearHoriAdvance类似,但它用于字形的垂直推进高度。只有当字体face包含垂直度量时这个值才是可靠的。 

2.管理字形图像 

转载到字形槽得字形图像可以转换到一幅位图中,这可以在装载时使用FT_LOAD_RENDER标志或者调用FT_Render_Glyph函数实现。每一次你装载一个新的字形图像到字形槽,前面装载的将会从字形槽中抹去。 

但是,你可能需要从字形槽中提取这个图像,以用来在你的应用程序中缓存它,或者进行附加的变换,或者在转换到位图前测量它。 

FreeType 2 API有一个特殊的扩展能够以一种灵活和普通的方式处理字形图像。要使用它,你首先需要包含FT_GLYPH_H头文件,如下: 

#include FT_GLYPH_H 

现在我们将解释如何使用这个文件定义的这个函数。 

a.提取字形图像 

你可以很简单地提取一个字形图像。这里有一向代码向你展示如何去做: 

FT_Glyph glyph; /* 字形图像的句柄 */ 

... 
error = FT_Load_Glyph( face, glyph_index, FT_LOAD_NORMAL ); 
if ( error ) { ... } 

error = FT_Get_Glyph( face->glyph, &glyph ); 
if ( error ) { ... } 

如你所看到的,我们: 

* 创建一个类型为FT_Glyph,名为glyph的变量。这是一个字形图像的句柄(即指针)。 

* 装载字形图像(通常情况下)到face的字形槽中。我们不使用FT_LOAD_RENDER因为我们想抓取一个可缩放的字形图像,以便后面对其进行变换。 

* 通过调用FT_Get_Glyph,把字形图像从字形槽复制到新的FT_Glyph对象glyph中。这个函数返回一个错误码并且设置glyph。 

要非常留意,被取出的字形跟字形槽中的原始字形的格式是一样的。例如,如果我们从TrueType字体文件中装载一个字形,字形图像将是可伸缩的矢量轮廓。 

如果你想知道字形是如何模型和存储的,你可以访问flyph->format字段。一个新的字形对象可以通过调用FT_Done_Glyph来销毁。 

字形对象正好包含一个字形图像和一个2D矢量,2D矢量以16.16固定浮点坐标的形式表示字形的推进。后者可以直接通过glyph->advance访问。 

注意,不同于其他TrueType对象,库不保存全部分配了的字形对象的列表。这意味着你必须自己销毁它们,而不是依靠FT_Done_FreeType完成全部的清除。 

b.变换和复制字形图像 

如果字形图像是可伸缩的(例如,如果glyph->format不等于FT_GLYPH_FORMAT_BITMAP),那么就可以随时通过调用FT_Glyph_Transform来变换该图像。 

你也可以通过FT_Glyph_Copy复制一个字形图像。这里是一些例子代码: 

FT_Glyph glyph, glyph2; 
FT_Matrix matrix; 
FT_Vector delta; 

... 装载字形图像到 `glyph' ... 

/* 复制 glyph 到 glyph2 */ 

error = FT_Glyph_Copy( glyph, &glyph2 ); 
if ( error ) { ... 无法复制(内存不足) ... } 

/* 平移 `glyph' */ 

delta.x = -100 * 64; /* 坐标是 26.6 象素格式的 */ 
delta.y = 50 * 64; 

FT_Glyph_Transform( glyph, 0, &delta ); 

/* 变换 glyph2 (水平剪切) */ 

matrix.xx = 0x10000L; 
matrix.xy = 0.12 * 0x10000L; 
matrix.yx = 0; 
matrix.yy = 0x10000L; 

FT_Glyph_Transform( glyph2, &matrix, 0 ); 

注意,2x2矩阵变换总是适用于字形的16.16推进矢量,所以你不需要重修计算它。 

c.测量字形图像 

你也可以通过FT_Glyph_Get_CBox函数检索任意字形图像(无论是可伸缩或者不可伸缩的)的控制(约束)框,如下: 

FT_BBox bbox; 

... 
FT_Glyph_Get_CBox( glyph, bbox_mode, &bbox ); 

坐标是跟字形的原点(0, 0)相关的,使用y向上的约定。这个函数取一个特殊的参数:bbox_mode来指出如何表示框坐标。 

如果字形装载时使用了FT_LOAD_NO_SCALE标志,bbox_mode必须设置为FT_GLYPH_BBOX_UNSCALED,以此 来获得以26.6象素格式为单位表示的不可缩放字体。值FT_GLYPH_BBOX_SUBPIXELS是这个常量的另一个名字。 

要注意,框(box)的最大坐标是唯一的,这意味着你总是可以以整数或26.6象素的形式计算字形图像的宽度和高度,公式如下: 

width = bbox.xMax - bbox.xMin; 
height = bbox.yMax - bbox.yMin; 

同时要注意,对于26.6坐标,如果FT_GLYPH_BBOX_GRIDFIT被用作为bbox_mode,坐标也将网格对齐,符合如下公式: 

bbox.xMin = FLOOR( bbox.xMin ) 
bbox.yMin = FLOOR( bbox.yMin ) 
bbox.xMax = CEILING( bbox.xMax ) 
bbox.yMax = CEILING( bbox.yMax ) 

要把bbox以整数象素坐标的形式表示,把bbox_mode设置为FT_GLYPH_BBOX_TRUNCATE。 

最后,要把约束框以网格对齐象素坐标的形式表示,把bbox_mode设置为FT_GLYPH_BBOX_PIXELS。 

d.转换字形图像为位图 

当你已经把字形对象缓存或者变换后,你可能需要转换它到一个位图。这可以通过FT_Glyph_To_Bitmap函数简单得实现。它负责转换任何字形对象到位图,如下: 

FT_Vector origin; 
origin.x = 32; /* 26.6格式的1/2象素 */ 
origin.y = 0; 
error = FT_Glyph_To_Bitmap( 
&glyph, 
render_mode, 
&origin, 
1 ); /* 销毁原始图像 == true */ 

一些注解: 

* 第一个参数是源字形句柄的地址。当这个函数被调用时,它读取该参数来访问源字形对象。调用结束后,这个句柄将指向一个新的包含渲染后的位图的字形对象。 

* 第二个参数时一个标准渲染模式,用来指定我们想要哪种位图。它取FT_RENDER_MODE_DEFAULT时表示8位颜色深度的抗锯齿位图;它取FT_RENDER_MODE_MONO时表示1位颜色深度的黑白位图。 

* 第三个参数是二维矢量的指针。该二维矢量是在转换前用来平移源字形图像的。要注意,函数调用后源图像将被平移回它的原始位置(这样便不会有变化)。如果你在渲染前不需要平移源字形,设置这个指针为0。 

* 最后一个参数是一个布尔值,用来指示该函数是否要销毁源字形对象。如果为false,源字形对象不会被销毁,即使它的句柄丢失了(客户应用程序需要自己保留句柄)。 

如果没返回错误,新的字形对象总是包含一个位图。并且你必须把它的句柄进行强制类型转换,转换为FT_BitmapGlyph类型,以此访问它的内容。这个类型是FT_Glyph的一种“子类”,它包含下面的附加字段(看FT_BitmapGlyphRec): 

Left 
类似于字形槽的bitmap_left字段。这是字形原点(0,0)到字形位图最左边象素的水平距离。它以整数象素的形式表示。 
Top 
类似于字形槽的bitmap_top字段。它是字形原点(0,0)到字形位图最高象素之间的垂直距离(更精确来说,到位图上面的象素)。这个距离以整数象素的形式表示,并且y轴向上为正。 
Bitmap 
这是一个字形对象的位图描述符,就像字形槽的bitmap字段。 

3.全局字形度量 

不同于字形度量,全局度量是用来描述整个字体face的距离和轮廓的。他们可以用26.6象素格式或者可缩放格式的“字体单位”来表示。 

a.预设全局度量 

对于可缩放格式,全部全局度量都是以字体单位的格式表示的,这可以用来在稍后依照本教程本部分的最后一章描述的规则来缩放到设备空间。你可以通过FT_Face句柄的字段直接访问它们。 

然而,你需要在使用它们前检查字体face的格式是否可缩放。你可以使用宏FT_IS_SCALEABLE来实现,当该字体是可缩放时它返回正。 

如果是这样,你就可以访问全局预设度量了,如下: 

units_per_EM 
这是字体face的EM正方形的大小。它是可缩放格式用来缩放预设坐标到设备象素的,我们在这部分的最后一章叙述它。通常这个值为2048(对于 TrueType)或者1000(对于Type 1),但是其他值也是可能的。对于固定尺寸格式,如FNT/FON/PCF/BDF,它的值为1。 

global_bbox 
全局约束框被定义为最大矩形,该矩形可以包围字体face的所有字形。它只为水平排版而定义。 

ascender 
Ascender是从水平基线到字体face最高“字符”的坐标之间的垂直距离。不幸地,不同的字体格式对ascender的定义是不同的。对于 某些来说,它代表了全部大写拉丁字符(重音符合除外)的上沿值(ascent);对于其他,它代表了最高的重音符号的上沿值(ascent);最后,其他 格式把它定义为跟global_bbox.yMax相同。 

descender 
Descender是从水平基线到字体face最低“字符”的坐标之间的垂直距离。不幸地,不同的字体格式对descender的定义是不同的。 对于某些来说,它代表了全部大写拉丁字符(重音符合除外)的下沿值(descent);对于其他,它代表了最高的重音符号的下沿值(descent);最 后,其他格式把它定义为跟global_bbox.yMin相同。这个字段的值是负数。 

text_height 
这个字段是在使用这个字体书写文本时用来计算默认的行距的(例如,基线到基线之间的距离)。注意,通常它都比ascender和descent的绝对值之和还要大。另外,不保证使用这个距离后面就没有字形高于或低于基线。 

max_advance_width 
这个字段指出了字体中所有字形得最大的水平光标推进宽度。它可以用来快速计算字符串得最大推进宽度。它不等于最大字形图像宽度! 

max_advance_height 
跟max_advance_width一样,但是用在垂直文本排版。它只在字体提供垂直字形度量时才可用。 

underline_position 
当显示或者渲染下划线文本时,这个值等于下划线到基线的垂直距离。当下划线低于基线时这个值为负数。 

underline_thickness 
当显示或者渲染下划线文本时,这个值等于下划线的垂直宽度。 

现在注意,很不幸的,由于字体格式多种多样,ascender和descender的值是不可靠的。 

b.伸缩的全局度量 

每一个size对象同时包含了上面描述的某些全局度量的伸缩版本。它们可以通过face->size->metrics结构直接访问。 

注意这些值等于预设全局变量的伸缩版本,但没有做舍入或网格对齐。它们也完全独立于任何hinting处理。换句话说,不要依靠它们来获取象素级别的精确度量。它们以26.6象素格式表示。 

ascender 
原始预设ascender的伸缩版本。 

descender 
原始预设ascender的伸缩版本。 

height 
原始预设文本高度(text_height)的伸缩版本。这可能是这个结构中你真正会用到的字段。 

max_advance 
原始预设最大推进的伸缩版本。 

注意,face->size->metrics结构还包含其他字段,用来伸缩预设坐标到设备空间。它们会在最后一章描述。 

c.字距调整 

字距调整是调整字符串中两个并排的字形图像位置的过程,它可以改善文本的整体外观。基本上,这意味着当‘A’的跟着‘V’时,它们之间的间距可以稍微减少,以此避免额外的“对角线空白”。 

注意,理论上字距调整适用于水平和垂直方向的两个字形,但是,除了非常极端的情况外,几乎在所有情况下,它只会发生在水平方向。 

不是所有的字体格式包含字距调整信息。有时候它们依赖于一个附加的文件来保存不同的字形度量,包括字距调整,但该文件不包含字形图像。一个显著的 例子就是Type1格式。它的字形图像保存在一个扩展名为.pfa或.pfb的文件中,字距调整度量存放在一个附加的扩展名为.afm或.pfm的文件 中。 

FreeType 2提供了FT_Attach_File和FT_Attach_Stream API来让你处理这种情况。两个函数都是用来装载附加的度量到一个face对象中,它通过从附加的特定格式文件中读取字距调整度量来实现。例如,你可以象 下面那样打开一个Type1字体: 

error = FT_New_Face( library, "/usr/shared/fonts/cour.pfb", 
0, &face ); 
if ( error ) { ... } 

error = FT_Attach_File( face, "/usr/shared/fonts/cour.afm" ); 
if ( error ) 
{ ... 没能读取字距调整和附加的度量 ... } 

注意,FT_Attach_Stream跟FT_Attach_File是类似的,不同的是它不是以C字符串指定附加文件,而是以一个FT_Stream句柄。另外,读取一个度量文件不是强制性的。 

最后,文件附加API是非常通用的,可以用来从指定的face中装载不同类型的附加信息。附加内容的种类完全是因字体格式而异的。 

FreeType 2允许你通过FT_Get_Kerning函数获取两个字形的字距调整信息,该函数界面如下: 

FT_Vector kerning; 

... 
error = FT_Get_Kerning( face, /* face对象的句柄 */ 
left, /* 左边字形索引 */ 
right, /* 右边字形索引 */ 
kerning_mode, /* 字距调整模式 */ 
&kerning ); /* 目标矢量 */ 

正如你所见到的,这个函数的参数有一个face对象的句柄、字距调整值所要求的左边和右边字形索引,以及一个称为字距调整模式的整数,和目标矢量的指针。目标矢量返回适合的距离值。 

字距调整模式跟前一章描述的bbox模式(bbox mode)是很类似的。这是一个枚举值,指示了目标矢量如何表示字距调整距离。 

默认值是FT_KERNING_DEFAULT,其数值为0。它指示字距调整距离以26.6网格对齐象素(这意味着该值是64的倍数)的形式表示。对于可伸缩格式,这意味着返回值是把预设字距调整距离先伸缩,然后舍入。 

值FT_KERNING_UNFITTED指示了字距调整距离以26.6非对齐象素(也就是,那不符合整数坐标)的形式表示。返回值是把预设字距调整伸缩,但不舍入。 

最后,值FT_KERNING_UNSCALED是用来返回预设字距调整距离,它以字体单位的格式表示。你可以在稍后用本部分的最后一章描述的算式把它拉伸到设备空间。 

注意,“左”和“右”位置是指字符串字形的可视顺序。这对双向或由右到左的文本来说是很重要的。 

4.简单的文本渲染:字距调整+居中 

为了显示我们刚刚学到的知识,现在我们将示范如何修改第一部分给出的代码以渲染一个字符串,并且增强它,使它支持字距调整和延迟渲染。 

a.字距调整支持 

要是我们只考虑处理从左到右的文字,如拉丁文,那在我们的代码上添加字距调整是很容易办到的。我们只要获取两个字形之间的字距调整距离,然后适当地改变笔位置。代码如下: 

FT_GlyphSlot slot = face->glyph; /* 一个小捷径 */ 
FT_UInt glyph_index; 
FT_Bool use_kerning; 
FT_UInt previous; 
int pen_x, pen_y, n; 

... 初始化库 ... 
... 创建face对象 ... 
... 设置字符尺寸 ... 

pen_x = 300; 
pen_y = 200; 

use_kerning = FT_HAS_KERNING( face ); 
previous = 0; 

for ( n = 0; n < num_chars; n++ ) 

/* 把字符码转换为字形索引 */ 
glyph_index = FT_Get_Char_Index( face, text[n] ); 

/* 获取字距调整距离,并且移动笔位置 */ 
if ( use_kerning && previous && glyph_index ) 

FT_Vector delta; 

FT_Get_Kerning( face, previous, glyph_index, 
ft_kerning_mode_default, &delta ); 

pen_x += delta.x >> 6; 


/* 装载字形图像到字形槽(擦除之前的字形图像) */ 
Error = FT_Load_Glyph(face, glyph_index, FT_LOAD_RENDER); 
if ( error ) 
continue; /* 忽略错误 */ 

/* 现在绘制到我们的目标表面(surface) */ 
my_draw_bitmap( &slot->bitmap, 
pen_x + slot->bitmap_left, 
pen_y - slot->bitmap_top ); 

/* 增加笔位置 */ 
pen_x += slot->advance.x >> 6; 

/* 记录当前字形索引 */ 
previous = glyph_index; 


若干注解: 

* 因为字距调整是由字形索引决定的,我们需要显式转换我们的字符代码到字形索引,然后调用FT_Load_Glyph而不是FT_Load_Char。 

* 我们使用一个名为use_kerning的变量,它的值为宏FT_HAS_KERNING的结果。当我们知道字体face不含有字距调整信息,不调用FT_Get_kerning程序将执行得更快。 

* 我们在绘制一个新字形前移动笔位置。 

* 我们以值0初始化变量previous,这表示“字形缺失(missing glyph)”(在Postscript中,这用.notdef表示)。该字形也没有字距调整距离。 

* 我们不检查FT_Get_kerning返回得错误码。这是因为这个函数在错误发生时总是把delta置为(0,0)。 

b.居中 

我们的代码开始变得有趣了,但对普通应用来说仍然有点太简单了。例如,笔的位置在我们渲染前就决定了。通常,你要在计算文本的最终位置(居中,等)前布局它和测量它,或者执行自动换行。 

现在让我们把文字渲染函数分解为两个截然不同但连续的两部分:第一部分将在基线上定位每一个字形图像,第二部分将渲染字形。我们将看到,这有很多好处。 

我们先保存每一个独立的字形图像,以及它们在基线上面的位置。这可以通过如下的代码完成: 

FT_GlyphSlot slot = face->glyph; /* 一个小捷径 */ 
FT_UInt glyph_index; 
FT_Bool use_kerning; 
FT_UInt previous; 
int pen_x, pen_y, n; 

FT_Glyph glyphs[MAX_GLYPHS]; /* 字形图像 */ 
FT_Vector pos [MAX_GLYPHS]; /* 字形位置 */ 
FT_UInt num_glyphs; 

... 初始化库 ... 
... 创建face对象 ... 
... 设置字符尺寸 ... 

pen_x = 0; /* 以 (0,0) 开始 */ 
pen_y = 0; 

num_glyphs = 0; 
use_kerning = FT_HAS_KERNING( face ); 
previous = 0; 

for ( n = 0; n < num_chars; n++ ) 

/* 把字符码转换为字形索引 */ 
glyph_index = FT_Get_Char_Index( face, text[n] ); 

/* 获取字距调整距离,并且移动笔位置 */ 
if ( use_kerning && previous && glyph_index ) 

FT_Vector delta; 

FT_Get_Kerning( face, previous, glyph_index, 
FT_KERNING_DEFAULT, &delta ); 

pen_x += delta.x >> 6; 


/* 保存当前笔位置 */ 
pos[num_glyphs].x = pen_x; 
pos[num_glyphs].y = pen_y; 

/* 装载字形图像到字形槽,不渲染它 */ 
error=FT_Load_Glyph(face, glyph_index, FT_LOAD_DEFAULT); 
if ( error ) 
continue; /* 忽略错误,跳到下一个字形 */ 

/* 提取字形图像并把它保存在我们的表中 */ 
error = FT_Get_Glyph( face->glyph, &glyphs[num_glyphs] ); 
if ( error ) 
continue; /* 忽略错误,跳到下一个字形 */ 

/* 增加笔位置 */ 
pen_x += slot->advance.x >> 6; 

/* 记录当前字形索引 */ 
previous = glyph_index; 

/* 增加字形数量 */ 
num_glyphs++; 


相对于我们之前的代码,这有轻微的变化:我们从字形槽中提取每一个字形图像,保存每一个字形图像和它对应的位置在我们的表中。 

注意pen_x包含字符串的整体前移值。现在我们可以用一个很简单的函数计算字符串的边界框(bounding box),如下: 

void compute_string_bbox( FT_BBox *abbox ) 

FT_BBox bbox; 

/* 初始化字符串bbox为“空”值 */ 
bbox.xMin = bbox.yMin = 32000; 
bbox.xMax = bbox.yMax = -32000; 

/* 对于每一个字形图像,计算它的边界框,平移它,并且增加字符串bbox */ 
for ( n = 0; n < num_glyphs; n++ ) 

FT_BBox glyph_bbox; 

FT_Glyph_Get_CBox( glyphs[n], ft_glyph_bbox_pixels, 
&glyph_bbox ); 

glyph_bbox.xMin += pos[n].x; 
glyph_bbox.xMax += pos[n].x; 
glyph_bbox.yMin += pos[n].y; 
glyph_bbox.yMax += pos[n].y; 

if ( glyph_bbox.xMin < bbox.xMin ) 
bbox.xMin = glyph_bbox.xMin; 

if ( glyph_bbox.yMin < bbox.yMin ) 
bbox.yMin = glyph_bbox.yMin; 

if ( glyph_bbox.xMax > bbox.xMax ) 
bbox.xMax = glyph_bbox.xMax; 

if ( glyph_bbox.yMax > bbox.yMax ) 
bbox.yMax = glyph_bbox.yMax; 


/* 检查我们是否真的增加了字符串bbox */ 
if ( bbox.xMin > bbox.xMax ) 

bbox.xMin = 0; 
bbox.yMin = 0; 
bbox.xMax = 0; 
bbox.yMax = 0; 


/* 返回字符串bbox */ 
*abbox = bbox; 


最终得到的边界框尺寸以整数象素的格式表示,并且可以随后在渲染字符串前用来计算最终的笔位置,如下: 

/* 计算整数象素表示的字符串尺度 */ 
string_width = string_bbox.xMax - string_bbox.xMin; 
string_height = string_bbox.yMax - string_bbox.yMin; 

/* 计算以26.6笛卡儿象素表示的笔起始位置*/ 
start_x = ( ( my_target_width - string_width ) / 2 ) * 64; 
start_y = ( ( my_target_height - string_height ) / 2 ) * 64; 

for ( n = 0; n < num_glyphs; n++ ) 

FT_Glyph image; 
FT_Vector pen; 

image = glyphs[n]; 

pen.x = start_x + pos[n].x; 
pen.y = start_y + pos[n].y; 

error = FT_Glyph_To_Bitmap(&image, FT_RENDER_MODE_NORMAL, 
&pen, 0 ); 
if ( !error ) 

FT_BitmapGlyph bit = (FT_BitmapGlyph)image; 

my_draw_bitmap( bit->bitmap, 
bit->left, 
my_target_height - bit->top ); 

FT_Done_Glyph( image ); 



一些说明: 

* 笔位置以笛卡儿空间(例如,y向上)的形式表示。 

* 我们调用FT_Glyph_To_Bitmap时destroy参数设置为0(false),这是为了避免破坏原始字形图像。在执行该调用后,新的字形位图通过image访问,并且它的类型转变为FT_BitmapGlyph。 

* 当调用FT_Glyph_To_Bitmap时,我们使用了平移。这可以确保位图字形对象的左区域和上区域已经被设置为笛卡儿空间中的正确的象素坐标。 

* 当然,在渲染前我们仍然需要把象素坐标从笛卡儿空间转换到设备空间。因此在调用my_draw_bitmap前要先计算my_target_height – bitmap->top。 

相同的循环可以用来把字符串渲染到我们的显示面(surface)任意位置,而不需要每一次都重新装载我们的字形图像。我们也可以决定实现自动换行或者只是绘制。 

5.高级文本渲染:变换 + 居中 + 字距调整 

现在我们将修改我们的代码,以便可以容易地变换已渲染的字符串,例如旋转它。我们将以实行少许小改进开始: 

a.打包然后平移字形 

我们先把与一个字形图像相关的信息打包到一个结构体,而不是并行的数组。因此我们定义下面的结构体类型: 

typedef struct TGlyph_ 

FT_UInt index; /* 字形索引 */ 
FT_Vector pos; /* 基线上面的字形原点 */ 
FT_Glyph image; /* 字形图像 */ 
} TGlyph, *PGlyph; 

我们在装载每一个字形图像过程中,在把它装载它在基线所在位置后便直接平移它。我们将看到,这有若干好处。我们的字形序列装载其因而变成: 

FT_GlyphSlot slot = face->glyph; /* 一个小捷径 */ 
FT_UInt glyph_index; 
FT_Bool use_kerning; 
FT_UInt previous; 
int pen_x, pen_y, n; 

TGlyph glyphs[MAX_GLYPHS]; /* 字形表 */ 
PGlyph glyph; /* 表中的当前字形*/ 
FT_UInt num_glyphs; 

... 初始化库 ... 
... 创建face对象 ... 
... 设置字符尺寸 ... 

pen_x = 0; /* 以 (0,0) 开始 */ 
pen_y = 0; 

num_glyphs = 0; 
use_kerning = FT_HAS_KERNING( face ); 
previous = 0; 

glyph = glyphs; 
for ( n = 0; n < num_chars; n++ ) 

glyph->index = FT_Get_Char_Index( face, text[n] ); 

if ( use_kerning && previous && glyph->index ) 

FT_Vector delta; 

FT_Get_Kerning( face, previous, glyph->index, 
FT_KERNING_MODE_DEFAULT, &delta ); 

pen_x += delta.x >> 6; 


/* 保存当前笔位置 */ 
glyph->pos.x = pen_x; 
glyph->pos.y = pen_y; 

error = FT_Load_Glyph(face,glyph_index,FT_LOAD_DEFAULT); 
if ( error ) continue; 

error = FT_Get_Glyph( face->glyph, &glyph->image ); 
if ( error ) continue; 

/* 现在平移字形图像 */ 
FT_Glyph_Transform( glyph->image, 0, &glyph->pos ); 

pen_x += slot->advance.x >> 6; 
previous = glyph->index; 

/* 增加字形的数量 */ 
glyph++; 


/* 计算已装载的字形的数量 */ 
num_glyphs = glyph - glyphs; 

注意,这个时候平移字形有若干好处。第一是当我们计算字符串的边界框时不需要平移字形bbox。代码将会变成这样: 

void compute_string_bbox( FT_BBox *abbox ) 

FT_BBox bbox; 

bbox.xMin = bbox.yMin = 32000; 
bbox.xMax = bbox.yMax = -32000; 

for ( n = 0; n < num_glyphs; n++ ) 

FT_BBox glyph_bbox; 

FT_Glyph_Get_CBox( glyphs[n], &glyph_bbox ); 

if (glyph_bbox.xMin < bbox.xMin) 
bbox.xMin = glyph_bbox.xMin; 

if (glyph_bbox.yMin < bbox.yMin) 
bbox.yMin = glyph_bbox.yMin; 

if (glyph_bbox.xMax > bbox.xMax) 
bbox.xMax = glyph_bbox.xMax; 

if (glyph_bbox.yMax > bbox.yMax) 
bbox.yMax = glyph_bbox.yMax; 


if ( bbox.xMin > bbox.xMax ) 

bbox.xMin = 0; 
bbox.yMin = 0; 
bbox.xMax = 0; 
bbox.yMax = 0; 


*abbox = bbox; 


更详细描述:compute_string_bbox函数现在可以计算一个已转换的字形字符串的边界框。例如,我们可以做如下的事情: 

FT_BBox bbox; 
FT_Matrix matrix; 
FT_Vector delta; 

... 装载字形序列 ... 
... 设置 "matrix" 和 "delta" ... 

/* 变换字形 */ 
for ( n = 0; n < num_glyphs; n++ ) 
FT_Glyph_Transform( glyphs[n].image, &matrix, &delta ); 

/* 计算已变换字形的边界框 */ 
compute_string_bbox( &bbox ); 

b.渲染一个已变换的字形序列 

无论如何,如果我们想重用字形来以不同的角度或变换方式绘制字符串,直接变换序列中的字形都不是一个好主意。更好的方法是在字形被渲染前执行放射变换,如下面的代码所示: 

FT_Vector start; 
FT_Matrix transform; 

/* 获取原始字形序列的 bbox */ 
compute_string_bbox( &string_bbox ); 

/* 计算整数象素表示的字符串尺度 */ 
string_width = (string_bbox.xMax - string_bbox.xMin) / 64; 
string_height = (string_bbox.yMax - string_bbox.yMin) / 64; 

/* 设置26.6笛卡儿空间表示的笔起始位置 */ 
start.x = ( ( my_target_width - string_width ) / 2 ) * 64; 
start.y = ( ( my_target_height - string_height ) / 2 ) * 64; 

/* 设置变换(旋转) */ 
matrix.xx = (FT_Fixed)( cos( angle ) * 0x10000L ); 
matrix.xy = (FT_Fixed)(-sin( angle ) * 0x10000L ); 
matrix.yx = (FT_Fixed)( sin( angle ) * 0x10000L ); 
matrix.yy = (FT_Fixed)( cos( angle ) * 0x10000L ); 

for ( n = 0; n < num_glyphs; n++ ) 

FT_Glyph image; 
FT_Vector pen; 
FT_BBox bbox; 

/* 创建原始字形的副本 */ 
error = FT_Glyph_Copy( glyphs[n].image, &image ); 
if ( error ) continue; 

/* 变换副本(这将平移它到正确的位置) */ 
FT_Glyph_Transform( image, &matrix, &start ); 

/* 检查边界框;如果已变换的字形图像不在*/ 
/* 我们的目标表面中,我们可以避免渲染它 */ 
FT_Glyph_Get_CBox( image, ft_glyph_bbox_pixels, &bbox ); 
if ( bbox.xMax <= 0 || bbox.xMin >= my_target_width || 
bbox.yMax <= 0 || bbox.yMin >= my_target_height ) 
continue; 

/* 把字形图像转换为位图(销毁字形的副本!) */ 
error = FT_Glyph_To_Bitmap( 
&image, 
FT_RENDER_MODE_NORMAL, 
0, /* 没有附加的平移*/ 
1 ); /* 销毁 "image" 指向的副本 */ 
if ( !error ) 

FT_BitmapGlyph bit = (FT_BitmapGlyph)image; 

my_draw_bitmap( bitmap->bitmap, 
bitmap->left, 
my_target_height - bitmap->top ); 
FT_Done_Glyph( image ); 



这份代码相对于原始版本有少许改变: 

* 我们没改变原始的字形图像,而是变换该字形图像的拷贝。 

* 我们执行“剪取”操作以处理渲染和绘制的字形不在我们的目标表面(surface)的情况。 

* 当调用FT_Glyhp_To_Bitmap时,我们总是销毁字形图像的拷贝,这是为了销毁已变换的图像。注意,即使当这个函数返回错误码,该图像依然会被销毁(这就是为什么FT_Done_Glyph只在复合语句中被调用的原因)。 

* 平移字形序列到起始笔位置集成到FT_Glyph_Transform函数,而不是FT_Glyph_To_Bitmap函数。 

可以多次调用这个函数以渲染字符串到不同角度的,或者甚至改变计算start的方法以移动它到另外的地方。 

这份代码是FreeType 2示范程序ftstring.c的基础。它可以被简单地扩展,在第一部发完成高级文本布局或自动换行,而第二部分不需改变。 

无论如何,要注意通常的实现会使用一个字形缓冲以减少内存消耗。据个例子,让我们假定我们的字符串是“FreeType”。我们将在我们的表中保存字母‘e’的三个相同的字形图像,这不是最佳的(特别是当你遇到更长的字符串或整个页面时)。 

6.以预设字体单位的格式访问度量,并且伸缩它们 

可伸缩的字体格式通常会为字体face中的每一个字形保存一份矢量图像,该矢量图像称为轮廓。每一个轮廓都定义在一个抽象的网格中,该网格被称为 预设空间(design space),其坐标以名义上(nominal)的字体单位(font unit)表示。当装载一个字形图像时,字体驱动器通常会依照FT_Size对象所指定的当前字符象素尺寸把轮廓伸缩到设备空间。字体驱动器也能修改伸缩 过的轮廓以大大地改善它在基于象素的表面(surface)中显示的效果。修改动作通常称为hinting或网格对齐。 

这一章描述了如何把预设坐标伸缩到设备空间,以及如何读取字形轮廓和如何获取以预设字体单位格式表示的度量。这对许多事情来说都是重要的: 

* 真正的所见即所得文字排版 

* 为了字体转换或者分析的目的而访问字体内容 

a.伸缩距离到设备空间 

我们使用一个简单的伸缩变换把预设坐标伸缩到设备空间。变换系数借助字符象素尺寸来计算: 

Device_x = design_x * x_scale 
Device_y = design_y * y_scale 

X_scale = pixel_size_x / EM_size 
Y_scale = pixel_size_y / EM_size 

这里,值EM_Size是因字体而异的,并且对应预设空间的一个抽象矩形(称为EM)的大小。字体设计者使用该矩形创建字形图像。EM_Size 以字体单元的形式表示。对于可伸缩字体格式,可以通过face->unix_per_EM直接访问。你应该使用FT_IS_SCALABLE宏检查 某个字体face是否包含可伸缩字形图像,当包含时该宏返回true。 

当你调用函数FT_Set_Pixel_Sizes,你便指定了pixel_size_x和pixel_size_y的值。FreeType库将会立即使用该值计算x_scale和y_scale的值。 

当你调用函数FT_Set_Char_Size,你便以物理点的形式指定了字符尺寸。FreeType库将会使用该值和设备的解析度来计算字符象素尺寸和相应的比例因子。 

注意,在调用上面提及的两个函数后,你可以通过访问face->size->metrices结构的字段得到字符象素尺寸和比例因子的值。这些字段是: 

X_ppem 
这个字段代表了“每一个EM的x方向象素”,这是以整数象素表示EM矩形的水平尺寸,也是字符水平象素尺寸,即上面例子所称的pixel_size_x。 

y_ppem 
这个字段代表了“每一个EM的y方向象素”,这是以整数象素表示EM矩形的垂直尺寸,也是字符垂直象素尺寸,即上面例子所称的pixel_size_y。 

X_scale 
这是一个16.16固定浮点比例,用来把水平距离从预设空间直接伸缩到1/64设备象素。 

y_scale 
这是一个16.16固定浮点比例,用来把垂直距离从预设空间直接伸缩到1/64设备象素。 

你可以借助FT_MulFix函数直接伸缩一个以26.6象素格式表示的距离,如下所示: 

/* 把预设距离转换到1/64象素 */ 
pixels_x=FT_MulFix(design_x,face->size->metrics.x_scale); 
pixels_y=FT_MulFix(design_y,face->size->metrics.y_scale); 

当然,你也可以使用双精度浮点数更精确地伸缩该值: 

FT_Size_Metrics* metrics = &face->size->metrics; /* 捷径 */ 
double pixels_x, pixels_y; 
double em_size, x_scale, y_scale; 

/* 计算浮点比例因子 */ 
em_size = 1.0 * face->units_per_EM; 
x_scale = metrics->x_ppem / em_size; 
y_scale = metrics->y_ppem / em_size; 

/* 把预设距离转换为浮点象素 */ 
pixels_x = design_x * x_scale; 
pixels_y = design_y * y_scale; 

b.访问预设度量(字形的和全局的) 

你可以以字体单位的格式访问字形度量,只要在调用FT_Load_Glyph或FT_Load_Char时简单地指定FT_LOAD_NO_SCALE位标志便可以了。度量返回在face->glyph_metrics,并且全部都以字体单位的格式表示。 

你可以使用FT_KERNING_MODE_UNSCALED模式访问未伸缩的字距调整数据。 

最后,FT_Face句柄的字段包含少数几个全局度量,我们已经在本部分的第三章叙述过了。 

结论 

这是FreeType 2教程第二部分的结尾。现在你可以访问字形度量,管理字形图像,以及更巧妙地渲染文字(字距调整,测量,变换和缓冲)。 

现在你有了足够的知识能够以FreeType2为基础构建一个相当好的文字服务,而且要是你愿意,你可以在这里止步了。 

下一部分将涉及FreeType2的内部(例如模块,矢量轮廓,设备驱动器,渲染器),以及少数的字体格式特有的问题(主要是,如何访问某些TrueType或Type 1表)。【这部分还没有编写】

你可能感兴趣的:(vector,Module,library,Matrix,网格,postscript)