Color

Creates an ApiColor from a universal input. The method recognizes several call signatures and either delegates to a narrower factory or constructs an ApiColor directly.

• Numeric components: "Api.Color(r, g, b)" or "Api.Color(r, g, b, a)" creates an RGB or RGBA color from byte components (0-255).
• Packed integer: "Api.Color(0xRRGGBB)" creates an RGB color from a 24-bit integer.
• Full HEX string: "Api.Color('#RRGGBB')" or "Api.Color('RRGGBB')" creates a HEX color; the leading "#" is optional.
• Short HEX string: "Api.Color('#RGB')" expands each digit by duplication, so "#F0A" becomes "#FF00AA".
• Theme color name: "Api.Color('accent1')" creates a theme color; any value of SchemeColorId is accepted.
• Preset color name: "Api.Color('aliceBlue')" resolves any value of PresetColor to its RGB equivalent.
• Auto color: "Api.Color('auto')" creates an auto color. For a single string argument, the resolution priority is: "auto", a string starting with "#", a theme name, a preset name, a bare 6-digit HEX. Theme and preset palettes do not overlap. A 3-digit shorthand is accepted only with the leading "#". Unsupported inputs (objects, arrays, an existing ApiColor, unknown strings, no arguments) return a black color (#000000).

Syntax

expression.Color(r, g, b, a);

expression - A variable that represents a Api class.

Parameters

Name	Required/Optional	Data type	Default	Description
r	Required	number | string | byte | SchemeColorId | PresetColor		The universal color input. With three or four arguments, the red component (0-255).
g	Optional	byte		The green component (0-255). Used only with the (r, g, b) and (r, g, b, a) forms.
b	Optional	byte		The blue component (0-255). Used only with the (r, g, b) and (r, g, b, a) forms.
a	Optional	byte		The alpha component (0-255). Used only with the (r, g, b, a) form.

Returns

ApiColor

Example

Apply Api.Color with every supported input format to fill separate shapes on a slide.

// How do I create colors from byte components, packed integers, HEX strings, theme names, and color names in a presentation?

// Render separate shapes filled with each color produced by Api.Color on the first slide of the presentation.

const presentation = Api.GetPresentation();
const slide = presentation.GetSlideByIndex(0);
slide.RemoveAllObjects();

const colors = [
    Api.Color(220, 50, 50),
    Api.Color(50, 200, 50, 180),
    Api.Color(0x0066CC),
    Api.Color('#FF6600'),
    Api.Color('#F0A'),
    Api.Color('accent1'),
    Api.Color('blue'),
];
const stroke = Api.CreateStroke(0, Api.CreateNoFill());
for (let idx = 0; idx < colors.length; idx++) {
    const fill = Api.CreateSolidFill(colors[idx]);
    const shape = Api.CreateShape("rect", 70 * 36000, 35 * 36000, fill, stroke);
    shape.SetPosition(608400, (1 + idx) * 36000 * 12);
    slide.AddObject(shape);
}