.. a7 Graphics Object class

.. _gsprite-label:

Class GSprite
=============
The class provides support simple sprite sheet animation. The sprite sheet is given by a 
JPEG, PNG, or GIF file whose name is stored in the attribute ``source``.  Sprite sheets 
should be stored in the **Images** directory so that Kivy can find them without the complete path name.

A sprite sheet, or filmstrip, is a single image file that contains animation frames
of equal size.  The animations frames are arranged in a rectangular grid.  When you
make a ``GSprite`` object, it reads in the frames left-to-right, top-to-bottom.  
At any time, you can change the ``frame`` attribute to control which frame is shown
on screen.

Beyond the support for animation frames, this class is identical to :ref:`GImage`.

Constructor
-----------
.. autoclass:: game2d.gsprite.GSprite

Attributes
----------

This class has all of the attributes of  :ref:`GImage <gimage-label>`.  In addition,
it has the following new attributes.

.. currentmodule:: game2d.gsprite
.. autoattribute:: GSprite.frame
.. autoattribute:: GSprite.count

Methods
-------

This class does not have any methods beyond those defined in :ref:`GObject <gobject-label>`.

:ref:`Return to top level <top-label>`