Python的2D平面几何库。
项目描述
注意:planar已不再处于积极开发中。
Planar是Python的2D几何库。它旨在为游戏和交互式实时应用程序使用,但设计上对任何需要方便、高性能几何API的程序都很有用。
Planar是作为更大的Grease游戏框架的一部分进行开发的。然而,它是一个独立的库,除了Python之外没有外部依赖,并且可选地有一个C编译器。
Planar纯粹是一个数学库,展示、图形或其他方面留由应用程序决定。
项目目标
专注于一项任务,2D几何,并且做得很好。
提供一个高级、简洁、Python风格的API。
所有API都有Python参考实现和具有相同接口的C的高性能实现。
与Python 2.6+和Python 3.1+兼容
100%测试覆盖率。
完整的叙述和API参考文档。
平台无关。
尽早发布,经常更新。
积极响应用户反馈。
不要对自己太过认真。
许可证
Planar 以新的BSD许可协议进行分发。您可以在商业或非商业项目中自由使用它,几乎没有限制,我们只是要求
代码的重新分发,无论全部还是部分,都保留原始的版权声明和许可文本。
您不要声称我们认可任何派生产品。
有关许可协议的完整文本,请参阅源分发中的 LICENSE.txt 文件。
致谢
Planar 的 API 和部分代码来源于 Super Effective Team 的出色工作,谢谢大家!
需求
Planar 需要 Python 2.6, 2.7, 3.1 或更高版本。
要体验原生代码性能的激动人心之处,需要一个 C 编译器。如果有人自愿,将为不常见平台(你知道是谁)提供二进制发行版。
下载 Planar
Planar 发行版可以从 Python 包索引(pypi)下载
您可以从 bitbucket 上的 Planar mercurial 仓库获取最新的开发代码
安装
要从源分发或仓库构建和安装 Planar,请使用
python setup.py install
要仅安装纯 Python 模块而不编译,请使用
python setup.py build_py install --skip-build
没有 C 扩展,牺牲的是性能,但所有功能在仅使用纯 Python 模块时仍然可用。
测试
Planar 需要 nose 进行测试。您可以使用 easy_install 为 Python 2.x 安装它
easy_install nose
对于 Python 3.x,您可以从这里下载并安装 distribute
目前,您可以从这里获取适用于 Python 3.x 的 nose3 的副本,已修复以正确安装在 Python 3.1 上
安装 nose 后,您可以使用 nosetests 从源目录运行测试,首先构建 C 扩展,如下所示(在 Unix 上)
python setup.py build && nosetests -d -w build/lib.*/planar/
这将在 build 目录中运行测试,以便测试 C 扩展。对于 Python 3.x,您可以在上述 python 和 nosetests 命令上添加 3 后缀。
文档
您可以在以下位置在线浏览文档
相同的文档也可在源分发的 doc/build/html 子目录中离线浏览。
贡献和支持
请访问 Grease 用户 Google 群组以获取帮助、精神支持、赞美、痛苦抱怨、报告错误或贡献想法
项目详情
下载文件
下载适合您平台的自定义文件。如果您不确定选择哪个,请了解更多关于 安装软件包 的信息。