world.PickColour

MUSHclient script function (Method) — introduced in version 3.22

Invokes the MUSHclient colour picker dialog

Prototype

long PickColour(long Suggested);

Data type meanings

Description

This lets you call the MUSHclient colour picker from within a script. Note that doing this will pause script execution while the dialog is active, and is not recommended for scripts that should run to completion quickly.

eg.

newcolour = PickColour (254)

You supply an existing colour as the starting point, or -1 if none is required, and the function returns the chosen colour, or -1 if the dialog was cancelled. Note that -1 is not a valid colour.

VBscript example

newcolour = PickColour (255)

Jscript example

newcolour = PickColour (255);

PerlScript example

newcolour  = $world->PickColour (255)

Python example

newcolour = world.PickColour (255);

Lua example

newcolour = PickColour (255)

Return value

The chosen colour, or -1 if the dialog box was dismissed.

Related topic

Colour management

See also

FunctionDescription
BoldColourGets/sets the RGB colour for one of the 8 ANSI bold colours
ColourNameToRGBConverts a named colour to a RGB colour code.
CustomColourBackgroundSets the RGB value for the background of a custom colour
CustomColourTextSets the RGB value for the text of a custom colour
DebugDisplays debugging information about the world
MapColourChanges the colour mapping - the way colours are displayed
NormalColourGets/sets the RGB colour for one of the 8 ANSI normal colours
NoteColourBackChooses which RGB colour will be used for world notes - background colour
NoteColourForeChooses which RGB colour will be used for world notes - text colour
NoteColourNameChooses which RGB colour name will be used for world notes - text and background
NoteColourRGBChooses which RGB colour will be used for world notes - text and background
RGBColourToNameConverts an RGB colour code to its equivalent name