world.RGBColourToName

MUSHclient script function (Method) — introduced in version 3.22

Converts an RGB colour code to its equivalent name

Prototype

BSTR RGBColourToName(long Colour);

Data type meanings

Description

Converts an RGB colour code (eg. 255) to its HTML name (eg. "red").

If the name is not in the list of names recognised by MUSHclient, the colour is represented as a hex HTML colour (eg. "#010203").

The list of colour names recognised can be found by using MUSHclient's "colour picker" (Ctrl+Alt+P), or by using the function:

world.Debug "colours"

Converts an RGB colour code (eg. 255) to its HTML name (eg. "red").

If the name is not in the list of names recognised by MUSHclient, the colour is represented as a hex HTML colour (eg. "#010203").

The list of colour names recognised can be found by using MUSHclient's "colour picker" (Ctrl+Alt+P), or by using the function:

world.Debug "colours"

Note that the RGB colour code is internally in the form BBGGRR. In other words:

print (string.format ("%06X", ColourNameToRGB ("red"))) --> 0000FF

The value for red is in the low-order byte, green is in the middle byte, and blue is in the high-order byte. This is the opposite to the order used in HTML colour codes, where the order is: #RRGGBB

VBscript example

world.note world.RGBColourToName (255)

Jscript example

world.note (world.RGBColourToName (255));

PerlScript example

$world->note ($world->RGBColourToName (255));

Python example

world.note (world.RGBColourToName (255))

Lua example

Note (RGBColourToName (255))

Return value

The colour name (eg. "red", "blue"), or an RGB code (eg. "#FFE4E1).

Related topic

Colour management

See also