Skip to content
TypeScript
2.0 KB
Raw Blame
import type { Img } from "./image.ts";

/**
 * One painting step. Either `full` (first frame or size change) or `changes` as a flat
 * [index, color, index, color, ...] list against the previous frame.
 */
export interface Frame {
  label: string;
  loc?: string;
  w: number;
  h: number;
  full?: Uint32Array;
  changes?: Uint32Array;
}

/** Records the composite image after every painting step of one asset build. */
export class Trace {
  frames: Frame[] = [];
  /** Steps that happened after `max` was reached (folded into the last frame). */
  dropped = 0;
  private prev?: Img;
  private max: number;

  constructor(max = 4000) {
    this.max = max;
  }

  record(label: string, loc: string | undefined, img: Img): void {
    if (this.frames.length >= this.max - 1) {
      this.dropped++;
      this.pending = img;
      return;
    }
    this.push(label, loc, img);
  }

  private pending?: Img;

  /** Make sure the last frame shows the final image. */
  finish(img: Img): void {
    if (this.pending || this.dropped) this.push(`… ${this.dropped} more steps`, undefined, this.pending ?? img);
    this.pending = undefined;
    const last = this.prev;
    if (!last || last.w !== img.w || last.h !== img.h || !sameData(last.data, img.data)) this.push("final", undefined, img);
  }

  private push(label: string, loc: string | undefined, img: Img): void {
    const prev = this.prev;
    if (!prev || prev.w !== img.w || prev.h !== img.h) {
      this.frames.push({ label, loc, w: img.w, h: img.h, full: img.data.slice() });
    } else {
      const ch: number[] = [];
      const a = prev.data, b = img.data;
      for (let i = 0; i < b.length; i++) if (a[i] !== b[i]) ch.push(i, b[i]);
      this.frames.push({ label, loc, w: img.w, h: img.h, changes: Uint32Array.from(ch) });
    }
    this.prev = img.copy();
  }
}

function sameData(a: Uint32Array, b: Uint32Array): boolean {
  if (a.length !== b.length) return false;
  for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
  return true;
}