Andrew Korson: Created page with "The '''set.view.v''' command assigns a view to an object indirectly. == Syntax == set.view.v(obj oA, var vVIEW); == Remarks == View Resour..."

2019-04-22T02:27:25Z

Created page with "The '''set.view.v''' command assigns a view to an object indirectly. == Syntax == set.view.v(obj oA, var vVIEW); == Remarks == View Resour..."

New page

The '''set.view.v''' command assigns a view to an object indirectly.

== Syntax ==

set.view.v([[screen object|obj]] oA, [[variable|var]] vVIEW);

== Remarks ==

[[View Resource (AGI)|View]] '''B''' (where '''B''' is the value of [[variable]] '''vVIEW''') is assigned to [[screen object]] '''oA'''. The view must be loaded or AGI raises [[trappable error #3]].

When the view is assigned, AGI checks the current [[loop]] value of the screen object against the loop count of the newly assigned view. If the loop value exceeds the new loop count, the object's loop value is set to zero. This will only be a concern if a screen object gets assigned a view, the loop is changed to a non-zero value, and then a different view is assigned later.

It is possible to assign the same view to multiple screen objects. King's Quest I does this with the alligators in the moat in the opening scene.

== Possible Errors ==

In [[version]] 2.089 only, AGI raises [[trappable error #2]] if object number '''oA''' is invalid. In all later versions, AGI does not check that object number '''oA''' is a valid [[screen object]]. If it is not, this command will overwrite other data on the [[memory heap]], which may cause unexpected results, including possibly [[crashing AGI]].

== Example ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
animate.obj(o1);
v51 = 5;
load.view.v(v51);
set.view.v(o1, v51);
animate.obj(o2);
set.view.v(o2, v51); [ ok to share a view
</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:'''
| 42 (0x2A hex)
|}

== See Also ==

'''[[load.view]]'''<br />
'''[[set.view]]'''<br />
[[Category:Commands]]<br />

Set.view.v - Revision history

Andrew Korson: Created page with "The '''set.view.v''' command assigns a view to an object indirectly. == Syntax == set.view.v(obj oA, var vVIEW); == Remarks == View Resour..."