- discard.view.v(var viewNumber);
viewNumber is discarded from memory.
Resources must be unloaded in reverse order of the way they were originally loaded, or unexpected results may occur.
Attempting to discard a resource that has not been loaded will generate an error.
Before unloading a view, make certain it is not in use by any active screen objects. If a view is unloaded while still assigned to an object, the interpreter will most likely crash.
AGI adds a script entry to the script stack each time a view resource is unloaded.
viewNumber: a variable, v0-v255, whose value specifies which view resource to remove from memory
- if the view is not already loaded, the game will crash with a view not loaded error
- if the view is assigned to an object when it is discarded, the game may crash or exhibit other odd behavior; it may not even generate an error message
- resources must be discarded in exactly the reverse order that they were loaded, or subsequent
discard.viewcommands may generate a view not loaded error, even if the view has actually been loaded; see Memory and Script for more details on this issue
discard.view.vcommands add to the script buffer; this can cause a script buffer overflow error
The following example uses
discard.view.v to remove view 203 from memory:
<syntax type = "C++">
load.view(203); v100 = 203; discard.view.v(v100);
|Required interpreter version||Available in all AGI versions|
|Bytecode value||153 (0x99 hex)|