函数
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
影响塑造进程的标记。