Class Color

constructor

• new Color(r?, g?, b?, a?): Color

• Create a new Color object.

  Parameters

  • Optionalr: number | number[] = 0

    The value of the red component (0-1). Defaults to 0. If r is an array of length 3 or 4, the array will be used to populate all components.
  • Optionalg: number = 0

    The value of the green component (0-1). Defaults to 0.
  • Optionalb: number = 0

    The value of the blue component (0-1). Defaults to 0.
  • Optionala: number = 1

    The value of the alpha component (0-1). Defaults to 1.

  Returns Color

a

b

g

r

Static ReadonlyBLACK

Static ReadonlyBLUE

Static ReadonlyCYAN

Static ReadonlyGRAY

Static ReadonlyGREEN

Static ReadonlyMAGENTA

Static ReadonlyRED

Static ReadonlyWHITE

Static ReadonlyYELLOW

clone

• clone(): Color

• Returns a clone of the specified color.

  Returns Color

  A duplicate color object.

copy

• copy(rhs): Color

• Copies the contents of a source color to a destination color.

  Parameters

  • rhs: Color

    A color to copy to the specified color.

  Returns Color

  Self for chaining.

  Example

  const src = new pc.Color(1, 0, 0, 1);
  const dst = new pc.Color();
  
  dst.copy(src);
  
  console.log("The two colors are " + (dst.equals(src) ? "equal" : "different"));
  Copy

equals

• equals(rhs): boolean

• Reports whether two colors are equal.

  Parameters

  • rhs: Color

    The color to compare to the specified color.

  Returns boolean

  True if the colors are equal and false otherwise.

  Example

  const a = new pc.Color(1, 0, 0, 1);
  const b = new pc.Color(1, 1, 0, 1);
  console.log("The two colors are " + (a.equals(b) ? "equal" : "different"));
  Copy

fromString

• fromString(hex): Color

• Set the values of the color from a string representation '#11223344' or '#112233'.

  Parameters

  • hex: string

    A string representation in the format '#RRGGBBAA' or '#RRGGBB'. Where RR, GG, BB, AA are red, green, blue and alpha values. This is the same format used in HTML/CSS.

  Returns Color

  Self for chaining.

lerp

• lerp(lhs, rhs, alpha): Color

• Returns the result of a linear interpolation between two specified colors.

  Parameters

  • lhs: Color

    The color to interpolate from.
  • rhs: Color

    The color to interpolate to.
  • alpha: number

    The value controlling the point of interpolation. Between 0 and 1, the linear interpolant will occur on a straight line between lhs and rhs. Outside of this range, the linear interpolant will occur on a ray extrapolated from this line.

  Returns Color

  Self for chaining.

  Example

  const a = new pc.Color(0, 0, 0);
  const b = new pc.Color(1, 1, 0.5);
  const r = new pc.Color();
  
  r.lerp(a, b, 0);   // r is equal to a
  r.lerp(a, b, 0.5); // r is 0.5, 0.5, 0.25
  r.lerp(a, b, 1);   // r is equal to b
  Copy

set

• set(r, g, b, a?): Color

• Assign values to the color components, including alpha.

  Parameters

  • r: number

    The value for red (0-1).
  • g: number

    The value for blue (0-1).
  • b: number

    The value for green (0-1).
  • Optionala: number = 1

    The value for the alpha (0-1), defaults to 1.

  Returns Color

  Self for chaining.

toString

• toString(alpha): string

• Converts the color to string form. The format is '#RRGGBBAA', where RR, GG, BB, AA are the red, green, blue and alpha values. When the alpha value is not included (the default), this is the same format as used in HTML/CSS.

  Parameters

  • alpha: boolean

    If true, the output string will include the alpha value.

  Returns string

  The color in string form.

  Example

  const c = new pc.Color(1, 1, 1);
  // Outputs #ffffffff
  console.log(c.toString());
  Copy