pixel-data-js 0.19.2 → 0.21.0

package/dist/index.prod.d.ts

@@ -42,6 +42,13 @@ type Rect = {
     w: number;
     h: number;
 };
+type BinaryMaskRect = {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    mask: BinaryMask;
+};
 /**
  * Defines how mask values should be interpreted during a draw operation.
  */
@@ -682,7 +689,7 @@ declare class PixelWriter<M> {
 }
 
 declare function makeFullPixelMutator(writer: PixelWriter<any>): {
-    clear(rect?: Partial<Rect>): void;
+    clear(rect?: Partial<BinaryMaskRect>): void;
     applyRectPencilStroke(color: Color32, x0: number, y0: number, x1: number, y1: number, brushWidth: number, brushHeight: number, alpha?: number, blendFn?: BlendColor32): void;
     applyRectPencil(color: Color32, centerX: number, centerY: number, brushWidth: number, brushHeight: number, alpha?: number, blendFn?: BlendColor32): void;
     applyRectBrushStroke(color: Color32, x0: number, y0: number, x1: number, y1: number, brushWidth: number, brushHeight: number, alpha: number | undefined, fallOff: (dist: number) => number, blendFn?: BlendColor32): void;
@@ -691,7 +698,7 @@ declare function makeFullPixelMutator(writer: PixelWriter<any>): {
     applyCircleBrushStroke(color: Color32, x0: number, y0: number, x1: number, y1: number, brushSize: number, alpha: number | undefined, fallOff: (dist: number) => number, blendFn?: BlendColor32): void;
     applyCircleBrush(color: Color32, centerX: number, centerY: number, brushSize: number, alpha: number | undefined, fallOff: (dist: number) => number, blendFn?: BlendColor32): void;
     invert(opts?: PixelMutateOptions): void;
-    fill(color: Color32, rect?: Partial<Rect>): void;
+    fill(color: Color32, rect?: Partial<BinaryMaskRect>): void;
     blendPixel(x: number, y: number, color: Color32, alpha?: number, blendFn?: BlendColor32): void;
     blendColor(color: Color32, opts?: ColorBlendOptions): void;
     blendPixelData(src: IPixelData, opts: PixelBlendOptions): void;
@@ -885,10 +892,9 @@ declare const mutatorBlendPixelData: (writer: PixelWriter<any>, deps?: Partial<D
  *
  * @param dst - The target {@link PixelData} to modify.
  * @param color - The {@link Color32} value to apply.
- * @param rect - A {@link Rect} defining the area to fill. If omitted, the entire
- * buffer is filled.
+ * @param rect - A {@link BinaryMaskRect} defining the area to fill.
  */
-declare function fillPixelData(dst: IPixelData, color: Color32, rect?: Partial<Rect>): void;
+declare function fillPixelData(dst: IPixelData, color: Color32, rect?: Partial<BinaryMaskRect>): void;
 /**
  * @param dst - The target {@link PixelData} to modify.
  * @param color - The {@link Color32} value to apply.
@@ -896,15 +902,16 @@ declare function fillPixelData(dst: IPixelData, color: Color32, rect?: Partial<R
  * @param y - Starting vertical coordinate.
  * @param w - Width of the fill area.
  * @param h - Height of the fill area.
+ * @param mask - A {@link BinaryMaskRect} defining the area to fill
  */
-declare function fillPixelData(dst: IPixelData, color: Color32, x: number, y: number, w: number, h: number): void;
+declare function fillPixelData(dst: IPixelData, color: Color32, x: number, y: number, w: number, h: number, mask?: BinaryMask): void;
 
 declare const defaults$2: {
     fillPixelData: typeof fillPixelData;
 };
 type Deps$2 = Partial<typeof defaults$2>;
 declare const mutatorClear: (writer: PixelWriter<any>, deps?: Deps$2) => {
-    clear(rect?: Partial<Rect>): void;
+    clear(rect?: Partial<BinaryMaskRect>): void;
 };
 
 declare const defaults$1: {
@@ -912,7 +919,7 @@ declare const defaults$1: {
 };
 type Deps$1 = Partial<typeof defaults$1>;
 declare const mutatorFill: (writer: PixelWriter<any>, deps?: Deps$1) => {
-    fill(color: Color32, rect?: Partial<Rect>): void;
+    fill(color: Color32, rect?: Partial<BinaryMaskRect>): void;
 };
 
 declare function invertPixelData(pixelData: IPixelData, opts?: PixelMutateOptions): void;
@@ -1354,7 +1361,7 @@ declare function blendPixelDataBinaryMask(dst: IPixelData, src: IPixelData, bina
  * Clears a region of the PixelData to transparent (0x00000000).
  * Internally uses the optimized fillPixelData.
  */
-declare function clearPixelData(dst: IPixelData, rect?: Partial<Rect>): void;
+declare function clearPixelData(dst: IPixelData, rect?: Partial<BinaryMaskRect>): void;
 
 /**
  * High-level extraction that returns a new PixelData instance.
@@ -1426,4 +1433,4 @@ declare function writePixelDataBuffer(target: IPixelData, data: Uint32Array, x:
  */
 declare function trimRectBounds<T extends Rect | SelectionRect>(target: T, bounds: Rect): void;
 
-export { type Alpha, type AlphaMask, type AnyMask, type ApplyMaskToPixelDataOptions, BASE_FAST_BLEND_MODE_FUNCTIONS, BASE_PERFECT_BLEND_MODE_FUNCTIONS, type Base64EncodedUInt8Array, BaseBlendMode, type BaseBlendModes, type BasePixelBlendOptions, type BinaryMask, type BlendColor32, type BlendModeRegistry, CANVAS_CTX_FAILED, type Color32, type ColorBlendMaskOptions, type ColorBlendOptions, type FloodFillImageDataOptions, type FloodFillResult, type HistoryAction, HistoryManager, type HistoryMutator, type IPixelData, type ImageDataLike, type ImageDataLikeConstructor, IndexedImage, type InvertMask, type MaskOffset, type MaskOffsetWidth, MaskType, type MergeAlphaMasksOptions, OFFSCREEN_CANVAS_CTX_FAILED, PixelAccumulator, type PixelBlendMaskOptions, type PixelBlendOptions, PixelBuffer32, type PixelCanvas, PixelData, PixelEngineConfig, type PixelMutateOptions, type PixelPatchTiles, type PixelRect, PixelTile, PixelWriter, type PixelWriterOptions, type RGBA, type Rect, type RequiredBlendModes, type ReusableCanvas, type ReusableImageData, type SelectionRect, type SerializedImageData, UnsupportedFormatError, applyAlphaMaskToPixelData, applyBinaryMaskToAlphaMask, applyBinaryMaskToPixelData, applyCircleBrushToPixelData, applyPatchTiles, applyRectBrushToPixelData, base64DecodeArrayBuffer, base64EncodeArrayBuffer, blendColorPixelData, blendColorPixelDataAlphaMask, blendColorPixelDataBinaryMask, blendPixelData, blendPixelDataAlphaMask, blendPixelDataBinaryMask, clearPixelData, color32ToCssRGBA, color32ToHex, colorBurnFast, colorBurnPerfect, colorDistance, colorDodgeFast, colorDodgePerfect, copyImageData, copyImageDataLike, copyMask, darkenFast, darkenPerfect, darkerFast, darkerPerfect, deserializeImageData, deserializeNullableImageData, deserializeRawImageData, differenceFast, differencePerfect, divideFast, dividePerfect, exclusionFast, exclusionPerfect, extractImageDataBuffer, extractMask, extractPixelData, extractPixelDataBuffer, fileInputChangeToImageData, fileToImageData, fillPixelData, floodFillSelection, forEachLinePoint, getCircleBrushOrPencilBounds, getCircleBrushOrPencilStrokeBounds, getImageDataFromClipboard, getIndexedImageColorCounts, getRectBrushOrPencilBounds, getRectBrushOrPencilStrokeBounds, 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, makeBlendModeRegistry, makeFastBlendModeRegistry, makeFullPixelMutator, makeImageDataLike, makePerfectBlendModeRegistry, makePixelCanvas, makeReusableCanvas, makeReusableImageData, mergeAlphaMasks, mergeBinaryMasks, multiplyFast, multiplyPerfect, mutatorApplyAlphaMask, mutatorApplyBinaryMask, mutatorApplyCircleBrush, mutatorApplyCircleBrushStroke, mutatorApplyCirclePencil, mutatorApplyCirclePencilStroke, mutatorApplyRectBrush, mutatorApplyRectBrushStroke, mutatorApplyRectPencil, mutatorApplyRectPencilStroke, mutatorBlendColor, mutatorBlendPixel, mutatorBlendPixelData, mutatorClear, mutatorFill, mutatorInvert, overlayFast, overlayPerfect, overwriteBase, overwriteFast, overwritePerfect, packColor, packRGBA, pinLightFast, pinLightPerfect, pixelDataToAlphaMask, reflectPixelDataHorizontal, reflectPixelDataVertical, resampleImageData, resampleIndexedImage, resamplePixelData, resizeImageData, rotatePixelData, screenFast, screenPerfect, serializeImageData, serializeNullableImageData, softLightFast, softLightPerfect, sourceOverFast, sourceOverPerfect, subtractFast, subtractPerfect, toBlendModeIndexAndName, trimRectBounds, uInt32ArrayToImageData, uInt32ArrayToImageDataLike, unpackAlpha, unpackBlue, unpackColor, unpackColorTo, unpackGreen, unpackRed, vividLightFast, vividLightPerfect, writeImageData, writeImageDataBuffer, writeImageDataToClipboard, writeImgBlobToClipboard, writePixelDataBuffer };
+export { type Alpha, type AlphaMask, type AnyMask, type ApplyMaskToPixelDataOptions, BASE_FAST_BLEND_MODE_FUNCTIONS, BASE_PERFECT_BLEND_MODE_FUNCTIONS, type Base64EncodedUInt8Array, BaseBlendMode, type BaseBlendModes, type BasePixelBlendOptions, type BinaryMask, type BinaryMaskRect, type BlendColor32, type BlendModeRegistry, CANVAS_CTX_FAILED, type Color32, type ColorBlendMaskOptions, type ColorBlendOptions, type FloodFillImageDataOptions, type FloodFillResult, type HistoryAction, HistoryManager, type HistoryMutator, type IPixelData, type ImageDataLike, type ImageDataLikeConstructor, IndexedImage, type InvertMask, type MaskOffset, type MaskOffsetWidth, MaskType, type MergeAlphaMasksOptions, OFFSCREEN_CANVAS_CTX_FAILED, PixelAccumulator, type PixelBlendMaskOptions, type PixelBlendOptions, PixelBuffer32, type PixelCanvas, PixelData, PixelEngineConfig, type PixelMutateOptions, type PixelPatchTiles, type PixelRect, PixelTile, PixelWriter, type PixelWriterOptions, type RGBA, type Rect, type RequiredBlendModes, type ReusableCanvas, type ReusableImageData, type SelectionRect, type SerializedImageData, UnsupportedFormatError, applyAlphaMaskToPixelData, applyBinaryMaskToAlphaMask, applyBinaryMaskToPixelData, applyCircleBrushToPixelData, applyPatchTiles, applyRectBrushToPixelData, base64DecodeArrayBuffer, base64EncodeArrayBuffer, blendColorPixelData, blendColorPixelDataAlphaMask, blendColorPixelDataBinaryMask, blendPixelData, blendPixelDataAlphaMask, blendPixelDataBinaryMask, clearPixelData, color32ToCssRGBA, color32ToHex, colorBurnFast, colorBurnPerfect, colorDistance, colorDodgeFast, colorDodgePerfect, copyImageData, copyImageDataLike, copyMask, darkenFast, darkenPerfect, darkerFast, darkerPerfect, deserializeImageData, deserializeNullableImageData, deserializeRawImageData, differenceFast, differencePerfect, divideFast, dividePerfect, exclusionFast, exclusionPerfect, extractImageDataBuffer, extractMask, extractPixelData, extractPixelDataBuffer, fileInputChangeToImageData, fileToImageData, fillPixelData, floodFillSelection, forEachLinePoint, getCircleBrushOrPencilBounds, getCircleBrushOrPencilStrokeBounds, getImageDataFromClipboard, getIndexedImageColorCounts, getRectBrushOrPencilBounds, getRectBrushOrPencilStrokeBounds, 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, makeBlendModeRegistry, makeFastBlendModeRegistry, makeFullPixelMutator, makeImageDataLike, makePerfectBlendModeRegistry, makePixelCanvas, makeReusableCanvas, makeReusableImageData, mergeAlphaMasks, mergeBinaryMasks, multiplyFast, multiplyPerfect, mutatorApplyAlphaMask, mutatorApplyBinaryMask, mutatorApplyCircleBrush, mutatorApplyCircleBrushStroke, mutatorApplyCirclePencil, mutatorApplyCirclePencilStroke, mutatorApplyRectBrush, mutatorApplyRectBrushStroke, mutatorApplyRectPencil, mutatorApplyRectPencilStroke, mutatorBlendColor, mutatorBlendPixel, mutatorBlendPixelData, mutatorClear, mutatorFill, mutatorInvert, overlayFast, overlayPerfect, overwriteBase, overwriteFast, overwritePerfect, packColor, packRGBA, pinLightFast, pinLightPerfect, pixelDataToAlphaMask, reflectPixelDataHorizontal, reflectPixelDataVertical, resampleImageData, resampleIndexedImage, resamplePixelData, resizeImageData, rotatePixelData, screenFast, screenPerfect, serializeImageData, serializeNullableImageData, softLightFast, softLightPerfect, sourceOverFast, sourceOverPerfect, subtractFast, subtractPerfect, toBlendModeIndexAndName, trimRectBounds, uInt32ArrayToImageData, uInt32ArrayToImageDataLike, unpackAlpha, unpackBlue, unpackColor, unpackColorTo, unpackGreen, unpackRed, vividLightFast, vividLightPerfect, writeImageData, writeImageDataBuffer, writeImageDataToClipboard, writeImgBlobToClipboard, writePixelDataBuffer };

package/dist/index.prod.js

@@ -3056,21 +3056,24 @@ var mutatorBlendPixelData = ((writer, deps = defaults11) => {
 
 // src/PixelData/fillPixelData.ts
 var SCRATCH_RECT = makeClippedRect();
-function fillPixelData(dst, color, _x, _y, _w, _h) {
+function fillPixelData(dst, color, _x, _y, _w, _h, _mask) {
   let x;
   let y;
   let w;
   let h;
+  let mask;
   if (typeof _x === "object") {
     x = _x.x ?? 0;
     y = _x.y ?? 0;
     w = _x.w ?? dst.width;
     h = _x.h ?? dst.height;
+    mask = _x.mask;
   } else if (typeof _x === "number") {
     x = _x;
     y = _y;
     w = _w;
     h = _h;
+    mask = _mask;
   } else {
     x = 0;
     y = 0;
@@ -3091,10 +3094,28 @@ function fillPixelData(dst, color, _x, _y, _w, _h) {
     dst32.fill(color);
     return;
   }
-  for (let iy = 0; iy < actualH; iy++) {
-    const start = (finalY + iy) * dw + finalX;
-    const end = start + actualW;
-    dst32.fill(color, start, end);
+  if (mask) {
+    for (let iy = 0; iy < actualH; iy++) {
+      const currentY = finalY + iy;
+      const maskY = currentY - y;
+      const maskOffset = maskY * w;
+      for (let ix = 0; ix < actualW; ix++) {
+        const currentX = finalX + ix;
+        const maskX = currentX - x;
+        const maskIndex = maskOffset + maskX;
+        const isMasked = mask[maskIndex];
+        if (isMasked) {
+          const dstIndex = currentY * dw + currentX;
+          dst32[dstIndex] = color;
+        }
+      }
+    }
+  } else {
+    for (let iy = 0; iy < actualH; iy++) {
+      const start = (finalY + iy) * dw + finalX;
+      const end = start + actualW;
+      dst32.fill(color, start, end);
+    }
   }
 }
 
@@ -3112,10 +3133,11 @@ var mutatorClear = ((writer, deps = defaults12) => {
         x = 0,
         y = 0,
         w = writer.target.width,
-        h = writer.target.height
+        h = writer.target.height,
+        mask = void 0
       } = rect;
       writer.accumulator.storeRegionBeforeState(x, y, w, h);
-      fillPixelData2(writer.target, 0, x, y, w, h);
+      fillPixelData2(writer.target, 0, x, y, w, h, mask);
     }
   };
 });
@@ -3134,10 +3156,11 @@ var mutatorFill = ((writer, deps = defaults13) => {
         x = 0,
         y = 0,
         w = writer.target.width,
-        h = writer.target.height
+        h = writer.target.height,
+        mask = void 0
       } = rect;
       writer.accumulator.storeRegionBeforeState(x, y, w, h);
-      fillPixelData2(writer.target, color, x, y, w, h);
+      fillPixelData2(writer.target, color, x, y, w, h, mask);
     }
   };
 });