R glyphInfo 说明一组排版字形

说明

创建一个包含有关排版字形信息的对象。这包括字形标识符、字形位置、字体和颜色信息以及度量信息。

用法

glyphInfo(id, x, y, font, size, fontList, 
          width, height, hAnchor, vAnchor,
          col=NA)

glyphFont(file, index, family, weight, style, PSname=NA)
glyphFontList(...)
glyphAnchor(value, label)
glyphWidth(w, label="width", left="left")
glyphHeight(h, label="height", bottom="bottom")
glyphWidthLeft(w, label)
glyphHeightBottom(h, label)
glyphJust(just, ...)
## S3 method for class 'GlyphJust'
glyphJust(just, ...)
## S3 method for class 'character'
glyphJust(just, ...)
## S3 method for class 'numeric'
glyphJust(just, which=NULL, ...)

参数

id	字形标识符的数字向量(字体文件内的字形索引)。
x , y	(大)点(1/72 英寸)中字形的数字位置。
font	fontList 的整数索引。
size	字形的数字大小(以磅为单位)。
fontList	字形字体列表，由 glyphFont() 生成。
width	字形的总宽度。可以是单个数值，但也可以是调用 glyphWidth() 的结果。
height	字形的总高度。可以是单个数值，但也可以是调用 glyphHeight() 的结果。
hAnchor	用于相对于( x 、 y )位置对齐字形的水平锚点。可以是单个数值(根据 "left" 进行调整)，但也可以是调用 glyphAnchor() 的结果。
vAnchor	用于相对于(x、y)位置对齐字形的垂直锚点。可以是单个数值(根据 "bottom" 进行调整)，但也可以是调用 glyphAnchor() 的结果。
col	每个字形的 R 颜色值。可以是 NA 。
file	字体文件的字符路径。
index	字体文件中字体的数字索引。
family	字体系列的字符名称。
weight	字形的数字权重(400 为正常值，700 为粗体)。
style	字形的字符样式( "normal" 、 "italic" 或 "oblique" )。
PSname	每种字体的 PostScript 名称。可以是 NA 。
value , w , h	一个数值。
label , left , bottom	一个字符值。
just	理由值。字符值(如 "left")或数字值(如 0)。
which	当 x 为数字时，是一个字符值，用于标识该数字值相对于哪个宽度度量。
...	进一步的参数传递给其他方法。

细节

可以指定多个锚点，以便允许字形相对于( x 、 y )位置进行不同的基于字符的对齐。需要带有标签 "left" 、 "centre" 和 "right" 的水平锚点。可以指定单个数字 hAnchor ，它被视为 "left" 锚点，或者带有标签 "left" 的单个锚点，在这种情况下，将根据字形所需的宽度计算其他所需的锚点(见下文)。需要带有标签 "bottom" 、 "centre" 和 "top" 的垂直锚点。可以指定单个数字 vAnchor ，它被视为 "bottom" 锚点，或者带有标签 "bottom" 的单个锚点，在这种情况下，将根据字形所需的高度计算其他所需的锚点(见下文)。非必需锚点的示例是带有标签 "baseline" 的垂直锚点，以便可以将字形的基线放置在 y 位置。

可以指定多个宽度和高度，以便允许字形相对于(x、y)位置进行不同的基于数字的对齐，例如，0 表示 left-justification，1 表示 right-justification ，但也可以使用介于这些限制之间甚至超出这些限制的任何值。需要带有标签 "width" 的宽度，相对于 "left" 水平锚点，但如果给出单个数值，则假定为所需的宽度。需要相对于 "bottom" 垂直锚点带有标签 "height" 的高度，但如果给出单个数值，则假定该高度是所需的高度。非必需宽度的一个示例是 "tight" 宽度，它相对于 "left-bearing" 水平锚点，以便字形可以相对于字形墨水周围的边界框(而不是包含左边界的边界框)对齐。和右轴承。

glyphWidthLeft() 和 glyphWidthHeight() 为需要访问宽度和高度指标相关锚点的代码提供 API。

值

glyphInfo() 的结果是一个 "RGlyphInfo" 对象，本质上是一个 DataFrame ，每行包含字形的 id、位置、字体和颜色。度量信息(宽度和锚点)作为数据帧的属性存储。

glyphAnchor() 、 glyphWidth() 和 glyphHeight() 返回可用于将 width 、 height 、 hAnchor 和 vAnchor 值指定为 glyphInfo() 的值。

警告

id 、 x 、 y 或 size 中任何带有 NA 的字形都会被静默删除。