函数

PangoFontDescriptionfrom_string

声明 [src]

PangoFontDescription*
pango_font_description_from_string (
  const char* str
)

描述 [src]

从字符串表示形式创建一个新的字体描述。

字符串必须具有以下形式

"[FAMILY-LIST] [STYLE-OPTIONS] [SIZE] [VARIATIONS]",

其中 FAMILY-LIST 是由逗号分隔的家族列表,可选地以逗号结束,STYLE_OPTIONS 是由空格分隔的单词列表,其中每个单词描述了一个样式、变体、粗细、拉伸或重力,而 SIZE 是一个十进制数字(以点为单位的大小)或可选地后跟单位修饰符 “px” 以进行绝对大小。 VARIATIONS 是一个逗号分隔的字体变化规范列表,形式为 @‍axis=value(等号是可选的)。

以下单词被视为样式:“正常”、“罗马”、“斜体”、“意大利斜体”。

以下单词被视为变体:“小写字母”、“全小写字母”、“小写字母”、“全小写字母”、“单大小写”、“标题大小写”。

以下单词被视为粗细:“细”、“超轻”、“超细”、“轻”、“半轻”、“细半粗”、“半粗”、“书籍”、“常规”、“中等”、“半粗”、“半粗”、“粗”、“超粗”、“超粗”、“超粗”、“黑”、“超黑”、“超黑”。

以下单词被视为拉伸值:“超紧缩”、“超紧缩”、“紧缩”、“半紧缩”、“半扩展”、“扩展”、“超扩展”、“超扩展”。

以下单词被视为重力值:“未旋转”、“南”、“颠倒”、“北”、“左旋转”、“东”、“右旋转”、“西”。

任何选项都可能不存在。如果 FAMILY-LIST 不存在,则生成的字体描述中的 family_name 字段将被初始化为 NULL。如果 STYLE-OPTIONS 缺失,则所有样式选项将设置为默认值。如果 SIZE 缺失,则生成的字体描述中的大小将设置为 0。

一个典型的例子

"Cantarell Italic Light 15 @‍wght=200".

参数

str

类型: const char*

字体描述的字符串表示。

数据由函数的调用者拥有。
值是一个空终止的 UTF-8 字符串。

返回值

类型: PangoFontDescription

一个新的 PangoFontDescription

函数的调用者获取数据所有权,并负责释放它。