功能
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-
类型:
intitem_text的长度(以字节为单位)。-1 表示以空结尾的文本。 paragraph_text-
类型:
const char*段落的文本(请参阅详情)。
该参数可以为 NULL。数据归函数调用者所有。 该值是要以 NUL 结尾的 UTF-8 字符串。 paragraph_length-
类型:
intparagraph_text的长度(以字节为单位)。-1 表示以空结尾的文本。 analysis-
类型:
PangoAnalysis来自
pango_itemize()的PangoAnalysis结构。数据归函数调用者所有。 glyphs-
类型:
PangoGlyphString要在其中存储结果的字形字符串。
数据归函数调用者所有。