功能

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_textNULL,则使用项目文本代之。

连字符插入和文本转换(特别是大写)的某些方面需要日志属性,因此只能由 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

要在其中存储结果的字形字符串。

数据归函数调用者所有。