<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 14.0.0 -",
    "tvOS: 17.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVFoundation",
  "identifier" : "/documentation/AVFoundation/AVCaptureDevice/isGlobalToneMappingEnabled",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "AVFoundation"
    ],
    "preciseIdentifier" : "c:objc(cs)AVCaptureDevice(py)globalToneMappingEnabled"
  },
  "title" : "isGlobalToneMappingEnabled"
}
-->

# isGlobalToneMappingEnabled

A Boolean value that indicates whether the device should use global tone mapping.

```
var isGlobalToneMappingEnabled: Bool { get set }
```

## Discussion

Tone mapping is a technique used to map the pixel levels in high dynamic range images to a reduced dynamic range (such as mapping from 16-bit to 8-bit), while still retaining an appearance as close to the original image as possible. Normally the active camera uses adaptive, local tone curves to preserve the highest image quality and adapt quickly to changing lighting conditions.

When this property value is true, the tone map adjusts dynamically depending on the current scene and applies to all pixels in an image. You can only enable this setting if the device’s active format’s [`isGlobalToneMappingSupported`](/documentation/AVFoundation/AVCaptureDevice/Format/isGlobalToneMappingSupported) property returns <doc://com.apple.documentation/documentation/Swift/true>. If set to its default value of <doc://com.apple.documentation/documentation/Swift/false>, the framework may apply different tone maps to different pixels in an image.

This property resets to its default value of <doc://com.apple.documentation/documentation/Swift/false> under the following conditions:

- You change the device’s active format.
- You add the device’s input to a session.
- You change the capture session’s preset value.

Key-value observe this property to observe automatic changes to its value.

> Note:
> When you enable global tone mapping, an ``doc://com.apple.avfoundation/documentation/AVFoundation/AVCapturePhotoOutput`` object connected to the device input’s session disables all forms of still image fusion, resulting in still images with no automatic stabilization applied.

---

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)