Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

2D shape primitives for pyglet.

Project Description

Polygon primitives for pyglet.

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. A Shape can be given a velocity and/or an angular velocity, and it will be updated accordingly when Shape.update is called.
  • A Shape can be manipulated using the methods Shape.scale, Shape.rotate, Shape.flip_x, Shape.flip_y, Shape.flip, and Shape.translate, or with in-place arithmetic (e.g. shape += [5, 0]).
  • Alternatively, setting the properties and Shape.radius will translate and scale the shape, respectively.
  • Clipping operations provided by polygon are bound to the operators |, +, (union), & (intersection), - (difference), and ^ (xor).
  • 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.2.1 (2014-07-27)

  • All in-place operations now return the Shape, allowing operations to be chained.

0.2.0 (2014-07-27)

  • Added optional arguments y_factor and center to Shape.scale.
  • Implemented Shape.rotate.
  • Implemented angular velocity.
  • Argument start_angle in Shape.regular_polygon is now in radians.
  • renamed to
  • Implement Shape.flip_x, Shape.flip_y, and Shape.flip.
  • Explicitly set the Polygon3 data style to STYLE_NUMPY.
  • Implement Shape union and difference with the addition and subtraction operators.
  • Don’t throw an error when comparing the equality of shapes with different numbers of vertices.

0.1.2 (2014-07-26)

  • Fixed Shape docstring.
  • Changed docs from napoleon to numpydoc.

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.
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pyglet2d-0.2.1-py2.py3-none-any.whl (9.5 kB) Copy SHA256 Checksum SHA256 3.4 Wheel Jul 27, 2014
pyglet2d-0.2.1.tar.gz (16.3 kB) Copy SHA256 Checksum SHA256 Source Jul 27, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting