---
title: "settingContentHeadroom(_:)"
framework: coreimage
role: symbol
role_heading: Instance Method
path: "coreimage/ciimage/settingcontentheadroom(_:)"
---

# settingContentHeadroom(_:)

Create an image by changing the receiver’s contentHeadroom property.

## Declaration

```swift
func settingContentHeadroom(_ headroom: Float) -> CIImage
```

## Return Value

Return Value  An autoreleased CIImage.

## Discussion

Discussion Changing this value will alter the behavior of the CIToneMapHeadroom and CISystemToneMap filters. If the value is set to 0.0 then the returned image’s headroom is unknown. If the value is set to 1.0 then the returned image is SDR. If the value is set to greater 1.0 then the returned image is HDR. Otherwise the returned image’s headroom is unknown.