world.PickColour
Invokes the MUSHclient colour picker dialog
Prototype
long PickColour(long Suggested);
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
See also
| Function | Description |
|---|---|
| BoldColour | Gets/sets the RGB colour for one of the 8 ANSI bold colours |
| ColourNameToRGB | Converts a named colour to a RGB colour code. |
| 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 |
| MapColour | Changes the colour mapping - the way colours are displayed |
| NormalColour | Gets/sets the RGB colour for one of the 8 ANSI normal colours |
| 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 |
| RGBColourToName | Converts an RGB colour code to its equivalent name |