AGIWiki/animate.obj

Object and View Commands add.to.pic add.to.pic.v animate.obj block cel current.loop current.view cycle.time discard.view discard.view.v distance draw end.of.loop erase fix.loop follow.ego force.update get.dir get.posn get.priority ignore.blocks ignore.horizon ignore.objs last.cel load.view load.view.v move.obj move.obj.v normal.cycle normal.motion number.of.loops object.on.anything object.on.land object.on.water observe.blocks observe.horizon observe.objs position position.v release.loop release.priority reposition.to reposition.to.v reposition reserve.cycle reserve.loop set.cel set.cel.v set.dir set.horizon set.loop set.loop.v set.priority set.priority.v set.upper.left set.view set.view.v start.cycling start.motion start.update step.size step.time stop.cycling stop.motion stop.update unanimate.all unblock wander

The animate.obj command activates a screen object.

Syntax

animate.obj(obj oA);

Parameters

• object: an object, o0 - o255; this object will be activated for use

Remarks

If the object number exceeds the max screen object count, usually 16, AGI will crash with a bad object number error. ( e.g. o17 )

Screen objects must be activated with the animate.obj command before it can be used in any other commands. Attempting to run commands on an unitialized screen object will generate a runtime error.

If you call the animate.obj command on an objedct that is already activated, the command is ignored.

Example

<source lang="cpp"> //basic steps needed to create //and display a screen object animate.obj(o2); load.view(4); set.view(o2,4); position(o2,80,120); draw(o2); </syntaxhighlight>

Technical Information

Required interpreter version	Available in all AGI versions
Bytecode value	33 (0x21 hex)

Related

• unanimate.all

Sources

Some of the content of this page was taken from the AGI Studio & WinAGI help files.