8
Gaming API and Sound
The creation of the raw frames follows these standards:
−Frames must be equally sized, all being of the frame width (fWidth) and height (fHeight) defined in the constructor parameters. They may be laid out in the image horizontally, vertically, or as a grid. The width of the source image must be an integer multiple of the frame width. The height of the source image must be an integer multiple of the frame height.
The frames in the source image will have raw frame numbers as follows:
−The frames are numbered like words are read on a page;
0 | 1 | . . . | N – 1 |
|
|
|
|
N | N + 1 | . . . | 2N – 1 |
|
|
|
|
2N | 2N + 1 | . . . |
|
|
|
|
|
. . . | . . . | . . . | . . . |
|
|
|
|
(M – 1) * N | . . . | (M * N ) – 1 | |
|
|
|
|
So the total number of frames is M * N, where:
−N = (image width) / (frame width)
−M = (image height) / (frame height)
At the time of creation, all Sprites have a default frame sequence corresponding to the raw frame numbers. This can be modified with setFrameSequence(). At construction time, the Sprite's position will be set to (0,0), the depth will be set to 0, and the Sprite will be visible. The Sprite shall behave as if the image used in creation were cached. If a mutable image is used to create the Sprite, the Sprite's appearance should not reflect changes to mutable source image.
public Sprite(Sprite s) – Creates a new Sprite from another Sprite. Create a copy of a Sprite. All attributes (raw frames, position, frame sequence, current frame, visibility) of the source Sprite should be reflected in the new Sprite. Any subsequent updates to the source Sprite after the creation of the second Sprite should not be reflected in the second Sprite.
Sprite Methods
The Sprite class implements the following methods:
•public void setPosition(int x, int y) – Set Sprite's x,y position. The x, y position is relative to whatever object the sprite is associated with or drawn on.
57
