<!--
{
  "availability" : [
    "FxPlug: 4.0.0 -",
    "macOS: 10.7.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "professional_video_applications",
  "identifier" : "/documentation/professional_video_applications/FxParameterRetrievalAPI_v6/getHistogramBlack(in:blackOut:whiteIn:whiteOut:gamma:forChannel:fromParameter:at:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Professional Video Applications"
    ],
    "preciseIdentifier" : "c:objc(pl)FxParameterRetrievalAPI_v6(im)getHistogramBlackIn:BlackOut:WhiteIn:WhiteOut:Gamma:forChannel:fromParameter:atTime:"
  },
  "title" : "getHistogramBlack(in:blackOut:whiteIn:whiteOut:gamma:forChannel:fromParameter:at:)"
}
-->

# getHistogramBlack(in:blackOut:whiteIn:whiteOut:gamma:forChannel:fromParameter:at:)

Gets the Histogram parameter settings.

```
func getHistogramBlack(in blackIn: UnsafeMutablePointer<Double>, blackOut: UnsafeMutablePointer<Double>, whiteIn: UnsafeMutablePointer<Double>, whiteOut: UnsafeMutablePointer<Double>, gamma: UnsafeMutablePointer<Double>, forChannel channel: FxHistogramChannel, fromParameter parameterID: UInt32, at time: CMTime) -> Bool
```

## Parameters

`blackIn`

Pointer for the parameter black in level value.

`blackOut`

Pointer for the parameter black out level value.

`whiteIn`

Pointer for the parameter white in level value.

`whiteOut`

Pointer for the parameter white out level value.

`gamma`

Pointer for the parameter gamma level value.

`channel`

Specified channel for the histogram information (RGB: `0`, Red: `1`, Green: `2`, Blue: `3`, Alpha: `4`).

`parameterID`

Unique identifier for the parameter.

`time`

Specified time to get the values.

## Return Value

Returns `YES` if the value is retrieved successfully; `NO` otherwise.

## Discussion

Depending on the host application, the time value may be relative to the start of the timeline or to the start of the clip. See [Understanding time in FxPlug](/documentation/Professional-Video-Applications/understanding-time-in-fxplug).

---

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)