Platforms to show: All Mac Windows Linux Cross-Platform
Back to NSColorMBS class.
NSColorMBS.blendedColorWithFraction(alpha as Double, c as NSColorMBS) as NSColorMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
fraction: The amount of the color to blend with the receiver's color. The method converts color and a copy of the receiver to RGB, and then sets each component of the returned color to fraction of color's value plus 1 – fraction of the receiver's.
color: The color to blend with the receiver's color.
The resulting color object or nil if the colors can't be converted.
NSColorMBS.CGColorHandle as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 12.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Return value may be an approximation in some cases, so there isn't guaranteed round-trip fidelity.
Available on Mac OS X 10.8.
NSColorMBS.colorSpace as NSColorSpaceMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
An object representing a color space. The returned NSColorSpace object may represent a custom color space.
Calling this method raises an exception if the receiver is not based on a color space represented by an NSColorSpace object—specifically, colors designated by NSNamedColorSpace and NSPatternColorSpace. If you are unsure about a color object, convert it to an equivalent NSColorSpace-based object before calling this method. Color objects created with color-space names NSCalibratedWhiteColorSpace, NSCalibratedBlackColorSpace, NSCalibratedRGBColorSpace, NSDeviceWhiteColorSpace, NSDeviceBlackColorSpace, NSDeviceRGBColorSpace, NSDeviceCMYKColorSpace, or NSCustomColorSpace—or with the NSColorSpace class methods corresponding to these names—are safe to use with this method. See "About Color Spaces" in Color Programming Topics for Cocoa for a list of these corresponding methods.
NSColorMBS.colorUsingColorSpace(colorSpace as NSColorSpaceMBS) as NSColorMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
space: The color space of the new NSColor object.
Returns the new NSColor object. This method converts the receiver's color to an equivalent one in the new color space. Although the new color might have different component values, it looks the same as the original. Returns nil if conversion is not possible.
If the receiver's color space is the same as that specified in space, this method returns the same NSColor object.
NSColorMBS.colorUsingColorSpaceName(colorSpace as string) as NSColorMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
colorSpace: The name of the color space containing the new NSColor object. If colorSpace is "", the most appropriate color space is used.
The new NSColor object or nil if the specified conversion cannot be done.
NSColorMBS.colorUsingType(type as Integer) as NSColorMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 18.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
Return nil if conversion is not possible.
NSColorMBS.colorWithAlphaComponent(alpha as Double) as NSColorMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
alpha: The opacity value of the new NSColor object.
Returns a new NSColor object. If the receiver's color space doesn't include an alpha component, the receiver is returned.
A subclass with explicit opacity components should override this method to return a color with the specified alpha.
Some examples using this method:
NSColorMBS.colorWithSystemEffect(systemEffect as Integer) as NSColorMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 18.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
This color is safe to create before draw time, as the resolution of the final color only happens when being set, retrieving its CGColor, resolving with colorWithType, etc. The return color type is named.
Available on MacOS 10.14 or newer.
NSColorMBS.Components as Double()
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
You can invoke this method on NSColor objects created from custom color spaces to get the individual floating point components, including alpha. Raises an exception if the receiver doesn't have floating-point components. To find out how many components are in the components array, send the receiver a numberOfComponents message.
NSColorMBS.Constructor(c as color)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 17.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
See also:
NSColorMBS.Constructor(red as Double, green as Double, blue as Double, alpha as Double = 1.0)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 17.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Pass values in range from 0.0 to 1.0.
See also:
NSColorMBS.getCMYK(byref cyan as Double, byref magenta as Double, byref yellow as Double, byref black as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
cyan: Upon return, contains the cyan component of the color object.
magenta: Upon return, contains the magenta component of the color object.
yellow: Upon return, contains the yellow component of the color object.
black: Upon return, contains the black component of the color object.
alpha: Upon return, contains opacity value of the color object. (optionally)
This method works only with objects representing colors in the NSDeviceCMYKColorSpace. Sending it to other objects raises an exception.
See also:
NSColorMBS.getCMYK(byref cyan as Double, byref magenta as Double, byref yellow as Double, byref black as Double, byref alpha as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
cyan: Upon return, contains the cyan component of the color object.
magenta: Upon return, contains the magenta component of the color object.
yellow: Upon return, contains the yellow component of the color object.
black: Upon return, contains the black component of the color object.
alpha: Upon return, contains opacity value of the color object. (optionally)
This method works only with objects representing colors in the NSDeviceCMYKColorSpace. Sending it to other objects raises an exception.
See also:
NSColorMBS.getHSV(byref hue as Double, byref saturation as Double, byref brightness as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
hue: Upon return, contains the hue component of the color object.
saturation: Upon return, contains the saturation component of the color object.
brightness: Upon return, contains the brightness component of the color object.
alpha: Upon return, contains the opacity value of the color object. (optionally)
This method works only with objects representing colors in the NSCalibratedRGBColorSpace or NSDeviceRGBColorSpace color space. Sending it to other objects raises an exception.
See also:
NSColorMBS.getHSV(byref hue as Double, byref saturation as Double, byref brightness as Double, byref alpha as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
hue: Upon return, contains the hue component of the color object.
saturation: Upon return, contains the saturation component of the color object.
brightness: Upon return, contains the brightness component of the color object.
alpha: Upon return, contains the opacity value of the color object. (optionally)
This method works only with objects representing colors in the NSCalibratedRGBColorSpace or NSDeviceRGBColorSpace color space. Sending it to other objects raises an exception.
See also:
NSColorMBS.getRGB(byref red as Double, byref green as Double, byref blue as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
red: Upon return, contains the red component of the color object.
green: Upon return, contains the green component of the color object.
blue: Upon return, contains the blue component of the color object.
alpha: Upon return, contains the opacity value of the color object. (optionally)
This method works only with objects representing colors in the NSCalibratedRGBColorSpace or NSDeviceRGBColorSpace color space. Sending it to other objects raises an exception.
Plugin converts color to calibrated RGB if needed.
See also:
NSColorMBS.getRGB(byref red as Double, byref green as Double, byref blue as Double, byref alpha as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
red: Upon return, contains the red component of the color object.
green: Upon return, contains the green component of the color object.
blue: Upon return, contains the blue component of the color object.
alpha: Upon return, contains the opacity value of the color object. (optionally)
This method works only with objects representing colors in the NSCalibratedRGBColorSpace or NSDeviceRGBColorSpace color space. Sending it to other objects raises an exception.
Plugin converts color to calibrated RGB if needed.
See also:
NSColorMBS.getWhite(byref white as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
white: Upon return, contains the grayscale value of the color object.
alpha: Upon return, contains the opacity value of the color object. (optionally)
This method works only with objects representing colors in the NSCalibratedWhiteColorSpace, NSCalibratedBlackColorSpace, NSDeviceBlackColorSpace, or NSDeviceWhiteColorSpace color space. Sending it to other objects raises an exception.
See also:
NSColorMBS.getWhite(byref white as Double, byref alpha as Double)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
white: Upon return, contains the grayscale value of the color object.
alpha: Upon return, contains the opacity value of the color object. (optionally)
This method works only with objects representing colors in the NSCalibratedWhiteColorSpace, NSCalibratedBlackColorSpace, NSDeviceBlackColorSpace, or NSDeviceWhiteColorSpace color space. Sending it to other objects raises an exception.
See also:
NSColorMBS.highlightWithLevel(level as Double) as NSColorMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
level: The amount of the highlight color that is blended with the receiver's color. This should be a number from 0.0 through 1.0. A highlightLevel below 0.0 is interpreted as 0.0; a highlightLevel above 1.0 is interpreted as 1.0.
Returns the new NSColor object. Returns nil if the colors can't be converted.
Invoke this method when you want to brighten the receiving NSColor for use in highlights.
NSColorMBS.patternImage as Variant
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
The image used by the color object. If the receiver doesn't have an image, this method raises an exception.
Declared a variant instead of NSImageMBS to reduce plugin dependencies.
NSColorMBS.shadowWithLevel(level as Double) as NSColorMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
level: The amount of the shadow color used for the blend. This should be a number from 0.0 through 1.0. A shadowLevel below 0.0 is interpreted as 0.0; a shadowLevel above 1.0 is interpreted as 1.0.
Returns the new NSColor object. Returns nil if the colors can't be converted.
Invoke this method when you want to darken the receiving NSColor for use in shadows.
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Cocoa Drawing | MBS MacBase Plugin | 9.8 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
The items on this page are in the following plugins: MBS MacBase Plugin.