Skip to content

Free open-source image editor for the browser

1.7 KB
Raw Blame
import type { Target } from "vgpu";

export type WhiteBalance = { temperature: number; tint: number };
export type RawDevelopment = {
  asShot: WhiteBalance;
  createPass(): {
    prepare(balance: WhiteBalance): Promise<void>;
    render(): Target;
    dispose(): void;
  };
  dispose(): void;
};

/**
 * The primaries an image's texels are in: the working space's, or the sRGB or Display P3 ones an
 * 8-bit source keeps, encoded in a texture format that decodes to linear when read.
 */
export type Primaries = "rec2020" | "srgb" | "display-p3";

/** The primaries as the shaders number them. */
export const primariesIndex: Record<Primaries, number> = {
  rec2020: 0,
  srgb: 1,
  "display-p3": 2,
};

/** A texture with the primaries its texels are in, which whoever reads it converts. */
export type EncodedImage = { image: Target; primaries: Primaries };

type SourceOptions = {
  raw?: RawDevelopment;
  /** The working space's unless said. */
  primaries?: Primaries;
};

/** Document content retained while a preview or export still uses it. */
export function createImageSource(
  image: Target,
  { raw, primaries = "rec2020" }: SourceOptions = {},
) {
  let references = 1;
  function release() {
    let active = true;
    return () => {
      if (!active) {
        return;
      }
      active = false;
      if (--references === 0) {
        image.color.dispose();
        raw?.dispose();
      }
    };
  }
  return {
    image,
    raw,
    primaries,
    retain() {
      if (!references) {
        throw Error("Image source is closed.");
      }
      references++;
      return release();
    },
    dispose: release(),
  };
}

export type ImageSource = ReturnType<typeof createImageSource>;