Open main menu

AGIWiki/discard.view

< AGIWiki
Revision as of 15:05, 25 October 2018 by Criezy (talk | contribs) (Text replacement - "<source lang=" to "<syntaxhighlight lang=")
AGIWiki


Object and View Commands

The discard.view command removes a view resource from memory. There is an indirect version of this command called discard.view.v.

Syntax

discard.view(byt viewNumber);

View viewNumber is discarded from memory.

Remarks

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.

Parameters

For discard.view

  • viewNumber: a number, 0-255, specifying which view resource to remove from memory

Possible errors

Examples

The following example uses discard.view to remove view 203 from memory:

<syntaxhighlight lang="cpp">

load.view(203);
discard.view(203);

</source>

Technical Information

Required interpreter version Available in all AGI versions
Bytecode value 32 (0x20 hex)

See also

Sources

  • Some of the text in the article is taken from the AGI Studio & WinAGI help files.