Skip to main content

colorMap

Type

property

Summary

Lists the colors in the current color table.

Syntax

set the colorMap to <colorsList>

Description

Use the colorMap property to specify what colors LiveCode uses to draw its windows when the bit depth of the screen is 8 bits or less.

If the bit depth is greater than 8 bits, the colorMap property always reports "fixed".

The number of lines in the colorMap property is set when the application starts up, and does not change if you change color depths while running the application.

If you leave a line blank when setting the colorMap, the color corresponding to that line is left unchanged.

Cross-platform note

On Windows systems, colors 1-10 and 246-256 cannot be changed.

On Unix systems, setting the colorMap property sets the privateColors property to true.

Examples

set the colorMap to myMap
if the colorMap is fixed then usePhotoIcons

Value

NameTypeDescription

value

The colorMap is a list of color references, one per line. A color reference is any standard color name; or three comma-separated integers between zero and 255, specifying the level of each of red, green, and blue; or an HTML-style color consisting of a hash mark (#) followed by three hexadecimal numbers, one for each of red, green, and blue.

The colorMap property contains the number of lines returned by the screenColors function.

control structure: function

function: screenColors

glossary: property, application, return, color reference, Windows, bit, color table, bit depth

keyword: line

property: colorWorld, borderPixel, dontDither, privateColors, remapColor

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

Platforms

desktop

server

Thank you for your feedback!

Was this page helpful?