ChooseColor(string object, table suggestedColors, selected)

Ask the user to choose one color in a menu.

If available, the list starts by a list of favorites colors, saved by previous choices for the same object (e.g. "Staff background").
Then, a list of suggested colors (e.g. found in score).
Then, the ability to pick a new color from the Color Picker, and save it to favorites for faster use next times.

Returns

string: Choosen color, in RRGGBB format, or nil if user canceled the choice.

string: Choosen color, in #RRGGBB format, or nil if user canceled the choice.

int: Color index, or nearest in 256 colors palette, or nil if user canceled the choice.

color_brightness(int red, int green, int blue, int opacity)

Get the brightness of a color A brightness between 0 and 127 is considered as dark, a brightness between 127 and 255 is considered as bright.

Without opacity, the formula is brightness = 0.2126*red + 0.7152*green + 0.0722*blue

Return

int: brightness value, between 0 and 255

CropSurface(Surface surface, int red, int green, int blue, int opacity, string operand, boolean left, boolean top, boolean right, boolean bottom)

Crop a Surface for a given color.

For example, CropSurface(mySurface, 255, 255, 255, 255) crops surface to remove white areas on 4 sides of a drawn image/text/staff.

Return

boolean: true if crop was needed and succeed, return by Surface.Crop(...) MyrScript function.