Andrew Korson: Created page with "The '''load.view.v''' command indirectly loads a view resource onto the memory heap. == Syntax == load.view.v(var vVIEWNUM); == Remarks == This comman..."

2019-04-11T02:56:13Z

Created page with "The '''load.view.v''' command indirectly loads a view resource onto the memory heap. == Syntax == load.view.v(var vVIEWNUM); == Remarks == This comman..."

New page

The '''load.view.v''' command indirectly loads a [[view]] resource onto the [[memory heap]].

== Syntax ==

load.view.v([[variable|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]]. [[View|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 ==

<div class="CodeBlockHeader">Code:</div>
<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 ==

{| 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:'''
| 31 (0x1F hex)
|}

== See Also ==

'''[[load.view]]'''<br />
[[Memory Management]]<br />
[[AGI Scripts]]<br />
[[Category:Commands]]<br />

Load.view.v - Revision history

Andrew Korson: Created page with "The '''load.view.v''' command indirectly loads a view resource onto the memory heap. == Syntax == load.view.v(var vVIEWNUM); == Remarks == This comman..."