亲爱的imgui基于cython的python绑定
imgui的Python项目详细描述
版本:
Pyimgui
Python绑定 {a6} C++库-无臃肿 即时模式图形用户界面。
安装
pyimgui在pypi上可用,因此您可以使用pip
:
pip install imgui[full]
上面的命令将安装imgui
包,其中包含所有
内置渲染后端集成(pygame、cocos2d等)。如果你不知道
希望安装所有可以始终使用bare的附加依赖项
pip install imgui
命令或选择一组特定的额外要求:
- 对于pygame后端使用
pip install imgui[pygame]
- 对于glfw3后端使用
pip install imgui[glfw]
- 对于SDL2后端使用
pip install imgui[sdl2]
- 对于cocos2d后端使用
pip install imgui[cocos2d]
- 对于pyglet后端使用
pip install imgui[pyglet]
包以build wheels的形式分发,因此不需要 在大多数操作系统上编译。有关兼容性的详细信息 对于不同的os和python版本,请参见project ditribution 本文档页的部分。
项目状态
imgui
包为大多数核心imgui小部件和
功能。一些低级的api元素和复杂的小部件(比如图)
可能不见了。我们正在努力提供核心100%的特征映射
imgui库。completion徽章显示该目标的最新状态。
项目分布
这个项目在Appveyor和Travis上有工作构建管道 适用于具有不同体系结构的所有主要操作系统:
- Windows(32位和64位)
- Linux(32位和64位)
- OS X(通用版本)
现在,我们已经准备好为这三个系统运送轮子了
(即使对于使用manylinux1
控制盘的Linux)。构建管道覆盖多个
python版本:
- PY27
- PY33
- PY34
- PY35
- PY36
pyimgui提供了包含多个可视示例的文档。 由于自定义的sphinx扩展,我们能够将gui示例呈现出来 直接从docstring片段中筛选。这些示例也可以作为自动化的 功能测试。文档托管在 pyimgui.readthedocs.io。
如果这些控制盘都不在您的环境中工作,则可以安装imgui
从sdist发行版直接编译包,使用以下方法之一
命令:
# will install Cython as extra dependency and compile from Cython sources
pip install imgui[Cython] --no-binary imgui
# will compile from pre-generated C++ sources
pip install imgui --no-binary imgui
开发技巧
我们努力使这个项目的引导过程简单化。 尽可能的。
为了在本地生成和安装项目,请确保已创建和
使用virtualenv
或python -m venv
(对于较新的
python版本)。然后您就可以运行:
make build
此命令将引导整个环境(拉git子模块,安装
开发需求等)并建立项目。make
将自动安装
imgui
处于development/editable模式。然后你可以举几个例子
在doc/examples
目录中找到,以验证项目是否正常工作。
为了构建文档和运行测试,您需要一些额外的
来自doc/requirements-test.txt
的要求。
您可以使用以下命令运行测试:
py.test
如果你对建造或安装这个项目有任何问题,只要问我们 通过创建github问题获得帮助。