pixel-data-js 0.19.2 → 0.20.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pixel-data-js",
   "type": "module",
-  "version": "0.19.2",
+  "version": "0.20.0",
   "packageManager": "pnpm@10.30.0",
   "description": "JS Pixel and ImageData operations",
   "author": {

package/src/PixelData/fillPixelData.ts

@@ -1,4 +1,4 @@
-import type { Color32, IPixelData, Rect } from '../_types'
+import type { BinaryMask, BinaryMaskRect, Color32, IPixelData } from '../_types'
 import { makeClippedRect, resolveRectClipping } from '../Internal/resolveClipping'
 import type { PixelData } from './PixelData'
 
@@ -9,13 +9,12 @@ const SCRATCH_RECT = makeClippedRect()
  *
  * @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.
  */
 export function fillPixelData(
   dst: IPixelData,
   color: Color32,
-  rect?: Partial<Rect>,
+  rect?: Partial<BinaryMaskRect>,
 ): void
 /**
  * @param dst - The target {@link PixelData} to modify.
@@ -24,6 +23,7 @@ export function fillPixelData(
  * @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
  */
 export function fillPixelData(
   dst: IPixelData,
@@ -32,30 +32,36 @@ export function fillPixelData(
   y: number,
   w: number,
   h: number,
+  mask?: BinaryMask,
 ): void
 export function fillPixelData(
   dst: IPixelData,
   color: Color32,
-  _x?: Partial<Rect> | number,
+  _x?: Partial<BinaryMaskRect> | number,
   _y?: number,
   _w?: number,
   _h?: number,
+  _mask?: BinaryMask,
 ): void {
   let x: number
   let y: number
   let w: number
   let h: number
+  let mask: BinaryMask | undefined
 
   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
@@ -84,10 +90,30 @@ export function fillPixelData(
     return
   }
 
-  // Row-by-row fill for partial rectangles
-  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 {
+    // Row-by-row fill for partial rectangles
+    for (let iy = 0; iy < actualH; iy++) {
+      const start = (finalY + iy) * dw + finalX
+      const end = start + actualW
+      dst32.fill(color, start, end)
+    }
   }
 }

package/src/_types.ts

@@ -47,6 +47,14 @@ export type Rect = {
   h: number
 }
 
+export type BinaryMaskRect = {
+  x: number
+  y: number
+  w: number
+  h: number
+  mask: BinaryMask
+}
+
 /**
  * Defines how mask values should be interpreted during a draw operation.
  */