<!--
{
  "availability" : [
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSColor/init(calibratedHue:saturation:brightness:alpha:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:objc(cs)NSColor(cm)colorWithCalibratedHue:saturation:brightness:alpha:"
  },
  "title" : "init(calibratedHue:saturation:brightness:alpha:)"
}
-->

# init(calibratedHue:saturation:brightness:alpha:)

Creates a color object using the given opacity and HSB color space components.

```
init(calibratedHue hue: CGFloat, saturation: CGFloat, brightness: CGFloat, alpha: CGFloat)
```

## Parameters

`hue`

The hue component of the color object in the HSB color space.

`saturation`

The saturation component of the color object in the HSB color space.

`brightness`

The brightness (or value) component of the color object in the HSB color space.

`alpha`

The opacity value of the color object,

## Return Value

The color object.

## Discussion

Values below 0.0 are interpreted as 0.0, and values above 1.0 are interpreted as 1.0.

## See Also

[`-  getHue:saturation:brightness:alpha:`](/documentation/AppKit/NSColor/getHue(_:saturation:brightness:alpha:))

Returns the color object’s HSB component and opacity values in the respective arguments.

[`+  colorWithCalibratedRed:green:blue:alpha:`](/documentation/AppKit/NSColor/init(calibratedRed:green:blue:alpha:))

Creates a color object using the given opacity and RGB components.


---

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)