python的二维平面几何图形库。
planar的Python项目详细描述
注意:planar不再处于活动开发中
Planar是Python的二维几何图形库供游戏使用 和交互式实时应用程序,但设计用于 大多数需要方便、高性能几何api的程序。
planar正在作为大型油脂游戏框架的一部分开发。 但是,它是一个独立的库,除了 Python和可选的C编译器
平面是一个纯粹的数学库,表示,图形或其他 由申请决定
项目目标
- 做一件事,二维几何,并做好它。
- 提供一个高级、干净的Pythonic API
- 所有api都有Python引用实现和高性能 使用相同接口在C中实现。
- 与Python2.6+和Python3.1+兼容
- 100%测试覆盖率。
- 完整的叙述和API参考文档
- 独立于平台。
- 尽早和经常释放
- 响应社区的意见。
- 别把自己看得太重。
许可证
Planar是根据新的BSD许可证的条款分发的。你可以自由地 用于商业或非商业项目,很少或没有 限制,我们要求的是:
- 重新分配代码,全部或部分,保留原始的 版权声明和许可文本。
- 你方不要求我方对任何衍生产品的背书
有关许可证的完整文本,请参见源代码中的LICENSE.txt文件 分配。
要求
planar需要python 2.6、2.7、3.1或更高版本。
为了体验本机代码性能的提升,C编译器 必修的。如果有人自愿,二进制版本的平台 是不常见的(你知道你是谁)会高兴地提供。
下载平面
平面版本可以从python包索引(pypi)下载:
您可以从planar mercurial获得开发中的最新代码 Bitbucket上的存储库:
安装
要从源分发或存储库构建和安装planar,请使用:
python setup.py install
要只安装纯Python模块而不进行编译,请使用:
python setup.py build_py install --skip-build
如果没有C扩展,只会牺牲性能,所有功能都是 仅使用纯Python模块时仍然可用
测试
平面测试需要机头您可以为Python 2.x安装它 使用简易安装:
easy_install nose
对于Python3.x,您可以从以下位置下载并安装distribute:
现在,您可以获得一个用于python 3.x的nose3副本,并对其进行修补以安装 在python 3.1上正确使用:
安装nose后,可以从源目录运行测试 使用nosetests,首先构建c扩展,如so(在unix上):
python setup.py build && nosetests -d -w build/lib.*/planar/
这将在build目录中运行测试,以便C扩展 可以测试。您可以在python和^{tt2}上加上3后缀$ 上面针对python 3.x的命令。