Lingo Dictionary > A-C > color() |  |

color()

Syntax

    color(#rgb, redValue, greenValue, blueValue)
    color(#paletteIndex, paletteIndexNumber)
    rgb(rgbHexString)
    rgb(redValue, greenValue, blueValue)
    paletteIndex(paletteIndexNumber)

Description

Function and data type; determines an object's color as either RGB or 8-bit palette index values. These are the same values as those used in the`color` member and `color` sprite properties, the `bgColor` member and `bgColor` sprite properties, and the `bgColor` Stage property.

The `color` function allows for either 24-bit or 8-bit color values to be manipulated as well as applied to cast members, sprites, and the Stage.

For RGB values, each color component has a range from 0 to 255, and all other values are truncated. For `paletteIndex` types, an integer from 0 to 255 is used to indicate the index number in the current palette, and all other values are truncated.

Example

This statement performs a math operation:

    palColorObj = paletteIndex(20)
    put palColorObj
    -- paletteIndex(20)
    put palColorObj / 2
    -- paletteIndex(10)

Example

This statement converts one color type to another type:

    newColorObj = color(#rgb, 155, 0, 75)
    put newColorObj
    -- rgb(155, 0, 75)
    newColorObj.colorType = #paletteIndex
    put newColorObj
    -- paletteIndex(106)

Example

This statement obtains the hexadecimal representation of a color regardless of its type:

    someColorObj = color(#paletteIndex, 32)
    put someColorObj.hexString()
    -- "#FF0099"

Example

This statement determines individual RGB components and the `paletteIndex` value of a color regardless of its type:

    newColorObj = color(#rgb, 155, 0, 75)
    put newColorObj.green
    -- 0
    put newColorObj.paletteIndex
    -- 106
    newColorObj.green = 100
    put newColorObj.paletteIndex
    -- 94
    put newColorObj
    -- rgb(155, 100, 75)
    newColorObj.paletteIndex = 45
    put newColorObj
    -- paletteIndex(45)

Example

This statement changes the color of the fourth through the seventh characters of text member myQuotes:

    member("myQuotes").char[4..7].color = rgb(200, 150, 75)

Example

This Lingo displays the color of sprite 6 in the Message window, and then sets the color of sprite 6 to a new RGB value:

    "put sprite(6).color
    -- rgb( 255, 204, 102 )
    sprite(6).color = rgb(122, 98, 210)"

Note: Setting the `paletteIndex` value of an RGB color type changes `colorType` to `paletteIndex`. Setting the RGB color type of a `paletteIndex` color sets its `colorType` value to RGB.

See also

`color()`, `bgColor`