ManimPango

ManimPango 是使用 Pango 的 C 绑定，通过 Cython 实现，并在 Manim 中内部用于渲染（非 LaTeX）文本。

安装

安装 ManimPango 非常简单，只需使用 pip。它是 PyPi 上的 manimpango。

pip install manimpango

Linux 用户，没有 Wheels。您必须拥有 C 编译器以及 Pango 和其依赖项以及 Pango 的开发头文件。有关更多信息，请参阅 构建。

工作流程设置/贡献

为了使开发者更容易贡献，我们有一个预提交工作流程，该工作流程将检查 black 格式化和 flake 检查。

pip install pre-commit
pre-commit install

构建

Linux/MacOS

要构建 ManimPango，您需要

• C 编译器
• Python 的开发头文件
• pkg-config
• Pango 以及其开发头文件及其依赖项。

如果您使用 MacOS，可以使用 brew 来安装这些。使用 MacPorts 也是可能的。

brew install pango pkg-config

如果您使用 Linux，可以使用系统包管理器来这样做。例如，如果您使用基于 Debian 的系统，您可以使用 apt

apt install libpango1.0-dev pkg-config python3-dev

Arch Linux： pacman -S pango pkgconf

Fedora： dnf install pango-devel pkg-config python3-devel

或在您系统的包管理器中类似操作。

使用 tar 归档

如果您不打算为此存储库做出贡献，您可以使用 PyPi 上发布的 tar 归档，或者只需使用 pip 安装即可

pip install manimpango --no-binary :all:

注意：pip 默认使用 wheels，所以请确保传递 --no-binary 参数。

使用 git 克隆/贡献

请记住，如果您想使用 ManimPango 与 Manim 一起使用，请在此操作。

python -m venv ./venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows

如果您使用此存储库的克隆版本，您将需要 Cython，它可以通过 pip 简单安装

pip install Cython

之后，您可以使用以下命令使用 pip 安装克隆版本

pip install -e .
pip install -r requirements-dev.txt .

然后，运行设置脚本

python setup.py build_ext -i

安装完成后，您应该能够运行 pytest

pytest

如果您想为 ManimPango 做出贡献，则需要这样做。

在 Windows 上贡献

如果您是普通用户，请勿阅读此部分，您有 wheels，可以直接使用 pip 安装。

如果您想为 ManimPango 做出贡献并且您使用 Windows，这部分是针对您的。

由于 Windows 默认不包含 C 编译器，您首先需要安装一个。您有两个选择

1. MinGW/Msys2

2. Visual Studio

MinGW/Msys2

1. 从其页面提供的下载链接 https://www.msys2.org/#installation 下载 MSYS2 并按照他们的说明进行安装。
2. 一旦安装了 MSYS2，它提供了三个不同的 shell：MinGW32 shell、MinGW64 shell 和 MSYS shell。为了使以下步骤正常工作，您必须打开 MSYS2 MinGW64 shell（您可以在搜索中查找此内容）。小提示：它有一个蓝色标志。
3. 运行以下命令安装 Python、Pango、Cython、Numpy、Scipy、Pillow、Pycairo 和 ffmpeg

pacman -S mingw-w64-x86_64-python
pacman -S mingw-w64-x86_64-python-pip
pacman -S mingw-w64-x86_64-pango
pacman -S mingw-w64-x86_64-cython
pacman -S mingw-w64-x86_64-python-numpy
pacman -S mingw-w64-x86_64-python-scipy
pacman -S mingw-w64-x86_64-python-pillow
pacman -S mingw-w64-x86_64-python-cairo
pacman -S mingw-w64-x86_64-ffmpeg

4. 仍在同一 shell 中，使用 pip install manim 安装 Manim。
5. 最后，获取你的 ManimPango 克隆版本，进入该目录然后运行 pip install -e .。 注意 你不能使用常规的 Python 版本。这样会导致一些奇怪的错误。要使用 ManimPango，你必须处于 MSYS2 MINGW64 shell 内。
6. 然后你可以在该 shell 中使用 manim 来运行 Manim。 提示：如果你想要交互式地尝试 Python，可以在该 shell 中使用命令 python -m idlelib 打开 idle。

Visual Studio

首先，按照 https://wiki.python.org/moin/WindowsCompilers 中的说明安装 Visual Studio。可能是 Visual Studio Build Tools 2022 和 Windows10 SDK。

然后运行 packing/download_dlls.py 脚本。这将获取一个包含 pkg-config 的 Pango 构建，并将其安装到 C:\cibw\vendor。将 C:\cibw\vendor\bin 添加到 PATH。

注意：你可以通过编辑 packing/download_dlls.py 文件的第 24 行来更改安装位置。

然后设置环境变量 PKG_CONFIG_PATH=C:\cibw\vendor\lib\pkgconfig。

然后你可以使用以下命令安装 Cython

pip install Cython

最后，你可以像安装其他 Python 包一样，通过键入以下命令安装你的本地 ManimPango 克隆版本

pip install .

行为准则

我们的完整行为准则以及我们如何执行它，可以在 我们的网站 上阅读。

许可证

本项目采用 MIT 许可证。PyPI 上分发的轮子包含受 GNU LGPL 和其他许可证条款约束的 Pango 和 Cairo 的编译版本。有关更多信息，请查阅每个库的许可证。