<panogroup>

Description

Multiple panoelements can be grouped in a panogroup. This group of elements can be moved around the scene, hidden and revealed as well als enabled and disabled as a single entity.

It is not necessary to specify a root group; panoelement nodes can reside directly in the scene node.

Syntax

<tour>
  <scene>
    <panogroup id="groupID"
      pan="0" tilt="0" zorder="0" 
      visible="true" enabled="true" >
      <panoelement />
      ...
    </panogroup>
    ...
    <panoelement />
    ...
  </scene>
</tour>

Attributes

• id

  Unique id to reference the group by.

• src

  Optionally specifies an external XML file that describes this node. If src is specified, node attributes and any inline child elements are replaced by the child elements specified in the external file. The external file should be SPi-V XML file, and contain at least a single panogroup node.

• pan

  Setting this value will offset the pan values of the children of this group by the specified amount.
  Values: -180 to 180, defaults to 0

• tilt

  Setting this value will offset the tilt values of the children of this group by the specified amount.
  Values: -90 to 90, defaults to 0

• zorder

  Sets the depth sort order of the group as a whole. The sort order of each of the children of the group are set individually using the children's zorder property.
  Values: 0 to 9, defaults to 0

• visible

  Shows/hides all the child elements.
  Values: true/false, defaults to true

• enabled

  Enables/disables all child elements (while remaining visible)
  Values: true/false, defaults to true

Events

• enter

  Fires when the pointer is moved over an element in the group.

• leave

  Fires when the pointer leaves the an element in the group.

• press

  Fires when the user presses the mouse button while over an element in the group.

• release

  Fires when the user releases the mouse button after the press event has fired for an element in the group.

• ready

  Fires when all the elements in this group are done building.

Children

• panoelement
• panogroup

History

• 22-Mar-07: Added events
• 06-Jun-05: Updated zorder attribute
• 13-Oct-04: Updated src attribute
• 15-Apr-04: Initial version