Omni Group Automation: Color

Color

The creation, blending, and application of colors to shapes and text is a common task performed in all Omni applications. This page details how to work with color values in various color spaces.

Color Functions

RGB(redValue, greenValue, blueValue, alphaValue or nil) (Color) • Makes a new color in the RGB colorspace, with the given components. If the alpha component is not given, 1.0 is used.
HSB(hueValue, saturationValue, brillianceValue, alphaValue or nil) • Makes a new color in the HSB colorspace, with the given components. If the alpha component is not given, 1.0 is used.
White(whiteValue, alphaValue or nil) • Makes a new color in the White colorspace, with the given components. If the alpha component is not given, 1.0 is used. A White value of: 0 is black, .5 is 50% gray.

Here’s a script example that creates a green circle (in the RGB color space) with a 50% transparency (alpha value) overlaid on a blue square:

cnvs = document.windows[0].selection.canvas square = cnvs.addShape('Rectangle',new Rect(72,72,200,200)) square.fillColor = Color.RGB(0, 0, 1, 1) circle = cnvs.addShape('Circle',new Rect(150,150,200,200)) circle.fillColor = Color.RGB(0, 1, 0, 0.5)

omnigraffle:///omnijs-run?script=cnvs%20%3D%20document%2Ewindows%5B0%5D%2Eselection%2Ecanvas%0Asquare%20%3D%20cnvs%2EaddShape%28%27Rectangle%27%2Cnew%20Rect%2872%2C72%2C200%2C200%29%29%0Asquare%2EfillColor%20%3D%20Color%2ERGB%280%2C%200%2C%201%2C%201%29%0Acircle%20%3D%20cnvs%2EaddShape%28%27Circle%27%2Cnew%20Rect%28150%2C150%2C200%2C200%29%29%0Acircle%2EfillColor%20%3D%20Color%2ERGB%280%2C%201%2C%200%2C%200%2E5%29

Using RGB ColorSpace

cnvs = document.windows[0].selection.canvas

square = cnvs.addShape('Rectangle',new Rect(72,72,200,200))

square.fillColor = Color.RGB(0, 0, 1, 1)

circle = cnvs.addShape('Circle',new Rect(150,150,200,200))

circle.fillColor = Color.RGB(0, 1, 0, 0.5)

Here’s a script example that adds grayscale tint swatches, from black to white in increments of 10%, to the current canvas:

cnvs = document.windows[0].selection.canvas objSize = 48 offset = 0 swatches = new Array() for(i = 0; i < 11; i++){ offset = offset + objSize aRect = new Rect(offset, objSize, objSize, objSize) graphic = cnvs.addShape('Rectangle', aRect) color = Color.White(i*.1,1) graphic.fillColor = color swatches.push(graphic) } swatchStrip = new Group(swatches)

omnigraffle:///omnijs-run?script=cnvs%20%3D%20document%2Ewindows%5B0%5D%2Eselection%2Ecanvas%0AobjSize%20%3D%2048%0Aoffset%20%3D%200%0Aswatches%20%3D%20new%20Array%28%29%0Afor%28i%20%3D%200%3B%20i%20%3C%2011%3B%20i%2B%2B%29%7B%0A%09offset%20%3D%20offset%20%20%2B%20objSize%0A%09aRect%20%3D%20new%20Rect%28offset%2C%20objSize%2C%20objSize%2C%20objSize%29%0A%09graphic%20%3D%20cnvs%2EaddShape%28%27Rectangle%27%2C%20aRect%29%0A%09color%20%3D%20Color%2EWhite%28i*%2E1%2C1%29%0A%09graphic%2EfillColor%20%3D%20color%0A%09swatches%2Epush%28graphic%29%0A%7D%0AswatchStrip%20%3D%20new%20Group%28swatches%29

Grayscale Bar - 10% Increments

cnvs = document.windows[0].selection.canvas

objSize = 48

offset = 0

swatches = new Array()

for(i = 0; i < 11; i++){

offset = offset + objSize

aRect = new Rect(offset, objSize, objSize, objSize)

graphic = cnvs.addShape('Rectangle', aRect)

color = Color.White(i*.1,1)

graphic.fillColor = color

swatches.push(graphic)

}

swatchStrip = new Group(swatches)

Color Class Properties

Some common colors can be represented with the following property values instead of using one of the Color methods.

Color Property

graphic.fillColor = Color.blue

black (Color) • A color in the White colorspace with white component of 0.0.
blue (Color) • A color in the RGB colorspace with components (0, 0, 1, 1).
brown (Color) • A color in the RGB colorspace with components (0.6, 0.4, 0.2, 1).
clear (Color) • A color in the White colorspace with white component of 0.0 and alpha of 0.0 (“transparent black”).
cyan (Color) • A color in the RGB colorspace with components (0, 1, 1, 1).
darkGray (Color) • A color in the White colorspace with white component of 0.333.
gray (Color) • A color in the White colorspace with white component of 0.5.
green (Color) • A color in the RGB colorspace with components (0, 1, 0, 1).
lightGray (Color) • A color in the White colorspace with white component of 0.667.
magenta (Color) • A color in the RGB colorspace with components (1, 0, 1, 1).
orange (Color) • A color in the RGB colorspace with components (1, 0.5, 0, 1).
purple (Color) • A color in the RGB colorspace with components (1, 0, 1, 1).
red (Color) • A color in the RGB colorspace with components (1, 0, 0, 1).
white (Color) • A color in the White colorspace with white component of 1.0.
yellow (Color) • A color in the RGB colorspace with components (1, 1, 0, 1).

Color Instance Properties

Once a Color object has been created, you can use the following instance properties to gather information about the color object.

alpha (Number r/o) • Returns the alpha component of the color.
blue (Number r/o) • Returns the blue component of the color, after converting to a RGB colorspace.
brightness (Number r/o) • Returns the brightness component of the color, after converting to a HSB colorspace.
colorSpace (ColorSpace r/o) • Returns the colorspace of the instance.
green (Number r/o) • Returns the green component of the color, after converting to a RGB colorspace.
hue (Number r/o) • Returns the hue component of the color, after converting to a HSB colorspace.
red (Number r/o) • Returns the red component of the color, after converting to a RGB colorspace.
saturation (Number r/o) • Returns the saturation component of the color, after converting to a HSB colorspace.
white (Number r/o) • Returns the white component of the color, after converting to a White colorspace.

Color Instance Functions

Color objects can be blended to create new colors, using the blend() method:

blend(otherColor, fractionNumber) (Color or nil) • Returns a new color that is a linear combination of the receiver and fraction of the other color (so, a fraction of 1.0 would just return the otherColor. If the colors cannot be blended (for example, if they cannot be converted to the same colorspace), then null is returned.

cnvs = document.windows[0].selection.canvas graphic = cnvs.addShape('Circle',new Rect(0,0,200,200)) colorA = Color.red colorB = Color.yellow blendColor = colorA.blend(colorB,0.5) graphic.fillColor = blendColor

omnigraffle:///omnijs-run?script=cnvs%20%3D%20document%2Ewindows%5B0%5D%2Eselection%2Ecanvas%0Agraphic%20%3D%20cnvs%2EaddShape%28%27Circle%27%2Cnew%20Rect%280%2C0%2C200%2C200%29%29%0AcolorA%20%3D%20Color%2Ered%0AcolorB%20%3D%20Color%2Eyellow%0AblendColor%20%3D%20colorA%2Eblend%28colorB%2C0%2E5%29%0Agraphic%2EfillColor%20%3D%20blendColor

Here’s an example of blending colors: creating an orange circle by blending red and yellow

Blending Colors

cnvs = document.windows[0].selection.canvas

graphic = cnvs.addShape('Circle',new Rect(0,0,200,200))

colorA = Color.red

colorB = Color.yellow

blendColor = colorA.blend(colorB,0.5)

graphic.fillColor = blendColor

ColorSpace

Curabitur blandit tempus porttitor. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec ullamcorper nulla non metus auctor fringilla. Etiam porta sem malesuada magna mollis euismod. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.

CMYK (ColorSpace r/o) • A colorspace with cyan, magenta, yellow, black, and alpha components.
HSB (ColorSpace r/o) • A colorspace with hue, saturation, and value (or brightness) components.
Named (ColorSpace r/o) • A space for named colors, like system defined colors, or specific color palette spaces.
Pattern (ColorSpace r/o) • A colorspace that wraps a pattern image.
RGB (ColorSpace r/o) • The sRGB colorspace with red, green, blue, and alpha components.
White (ColorSpace r/o) • A colorspace with white and alpha components.

UNDER CONSTRUCTION

This webpage is in the process of being developed. Any content may change and may not be accurate or complete at this time.

DISCLAIMER

Mention of third-party websites and products is for informational purposes only and constitutes neither an endorsement nor a recommendation. OMNI-AUTOMATION.COM assumes no responsibility with regard to the selection, performance or use of information or products found at third-party websites. OMNI-AUTOMATION.COM provides this only as a convenience to our users. OMNI-AUTOMATION.COM has not tested the information found on these sites and makes no representations regarding its accuracy or reliability. There are risks inherent in the use of any information or products found on the Internet, and OMNI-AUTOMATION.COM assumes no responsibility in this regard. Please understand that a third-party site is independent from OMNI-AUTOMATION.COM and that OMNI-AUTOMATION.COM has no control over the content on that website. Please contact the vendor for additional information.