HomefieldOfView | SPi-V dev

Legend

  • required
  • not yet implemented

Navigation

user

<action>

Description

actions allow both navigating between scenes in a tour and complex interaction with the panoramic scene. A single event can lead to the execution of multiple actions within the behavior.

Different nodes have different events, see the defenition of each node to see what events are available.

Syntax

<tour>
  <scene>
    <panoelement id="nodeID" ...\>
    ...

    <behavior id="behaviorID" />
      <action event="click" type="getURL"
        src="file.jpg" target="infoframe" />
      <action event="click" type="setProperty"
        target="nodeID"  property="visible" value="false"  />
      <action event="click" type="setView"
        scene="sceneID" pan="0" tilt="0" fov="90" />
    </behavior>
      ...
  </scene>

  <scene id="sceneID">
    ..
  </scene>
</tour>

Attributes

  • event
    The event, fired by the parent element, that this action should respond to.
  • type
    The type of action to perform

    The rest of the attributes of the action node depend on the type attribute. For a more indepth description of each type of action, see the API documentation

    • getURL
      Open a url in the specified frame. Attributes: src, target
    • setProperty
      Set a property of the specified object. Attributes: target, property, value
    • setView
      Sets the viewing direction and/or scene. Attributes: scene, pan, tilt, fov
    • logMessage
      Adds a message to the viewer log. Attributes: message, importance
    • setWindow
      Only functional in the SPi-V standalone viewers. Sets the viewer window state/size. Attributes: state
    • exitWindow
      Only functional in the SPi-V standalone viewers. Closes the viewer window.

Children

none

History

  • 20-Apr-04: Initial version

setProperty and panoelements

Currently, you cannot alter the hfov, vfov, hoffset or voffset of a panoelement on-the-fly from actions, as these attributes would change the geometry of the displayed image.
Pan/tilt/roll are alterable, so you can make panoelements swing around within the panorama or roll on the spot.

Ian Wood
Spi-V engine 1.3 beta 10

getURL documentation inconstancy

Here you specify getURL attributes as "src" and "target", however in your example you use "value" instead of "src".
If you click on the getURL link it tells me I've got to use the "url" atribute....

EDIT:
It appears that only the "url" atribute works. Also don't you mean "release" instead of "click"?

Re: getURL documentation inconstancy

Thanks for going through the docs with such diligence. You are right about both 'url' and 'release'. I will fix up the docs over the next few days.