pixel-data-js 0.5.0 → 0.5.2

package/dist/index.prod.d.ts

@@ -578,6 +578,41 @@ declare function writeImageDataPixels(imageData: ImageData, data: Uint8ClampedAr
  */
 declare function writeImageDataPixels(imageData: ImageData, data: Uint8ClampedArray, x: number, y: number, w: number, h: number): void;
 
+/**
+ * Compressed data format for image processing optimization.
+ * Representing an image as a grid of palette indices rather than raw RGBA values
+ * significantly reduces memory overhead and optimizes pattern matching logic.
+ */
+type IndexedImage = {
+    /** The width of the image in pixels. */
+    width: number;
+    /** The height of the image in pixels. */
+    height: number;
+    /**
+     *  A flat array of indices where each value points to a color in the palette.
+     * Accessible via the formula: `index = x + (y * width)`.
+     */
+    data: Int32Array;
+    /**
+     * A flattened Uint8Array of RGBA values.
+     * Every 4 bytes represent one color: `[r, g, b, a]`.
+     */
+    palette: Uint8Array;
+    /**
+     * The specific index in the palette that represents a fully transparent pixel.
+     * All pixels with an alpha value of 0 are normalized to this index.
+     */
+    transparentPalletIndex: number;
+};
+/**
+ * Converts standard ImageData into an IndexedImage format.
+ * This process normalizes all transparent pixels into a single palette entry
+ * and maps all unique RGBA colors to sequential integer IDs.
+ * @param imageData - The raw ImageData from a canvas or image source.
+ * @returns An IndexedImage object containing the index grid and color palette.
+ */
+declare function makeIndexedImage(imageData: ImageData): IndexedImage;
+
 /**
  * A convenience wrapper that extracts the first {@link File} from an
  * {@link HTMLInputElement} change event and converts it into {@link ImageData}.
@@ -784,4 +819,4 @@ declare function pixelDataToAlphaMask(pixelData: PixelData): AlphaMask;
  */
 declare function trimRectBounds<T extends Rect | SelectionRect>(target: T, bounds: Rect): void;
 
-export { type AlphaMask, type AnyMask, type ApplyMaskOptions, type Base64EncodedUInt8Array, type BinaryMask, type BlendColor32, BlendMode, type BlendModeIndex, COLOR_32_BLEND_MODES, COLOR_32_BLEND_TO_INDEX, type Color32, type ColorBlendOptions, type FloodFillImageDataOptions, type FloodFillResult, INDEX_TO_COLOR_32_BLEND, type ImageDataLike, MaskType, type PixelBlendOptions, type PixelCanvas, PixelData, type PixelOptions, type RGBA, type Rect, type RegisteredBlender, type ReusableCanvas, type SelectionRect, type SerializedImageData, UnsupportedFormatError, applyMaskToPixelData, base64DecodeArrayBuffer, base64EncodeArrayBuffer, blendColorPixelData, blendPixelData, clearPixelData, color32ToCssRGBA, color32ToHex, colorBurnColor32, colorDistance, colorDodgeColor32, copyImageData, copyImageDataLike, copyMask, darkenColor32, darkerColor32, deserializeImageData, deserializeNullableImageData, deserializeRawImageData, differenceColor32, divideColor32, exclusionColor32, extractImageDataPixels, extractMask, fileInputChangeToImageData, fileToImageData, fillPixelData, floodFillSelection, getImageDataFromClipboard, getSupportedPixelFormats, hardLightColor32, hardMixColor32, imageDataToAlphaMask, imageDataToDataUrl, imageDataToImgBlob, imgBlobToImageData, invertAlphaMask, invertBinaryMask, invertImageData, invertPixelData, lerpColor32, lerpColor32Fast, lightenColor32, lighterColor32, linearBurnColor32, linearDodgeColor32, linearLightColor32, makePixelCanvas, makeReusableCanvas, mergeMasks, multiplyColor32, overlayColor32, overwriteColor32, packColor, packRGBA, pinLightColor32, pixelDataToAlphaMask, resizeImageData, screenColor32, serializeImageData, serializeNullableImageData, softLightColor32, sourceOverColor32, subtractColor32, trimRectBounds, unpackAlpha, unpackBlue, unpackColor, unpackColorTo, unpackGreen, unpackRed, vividLightColor32, writeImageDataPixels, writeImageDataToClipboard, writeImgBlobToClipboard };
+export { type AlphaMask, type AnyMask, type ApplyMaskOptions, type Base64EncodedUInt8Array, type BinaryMask, type BlendColor32, BlendMode, type BlendModeIndex, COLOR_32_BLEND_MODES, COLOR_32_BLEND_TO_INDEX, type Color32, type ColorBlendOptions, type FloodFillImageDataOptions, type FloodFillResult, INDEX_TO_COLOR_32_BLEND, type ImageDataLike, type IndexedImage, MaskType, type PixelBlendOptions, type PixelCanvas, PixelData, type PixelOptions, type RGBA, type Rect, type RegisteredBlender, type ReusableCanvas, type SelectionRect, type SerializedImageData, UnsupportedFormatError, applyMaskToPixelData, base64DecodeArrayBuffer, base64EncodeArrayBuffer, blendColorPixelData, blendPixelData, clearPixelData, color32ToCssRGBA, color32ToHex, colorBurnColor32, colorDistance, colorDodgeColor32, copyImageData, copyImageDataLike, copyMask, darkenColor32, darkerColor32, deserializeImageData, deserializeNullableImageData, deserializeRawImageData, differenceColor32, divideColor32, exclusionColor32, extractImageDataPixels, extractMask, fileInputChangeToImageData, fileToImageData, fillPixelData, floodFillSelection, getImageDataFromClipboard, getSupportedPixelFormats, hardLightColor32, hardMixColor32, imageDataToAlphaMask, imageDataToDataUrl, imageDataToImgBlob, imgBlobToImageData, invertAlphaMask, invertBinaryMask, invertImageData, invertPixelData, lerpColor32, lerpColor32Fast, lightenColor32, lighterColor32, linearBurnColor32, linearDodgeColor32, linearLightColor32, makeIndexedImage, makePixelCanvas, makeReusableCanvas, mergeMasks, multiplyColor32, overlayColor32, overwriteColor32, packColor, packRGBA, pinLightColor32, pixelDataToAlphaMask, resizeImageData, screenColor32, serializeImageData, serializeNullableImageData, softLightColor32, sourceOverColor32, subtractColor32, trimRectBounds, unpackAlpha, unpackBlue, unpackColor, unpackColorTo, unpackGreen, unpackRed, vividLightColor32, writeImageDataPixels, writeImageDataToClipboard, writeImgBlobToClipboard };

package/dist/index.prod.js

@@ -1075,6 +1075,53 @@ function writeImageDataPixels(imageData, data, _x, _y, _w, _h) {
   }
 }
 
+// src/IndexedImage/IndexedImage.ts
+function makeIndexedImage(imageData) {
+  const width = imageData.width;
+  const height = imageData.height;
+  const rawData = imageData.data;
+  const indexedData = new Int32Array(rawData.length / 4);
+  const colorMap = /* @__PURE__ */ new Map();
+  const tempPalette = [];
+  const transparentKey = "0,0,0,0";
+  const transparentPalletIndex = 0;
+  colorMap.set(transparentKey, transparentPalletIndex);
+  tempPalette.push(0);
+  tempPalette.push(0);
+  tempPalette.push(0);
+  tempPalette.push(0);
+  for (let i = 0; i < indexedData.length; i++) {
+    const r = rawData[i * 4];
+    const g = rawData[i * 4 + 1];
+    const b = rawData[i * 4 + 2];
+    const a = rawData[i * 4 + 3];
+    let key;
+    if (a === 0) {
+      key = transparentKey;
+    } else {
+      key = `${r},${g},${b},${a}`;
+    }
+    let id = colorMap.get(key);
+    if (id === void 0) {
+      id = colorMap.size;
+      tempPalette.push(r);
+      tempPalette.push(g);
+      tempPalette.push(b);
+      tempPalette.push(a);
+      colorMap.set(key, id);
+    }
+    indexedData[i] = id;
+  }
+  const palette = new Uint8Array(tempPalette);
+  return {
+    width,
+    height,
+    data: indexedData,
+    transparentPalletIndex,
+    palette
+  };
+}
+
 // src/Input/fileInputChangeToImageData.ts
 async function fileInputChangeToImageData(event) {
   const target = event.target;
@@ -1708,6 +1755,7 @@ export {
   linearBurnColor32,
   linearDodgeColor32,
   linearLightColor32,
+  makeIndexedImage,
   makePixelCanvas,
   makeReusableCanvas,
   mergeMasks,