命名空间

Pango – 1.0

国际化文本布局和渲染

版本1.56.0
作者Owen Taylor,Behdad Esfahbod
许可证LGPL-2.1-or-later
网站https://www.pango.org
来源https://gitlab.gnome.org/GNOME/pango/

构建

C 头文件pango/pango.h
pkg-config 文件pango

依赖项

GObject—2.0 基本类型系统库
浏览文档
HarfBuzz—0.0 一个文本整形库
浏览文档
PangoCairo Pango 对 Cairo 的支持
浏览文档
PangoFc Pango 对 Fontconfig 的支持
浏览文档
PangoFT2 Pango 对 FreeType 的支持
浏览文档
PangoOT Pango 对 OpenType 的支持
浏览文档
PangoXft Pango 对 Xft 的支持
浏览文档

上下文

一个 PangoContext 存储用于控制分项处理的全局信息。

覆盖

一个 PangoCoverage 结构是 Unicode 字符到 PangoCoverageLevel 值的映射。

字体

一个 PangoFont 用于以与渲染系统无关的方式表示字体。

字体样式

一个 PangoFontFace 用于表示一组具有相同字体系列、倾斜度、粗细和宽度的字体,但大小不同。

字体系列

一个 PangoFontFamily 用于表示相关字体样式的字体系列。

字体映射

一个 PangoFontMap 表示针对特定渲染系统可用的字体集。

字体集

一个 PangoFontset 表示在渲染文本时要使用的一组 PangoFont

简单字体集

PangoFontsetSimple 是一个作为字体数组实现的抽象 PangoFontset 基类的实现。

布局

一个 PangoLayout 结构表示一个完整的文本段落。

渲染器

PangoRenderer 是一个基础类,用于可以渲染作为 PangoGlyphStringPangoLayout 提供的文本的对象。

自:1.8

结构

分析

PangoAnalysis 结构存储有关文本片段属性的信息。

属性类

PangoAttrClass 结构存储特定类型的属性的类型和操作。

属性颜色

PangoAttrColor 结构用于表示是颜色的属性。

属性浮点

PangoAttrFloat 结构用于表示具有 float 或 double 值的属性。

属性字体描述

PangoAttrFontDesc 结构用于存储一个属性,该属性一次性设置字体描述的所有方面。

属性字体功能

PangoAttrFontFeatures 结构用于表示作为属性的 OpenType 字体功能。

自:1.38

属性

PangoAttribute 结构表示所有属性的公共部分。

属性整数

PangoAttrInt 结构用于表示具有整数或枚举值的属性。

属性迭代器

一个 PangoAttrIterator 用于遍历 PangoAttrList

属性语言

PangoAttrLanguage 结构用于表示是语言的属性。

属性列表

PangoAttrList 表示应用于文本段的属性列表。

AttrShape

PangoAttrShape 结构用于表示施加形状限制的属性。

AttrSize

PangoAttrSize 结构用于表示设置字体大小的属性。

AttrString

PangoAttrString 结构用于表示具有字符串值的属性。

Color

PangoColor 结构用于表示未校准的 RGB 颜色空间中的颜色。

FontDescription

PangoFontDescription 以与实现无关的方式描述字体。

FontMetrics

PangoFontMetrics 结构存储字体的一般度量信息。

GlyphGeometry

PangoGlyphGeometry 结构包含单个字形的宽度和定位信息。

GlyphInfo

PangoGlyphInfo 结构表示具有定位信息和视觉属性的单个字形。

GlyphItem

PangoGlyphItemPangoItem 和通过对项目文本定型产生的字形的配对。

GlyphItemIter

PangoGlyphItemIterPangoGlyphItem 中群集的迭代器。

since: 1.22

GlyphString

PangoGlyphString 用于存储具有几何和视觉属性信息的字形字符串。

GlyphVisAttr

PangoGlyphVisAttr 结构在定型阶段和渲染阶段之间传输信息。

Item

PangoItem 结构存储关于文本分段的信息。

Language

PangoLanguage 结构用于表示语言。

LayoutIter

PangoLayoutIter 可用于遍历 PangoLayout 的视觉范围。

LayoutLine

PangoLayoutLine 表示通过 PangoLayout 布局段落产生的行之一。

LogAttr

PangoLogAttr 结构存储关于单个字符的属性信息。

Matrix

PangoMatrix 指定用户空间和设备坐标之间的变换。

since: 1.6

Rectangle

PangoRectangle 结构表示矩形。

ScriptIter

PangoScriptIter 用于遍历字符串并识别不同脚本的范围。

TabArray

PangoTabArray 包含一个制表位数组。

别名

Glyph

PangoGlyph 表示字符串输出形式中的单个字形。

GlyphUnit

PangoGlyphUnit 类型用于存储 Pango 内的尺寸。

LayoutRun

PangoLayoutRun 表示 PangoLayoutLine 内的单次运行。

枚举

Alignment

PangoAlignment 描述如何在可用空间内对齐 PangoLayout 的行。

AttrType

PangoAttrType 区分不同类型的属性。

BaselineShift

影响运行之间基线偏移的枚举。

since: 1.50

BidiType

PangoBidiType 表示 Unicode 字符的双向字符类型。

已弃用: 1.44 since: 1.22

CoverageLevel

PangoCoverageLevel 用于表示字体对于特定脚本的特定 Unicode 字符的表现能力。

Direction

PangoDirection 表示 Unicode 双向算法中的方向。

EllipsizeMode

PangoEllipsizeMode 描述应用于文本的省略方式。

FontScale

影响上标和下标定位以及(仿效)小型大写字母字体的枚举。

since: 1.50

Gravity

PangoGravity 表示文本分段中字形的定位。

since: 1.16

GravityHint

PangoGravityHint 定义水平脚本在垂直上下文中应如何表现。

since: 1.16

Overline

PangoOverline 枚举用于指定文本是否应加删除线,如果是,则指定删除线的类型。

since: 1.46

RenderPart

PangoRenderPart 定义用于设置颜色等目的的不同渲染项。

自:1.8

Script

PangoScript 枚举标识不同的书写系统。

Stretch

指定与系列中其他设计相比的字体宽度的枚举。

Style

指定字体可能的不同倾斜样式的枚举。

TabAlign

PangoTabAlign 指定文本相对于制表位位置显示的位置。

TextTransform

影响 Pango 在成形期间如何处理字符的枚举。

since: 1.50

Underline

PangoUnderline 枚举用于指定文本是否应加下划线,如果是,则指定下划线的类型。

Variant

指定字体的大写小写变体的枚举。

Weight

指定一个字体(粗细)的重量的枚举。

WrapMode

PangoWrapMode 描述如何将 PangoLayout 的行换行到所需的宽度。

位段

FontMask

PangoFontMask 中的位对应 PangoFontDescription 中的设置字段。

LayoutDeserializeFlags

影响 pango_layout_deserialize() 行为的标志。

since: 1.50

LayoutSerializeFlags

影响 pango_layout_serialize() 行为的标志。

since: 1.50

ShapeFlags

影响成形过程的标志。

since: 1.44

ShowFlags

这些标志影响 Pango 如何处理输出中通常不可见的字符。

since: 1.44

错误域

LayoutDeserializeError

pango_layout_deserialize() 可能返回的错误。

since: 1.50

回调

AttrDataCopyFunc

可以复制属性的特定数据的函数类型。

AttrFilterFunc

过滤属性列表的函数类型。

FontsetForeachFunc

在字体集中枚举字体时使用的回调。

since: 1.4

函数

attr_allow_breaks_new

创建一个新的允许断行属性。

since: 1.44

attr_background_alpha_new

创建一个新的背景 alpha 属性。

自:1.38

attr_background_new

创建一个新的背景颜色属性。

attr_baseline_shift_new

创建一个新的基线偏移属性。

since: 1.50

attr_break

从属性中将自定义应用到 attrs 中的断行。

since: 1.50

attr_fallback_new

创建一个新的字体后备属性。

since: 1.4

attr_family_new

创建一个新的字体系列属性。

attr_font_scale_new

创建一个新的字体缩放属性。

since: 1.50

attr_foreground_alpha_new

创建一个新的前景 alpha 属性。

自:1.38

attr_foreground_new

创建一个新的前景颜色属性。

attr_gravity_hint_new

创建一个新的重力提示属性。

since: 1.16

attr_gravity_new

创建一个新的重力属性。

since: 1.16

attr_insert_hyphens_new

创建一个新的插入连字符属性。

since: 1.44

attr_letter_spacing_new

创建一个新的 letter-spacing 属性。

since: 1.6

attr_line_height_new

以某个因子修改逻辑行范围的高度。

since: 1.50

attr_line_height_new_absolute

将逻辑行范围的高度重写为 height

since: 1.50

attr_overline_color_new

创建一个新的删除线颜色属性。

since: 1.46

attr_overline_new

创建一个新的删除线样式属性。

since: 1.46

attr_rise_new

创建一个新的基线偏移属性。

attr_scale_new

创建新的字体大小范围属性。

attr_sentence_new

将属性的范围标记为单句。

since: 1.50

attr_show_new

创建新的属性来影响以何种方式渲染不可见字符。

since: 1.44

attr_stretch_new

创建新的字体扩张属性。

attr_strikethrough_color_new

创建新的删除线颜色属性。

自:1.8

attr_strikethrough_new

创建新的删除线属性。

attr_style_new

创建新的字体倾斜样式属性。

attr_text_transform_new

创建新的属性来影响在定型期间以何种方式转换字符。

since: 1.50

attr_underline_color_new

创建新的下划线颜色属性。

自:1.8

attr_underline_new

创建新的下划线样式属性。

attr_variant_new

创建新的字体变体属性(常规或小型 Caps)。

attr_weight_new

创建新的字体粗细属性。

attr_word_new

将属性的范围标记为单字。

since: 1.50

break

为单一 Unicode 文本字符串确定可能的行、字和字符断点(通过单一分析)。

已弃用:1.44 

default_break

这是默认断点算法。

extents_to_pixels

将外延从 Pango 单位转换为设备单位。

since: 1.16

find_base_dir

根据 Unicode 双向算法,在字符串中搜索第一个具有强方向的字符。

since: 1.4

find_paragraph_boundary

text 中找到段落边界。

get_log_attrs

text 中的每个字符计算一个 PangoLogAttr

get_mirror_char

返回 Unicode 字符的镜像字符。

已弃用:1.30 

is_zero_width

检查是否应该不正常渲染字符。

since: 1.10

itemize

将一段文本拆分为具有连续方向级别和字体的段。

itemize_with_base_dir

pango_itemize() 类似,但具有明确指定的基础方向。

since: 1.4

log2vis_get_embedding_levels

返回输入段落的双向嵌入级别。

since: 1.4

markup_parser_finish

完成解析标记。

since: 1.31.0

markup_parser_new

增量解析标记文本以创建纯文本字符串和属性列表。

since: 1.31.0

parse_enum

解析枚举类型并将结果存储在 value 中。

已弃用:1.38 since: 1.16

parse_markup

解析标记文本以创建纯文本字符串和属性列表。

parse_stretch

解析字体扩张。

parse_style

解析字体样式。

parse_variant

解析字体变体。

parse_weight

解析字体粗细。

quantize_line_geometry

对线段的厚度和位置进行量化处理,以转换为完整设备像素。

since: 1.12

read_line

从文件读取一行内容到缓冲区中。

已弃用:1.38 

reorder_items

从逻辑顺序重新排序为可视顺序。

scan_int

扫描整数。

已弃用:1.38 

scan_string

将字符串扫描到 GString 缓冲区。

已弃用:1.38 

scan_word

将单词扫描到 GString 缓冲区。

已弃用:1.38 

shape

转换 text 中的字符为字形。

shape_full

转换 text 中的字符为字形。

since: 1.32

shape_item

转换 item 中的字符为字形。

since: 1.50

shape_with_flags

转换 text 中的字符为字形。

since: 1.44

skip_space

跳过 0 个或多个空格字符。

已弃用:1.38 

split_file_list

G_SEARCHPATH_SEPARATOR 分隔的文件列表,去掉空格并用 ~/ 替换为 $HOME/。

已弃用:1.38 

tailor_break

将特定语言的定制应用于 attrs 中的断点。

since: 1.44

trim_string

去掉字符串前后空白。

已弃用:1.38 

unichar_direction

确定字符的固有方向。

units_from_double

将浮点数转换为 Pango 单位。

since: 1.16

units_to_double

将 Pango 单位中的数字转换为浮点数。

since: 1.16

version

返回在运行时可用的 Pango 编码版本。

since: 1.16

version_check

检查正在使用的 Pango 库是否与给定的版本兼容。

since: 1.16

version_string

返回在运行时可用的 Pango 版本。

since: 1.16

函数宏

ASCENT

从表示字形范围的 `PangoRectangle` 中提取上坡度(ascent)。

DESCENT

从表示字形范围的 `PangoRectangle` 中提取下坡度(descent)。

LBEARING

从表示字形范围的 `PangoRectangle` 中提取左轴承(left bearing)。

PIXELS

通过舍入,将维度转换为设备单位。

PIXELS_CEIL

通过取上限,将维度转换为设备单位。

自:1.14

PIXELS_FLOOR

通过取下限,将维度转换为设备单位。

自:1.14

RBEARING

从表示字形范围的 `PangoRectangle` 中提取右轴承(right bearing)。

UNITS_CEIL

将维度向上舍入为整个设备单位,但不会将其转换为设备单位。

since: 1.50

UNITS_FLOOR

将维度向下舍入为整个设备单位,但不会将其转换为设备单位。

since: 1.50

UNITS_ROUND

将维度舍入为整个设备单位,但不会将其转换为设备单位。

自:1.18

VERSION_CHECK

检查在编译时可用的 Pango 版本是否不低于提供的版本号。

VERSION_ENCODE

此宏将给定 Pango 版本编码为一个整数。使用此宏对 `PANGO_VERSION` 和 `pango_version()` 返回的数字进行编码。可以将两个编码版本号作为整数进行比较。

常量

ANALYSIS_FLAG_CENTERED_BASELINE

片段是否应偏移到以基线为中心。

ANALYSIS_FLAG_IS_ELLIPSIS

此运行是否包含省略号文本。

ANALYSIS_FLAG_NEED_HYPHEN

在整形过程中是否在运行结尾添加连字符。

ATTR_INDEX_FROM_TEXT_BEGINNING

`PangoAttribute` 中用于指示文本开头的 `start_index` 值。

ATTR_INDEX_TO_TEXT_END

`PangoAttribute` 中用于指示文本结尾的 `end_index` 值。

GLYPH_EMPTY

指示零宽空字形的 `PangoGlyph` 值。

GLYPH_INVALID_INPUT

无效输入的 `PangoGlyph` 值。

GLYPH_UNKNOWN_FLAG

在 `PangoGlyph` 中使用的标志,可将有效 Unicode 字符的 `gunichar` 值转换为该 `gunichar` 的未知字符字形。

SCALE

用于 Pango 距离和设备单位之间的尺寸之间的比例。

VERSION_MAJOR

在编译时可用的 Pango 版本的主要组件。

VERSION_MICRO

在编译时可用的 Pango 版本的微型组件。

VERSION_MINOR

在编译时可用的 Pango 版本的次要组件。

VERSION_STRING

包含在编译时可用的 Pango 版本的字符串文字。