GNU FriBidi 技术文档

1. 安装指南

要安装 GNU FriBidi，您可以按照以下步骤操作：

• 首先，访问 GNU FriBidi GitHub 页面 以下载最新版本的源代码。
• 解压下载的源代码包。
• 在解压后的目录中，运行 ./autogen.sh 脚本以生成构建脚本。
• 接下来，运行 ./configure 命令进行配置。
• 最后，运行 make 命令来编译源代码，然后使用 make install 命令安装库。

2. 项目的使用说明

GNU FriBidi 是一个实现了 Unicode 双向算法的库，主要用于支持阿拉伯语和希伯来语等需要双向文本排列的文本处理。它已被多个自由软件项目所采用，例如 Pango、AbiWord 和 MPlayer 等。

3. 项目 API 使用文档

以下是项目的主要 API 函数 fribidi_log2vis 的使用说明：

fribidi_boolean fribidi_log2vis(
    /* 输入 */
    FriBidiChar     *str,
    FriBidiStrIndex len,
    FriBidiCharType *pbase_dir,
    /* 输出 */
    FriBidiChar     *visual_str,
    FriBidiStrIndex *position_L_to_V_list,
    FriBidiStrIndex *position_V_to_L_list,
    FriBidiLevel    *embedding_level_list
)

• str: Unicode 输入字符串。
• len: Unicode 字符串的长度。
• pbase_dir: 输入和输出基本方向。如果 pbase_dir == FRIBIDI_TYPE_ON，则 fribidi_log2vis() 会根据双向算法自行计算基本方向。
• visual_str: 重排后的输出 Unicode 字符串。
• position_L_to_V_list: 逻辑字符串中的位置映射到视觉字符串中的位置。
• position_V_to_L_list: 视觉字符串中的位置映射到逻辑字符串中的位置。
• embedding_level_list: 返回每个字符的分类。偶数级别表示 LTR 字符，奇数级别表示 RTL 字符。

如果任何输出指针等于 NULL，则不计算该信息。

请注意，调用 fribidi_log2vis() 相当于依次调用以下三个函数：

1. fribidi_get_bidi_types()
2. fribidi_get_par_embedding_levels_ex()
3. fribidi_reorder_line()

4. 项目安装方式

GNU FriBidi 支持两种构建系统：GNU Build System 和 meson。以下是使用这两种方式的安装步骤：

使用 GNU Build System

1. 下载并解压源代码。
2. 在解压后的目录中，运行 ./autogen.sh。
3. 运行 ./configure。
4. 运行 make。
5. 运行 make install。

使用 meson

1. 下载并解压源代码。
2. 在解压后的目录中，创建一个构建目录，例如 mkdir build。
3. 进入构建目录，运行 meson ..。
4. 运行 ninja。
5. 运行 ninja install。

这样，您就可以成功安装 GNU FriBidi 并开始使用了。