功能
Pangoshape_full
自:1.32
声明 [src]
void
pango_shape_full (
const char* item_text,
int item_length,
const char* paragraph_text,
int paragraph_length,
const PangoAnalysis* analysis,
PangoGlyphString* glyphs
)
说明 [src]
将 text
中的字符转换为字形。
给定一段文本和从 pango_itemize()
返回的相应 PangoAnalysis
结构,将字符转换为字形。您还可以仅传入 pango_itemize()
中项目的一个子字符串。
这类似于 pango_shape()
,但它还可以选择将整个段落文本作为输入,然后将该文本用于执行某些项目间的塑造交互。如果您可以访问 item_text
所在的更广泛文本,请将更广泛的文本作为 paragraph_text
提供。如果 paragraph_text
为 NULL
,则使用项目文本代之。
连字符插入和文本转换(特别是大写)的某些方面需要日志属性,因此只能由 pango_shape_item()
处理。
请注意,从 pango_itemize()
返回的 analyis
中的额外属性具有相对于整个段落的索引,因此您不要将整个段落文本作为 paragraph_text
传递,您需要在调用 pango_shape_full()
之前从其索引中减去项目偏移。
自以下版本提供:1.32
参数
item_text
-
类型:
const char*
要塑造的有效 UTF-8 文本。
数据归函数调用者所有。 该值是要以 NUL 结尾的 UTF-8 字符串。 item_length
-
类型:
int
item_text
的长度(以字节为单位)。-1 表示以空结尾的文本。 paragraph_text
-
类型:
const char*
段落的文本(请参阅详情)。
该参数可以为 NULL
。数据归函数调用者所有。 该值是要以 NUL 结尾的 UTF-8 字符串。 paragraph_length
-
类型:
int
paragraph_text
的长度(以字节为单位)。-1 表示以空结尾的文本。 analysis
-
类型:
PangoAnalysis
来自
pango_itemize()
的PangoAnalysis
结构。数据归函数调用者所有。 glyphs
-
类型:
PangoGlyphString
要在其中存储结果的字形字符串。
数据归函数调用者所有。