与 Manim 一起使用的 Pango 绑定。
项目描述
曼尼潘戈
ManimPango是使用Cython的Pango的 C 绑定,在Manim内部用于渲染(非 LaTeX)文本。
安装
安装ManimPango非常简单,只需使用pip. 它manimpango在 PyPi 中。
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
软呢帽: dnf install pango-devel pkg-config python3-devel
或在系统的包管理器中类似。
使用tar档案
如果您不想为此存储库做出贡献,您可以使用 PyPi 中发布的 tar 存档,或者只是使用pip安装使用
pip install manimpango --no-binary :all:
注意:pip默认情况下使用轮子,所以一定要传递--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 一起贡献
如果您是普通用户,请不要阅读本文,您可以使用 pip 直接安装轮子。
如果您想为ManimPango做出贡献并且您使用的是 Windows,那么此部分适合您。
由于 Windows 默认不包含 C 编译器,因此您首先需要安装一个。你有两个选择:
-
MinGW/Msys2
-
视觉工作室
MinGW/Msys2
- 从他们的页面https://www.msys2.org/#installation上提供的下载链接下载MSYS2并根据他们的说明进行安装。
- 一旦你安装了MSYS2,它会为你提供三种不同的 shell:MinGW32 shell、MinGW64 shell 和MSYS shell。为了使以下步骤起作用,您必须打开MSYS2 MinGW64 shell(您可以搜索它)。小提示:它有一个蓝色的标志。
- 运行以下命令安装 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
- 仍然在同一个 shell 中,使用
pip install manim. - 最后,将ManimPango的克隆复制
cd到该目录中,然后运行pip install -e .. 注意您不能将它与常规 Python 版本一起使用。如果这样做会导致奇怪的错误。要使用ManimPango,您必须在MSYS2 MINGW64 shell. - 然后,您可以
manim在该外壳内使用来运行Manim。 提示:如果您想以交互方式试用 Python,可以使用该 shellidle中的命令打开。python -m idlelib
视觉工作室
首先,按照https://wiki.python.org/moin/WindowsCompilers中的说明安装 Visual Studio 。可能是带有 Windows10 SDK 的 Visual Studio Build Tools 2019。
然后在 处运行脚本packing/download_dlls.py。这将获得一个Pango版本,pkg-config并将其安装在C:\cibw\vendor. 添加C:\cibw\vendor\bin和C:\cibw\vendor\pkg-config\bin到 PATH。
注意:您可以通过编辑文件的第 24 行来更改安装位置packing/download_dlls.py。
然后设置一个环境变量PKG_CONFIG_PATH= C:\cibw\vendor\lib\pkgconfig。
然后你可以使用安装 Cython
pip install Cython
最后,您可以像安装任何其他 python 包一样安装本地ManimPango克隆,方法是键入:
pip install .
重要提示:在运行ManimPango之前,您必须使用https://docs.python.org/3/library/os.html#os.add_dll_directory。或者,您需要将at复制到编译ManimPango的文件夹中。这适用于 Python 3.8 及更高版本。dllC:\cibw\vendor\bin
import os
os.add_dll_directory('C:\cibw\vendor\bin')
行为守则
可以在我们的网站上阅读我们的完整行为准则以及我们如何执行它。
执照
该项目在 MIT 许可下获得许可。在 PyPI 上分发的轮子包含 Pango 和 Cairo 的编译版本,受 GNU LGPL 和其他许可条款的约束。有关更多信息,请查阅每个库的许可证。
项目详情
下载文件
下载适用于您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。
源分布
内置发行版
ManimPango -0.4.1.tar.gz 的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | f2da037ccdfe174040d3315001cc59bfc7405cd1b1191078bd4db0938005d649 |
|
| MD5 | 01d4a2139007c5514944619563efa679 |
|
| 布莱克2-256 | a8c023944d54e7a56986c7a90869b6461f5ee8b93c229937e01ff5d4531a017d |
ManimPango -0.4.1-cp310-cp310-win_amd64.whl 的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | a83da66451498d6cc3f6e637157ca6c7530b68f9bc0ac6fe043b04bf78c87073 |
|
| MD5 | 30e5dc429c9573ef01d909d40d330ecf |
|
| 布莱克2-256 | f6a67f49a2bb3e023e86614fb270911fcec535029fdbafe12dfc6fc3e98d13cb |
ManimPango -0.4.1-cp310-cp310-win32.whl 的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | 5228e5326dc52753f4e6855ac4bf9667d78c0005315cddaf74fac5c2a6f87bc3 |
|
| MD5 | f0291439c99c87f92a0205a2ccf88019 |
|
| 布莱克2-256 | 5b31f8205cad0f72409e3296a49c1ddbdacc5067d0e5289e1188221032143de7 |