Metadata-Version: 1.1
Name: pyglet2d
Version: 0.1.0
Summary: 2D shape primitives for pyglet.
Home-page: https://github.com/hsharrison/pyglet2d
Author: Henry S. Harrison
Author-email: henry.schafer.harrison@gmail.com
License: BSD
Description: ========
        pyglet2d
        ========
        
        Polygon primitives for `pyglet`_.
        
        +--------------------+-------------------+---------------+
        | | |travis-badge|   | | |version-badge| | | |git-badge| |
        | | |coverage-badge| | | |license-badge| | | |hg-badge|  |
        +--------------------+-------------------+---------------+
        
        .. |travis-badge| image:: http://img.shields.io/travis/hsharrison/pyglet2d.png?style=flat
            :alt: Travis-CI Build Status
            :target: https://travis-ci.org/hsharrison/pyglet2d
        
        .. |coverage-badge| image:: http://img.shields.io/coveralls/hsharrison/pyglet2d.png?style=flat
            :alt: Coverage Status
            :target: https://coveralls.io/r/hsharrison/pyglet2d
        
        .. |version-badge| image:: http://img.shields.io/pypi/v/pyglet2d.png?style=flat
            :alt: PyPi Package
            :target: https://pypi.python.org/pypi/pyglet2d
        
        .. |license-badge| image:: http://img.shields.io/badge/license-MIT-blue.png?style=flat
            :alt: License
            :target: https://pypi.python.org/pypi/pyglet2d
        
        .. |git-badge| image:: http://img.shields.io/badge/repo-git-lightgrey.png?style=flat
            :alt: Git Repository
            :target: https://github.com/hsharrison/pyglet2d
        
        .. |hg-badge| image:: http://img.shields.io/badge/repo-hg-lightgrey.png?style=flat
            :alt: Mercurial Repository
            :target: https://bitbucket.org/hharrison/pyglet2d
        
        
        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.
        
        Features
        ========
        
        - In addition the standard constructor (from a list or array of points), ``Shape``s can be constructed with
          ``Shape.regular_polygon``, ``Shape.circle``, ``Shape.rectangle``, and ``Shape.from_dict``.
          The latter is a specification-based constructor that is easy to be 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 ``Shape.center`` 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)``.
        
        Example
        =======
        
        See ``tests/graphics_test.py`` 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/graphics_test.py
        
        Requirements
        ============
        
        - Python >= 3.3
        - `pyglet`_ >= 1.2alpha1. This must be manually installed as it is not on PyPi.
        - `polygon`_ >= 3
        - `numpy`_
        
        Installation
        ============
        
        ::
        
            pip install pyglet2d --upgrade
        
        Documentation
        =============
        
        https://pyglet2d.readthedocs.org/
        
        Development
        ===========
        
        To run the all tests run::
        
            tox
        
        .. _pyglet: http://www.pyglet.org/index.html
        .. _polygon: http://www.j-raedler.de/projects/polygon/
        .. _numpy: http://www.numpy.org/
        
        
        Changelog
        =========
        
        0.1.0 (2014-07-25)
        ------------------
        
        * First release on PyPI.
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Utilities
