Group objects are no longer added to the display list.
These objects need to be on the object list but don't serve any purpose on the display list. Therefore they are no longer added upon creation.
If you try to move them in the display list (z-ordering) via GR.DL.MOVE, only the objects in their lists will be moved. However, GR.DL.REMOVE will remove them (if they are on the display list), along with the objects in their lists.

Four more parameters have been added to the General Purpose parameters (Paint and Alpha),
these are "x","y","speed" and "dir".

These parameters are availble to all viewable display list objects.

Note that as before (legacy Basic), the alpha is that of the object (not the paint's alpha). If the object's alpha has been changed, it overrides the paint's alpha.

"x" and "y" are for moving whole objects.

The position parameters are the same parameters for those objects that already have "x" and "y".
For other, objects that did not have them, "x" and "y" gives a position and will get the same values found for  "x1", "y1" and  "left","top".
e.g
GR.GET.VALUE oLine, "x",myvar                  % gets the same value as "x1"
GR.GET.VALUE oRect, "x",myvar                  % gets the same value as "left"

The difference being that if you modify "x" or "y" using GR.MODIFY, then the whole object is moved to that position (not just one corner).

e.g
GR.MODIFY oRect, "x", 200
Above command modifies both "left" and "right" values of the rectangle so that "left" is at 200 and "right" moves to right to preserve the same width. Similarly with "y" and "top","bottom".

Groups
If you GR.MODIFY the "x" or "y" of a group, the objects in it's list are also modified (moved to that position).

"speed" and "dir" are components for a vector of motion. Vectors allow an object to move in a specified way. This is described in the section on Object Motion.

This is given as pixels per second.

If the speed is zero, the object will not move.

If the speed is non-zero and positive, the object will move.
The speed cannot be negative.
The default speed for all objects is zero (no movement).

You may express the speed with a fractional part for accuracy.

To stop an object (no movement), set the speed to zero (default).

This is given as an angle in degrees.
The default direction for all objects is zero, which is pointing to the right (east).
Direction angles move clockwise, so 90 degrees is pointing down (south).

You may express the direction with a fractional part for accuracy.

If you never use GR.MOTION (e.g legacy programs), then objects will not be moved by it.

If you don't want objects affected by GR.MOTION, set their speeds to zero.
You can still manually move them in the usual way by using GR.MODIFY.

e.g
GR.MODIFY object, "speed",0                % will not be moved by GR.MOTION
GR.MOTION                                               % for other objects and animation
GR.RENDER

e.g                                                                % manual positioning
GR.MODIFY object, "x",x,  "y",y              % (see whole object positioning)

GR.MOTION does not move objects with zero speed nor animate sprites with zero arates.

As well as the general purpose properties (including speed and dir) sprites also offer the following

for GR.GET.VALUE

and for GR.MODIFY,

where

Parameter property	Description	default	special remarks
bitmap	Standing bitmap pointer		used if no animation
anim	Animation Index	0	0 = no animation
arate	Animation Rate	10	frames per second 0 = freeze frame <0 = reverse animation
aframe	Current animation frame	0	0 to max  (zero based)
aloop	Animation Looping or not	1	0 = no looping
width	width of standing bitmap		read-only
height	height of standing bitmap		read-only

Before you create a sprite, you must have at least a bitmap. This is the called the 'standing' bitmap.
GR.BITMAP.LOAD bmp, "h-stand.png"

To create a Sprite with no animation,
GR.SPRITE.DRAW s0, 100, 100, bmp    % spr_obj, x , y , bitmap_ptr

This creates a sprite object on the object list and also adds it onto the display list.
The standing bitmap  bmp is used when a sprite is not animating.

The standing bitmap can be changed.
GR.MODIFY s1, "bitmap", bmp2           % bitmap bmp2 must already exist

An animation is a sequence of bitmaps. Similar to bitmaps, there is an internal list of Animations.
This list is indexed the same way as bitmaps, it starts with 1 and grows as more animations are added.
When you create an animation, you get back an animation index (pointer).
You can attach this animation to a sprite using this index.
Animations are not graphic objects, similar to bitmaps, they are attached to sprites.

To create a new Animation, you can load it from a file
GR.ANIM.LOAD ani, "h-animate.png",32,33,16

See GR.ANIM.LOAD for more information.

Animations may be created before or after sprite object creation.

To create a new sprite with animation,
First create and load an animation.
GR.ANIM.LOAD ani,"h-animate.png",32,33,16

Then create the new Sprite and attach the animation;
GR.SPRITE.DRAW s1,100,100,bmp,ani    % obj, x , y , bitmap, animation

Note that you still need to specify the standing bitmap.

The default animation rate for a new sprite is 10 frames per second (fps) and will animate with each GR.RENDER. The animation is based on times between each render.

To attach or change an Animation to an existing Sprite, use GR.MODIFY

GR.MODIFY s0, "anim", ani
where s0 is the sprite object number and ani is the animation index (pointer).
The animation must already exist. The exception is 0 = no animation.

To stop animating, remove the animation by setting the sprite's animation pointer to zero.
GR.MODIFY s1, "anim", 0
This means the sprite has no animation and defaults to it's standing bitmap.
Alternatively, you can freeze the frame by setting the animation rate "arate" to zero (see bleow).

As with all objects, you can use the built-in motion vectors to move the sprite with GR.MOTION
or you can manually set the position of a sprite with GR.MODIFY s1, "x", X, "y", Y
(see the section on Object Motion). If you opt to move sprites manually, set their speed to zero to avoid being moved by GR.MOTION.

In addition to movement, GR.MOTION also updates a sprite's animation according to it's animation rate ("arate"), see GR.MOTION for the effects of entering a motion loop. Therefore, if you are using animation, you must also use GR.MOTION.

The animation rate arate is given as frames per second. The default for a new sprite is 10.

Zero aRate

Negative aRate