<!--
{
  "availability" : [
    "macOS: 14.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSImage/DynamicRange",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:@E@NSImageDynamicRange"
  },
  "title" : "NSImage.DynamicRange"
}
-->

# NSImage.DynamicRange

Describes how High Dynamic Range (HDR) image content displays.

```
enum DynamicRange
```

## Overview

Use this type to enable or constrain the display of High Dynamic Range (HDR) in an [`NSImageView`](/documentation/AppKit/NSImageView). Displaying HDR content in an [`NSImageView`](/documentation/AppKit/NSImageView) requires that the [`NSImage`](/documentation/AppKit/NSImage) has HDR content in the ITU-R 2100 color space and that the output device has Extended Dynamic Range (EDR) capabilities.

## Topics

### Setting the dynamic range

[`case standard`](/documentation/AppKit/NSImage/DynamicRange/standard)

Restricts the image content dynamic range to the standard range regardless of the actual range of the image content.

[`case constrainedHigh`](/documentation/AppKit/NSImage/DynamicRange/constrainedHigh)

Allows for constrained High Dynamic Range (HDR) image content which is useful for mixing HDR and Standard Dynamic Range (SDR) content.

[`case high`](/documentation/AppKit/NSImage/DynamicRange/high)

Allows image content to use extended dynamic range if it has dynamic range content.

[`case unspecified`](/documentation/AppKit/NSImage/DynamicRange/unspecified)

Indicates that the dynamic range treatment of the image is unknown or otherwise unspecified.

### Initializers

[`init?(rawValue: Int)`](/documentation/AppKit/NSImage/DynamicRange/init(rawValue:))

## Relationships

### Conforms To

[`Equatable`](/documentation/Swift/Equatable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`BitwiseCopyable`](/documentation/Swift/BitwiseCopyable)

[`Hashable`](/documentation/Swift/Hashable)

[`RawRepresentable`](/documentation/Swift/RawRepresentable)

[`Sendable`](/documentation/Swift/Sendable)

---

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)