pixel-data-js 0.13.0 → 0.14.0

package/dist/index.prod.d.ts

@@ -205,11 +205,15 @@ declare function color32ToHex(color: Color32): string;
 declare function color32ToCssRGBA(color: Color32): string;
 
 declare class PixelData {
-    readonly imageData: ImageDataLike;
     data32: Uint32Array;
-    width: number;
-    height: number;
-    constructor(imageData: ImageDataLike);
+    imageData: ImageData;
+    get width(): number;
+    get height(): number;
+    constructor(imageData: ImageData);
+    set(imageData: ImageData): void;
+    /**
+     * Creates a deep copy of the PixelData using the environment's ImageData constructor.
+     */
     copy(): PixelData;
 }
 
@@ -567,6 +571,11 @@ declare namespace imageDataToDataUrl {
  */
 declare function imageDataToImgBlob(imageData: ImageData): Promise<Blob>;
 
+/**
+ * converts {@link ImageData} to a faster Uint32Array
+ */
+declare function imageDataToUInt32Array(imageData: ImageDataLike): Uint32Array;
+
 /**
  * Decodes a {@link Blob} (typically PNG) back into an {@link ImageData} object.
  *
@@ -605,7 +614,7 @@ declare function resampleImageData(source: ImageData, factor: number): ImageData
  * instead, it crops or pads the image based on the new dimensions and
  * provides an offset for repositioning.
  *
- * @param current The source {@link ImageData} to resize.
+ * @param current The source {@link ImageDataLike} to resize.
  * @param newWidth The target width in pixels.
  * @param newHeight The target height in pixels.
  * @param offsetX The horizontal offset for placing the
@@ -629,7 +638,7 @@ declare function resampleImageData(source: ImageData, factor: number): ImageData
  * );
  * ```
  */
-declare function resizeImageData(current: ImageData, newWidth: number, newHeight: number, offsetX?: number, offsetY?: number): ImageData;
+declare function resizeImageData(current: ImageDataLike, newWidth: number, newHeight: number, offsetX?: number, offsetY?: number): ImageData;
 
 declare function base64EncodeArrayBuffer(buffer: ArrayBufferLike): Base64EncodedUInt8Array;
 declare function base64DecodeArrayBuffer(encoded: Base64EncodedUInt8Array): Uint8ClampedArray<ArrayBuffer>;
@@ -969,7 +978,7 @@ declare function resamplePixelData(pixelData: PixelData, factor: number): PixelD
 /**
  * Rotates pixel data 90 degrees clockwise.
  * If the image is square, it performs the rotation in-place.
- * If rectangular, it returns a new Uint32Array and updates dimensions.
+ * If rectangular, it replaces the internal ImageData with a new rotated version.
  */
 declare function rotatePixelData(pixelData: PixelData): void;
 
@@ -989,4 +998,4 @@ declare function rotatePixelData(pixelData: PixelData): void;
  */
 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, type BlendToIndexGetter, type Color32, type ColorBlendOptions, FAST_BLENDER_REGISTRY, FAST_BLEND_MODES, FAST_BLEND_MODE_BY_NAME, FAST_BLEND_TO_INDEX, type FastBlendModes, type FloodFillImageDataOptions, type FloodFillResult, INDEX_TO_FAST_BLEND, INDEX_TO_PERFECT_BLEND, type ImageDataLike, type IndexToBlendGetter, IndexedImage, MaskType, PERFECT_BLENDER_REGISTRY, PERFECT_BLEND_MODES, PERFECT_BLEND_MODE_BY_NAME, PERFECT_BLEND_TO_INDEX, type PerfectBlendModes, type PixelBlendOptions, type PixelCanvas, PixelData, type PixelOptions, type Point, type RGBA, type Rect, type RegisteredFastBlender, type RegisteredPerfectBlender, type ReusableCanvas, type ReusableImageData, type SelectionRect, type SerializedImageData, UnsupportedFormatError, applyMaskToPixelData, base64DecodeArrayBuffer, base64EncodeArrayBuffer, blendColorPixelData, blendPixelData, clearPixelData, color32ToCssRGBA, color32ToHex, colorBurnFast, colorBurnPerfect, colorDistance, colorDodgeFast, colorDodgePerfect, copyImageData, copyImageDataLike, copyMask, darkenFast, darkenPerfect, darkerFast, darkerPerfect, deserializeImageData, deserializeNullableImageData, deserializeRawImageData, differenceFast, differencePerfect, divideFast, dividePerfect, exclusionFast, exclusionPerfect, extractImageDataPixels, extractMask, fileInputChangeToImageData, fileToImageData, fillPixelData, floodFillSelection, getImageDataFromClipboard, getIndexedImageColorCounts, getSupportedPixelFormats, hardLightFast, hardLightPerfect, hardMixFast, hardMixPerfect, imageDataToAlphaMask, imageDataToDataUrl, imageDataToImgBlob, imgBlobToImageData, indexedImageToAverageColor, indexedImageToImageData, invertAlphaMask, invertBinaryMask, invertImageData, invertPixelData, lerpColor32, lerpColor32Fast, lightenFast, lightenPerfect, lighterFast, lighterPerfect, linearBurnFast, linearBurnPerfect, linearDodgeFast, linearDodgePerfect, linearLightFast, linearLightPerfect, makePixelCanvas, makeReusableCanvas, makeReusableImageData, mergeMasks, multiplyFast, multiplyPerfect, overlayFast, overlayPerfect, overwriteFast, overwritePerfect, packColor, packRGBA, pinLightFast, pinLightPerfect, pixelDataToAlphaMask, reflectPixelDataHorizontal, reflectPixelDataVertical, resampleImageData, resampleIndexedImage, resamplePixelData, resizeImageData, rotatePixelData, screenFast, screenPerfect, serializeImageData, serializeNullableImageData, softLightFast, softLightPerfect, sourceOverFast, sourceOverPerfect, subtractFast, subtractPerfect, trimRectBounds, unpackAlpha, unpackBlue, unpackColor, unpackColorTo, unpackGreen, unpackRed, vividLightFast, vividLightPerfect, writeImageData, writeImageDataPixels, writeImageDataToClipboard, writeImgBlobToClipboard };
+export { type AlphaMask, type AnyMask, type ApplyMaskOptions, type Base64EncodedUInt8Array, type BinaryMask, type BlendColor32, BlendMode, type BlendModeIndex, type BlendToIndexGetter, type Color32, type ColorBlendOptions, FAST_BLENDER_REGISTRY, FAST_BLEND_MODES, FAST_BLEND_MODE_BY_NAME, FAST_BLEND_TO_INDEX, type FastBlendModes, type FloodFillImageDataOptions, type FloodFillResult, INDEX_TO_FAST_BLEND, INDEX_TO_PERFECT_BLEND, type ImageDataLike, type IndexToBlendGetter, IndexedImage, MaskType, PERFECT_BLENDER_REGISTRY, PERFECT_BLEND_MODES, PERFECT_BLEND_MODE_BY_NAME, PERFECT_BLEND_TO_INDEX, type PerfectBlendModes, type PixelBlendOptions, type PixelCanvas, PixelData, type PixelOptions, type Point, type RGBA, type Rect, type RegisteredFastBlender, type RegisteredPerfectBlender, type ReusableCanvas, type ReusableImageData, type SelectionRect, type SerializedImageData, UnsupportedFormatError, applyMaskToPixelData, base64DecodeArrayBuffer, base64EncodeArrayBuffer, blendColorPixelData, blendPixelData, clearPixelData, color32ToCssRGBA, color32ToHex, colorBurnFast, colorBurnPerfect, colorDistance, colorDodgeFast, colorDodgePerfect, copyImageData, copyImageDataLike, copyMask, darkenFast, darkenPerfect, darkerFast, darkerPerfect, deserializeImageData, deserializeNullableImageData, deserializeRawImageData, differenceFast, differencePerfect, divideFast, dividePerfect, exclusionFast, exclusionPerfect, extractImageDataPixels, extractMask, fileInputChangeToImageData, fileToImageData, fillPixelData, floodFillSelection, getImageDataFromClipboard, getIndexedImageColorCounts, getSupportedPixelFormats, hardLightFast, hardLightPerfect, hardMixFast, hardMixPerfect, imageDataToAlphaMask, imageDataToDataUrl, imageDataToImgBlob, imageDataToUInt32Array, imgBlobToImageData, indexedImageToAverageColor, indexedImageToImageData, invertAlphaMask, invertBinaryMask, invertImageData, invertPixelData, lerpColor32, lerpColor32Fast, lightenFast, lightenPerfect, lighterFast, lighterPerfect, linearBurnFast, linearBurnPerfect, linearDodgeFast, linearDodgePerfect, linearLightFast, linearLightPerfect, makePixelCanvas, makeReusableCanvas, makeReusableImageData, mergeMasks, multiplyFast, multiplyPerfect, overlayFast, overlayPerfect, overwriteFast, overwritePerfect, packColor, packRGBA, pinLightFast, pinLightPerfect, pixelDataToAlphaMask, reflectPixelDataHorizontal, reflectPixelDataVertical, resampleImageData, resampleIndexedImage, resamplePixelData, resizeImageData, rotatePixelData, screenFast, screenPerfect, serializeImageData, serializeNullableImageData, softLightFast, softLightPerfect, sourceOverFast, sourceOverPerfect, subtractFast, subtractPerfect, trimRectBounds, unpackAlpha, unpackBlue, unpackColor, unpackColorTo, unpackGreen, unpackRed, vividLightFast, vividLightPerfect, writeImageData, writeImageDataPixels, writeImageDataToClipboard, writeImgBlobToClipboard };

package/dist/index.prod.js

@@ -1501,6 +1501,16 @@ function imageDataToDataUrl(imageData) {
 }
 imageDataToDataUrl.reset = get.reset;
 
+// src/ImageData/imageDataToUInt32Array.ts
+function imageDataToUInt32Array(imageData) {
+  return new Uint32Array(
+    imageData.data.buffer,
+    imageData.data.byteOffset,
+    // Shift right by 2 is a fast bitwise division by 4.
+    imageData.data.byteLength >> 2
+  );
+}
+
 // src/ImageData/invertImageData.ts
 function invertImageData(imageData) {
   const data = imageData.data;
@@ -2036,28 +2046,34 @@ function mergeMasks(dst, dstWidth, src, opts) {
 
 // src/PixelData/PixelData.ts
 var PixelData = class _PixelData {
+  data32;
+  imageData;
+  get width() {
+    return this.imageData.width;
+  }
+  get height() {
+    return this.imageData.height;
+  }
   constructor(imageData) {
+    this.data32 = imageDataToUInt32Array(imageData);
     this.imageData = imageData;
-    this.width = imageData.width;
-    this.height = imageData.height;
-    this.data32 = new Uint32Array(
-      imageData.data.buffer,
-      imageData.data.byteOffset,
-      // Shift right by 2 is a fast bitwise division by 4.
-      imageData.data.byteLength >> 2
-    );
   }
-  data32;
-  width;
-  height;
+  set(imageData) {
+    this.imageData = imageData;
+    this.data32 = imageDataToUInt32Array(imageData);
+  }
+  /**
+   * Creates a deep copy of the PixelData using the environment's ImageData constructor.
+   */
   copy() {
-    const buffer = new Uint8ClampedArray(this.data32.buffer.slice(0));
-    const imageData = {
-      data: buffer,
-      width: this.width,
-      height: this.height
-    };
-    return new _PixelData(imageData);
+    const buffer = new Uint8ClampedArray(this.imageData.data);
+    const ImageConstructor = typeof ImageData !== "undefined" ? ImageData : this.imageData.constructor;
+    const newImageData = new ImageConstructor(
+      buffer,
+      this.width,
+      this.height
+    );
+    return new _PixelData(newImageData);
   }
 };
 
@@ -2489,11 +2505,11 @@ function reflectPixelDataVertical(pixelData) {
 // src/PixelData/resamplePixelData.ts
 function resamplePixelData(pixelData, factor) {
   const { data, width, height } = resample32(pixelData.data32, pixelData.width, pixelData.height, factor);
-  return new PixelData({
+  return new PixelData(new ImageData(
+    new Uint8ClampedArray(data.buffer),
     width,
-    height,
-    data: new Uint8ClampedArray(data.buffer)
-  });
+    height
+  ));
 }
 
 // src/PixelData/rotatePixelData.ts
@@ -2507,30 +2523,33 @@ function rotatePixelData(pixelData) {
   }
   const newWidth = height;
   const newHeight = width;
-  const newData = new Uint32Array(data.length);
+  const newData32 = new Uint32Array(data.length);
   for (let y = 0; y < height; y++) {
     for (let x = 0; x < width; x++) {
       const oldIdx = y * width + x;
       const newX = height - 1 - y;
       const newY = x;
       const newIdx = newY * newWidth + newX;
-      newData[newIdx] = data[oldIdx];
+      newData32[newIdx] = data[oldIdx];
     }
   }
-  pixelData.width = newWidth;
-  pixelData.height = newHeight;
-  pixelData.data32 = newData;
+  const newImageData = new ImageData(
+    new Uint8ClampedArray(newData32.buffer),
+    newWidth,
+    newHeight
+  );
+  pixelData.set(newImageData);
 }
 function rotateSquareInPlace(pixelData) {
   const n = pixelData.width;
   const data = pixelData.data32;
   for (let i = 0; i < n / 2; i++) {
     for (let j = i; j < n - i - 1; j++) {
-      const temp = data[i * n + j];
       const top = i * n + j;
       const right = j * n + (n - 1 - i);
       const bottom = (n - 1 - i) * n + (n - 1 - j);
       const left = (n - 1 - j) * n + i;
+      const temp = data[top];
       data[top] = data[left];
       data[left] = data[bottom];
       data[bottom] = data[right];
@@ -2599,6 +2618,7 @@ export {
   imageDataToAlphaMask,
   imageDataToDataUrl,
   imageDataToImgBlob,
+  imageDataToUInt32Array,
   imgBlobToImageData,
   indexedImageToAverageColor,
   indexedImageToImageData,