<!--
{
  "availability" : [
    "*: -"
  ],
  "documentType" : "symbol",
  "framework" : "quicktime-file-format",
  "identifier" : "/documentation/quicktime-file-format/QuickTime_VR_sample_description",
  "metadataVersion" : "0.1.0",
  "role" : "Atom",
  "symbol" : {
    "kind" : "Atom",
    "modules" : [
      "QuickTime File Format"
    ],
    "preciseIdentifier" : "__docc_universal_symbol_reference_$QuickTime_VR_sample_description"
  },
  "title" : "QuickTime VR sample description ('qtvr')"
}
-->

# QuickTime VR sample description ('qtvr')

Describe QuickTime VR samples.

## Overview

Whereas the QuickTime VR media sample is simply the node information itself, all sample descriptions are required by QuickTime to have a certain structure for the first several bytes. The structure for the QuickTime VR sample description is as follows:

```c
typedef struct QTVRSampleDescription {
    UInt32                              size;
    UInt32                              type;
    UInt32                              reserved1;
    UInt16                              reserved2;
    UInt16                              dataRefIndex;
    UInt32                              data;
} QTVRSampleDescription, *QTVRSampleDescriptionPtr, **QTVRSampleDescriptionHandle;
```

## Topics

### Data fields

[`size`](/documentation/quicktime-file-format/QuickTime_VR_sample_description/size)

The size, in bytes, of the sample description header structure.

[`type`](/documentation/quicktime-file-format/QuickTime_VR_sample_description/type)

The sample description type.

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

Reserved.

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

Reserved.

[`dataRefIndex`](/documentation/quicktime-file-format/QuickTime_VR_sample_description/dataRefIndex)

Reserved.

[`data`](/documentation/quicktime-file-format/QuickTime_VR_sample_description/data)

The VR world atom container.


---

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)