Fix.loop - Revision history

Andrew Korson: /* Remarks */

2019-04-21T05:38:51Z

Remarks

Andrew Korson: /* Possible Errors */

2019-04-09T01:54:59Z

Possible Errors

Andrew Korson: Created page with "The '''fix.loop''' command disables the auto loop select feature for a screen object. == Syntax == fix.loop(obj oA); == Remarks..."

2019-03-30T22:34:42Z

Created page with "The '''fix.loop''' command disables the auto loop select feature for a screen object. == Syntax == fix.loop(obj oA); == Remarks..."

New page

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 [[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 />

@@ Line 7: / Line 7: @@
 == 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.)
+AGI includes a [[Screen object#Auto Loop Feature|auto-loop]] 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.

@@ Line 15: / Line 15: @@
 == 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 [[heap]], which may cause unexpected results, including possibly [[crashing AGI]].
+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 ==