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也是可能的，但它们版本的Pango较旧，可能在未来一段时间内不会更新。

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默认使用wheel，请确保传递--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上做出贡献

如果您是普通用户，请勿阅读此部分，您有wheel可以直接使用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 2019和Windows10 SDK。

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

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

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

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

pip install Cython

最后，您可以像安装其他Python包一样安装您本地的 ManimPango 克隆，只需输入

pip install .

重要：在运行 ManimPango 之前，您必须使用 https://docs.pythonlang.cn/3/library/os.html#os.add_dll_directory。或者，您需要将位于 C:\cibw\vendor\bin 的 dll 复制到 ManimPango 编译的文件夹。这适用于Python 3.8及以上版本。

import os
os.add_dll_directory('C:\cibw\vendor\bin')

行为准则

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

许可证

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