Script function

world.RGBColourToName

Type

Method

Summary

Converts an RGB colour code to its equivalent name

Prototype

BSTR RGBColourToName(long Colour);

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

Available in MUSHclient version 3.22 onwards.

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).

See Also ...

Topics

Colour management
Default triggers/aliases/timers/macros/colours

Functions

(AdjustColour) Adjust an RGB colour
(ANSI) Generates an ANSI colour sequence
(BoldColour) Gets/sets the RGB colour for one of the 8 ANSI bold colours
(ColourNameToRGB) Converts a named colour to a RGB colour code.
(ColourNote) Sends a message to the output window in specified colours
(ColourTell) Sends a message to the output window in specified colours - not terminated by a newline
(CustomColourBackground) Sets the RGB value for the background of a custom colour
(CustomColourText) Sets the RGB value for the text of a custom colour
(Debug) Displays debugging information about the world
(GetCustomColourName) Gets the name of a custom colour
(GetMapColour) Returns the mapping for how a particular colour will be displayed
(MapColour) Changes the colour mapping - the way colours are displayed
(MapColourList) Returns an array of all the mapped colours
(NormalColour) Gets/sets the RGB colour for one of the 8 ANSI normal colours
(NoteColour) Chooses which custom colour will be used for world notes.
(NoteColourBack) Chooses which RGB colour will be used for world notes - background colour
(NoteColourFore) Chooses which RGB colour will be used for world notes - text colour
(NoteColourName) Chooses which RGB colour name will be used for world notes - text and background
(NoteColourRGB) Chooses which RGB colour will be used for world notes - text and background
(PickColour) Invokes the MUSHclient colour picker dialog
(SetCustomColourName) Sets the name of a custom colour

(Help topic: function=RGBColourToName)