ScriptableColor

Scriptable wrapper for Color to expose RGB color functionality to scripts.

This class provides comprehensive color manipulation features for scripts. In scripts, this type is exposed as Color (without the Scriptable prefix) and provides the same functionality as ceramic.Color.

Colors are represented as integers in RGB format (0xRRGGBB). You can use hex values directly or create colors using various color space methods.

Usage in Scripts #

// Use predefined colors
var red = Color.RED;
var blue = Color.BLUE;

// Create from hex value
var purple = 0x9400D3;

// Create from RGB values
var orange = Color.fromRGB(255, 165, 0);

// Create from HSB (hue, saturation, brightness)
var cyan = Color.fromHSB(180, 1.0, 1.0);

// Interpolate between colors
var blend = Color.interpolate(red, blue, 0.5);

// Modify colors
var darkRed = Color.getDarkened(red, 0.3);
var lightBlue = Color.getLightened(blue, 0.3);

Color Spaces #

• RGB: Red, Green, Blue (0-255 per channel)
• HSB/HSV: Hue (0-360°), Saturation (0-1), Brightness/Value (0-1)
• HSL: Hue (0-360°), Saturation (0-1), Lightness (0-1)
• CMYK: Cyan, Magenta, Yellow, Key/Black (0-1 per channel)
• HSLuv: Perceptually uniform color space (if enabled)

Note that colors are stored internally as RGB, so repeated conversions between color spaces may result in precision loss.

Static Members #

Generate a random color (away from white or black)

Create a color from the least significant four bytes of an Int

Generate a color from integer RGB values (0 to 255)

Generate a color from float RGB values (0 to 1)

Generate a color from CMYK values (0 to 1)

Generate a color from HSB (aka HSV) components.

Generate a color from HSL components.

Parses a String and returns a Color or null if the String couldn't be parsed.

Examples (input -> output in hex):

• 0x00FF00 -> 0x00FF00
• #0000FF -> 0x0000FF
• GRAY -> 0x808080
• blue -> 0x0000FF

Get HSB color wheel values in an array which will be 360 elements in size

Get an interpolated color based on two different colors.

Create a gradient from one color to another

Multiply the RGB channels of two Colors

Add the RGB channels of two Colors

Subtract the RGB channels of one Color from another

Return a String representation of the color in the format

Return a String representation of the color in the format #RRGGBB

Get a string of color information about this color

Get a darkened version of this color

Get a lightened version of this color

Get the inversion of this color

Get the hue of the color in degrees (from 0 to 359)

Get the saturation of the color (from 0 to 1)

Get the brightness (aka value) of the color (from 0 to 1)

Get the lightness of the color (from 0 to 1)

Generate a color from HSLuv components.

Get HSLuv components from the color instance.