Skip to main content

Python 的 2D 平面几何库。

项目描述

注意:平面不再处于积极开发中。

Planar 是 Python 的 2D 几何库。它旨在供游戏和交互式实时应用程序使用,但设计用于大多数需要方便、高性能几何 API 的程序。

Planar 正在开发为更大的 Grease 游戏框架的一部分。但是,它是一个独立的库,除了 Python 和可选的 C 编译器之外没有外部依赖项。

Planar 纯粹是一个数学库,演示、图形或其他方式由应用程序决定。

项目目标

  • 做一件事,2D 几何,把它做好。

  • 提供一个高级的、干净的、Pythonic API。

  • 所有 API 都具有 Python 参考实现和 C 中具有相同接口的高性能实现。

  • 与 Python 2.6+ 和 Python 3.1+ 的兼容性

  • 100% 的测试覆盖率。

  • 完整的叙述和 API 参考文档。

  • 平台无关。

  • 尽早并经常发布。

  • 响应社区的意见。

  • 不要把自己太当回事。

执照

Planar 是根据新的 BSD 许可条款分发的。您可以自由地将其用于商业或非商业项目,几乎没有限制,我们只要求:

  • 代码的重新分发,全部或部分,保留原始版权声明和许可文本。

  • 您不主张我们对任何衍生产品的背书。

有关许可证的完整文本,请参阅源分发中的LICENSE.txt文件。

致谢

平面API,部分代码来源于Super Effective Team的出色工作,谢谢大家!

要求

Planar 需要 Python 2.6、2.7、3.1 或更高版本。

要体验本机代码性能的快感,需要 C 编译器。如果有人自愿,将很高兴为不常见的平台(你知道你是谁)提供二进制版本。

下载平面

平面版本可以从 python 包索引 (pypi) 下载:

您可以从 bitbucket 上的平面 mercurial 存储库获取最新的开发代码:

安装

要从源分发或存储库构建和安装 Planar,请使用:

python setup.py install

要仅安装纯 Python 模块而不进行编译,请使用:

python setup.py build_py install --skip-build

在没有 C 扩展的情况下只会牺牲性能,仅使用纯 Python 模块时所有功能仍然可用。

测试

平面需要鼻子进行测试。您可以使用 easy_install 为 Python 2.x 安装它:

easy_install nose

对于 Python 3.x,您可以从此处下载并安装分发:

现在,您可以在此处获取 Python 3.x 的 nose3 的副本,已修补以在 Python 3.1 上正确安装:

一旦安装了nose,您就可以使用nosetests从源目录运行测试,首先构建C 扩展,就像这样(在Unix 上):

python setup.py build && nosetests -d -w build/lib.*/planar/

这会在构建目录中运行测试,以便可以测试 C 扩展。 对于 Python 3.x,您可以在上面的pythonnosetests命令上加上3后缀。

文档

您可以在此处在线浏览文档:

相同的文档也可用于在源代码分发的 doc/build/html子目录中进行离线浏览。

贡献和获得支持

来 Grease users google group 访问我们以获得帮助、精神上的支持、慷慨的赞美、痛苦的抱怨、报告错误或贡献想法:

下载文件

下载适用于您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。

源分布

plane-0.4.zip (622.5 kB 查看哈希

已上传 source

plane-0.4.tar.gz (558.2 kB 查看哈希)

已上传 source