Note: planar is no longer under active development.
Planar is a 2D geometry library for Python. It is intended for use by games and interactive real-time applications, but is designed to be useful for most any program that needs a convenient, high-performance geometry API.
Planar is being developed as part of the larger Grease game framework. However, it is a standalone library and has no external dependencies besides Python, and optionally a C compiler.
Planar is purely a math library, presentation, graphical or otherwise is left up to the application.
Planar is distributed under the terms of the new BSD license. You are free to use it for commercial or non-commercial projects with little or no restriction, all we ask is that:
For a complete text of the license see the LICENSE.txt file in the source
distrbution.
The API for planar, and some of the code is derived from the excellent work done by the Super Effective Team, thanks guys!
Planar requires Python 2.6, 2.7, 3.1, or better.
To experience the exhilaration of native-code performance, a C compiler is required. If someone volunteers, binary releases for platforms where this is not common (you know who you are) will be happily made available.
Planar releases can be downloaded from the python package index (pypi):
You can get the latest code in development from the planar mercurial repository on bitbucket:
To build and install Planar from the source distribution or repository use::
python setup.py install
To install only the pure-Python modules without compiling, use::
python setup.py build_py install --skip-build
Only performance is sacrificed without the C extensions, all functionality is still available when using only the pure-Python modules.
Planar requires nose for testing. You can install it for Python 2.x using easy_install::
easy_install nose
For Python 3.x, you can download and install distribute from here:
For now, you can get a copy of nose3 for Python 3.x, patched to install properly on Python 3.1 here:
Once nose is installed you can run the tests from the source directory
using nosetests, first building the C extensions, like so (on Unix)::
python setup.py build && nosetests -d -w build/lib.*/planar/
This runs the tests inside the build directory so that the C extensions
can be tested. You can put a 3 suffix on the python and nosetests
commands above for Python 3.x.
You can browse the documentation online here:
The same documentation is also available for offline browsing in the
doc/build/html subdirectory of the source distribution.
Come visit us at the Grease users google group to get help, moral support, lavish praise, complain bitterly, report a bug, or contribute ideas:
FAQs
2D planar geometry library for Python.
We found that planar demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.