# NSColor

scottc@net-community.com
fredkiefer@gmx.de
Generated at 2026-06-27 19:09:52 +0000

The colorful color class

1996, 1998, 2001, 2002 Free Software Foundation, Inc.
Software documentation for the NSColor class
AppKit/NSColor.h
NSCoding
NSCopying

TODO NSColor description

alternateSelectedControlColor
Description forthcoming.
alternateSelectedControlTextColor
Description forthcoming.
blackColor

Returns a NSColor in a NSCalibratedWhiteColorSpace space name. with white and alpha values set as NSBlack and 1.0 respectively.

See Also : +colorWithCalibratedWhite:alpha:

blueColor

Returns an NSColor in a NSCalibratedRGBColorSpace space name. with red, green, blue and alpha values set as 0.0, 0.0, 1.0 and 1.0 respectively.

See Also : +colorWithCalibratedRed:green:blue:alpha:

brownColor

Returns a NSColor in a NSCalibratedRGBColorSpace space name. with red, green, blue and alpha values set as 0.6, 0.4, 0.2 and 1.0 respectively.

See Also: +colorWithCalibratedRed:green:blue:alpha:

clearColor

Returns a NSColor in a NSCalibratedWhiteColorSpace space name. with white and alpha values set as 0.0 and 1.0 respectively.

See Also : +colorWithCalibratedWhite:alpha:

colorForControlTint:
controlTint
Description forthcoming.
colorFromPasteboard:
pasteBoard

Returns the NSColor on the NSPasteboard pasteBoard or `nil` if it does not exists.

See Also: -writeToPasteboard:

colorWithCalibratedHue:
hue
saturation:
saturation
brightness:
brightness
alpha:
alpha

Creates and returns a new NSColor in a NSCalibratedRGBColorSpace space name, with hue, saturation, brightness and alpha as specified. Valid values are the range 0.0 to 1.0. Out of range values will be clipped.

colorWithCalibratedRed:
red
green:
green
blue:
blue
alpha:
alpha

Creates and returns a new NSColor in a NSCalibratedRGBColorSpace space name, with red, green, blue and alpha as specified. Valid values are the range 0.0 to 1.0. Out of range values will be clipped.

colorWithCalibratedWhite:
white
alpha:
alpha

Creates and returns a new NSColor in a NSCalibratedWhiteColorSpace space name, with red, green, blue and alpha as specified. Valid values are the range 0.0 to 1.0. Out of range values will be clipped.

colorWithCatalogName:
listName
colorName:
colorName

TODO

colorWithColorSpace:
space
components:
comp
count:
number
Description forthcoming.
colorWithColorSpace:
space
hue:
hue
saturation:
saturation
brightness:
brightness
alpha:
alpha
Description forthcoming.
colorWithDeviceCyan:
cyan
magenta:
magenta
yellow:
yellow
black:
black
alpha:
alpha

Creates and returns a new NSColor in a NSDeviceCMYKColorSpace space name, with cyan, magenta, yellow, black and alpha as specified. Valid values are the range 0.0 to 1.0. Out of range values will be clipped.

colorWithDeviceHue:
hue
saturation:
saturation
brightness:
brightness
alpha:
alpha

Creates and returns a new NSColor in a NSDeviceCMYKColorSpace space name, with hue, saturation, brightness and alpha as specified. Valid values are the range 0.0 to 1.0. Out of range values will be clipped.

colorWithDeviceRed:
red
green:
green
blue:
blue
alpha:
alpha

Creates and returns a new NSColor in a NSDeviceCMYKColorSpace space name, with red, green, blue and alpha as specified. Valid values are the range 0.0 to 1.0. Out of range values will be clipped.

colorWithDeviceWhite:
white
alpha:
alpha

Creates and returns a new NSColor in a NSDeviceWhiteColorSpace space name, with red, green, blue and alpha as specified. Valid values are the range 0.0 to 1.0. Out of range values will be clipped.

colorWithDisplayP3Red:
red
green:
green
blue:
blue
alpha:
alpha
Description forthcoming.
colorWithGenericGamma22White:
white
alpha:
alpha
Description forthcoming.
colorWithHue:
hue
saturation:
saturation
brightness:
brightness
alpha:
alpha
Description forthcoming.
colorWithPatternImage:
image
Description forthcoming.
colorWithRed:
red
green:
green
blue:
blue
alpha:
alpha
Description forthcoming.
colorWithSRGBRed:
red
green:
green
blue:
blue
alpha:
alpha
Description forthcoming.
colorWithWhite:
white
alpha:
alpha
Description forthcoming.
controlAlternatingRowBackgroundColors
Description forthcoming.
controlBackgroundColor
Description forthcoming.
controlColor
Description forthcoming.
controlDarkShadowColor
Description forthcoming.
controlHighlightColor
Description forthcoming.
controlLightHighlightColor
Description forthcoming.
controlShadowColor
Description forthcoming.
controlTextColor
Description forthcoming.
currentControlTint
Description forthcoming.
cyanColor

Returns a NSColor in a NSCalibratedRGBColorSpace space name. with red, green, blue and alpha values set as 0.0, 1.0, 1.0 and 1.0 respectively.

See Also : +colorWithCalibratedRed:green:blue:alpha:

darkGrayColor

Returns a NSColor in a NSCalibratedWhiteColorSpace space name. with white and alpha values set as NSDarkGray and 1.0 respectively.

See Also : +colorWithCalibratedWhite:alpha:

disabledControlTextColor
Description forthcoming.
grayColor

Returns a NSColor in a NSCalibratedWhiteColorSpace space name. with white and alpha values set as NSGray and 1.0 respectively.

See Also: +colorWithCalibratedWhite:alpha:

greenColor

Returns a NSColor in a NSCalibratedRGBColorSpace space name. with red, green, blue and alpha values set as 0.0, 1.0, 0.0 and 1.0 respectively

See Also: +colorWithCalibratedRed:green:blue:alpha:

gridColor
Description forthcoming.
headerColor
Description forthcoming.
headerTextColor
Description forthcoming.
highlightColor
Description forthcoming.
ignoresAlpha
Returns whether TODO

See Also: +setIgnoresAlpha:

keyboardFocusIndicatorColor
Description forthcoming.
knobColor
Description forthcoming.
labelColor
Description forthcoming.
lightGrayColor

Returns a NSColor in a NSCalibratedWhiteColorSpace space name. with white and alpha values set as NSLightGray and 1.0 respectively

See Also : +colorWithCalibratedRed:green:blue:alpha:

magentaColor

Returns a NSColor in a NSCalibratedRGBColorSpace space name. with red, green, blue and alpha values set as 1.0, 0.0, 1.0 and 1.0 respectively.

See Also : +colorWithCalibratedRed:green:blue:alpha:

orangeColor

Returns a NSColor in a NSCalibratedRGBColorSpace space name. with red, green, blue and alpha values set as 1.0, 0.5, 0.0 and 1.0 respectively.

See Also: +colorWithCalibratedRed:green:blue:alpha:

purpleColor

Returns a NSColor in a NSCalibratedRGBColorSpace space name. with red, green, blue and alpha values set as 0.5, 0.0, 0.5 and 1.0 respectively.

See Also : +colorWithCalibratedRed:green:blue:alpha:

quaternaryLabelColor
Description forthcoming.
redColor

Returns a NSColor in a NSCalibratedRGBColorSpace space name. with red, green, blue and alpha values set as 1.0, 0.0, 0.0 and 1.0 respectively

See Also: +colorWithCalibratedRed:green:blue:alpha:

scrollBarColor
Description forthcoming.
secondaryLabelColor
Description forthcoming.
secondarySelectedControlColor
Description forthcoming.
selectedControlColor
Description forthcoming.
selectedControlTextColor
Description forthcoming.
selectedKnobColor
Description forthcoming.
selectedMenuItemColor
Description forthcoming.
selectedMenuItemTextColor
Description forthcoming.
selectedTextBackgroundColor
Description forthcoming.
selectedTextColor
Description forthcoming.
setIgnoresAlpha:
flag
TODO

See Also: +ignoresAlpha

shadowColor
Description forthcoming.
systemBlueColor
Description forthcoming.
systemBrownColor
Description forthcoming.
systemGrayColor
Description forthcoming.
systemGreenColor
Description forthcoming.
systemIndigoColor
Description forthcoming.
systemOrangeColor
Description forthcoming.
systemPinkColor
Description forthcoming.
systemPurpleColor
Description forthcoming.
systemRedColor
Description forthcoming.
systemTealColor
Description forthcoming.
systemYellowColor
Description forthcoming.
tertiaryLabelColor
Description forthcoming.
textBackgroundColor
Description forthcoming.
textColor
Description forthcoming.
toolTipColor
Description forthcoming.
toolTipTextColor
Description forthcoming.
whiteColor

Returns a NSColor in a NSCalibratedWhiteColorSpace space name. with white and alpha values set as NSWhite and 1.0 respectively.

See Also : +colorWithCalibratedWhite:alpha:

windowBackgroundColor
Description forthcoming.
windowFrameColor
Description forthcoming.
windowFrameTextColor
Description forthcoming.
yellowColor

Returns a NSColor in a NSCalibratedRGBColorSpace space name. with red, green, blue and alpha values set as 1.0, 0.0, 0.0 and 1.0 respectively.

See Also : +colorWithCalibratedRed:green:blue:alpha:

alphaComponent

Returns the alpha component.

blackComponent

Returns the black component. Raises a NSInternalInconsistencyException if NSColor is not a CMYK color.

blendedColorWithFraction:
fraction
ofColor:
aColor
Description forthcoming.
blueComponent

Returns the blue component. Raises a NSInternalInconsistencyException if NSColor is not a RGB color.

brightnessComponent

Returns the brightness component. Raises a NSInternalInconsistencyException if NSColor space is not a RGB color

catalogNameComponent
Description forthcoming.
colorNameComponent
Description forthcoming.
colorSpace
Description forthcoming.
colorSpaceName
Description forthcoming.
colorUsingColorSpace:
space
Description forthcoming.
colorUsingColorSpaceName:
colorSpace
Description forthcoming.
colorUsingColorSpaceName:
colorSpace
device:
deviceDescription
Description forthcoming.
colorUsingType:
type
Description forthcoming.
colorWithAlphaComponent:
alpha
Description forthcoming.
colorWithSystemEffect:
systemEffect
Description forthcoming.
cyanComponent

Returns the cyan component. Raises a NSInternalInconsistencyException if NSColor is not a CYMK color

drawSwatchInRect:
rect
Description forthcoming.
getComponents:
components
Description forthcoming.
getCyan:
cyan
magenta:
magenta
yellow:
yellow
black:
black
alpha:
alpha

Gets the cyan, magenta, yellow,black and alpha values from the NSColor. Raises a NSInternalInconsistencyException if the NSColor is not a CYMK color

getHue:
hue
saturation:
saturation
brightness:
brightness
alpha:
alpha

Gets the hue, saturation, brightness and alpha values from the NSColor. Raises a NSInternalInconsistencyException if the NSColor is not a RGB color

getRed:
red
green:
green
blue:
blue
alpha:
alpha

Gets the red, green, blue and alpha values from the NSColor. Raises a NSInternalInconsistencyException if the NSColor is not a RGB color

getWhite:
white
alpha:
alpha

Gets the white alpha values from the NSColor. Raises a NSInternalInconsistencyException if the NSColor is not a greyscale color

greenComponent

Returns the green component. Raises a NSInternalInconsistencyException if NSColor is not a RGB color

highlightWithLevel:
level
Description forthcoming.
hueComponent

Returns the hue component. Raises a NSInternalInconsistencyException if NSColor is not a RGB color

localizedCatalogNameComponent
Description forthcoming.
localizedColorNameComponent
Description forthcoming.
magentaComponent

Returns the magenta component. Raises a NSInternalInconsistencyException if NSColor is not a CMYK color

numberOfComponents
Description forthcoming.
patternImage
Description forthcoming.
redComponent

Returns the red component. Raises a NSInternalInconsistencyException if NSColor is not a RGB color

saturationComponent

Returns the saturation component. Raises a NSInternalInconsistencyException if NSColor is not a RGB color

set
Description forthcoming.
setFill
Description forthcoming.
setStroke
Description forthcoming.
shadowWithLevel:
level
Description forthcoming.
type
Description forthcoming.
whiteComponent

Returns the white component. Raises a NSInternalInconsistencyException if NSColor is not a grayscale color

writeToPasteboard:
pasteBoard

Writes the NSColor into the NSPasteboard specified by pasteBoard

See Also: +colorFromPasteboard:

yellowComponent

Returns the yellow component. Raises a NSInternalInconsistencyException if NSColor is not a RGB color

Software documentation for the NSCoder(NSCoderAdditions) category
AppKit/NSColor.h
Description forthcoming.
decodeNXColor
Description forthcoming.
Software documentation for the NSColor(GSQuartz) category
AppKit/NSColor.h
Description forthcoming.
CGColor
Description forthcoming.