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 GImage.

Constructor

GSprite(**keywords)

Creates a new sprite

To use the constructor for this class, you should provide it with a list of keyword arguments that initialize various attributes. For example, to load the filmstrip alien-strip1.png, which has 3 rows and 2 columns, use the constructor:

GSprite(x=0,y=0,width=10,height=10,source='alien-strip1.png',frames=(3,2))

This class supports the all same keywords as GImage; the only new keyword is frames. This keyword specifies the grid size of the animation frames in the image. See the documentation of GImage and GObject for the other supported keywords.

Parameter:keywords (keys are attribute names) – dictionary of keyword arguments

Attributes

This class has all of the attributes of GImage. In addition, it has the following new attributes.

frame

The current animation frame of this filmstrip

invariant. Value is an int 0..count-1.

count

The number of frames in this filmstrip

invariant. Value is an int > 0.

Methods

This class does not have any methods beyond those defined in GObject.

Return to top level