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 的字形都會被靜默刪除。