跳转到主要内容

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 群组以获取帮助、精神支持、赞美、痛苦抱怨、报告错误或贡献想法

项目详情


下载文件

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

源分发

planar-0.4.zip (622.5 kB 查看散列值)

上传时间

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

上传时间: 源代码

支持