color-kitnext

@pbroom/color-kit/driverColor state

setColorActiveGamut

Switches the active display gamut without touching requested/displayed values. No-op when both gamut and source are unchanged.

functionimport { setColorActiveGamut } from '@pbroom/color-kit/driver';color-state.ts:475
function setColorActiveGamut(
  state: ColorState,
  gamut: GamutTarget,
  source: ColorSource,
): ColorState;

Parameters

stateColorState
gamutGamutTarget
sourceColorSource

Returns

ColorState

Throws

  • When gamut is not 'srgb' or 'display-p3' (for example the removed 'p3' spelling).

Example

TypeScript
import { parse } from '@pbroom/color-kit';
import { createColorState, setColorActiveGamut } from '@pbroom/color-kit/driver';

const state = createColorState(parse('#3b82f6'));
const next = setColorActiveGamut(state, 'srgb', 'user');
next.activeGamut; // → 'srgb'
next.requested === state.requested; // → true