Difference between revisions of "Load.view"

From AGI Wiki
Jump to navigationJump to search
Line 32: Line 32:
 
The following code loads VIEW.025 into memory using <code>load.view</code>:
 
The following code loads VIEW.025 into memory using <code>load.view</code>:
  
<code>load.view(25);</code>
+
<div class="CodeBlockHeader">Code:</div>
 +
<syntaxhighlight lang="agi">
 +
load.view(25);
 +
</syntaxhighlight>
  
 
The following code uses the [[Indirect Command|indirect command]] <code>load.view.v</code> to do the same thing:
 
The following code uses the [[Indirect Command|indirect command]] <code>load.view.v</code> to do the same thing:
  
<code>v195 = 25;
+
<div class="CodeBlockHeader">Code:</div>
load.view.v(v195);</code>
+
<syntaxhighlight lang="agi">
 +
v195 = 25;
 +
load.view.v(v195);
 +
</syntaxhighlight>
  
 
&nbsp;
 
&nbsp;
 +
 
== See also ==
 
== See also ==
  

Revision as of 16:29, 28 December 2013

The load.view and load.view.v commands load a view resource into memory. A view must be loaded before it can be assigned to any objects or used in any command such as add.to.pic (note: a view does not have to be loaded before the show.obj command is used).

load.view(number viewNumber);

load.view.v(variable viewNumber);

The view viewNumber is loaded into memory.


Parameters

For load.view:

  • viewNumber: a number, 0-255, specifying the view that should be loaded

For the indirect version, load.view.v:

  • viewNumber: a variable, v0-v255, whose value specifies the view that should be loaded

 

Possible errors

  • The view must exist in the game's vol files, or the game will crash with a view not found error.
  • There must be sufficient memory to load the entire view resource into memory, or the game will crash with an out of memory error.
  • If the view resource is already loaded, it is not loaded a second time, nor is the script buffer affected. If the view is discarded and then loaded again, it will of course be loaded a second time; however, this adds to the script buffer.

 

Example

The following code loads VIEW.025 into memory using load.view:

Code:
load.view(25);

The following code uses the indirect command load.view.v to do the same thing:

Code:
v195 = 25;
load.view.v(v195);

 

See also

 

Sources

Some of the text in this article is taken from the AGI Studio help file.