Ignore.horizon

From AGI Wiki
Revision as of 20:25, 8 April 2019 by Andrew Korson (talk | contribs) (Created page with "The '''ignore.horizon''' command allows an object to go above the horizon. == Syntax == ignore.horizon(obj oA); == Remarks == The horizon is an invis...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

The ignore.horizon command allows an object to go above the horizon.

Syntax

ignore.horizon(obj oA);

Remarks

The horizon is an invisible horizontal line with a default value of 36. Normally, screen objects cannot go above the horizon. The ignore.horizon command allows an object to go past the horizon, all the way to the top of the screen. Use the observe.horizon command to restore normal behavior. Use the set.horizon command to adjust the location of the horizon.

Possible Errors

AGI does not check that object number oA is a valid 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

Code:

<syntaxhighlight lang="agi"> set.horizon(42); [ adjust horizon ignore.horizon(o1); [ object 1 is now allowed above horizon ... observe.horizon(o1); [ object 1 is NOT allowed above horizon </syntaxhighlight>

Technical Information

Required Interpreter Version: Available in all AGI versions.
Byte-Code Value: 61 (0x3D hex)

See Also

observe.horizon
set.horizon
ignore.blocks
ignore.objs