Andrew Korson: Created page with "The '''observe.blocks''' command prevents an object from crossing the boundary of a block or a conditional control line. == Syntax == observe.blocks(obj oA..."

2019-04-14T22:04:18Z

Created page with "The '''observe.blocks''' command prevents an object from crossing the boundary of a block or a conditional control line. == Syntax == observe.blocks(obj oA..."

New page

The '''observe.blocks''' command prevents an object from crossing the boundary of a block or a conditional control line.

== Syntax ==

observe.blocks([[screen object|obj]] oA);

== Remarks ==

If [[screen object]] '''oA''' was previously set to ignore [[blocks]] (using the '''[[ignore.blocks]]''' command), the '''observe.blocks''' command restores normal behavior.

In addition to observing blocks, this command will also cause objects to observe conditional [[control lines]] (pixels with [[priority]] of 1 on the priority screen).

== Possible Errors ==

AGI does not check that screen 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">block(25, 25, 100, 100); [ create a block
ignore.blocks(o1); [ object 1 will ignore the block
...
observe.blocks(o1); [ now object 1 will observe the block
...
unblock(); [ remove the block
</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:'''
| 89 (0x59 hex)
|}

== See Also ==

'''[[block]]'''<br />
'''[[unblock]]'''<br />
'''[[ignore.blocks]]'''<br />
[[Managing Obstacles]]<br />
[[Control Lines]]<br />
[[Category:Commands]]<br />

Observe.blocks - Revision history

Andrew Korson: Created page with "The '''observe.blocks''' command prevents an object from crossing the boundary of a block or a conditional control line. == Syntax == observe.blocks(obj oA..."