Method

CMY


Warning

This item was deprecated in version 2019r2. Please use Color.CMY as a replacement.

Description

Returns a Color based on the CMY (cyan, magenta, yellow) color model and the specified level of transparency. Use the new form of the Picture constructor to create pictures that support the alpha channel or convert existing pictures to the new format using the code described in HasAlphaChannel.

Usage

result = CMY(cyan, magenta, yellow [, alpha = 0])

Part

Type

Description

result

Color

An object that represents the color based on the cyan, magenta, and yellow values.

cyan

Double

The value of Cyan in the color (0-1).

magenta

Double

The value of Magenta in the color (0-1).

yellow

Double

The value of Yellow in the color (0-1).

alpha

Integer

The value of transparency in the color (0-255). Zero is completely opaque and 255 is transparent. If omitted, the default is 0 (no transparency).

Notes

The CMY function returns a Color based on the amounts of Cyan, Magenta, Yellow, and transparency passed. The color amounts are represented by doubles between 0 and 1 and are stored internally as three bytes. The level of transparency is an optional Integer from 0-255. If omitted, it defaults to completely opaque. You can also use either the Color.RGB or Color.HSV models to assign a color and you can also specify a color with the RGB model using the &c literal. All alternatives support the optional transparency parameter.

Sample code

This code uses the CMY function to assign a Color. It is in the Paint event of a Canvas or a Window.

Rectangle1.FillColor = CMY(0.35, 0.9, 0.6)

The following code draws a color patch in a Canvas with 75% transparency. With the CMY function, the range is from 0 to 255. Zero is completely opaque and 255 is completely transparent. The code is in the Paint event.

g.ForeColor = CMY(0.0, 1.0, 1.0, 255 * 0.75) ' transparency = 75%

g.FillRect(0, 70, 200, 50)
g.ForeColor = CMY(0.0, 0.0, 0.0)
g.DrawString("Translucent = 30%", 210, 80)

Compatibility

All project types on all supported operating systems.

See also

Color data type; Color.HSV, Color.RGB, Color.SelectedFromDialog functions; &c literal.