函数

Pangoshape_with_flags

自:1.44

声明 [src]

void
pango_shape_with_flags (
  const char* item_text,
  int item_length,
  const char* paragraph_text,
  int paragraph_length,
  const PangoAnalysis* analysis,
  PangoGlyphString* glyphs,
  PangoShapeFlags flags
)

描述 [src]

text 中的字符转换成字形。

对于一段文本和相应的来自 pango_itemize()PangoAnalysis 结构,将字符转换成字形。你还可以仅传入来自 pango_itemize() 的项的子字符串。

这与 pango_shape_full() 类似,除了它还接受可以影响塑造进程的标记。

连字符插入和文本转换(特别是大写)的一些方面需要日志属性,因此只能由 pango_shape_item() 处理。

请注意,从 pango_itemize() 返回的 analyis 中的额外属性具有相对于整个段落的索引,因此不要将全段文本作为 paragraph_text 传递,需要在调用 pango_shape_with_flags() 之前从其索引中减去项偏移。

自 1.44 起可用

参数

item_text

类型: const char*

有效的要塑造的 UTF-8 文本。

数据归函数调用者所有。
该值是一个以 NUL 结尾的 UTF-8 字符串。
item_length

类型: int

item_text 的长度(以字节为单位)。-1 表示以 nul 结尾的文本。

paragraph_text

类型: const char*

段落的文本(参见详情)。

参数可以是 NULL
数据归函数调用者所有。
该值是一个以 NUL 结尾的 UTF-8 字符串。
paragraph_length

类型: int

paragraph_text 的长度(以字节为单位)。-1 表示以 nul 结尾的文本。

analysis

类型: PangoAnalysis

来自 pango_itemize()PangoAnalysis 结构。

数据归函数调用者所有。
glyphs

类型: PangoGlyphString

用来存储结果的字形字符串。

数据归函数调用者所有。
flags

类型: PangoShapeFlags

影响塑造进程的标记。