View source for Fix.loop

The '''fix.loop''' command disables the [[Auto Loop Feature|auto loop]] select feature for a [[screen object]].

== Syntax ==

fix.loop([[screen object|obj]] oA);

== Remarks ==

AGI includes a [[Auto Loop Feature|feature]] that automatically changes an object's [[loop]] based in its direction of motion. This made it much simpler for dealing with characters that need to change profiles as they move about the screen. (For example, when walking to the right, show a right facing loop, when walking toward the horizon, show a rear view loop, etc.)

The '''fix.loop''' command disables this feature. The [[screen object|screen object's]] current [[loop]] will stay the same regardless of the object's direction of motion.

Use the '''[[release.loop]]''' command to re-enable the auto loop select feature.

== 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 ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
#define dancer o4
...  [ initialize and draw object
set.loop(dancer, 2);  [ face forward
fix.loop(dancer);     [ begin dancing, always face forward
...              
release.loop(dancer); [ done dancing
</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:'''
| 45 (0x2D hex)
|}

== See Also ==

'''[[release.loop]]'''<br />
[[Auto Loop Feature]]<br />
[[Category:Commands]]<br />