<!--
{
  "availability" : [
    "*: -"
  ],
  "documentType" : "symbol",
  "framework" : "QuickTime File Format",
  "identifier" : "/documentation/quicktime-file-format/Hot_spot_information_atom",
  "metadataVersion" : "0.1.0",
  "role" : "Atom",
  "symbol" : {
    "kind" : "Atom",
    "modules" : [
      "QuickTime File Format"
    ],
    "preciseIdentifier" : "__docc_universal_symbol_reference_$Hot_spot_information_atom"
  },
  "title" : "Hot spot information atom ('hsin')"
}
-->

# Hot spot information atom ('hsin')

An atom that contains general information about a hot spot.

## Overview

The hot spot information atom contains general information about a hot spot. Its atom type is `kQTVRHotSpotInfoAtomType` (`'hsin'`). Every hot spot atom should have a hot spot information atom as a child.

The structure of a hot spot information atom is defined by the `QTVRHotSpotInfoAtom` data type:

```c
typedef struct VRHotSpotInfoAtom {
    UInt16                              majorVersion;
    UInt16                              minorVersion;
    OSType                              hotSpotType;
    QTAtomID                            nameAtomID;
    QTAtomID                            commentAtomID;
    SInt32                              cursorID[3];
    Float32                             bestPan;
    Float32                             bestTilt;
    Float32                             bestFOV;
    FloatPoint                          bestViewCenter;
    Rect                                hotSpotRect;
    UInt32                              flags;
    UInt32                              reserved1;
    UInt32                              reserved2;
} VRHotSpotInfoAtom, *QTVRHotSpotInfoAtomPtr;
```

> Note: In QuickTime VR movie files, all angular values are stored as 32-bit floating-point values that specify degrees. In addition, all floating-point values conform to the IEEE Standard 754 for binary floating-point arithmetic, in big-endian format.

## Topics

### Data fields

[`majorVersion`](/documentation/quicktime-file-format/Hot_spot_information_atom/majorVersion)

The major version number of the file format.

[`minorVersion`](/documentation/quicktime-file-format/Hot_spot_information_atom/minorVersion)

The minor version number of the file format.

[`hotSpotType`](/documentation/quicktime-file-format/Hot_spot_information_atom/hotSpotType)

The hot spot type.

[`nameAtomID`](/documentation/quicktime-file-format/Hot_spot_information_atom/nameAtomID)

The ID of the string atom that contains the name of the hot spot.

[`commentAtomID`](/documentation/quicktime-file-format/Hot_spot_information_atom/commentAtomID)

The ID of the string atom that contains a comment for the hot spot.

[`cursorID`](/documentation/quicktime-file-format/Hot_spot_information_atom/cursorID)

An array of three IDs for custom hot spot cursors.

[`bestPan`](/documentation/quicktime-file-format/Hot_spot_information_atom/bestPan)

The best pan angle for viewing this hot spot.

[`bestTilt`](/documentation/quicktime-file-format/Hot_spot_information_atom/bestTilt)

The best tilt angle for viewing this hot spot.

[`bestFOV`](/documentation/quicktime-file-format/Hot_spot_information_atom/bestFOV)

The best field of view for viewing this hot spot.

[`bestViewCenter`](/documentation/quicktime-file-format/Hot_spot_information_atom/bestViewCenter)

The best view center for viewing this hot spot.

[`hotSpotRect`](/documentation/quicktime-file-format/Hot_spot_information_atom/hotSpotRect)

The boundary box for this hot spot, specified as the number of pixels in full panoramic space.

[`flags`](/documentation/quicktime-file-format/Hot_spot_information_atom/flags)

A set of hot spot flags.

[`reserved1`](/documentation/quicktime-file-format/Hot_spot_information_atom/reserved1)

Reserved.

[`reserved2`](/documentation/quicktime-file-format/Hot_spot_information_atom/reserved2)

Reserved.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)