Load.view.v
The load.view.v command indirectly loads a view resource onto the memory heap.
Syntax
load.view.v(var vVIEWNUM);
Remarks
This command loads view B, where B equals the value of vVIEWNUM, onto the memory heap. View resources must be loaded before being used in any other commands. If a view is not loaded before being used in commands, AGI will generate one of several trappable errors. Views should be unloaded using the discard.view or discard.view.v command once they are no longer needed.
AGI adds a script entry to the script stack each time a view resource is loaded.
Possible Errors
If you attempt to load a view that does not exist, AGI will raise a runtime error and crash.
Example
<syntaxhighlight lang="agi"> [ typical code to assign ego's view upon entering a room animate.obj(ego); [ must initialize the object every time a new room is entered load.view.v(currentEgoView); [ this reserved variable (v16) contains current view number of ego set.view.v(ego, currentEgoView); [ assign the view draw(ego); [ and then draw ego on screen </syntaxhighlight>
Technical Information
| Required Interpreter Version: | Available in all AGI versions. |
| Byte-Code Value: | 31 (0x1F hex) |
