---
title: Support for wired actions
framework: QuickTime File Format
role: article
role_heading: Article
path: quicktime-file-format/support_for_wired_actions
---

# Support for wired actions

Support wired actions in a QuickTime VR file.

## Overview

Overview important: VR Media is deprecated in the QuickTime file format. The information that follows documents existing content containing VR Media and should not be used for new development. Certain actions on a QuickTime VR movie can trigger wired actions if the appropriate event handler atoms have been added to the file. This section discusses what atoms must be included in the QuickTime VR file to support wired actions. As with sprite tracks, the presence of a certain atom in the media property atom container of the QTVR track enables the handling of wired actions. This atom is of type kSpriteTrackPropertyHasActions, which has a single Boolean value that must be set to true. When certain events occur and the appropriate event handler atom is found in the QTVR file, then that atom is passed to QuickTime to perform any actions specified in the atom. The event handler atoms themselves must be added to the node information atom container in the QTVR track. There are two types of event handlers for QTVR nodes: global and hot spot specific. The currently supported global event handlers are kQTEventFrameLoaded and kQTEventIdle. The event handler atoms for these are located at the root level of the node information atom container. A global event handler atom’s type is set to the event type and its ID is set to 1. Hot spot–specific event handler atoms are located in the specific hot spot atom as a sibling to the hot spot info atom. For these atoms, the atom type is always kQTEventType and the ID is the event type. Supported hot spot–specific event types are kQTEventMouseClick, kQTEventMouseClickEnd, kQTEventMouseClickEndTriggerButton, and kQTEventMouseEnter, kQTEventMouseExit. The specific actions that cause these events to be generated are described as follows:

## See Also

### Media data atom types

- [Sprite media](quicktime-file-format/sprite_media.md)
- [Sprite track properties](quicktime-file-format/sprite_track_properties.md)
- [Sprite track media format](quicktime-file-format/sprite_track_media_format.md)
- [Sprite media atom and data types](quicktime-file-format/sprite_media_atom_and_data_types.md)
- [Sprite button behaviors](quicktime-file-format/sprite_button_behaviors.md)
- [QT atom container description key](quicktime-file-format/qt_atom_container_description_key.md)
- [Sprite media handler track properties QT atom container format](quicktime-file-format/sprite_media_handler_track_properties_qt_atom_container_format.md)
- [Sprite media handler sample QT atom container formats](quicktime-file-format/sprite_media_handler_sample_qt_atom_container_formats.md)
- [Wired action grammar](quicktime-file-format/wired_action_grammar.md)
- [Tween media](quicktime-file-format/tween_media.md)
- [3D media](quicktime-file-format/3d_media.md)
- [VR media](quicktime-file-format/vr_media.md)
- [Node parent atom](quicktime-file-format/node_parent_atom.md)
- [Node location atom structure](quicktime-file-format/node_location_atom_structure.md)
- [Custom cursor atom](quicktime-file-format/custom_cursor_atom.md)