Skip to main content

2D shape primitives for pyglet.

Project description

Polygon primitives for pyglet.

Travis-CI Build Status
Coverage Status
PyPi Package
Git Repository
Mercurial Repository

This package provides a Shape object that can be acts as an interface between the libraries polygon and pyglet. The former provides numerical routines for handling shapes, and the latter can process OpenGL bindings. With pyglet2d, you can incorporate 2D shapes into your applications without having to write your own OpenGL calls.


  • In addition to the standard constructor (from a list or array of points), four others are provided: Shape.regular_polygon,, Shape.rectangle, and Shape.from_dict. The latter is a specification-based constructor that is easy to use with JSON or YAML.

  • Shape has two methods that are useful as pyglet callbacks: Shape.draw and Shape.update. Shape``s can be given a velocity, and their positions will be updated when ``Shape.update is called.

  • A Shape can be scaled and translated using the methods Shape.scale and Shape.translate, or with in-place arithmetic.

  • Alternatively, setting the properties and Shape.radius will translate and scale the shape, respectively.

  • Clipping operations provided by polygon are bound to the operators |, &, and ^.

  • Additional polygon methods can be accessed directly from the Shape.poly attribute, where the Polygon object is stored.

  • Shortcuts are provided to polygon functions via the boolean methods Shape.overlaps(other) and Shape.covers(other).


See tests/ for a usage example. This script also serves as a test. Run it to make sure that your graphics pipeline is working correctly:

python tests/


  • Python >= 3.3

  • pyglet >= 1.2alpha1. This must be manually installed as it is not on PyPi.

  • polygon >= 3

  • numpy


pip install pyglet2d --upgrade



To run the all tests run:



0.1.1 (2014-07-26)

  • Mocking of graphics calls to pyglet, for testing without a display (e.g., on Travis).

  • Fixed intersphinx links in docs.

  • Fixed integration.

0.1.0 (2014-07-25)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyglet2d-0.1.1.tar.gz (14.0 kB view hashes)

Uploaded source

Built Distribution

pyglet2d-0.1.1-py2.py3-none-any.whl (8.2 kB view hashes)

Uploaded 3 4

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page