Motorola J2ME Specifications download pdf (Page 57)

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; left-to-right, then top-

to-bottom. The top-left frame is numbered 0. If there is a frame to its right, this

frame is numbered 1, and so on, across the first row of frames. If there is a

second row of frames, the number of the left-most frame in this row is one

greater than the right-most frame in the preceding row. The table below is a

diagrammatic depiction:

0 1 . . . N – 1

N N + 1 . . . 2N – 1

2N 2N + 1 . . .

. . . . . . . . . . . .

(M – 1) * N ((M-1)* N ) + 1 . . . (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.

1 2 ... 52 53 54 55 56 57 58 59 60 61 62 ... 85 86

Comments to this Manuals

No comments

Motorola J2ME Specifications Page 57

Comments to this Manuals

Related products and manuals for Mobile phones Motorola J2ME