<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "quicktime-file-format",
  "identifier" : "/documentation/quicktime-file-format/Object_sample_atom/controlSettings",
  "metadataVersion" : "0.1.0",
  "role" : "Data field",
  "symbol" : {
    "kind" : "Data field",
    "modules" : [
      "QuickTime File Format"
    ],
    "preciseIdentifier" : "__docc_universal_symbol_reference_$Object_sample_atom_controlSettings"
  },
  "title" : "controlSettings"
}
-->

# controlSettings

A set of 32-bit flags that encode information about the control settings of the object.

## Overview

The `controlSettings` field of the object sample atom is a long integer that specifies a set of control settings for an object node. Control settings specify whether the object can wrap during panning and tilting, as well as other features of the node. The control settings are specified using these bit flags:

```c
enum QTVRControlSettings {
    kQTVRObjectWrapPanOn                        = (1 << 0),
    kQTVRObjectWrapTiltOn                       = (1 << 1),
    kQTVRObjectCanZoomOn                        = (1 << 2),
    kQTVRObjectReverseHControlOn                = (1 << 3),
    kQTVRObjectReverseVControlOn                = (1 << 4),
    kQTVRObjectSwapHVControlOn                  = (1 << 5),
    kQTVRObjectTranslationOn                    = (1 << 6)
};
```

**Constant Descriptions**

- `kQTVRObjectWrapPanOn`: The control setting to enable wrapping during panning. When this control setting is enabled, the user can wrap around from the current pan constraint maximum value to the pan constraint minimum value (or vice versa) using the mouse or arrow keys.
- `kQTVRObjectWrapTiltOn`: The control setting to enable wrapping during tilting. When this control setting is enabled, the user can wrap around from the current tilt constraint maximum value to the tilt constraint minimum value (or vice versa) using the mouse or arrow keys.
- `kQTVRObjectCanZoomOn`: The control setting to enable zooming. When this control setting is enabled, the user can change the current field of view using the zoom-in and zoom-out keys on the keyboard (or using the VR controller buttons).
- `kQTVRObjectReverseHControlOn`: The control setting to reverse the direction of the horizontal control.
- `kQTVRObjectReverseVControlOn`: The control setting to reverse the direction of the vertical control.
- `kQTVRObjectSwapHVControlOn`: The control setting to exchange the horizontal and vertical controls.
- `kQTVRObjectTranslationOn`: The control setting to enable translation. When this setting is enabled, the user can translate using the mouse when either the translate key is held down or the controller translation mode button is toggled on.

---

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)