Difference between revisions of "Animate.obj"
From AGI Wiki
Jump to navigationJump to search| (7 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | The '''animate.obj''' command | + | The '''animate.obj''' command initializes a [[screen object]] so it can be used on screen. |
| − | + | == Syntax == | |
| − | + | animate.obj([[screen object|obj]] oA); | |
| − | + | == Remarks == | |
| − | + | [[Screen object|Screen objects]] must be initialized with the '''animate.obj''' command before they can be used in any other commands. When a [[screen object]] is initialized it is enabled for [[updating]] and [[cycling]] by default. If you call the '''animate.obj''' command on an object that is already initialized, the command is ignored. | |
| − | + | == Possible Errors == | |
| − | + | If the object number exceeds the [[max screen object]] count, AGI will raise [[trappable error #13]]. | |
| − | + | Most commands that are run on an uninitialized screen objects are just ignored by AGI, but some of them can result in interactions with invalid data. | |
| − | + | == Example == | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
<div class="CodeBlockHeader">Code:</div> | <div class="CodeBlockHeader">Code:</div> | ||
<syntaxhighlight lang="agi"> | <syntaxhighlight lang="agi"> | ||
| − | + | [ basic steps needed to create | |
| − | + | [ and display a screen object | |
animate.obj(o2); | animate.obj(o2); | ||
load.view(4); | load.view(4); | ||
| Line 33: | Line 28: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
== Technical Information == | == Technical Information == | ||
{| border="1" cellpadding="2" | {| border="1" cellpadding="2" | ||
| − | | style="background-color: #efefef" | '''Required | + | | style="background-color: #efefef" width="200" | '''Required Interpreter Version:''' |
| − | | Available in all AGI versions | + | | width="175" | Available in all AGI versions. |
|- | |- | ||
| − | | style="background-color: #efefef" | ''' | + | | style="background-color: #efefef" | '''Byte-Code Value:''' |
| 33 (0x21 hex) | | 33 (0x21 hex) | ||
|} | |} | ||
| − | == See | + | == See Also == |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | [[Screen Object/View Commands]]<br /> | |
| + | [[Working with Screen Objects]]<br /> | ||
| − | [[Category: | + | [[Category:Commands]] |
| − | |||
Latest revision as of 17:05, 23 March 2019
The animate.obj command initializes a screen object so it can be used on screen.
Syntax
animate.obj(obj oA);
Remarks
Screen objects must be initialized with the animate.obj command before they can be used in any other commands. When a screen object is initialized it is enabled for updating and cycling by default. If you call the animate.obj command on an object that is already initialized, the command is ignored.
Possible Errors
If the object number exceeds the max screen object count, AGI will raise trappable error #13.
Most commands that are run on an uninitialized screen objects are just ignored by AGI, but some of them can result in interactions with invalid data.
Example
Code:
<syntaxhighlight lang="agi"> [ basic steps needed to create [ and display a screen object animate.obj(o2); load.view(4); set.view(o2,4); position(o2,80,120); draw(o2); </syntaxhighlight>
Technical Information
| Required Interpreter Version: | Available in all AGI versions. |
| Byte-Code Value: | 33 (0x21 hex) |
