View source for Wander

The '''wander''' command sets a screen object's [[movement mode]] to 'wander' meaning it will randomly move around the screen.

== Syntax ==

wander([[screen object|obj]] oA);

== Remarks ==

The [[movement mode]] of [[screen object]] '''oA''' is set to 'wander'. While wandering, AGI will randomly change the direction and distance the object travels. The distance is set to a random number >=6 and <=50. The screen object will also change to a new random direction if it encounters any [[obstacle]] (such as a horizon, screen edge, control line, block, etc.)

Setting the [[movement mode]] to 'wander' will automatically enable the object for [[updating]] if not currently enabled. The [[cycling property]] is not modified by the '''wander''' command.

If '''oA''' is [[ego]], it automatically switches to [[program.control|program control mode]].

If the '''[[set.dir]]''' command is executed while an object is wandering, it will move in the assigned direction until the random function chooses a new direction.

== Possible Errors ==

AGI does not check that object number '''oA''' is a valid [[screen object]]. If it is not, this command will overwrite other data on the [[memory heap]], which may cause unexpected results, including possibly [[crashing AGI]].

== Example ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
#define f68 drunk
if(isset(drunk))
  {
  wander(ego);  [ ego will wander aimlessly
  }
</syntaxhighlight>

== Technical Information ==

{| border="1" cellpadding="2"
| style="background-color: #efefef" width="200" | '''Required Interpreter Version:'''
| width="175" | Available in all AGI versions.
|-
| style="background-color: #efefef" | '''Byte-Code Value:'''
| 84 (0x54 hex)
|}

== See Also ==

'''[[follow.ego]]'''<br />
'''[[move.obj]]'''<br />
'''[[mov.obj.v]]'''<br />
'''[[normal.motion]]'''<br />
'''[[set.dir]]'''<br />
[[Category:Commands]]<br />