Difference between revisions of "Open.dialogue"
(Created page with "The '''open.dialogue''' command affects how '''get.string''' and '''get.num''' commands operate when AGI is run on a system using a Hercules Graphics Card (HGC). == S...") |
|||
| Line 12: | Line 12: | ||
This command has no effect if called while running on a non-HGC monitor. AGI will just ignore it. Unless you are intending to run on an HGC monitor, this command has no usefulness. | This command has no effect if called while running on a non-HGC monitor. AGI will just ignore it. Unless you are intending to run on an HGC monitor, this command has no usefulness. | ||
| + | |||
| + | In the last [[version]] of AGI (3.002.149), support for the '''[[close.dialogue]]''' and '''open.dialogue''' commands was removed. The commands were directed to a null function, and calls to these two commands had no effect. | ||
== Possible Errors == | == Possible Errors == | ||
| Line 33: | Line 35: | ||
{| border="1" cellpadding="2" | {| border="1" cellpadding="2" | ||
| style="background-color: #efefef" width="200" | '''Required Interpreter Version:''' | | style="background-color: #efefef" width="200" | '''Required Interpreter Version:''' | ||
| − | | width="175" | Available in version 2.411 | + | | width="175" | Available in version 2.411 through 3.002.107. |
|- | |- | ||
| style="background-color: #efefef" | '''Byte-Code Value:''' | | style="background-color: #efefef" | '''Byte-Code Value:''' | ||
| 163 (0xA3 hex) | | 163 (0xA3 hex) | ||
|} | |} | ||
| + | Support for this command was removed in version 3.002.149 | ||
== See Also == | == See Also == | ||
Latest revision as of 16:36, 30 March 2019
The open.dialogue command affects how get.string and get.num commands operate when AGI is run on a system using a Hercules Graphics Card (HGC).
Syntax
open.dialogue();
Remarks
The default behavior for get.string and get.num commands on an HGC monitor is to display an input box, similar to the one used for normal player input. The open.dialogue command will cause get.string and get.num to operate the same way as on other displays, meaning get.num will use the input line and get.string will display the prompt according to the row and column argument values.
Use the close.dialogue to restore default behavior.
This command has no effect if called while running on a non-HGC monitor. AGI will just ignore it. Unless you are intending to run on an HGC monitor, this command has no usefulness.
In the last version of AGI (3.002.149), support for the close.dialogue and open.dialogue commands was removed. The commands were directed to a null function, and calls to these two commands had no effect.
Possible Errors
None.
Example
<syntaxhighlight lang="agi"> [ assume AGI is running on a monochrome system open.dialogue(); get.num("Enter a number", v228); [ get.num works as if on a non-HGC system ... close.dialogue(); get.string("Enter a number" v228); [ get.num displays an input box on an HGC system </syntaxhighlight>
Technical Information
| Required Interpreter Version: | Available in version 2.411 through 3.002.107. |
| Byte-Code Value: | 163 (0xA3 hex) |
Support for this command was removed in version 3.002.149
