Difference between revisions of "Push.script"
From AGI Wiki
Jump to navigationJump to search (Created page with "The '''push.script''' command (previously known as '''unknown171''') saves the current position in the script buffer so that it can be restored later by a ca...") |
|||
| Line 1: | Line 1: | ||
| − | The '''push.script''' command | + | The '''push.script''' command saves the [[script table]] pointer. |
| − | + | == Syntax == | |
| − | + | push.script(); | |
| − | + | == Remarks == | |
| − | ''' | + | This command saves the script pointer so that it can be restored later by the '''[[pop.script]]''' command. |
| − | + | A detailed discussion of scripts, and how to push and pop the pointer can be found in the [[AGI Scripts]] topic. | |
| − | == | + | == Possible Errors == |
| − | + | Do not manipulate the [[AGI Scripts|script]] features of AGI unless you fully understand what you are doing, as it is easy to corrupt save game files if the script entries are not correct. | |
| − | == | + | == Example == |
| − | ( | + | <div class="CodeBlockHeader">Code:</div> |
| + | <syntaxhighlight lang="agi"> | ||
| + | push.script(); | ||
| + | ... [ some activities that add script entries | ||
| + | pop.script(); [ script pointer is reset | ||
| + | </syntaxhighlight> | ||
| − | == | + | == Technical Information == |
| − | + | {| border="1" cellpadding="2" | |
| + | | style="background-color: #efefef" width="200" | '''Required Interpreter Version:''' | ||
| + | | width="175" | Available in version 2.915 and above. | ||
| + | |- | ||
| + | | style="background-color: #efefef" | '''Byte-Code Value:''' | ||
| + | | 171 (0xAB hex) | ||
| + | |} | ||
| − | ==See | + | == See Also == |
| − | + | [[System Commands]]<br /> | |
| − | + | '''[[pop.script]]'''<br /> | |
| − | + | [[AGI Scripts]]<br /> | |
| − | + | [[Category:Commands]]<br /> | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Latest revision as of 21:45, 18 April 2019
The push.script command saves the script table pointer.
Syntax
push.script();
Remarks
This command saves the script pointer so that it can be restored later by the pop.script command.
A detailed discussion of scripts, and how to push and pop the pointer can be found in the AGI Scripts topic.
Possible Errors
Do not manipulate the script features of AGI unless you fully understand what you are doing, as it is easy to corrupt save game files if the script entries are not correct.
Example
Code:
<syntaxhighlight lang="agi"> push.script(); ... [ some activities that add script entries pop.script(); [ script pointer is reset </syntaxhighlight>
Technical Information
| Required Interpreter Version: | Available in version 2.915 and above. |
| Byte-Code Value: | 171 (0xAB hex) |
