pixel-data-js 0.27.0 → 0.28.0

package/src/_types.ts

@@ -1,3 +1,5 @@
+import type { BinaryMask } from './Mask/_mask-types'
+
 /** ALL values are 0-255 (including alpha which in CSS is 0-1) */
 export type RGBA = { r: number, g: number, b: number, a: number }
 
@@ -15,84 +17,6 @@ export type BlendColor32 = {
   isOverwrite?: true
 }
 
-export type ImageDataLike = {
-  width: number
-  height: number
-  data: Uint8ClampedArray<ArrayBufferLike>
-}
-
-export type ImageDataLikeConstructor<T extends ImageDataLike = ImageDataLike> = {
-  new(
-    data: Uint8ClampedArray,
-    width: number,
-    height: number,
-  ): T
-}
-
-export type SerializedImageData = {
-  width: number
-  height: number
-  data: string
-}
-
-export type Base64EncodedUInt8Array = string & { readonly __brandBase64UInt8Array: unique symbol }
-
-/** Rectangle definition */
-export type Rect = {
-  x: number
-  y: number
-  w: number
-  h: number
-}
-
-/**
- * Defines how mask values should be interpreted during a draw operation.
- */
-export enum MaskType {
-  /**
-   * Values are treated as alpha weights.
-   * 0 is skipped, values > 0 are processed.
-   */
-  ALPHA,
-  /**
-   *  Values are treated as on/off.
-   * 0 is fully transparent (skipped), any other value is fully opaque.
-   */
-  BINARY
-}
-
-export interface BaseMask {
-  readonly type: MaskType
-  readonly data: Uint8Array
-  readonly w: number
-  readonly h: number
-}
-
-export type Mask = BinaryMask | AlphaMask
-
-/** Strictly 0 or 1 */
-export interface BinaryMask extends BaseMask {
-  readonly type: MaskType.BINARY
-}
-
-/** Strictly 0-255 */
-export interface AlphaMask extends BaseMask {
-  readonly type: MaskType.ALPHA
-}
-
-interface BasePaintMask {
-  readonly centerOffsetX: number
-  readonly centerOffsetY: number
-}
-
-export interface PaintAlphaMask extends BasePaintMask, AlphaMask {
-}
-
-export interface PaintBinaryMask extends BasePaintMask, BinaryMask {
-}
-
-export type PaintMask = PaintAlphaMask | PaintBinaryMask
-
 /**
  * Configuration for pixel manipulation operations.
  * Designed to be used by spreading a Rect object ({x, y, w, h}) directly.
@@ -138,7 +62,6 @@ export interface MaskOffset {
 }
 
 export interface InvertMask {
-
   /**
    * If true the inverse of the mask will be applied
    * @default false
@@ -158,7 +81,6 @@ export interface ApplyMaskToPixelDataOptions extends PixelRect, Alpha, MaskOffse
 }
 
 export interface MergeAlphaMasksOptions extends PixelRect, Alpha, MaskOffset, InvertMask {
-
 }
 
 export interface PixelMutateOptions extends PixelRect, MaskOffset, InvertMask {
@@ -209,41 +131,3 @@ export interface ColorBlendOptions extends PixelRect, Alpha {
 
 export interface ColorBlendMaskOptions extends ColorBlendOptions, MaskOffset, InvertMask {
 }
-
-export interface ColorBlendPaintMaskOptions extends Omit<ColorBlendOptions, 'w' | 'h'> {
-}
-
-export type MaskRect<T extends MaskType> = Rect & {
-  type: T
-  data: Uint8Array
-}
-
-export type BinaryMaskRect = MaskRect<MaskType.BINARY>
-
-export type AlphaMaskRect = MaskRect<MaskType.ALPHA>
-
-export type NullableBinaryMaskRect = Rect & ({
-  type: MaskType.BINARY
-  data: Uint8Array
-} | {
-  type?: null
-  data?: null
-})
-
-export type NullableMaskRect = Rect & ({
-  type: MaskType
-  data: Uint8Array
-} | {
-  type?: null
-  data?: null
-})
-
-export interface IPixelData32 {
-  readonly data32: Uint32Array
-  readonly width: number
-  readonly height: number
-}
-
-export interface IPixelData<T extends ImageDataLike = ImageData> extends IPixelData32 {
-  readonly imageData: T
-}

package/src/index.ts

@@ -1,23 +1,31 @@
-// @sort-all (generated by `npm run re-index`)
+// generated by `npm run re-index` 
+
+export * from './_errors'
+export * from './_types'
 
 export * from './Algorithm/floodFillSelection'
 export * from './Algorithm/forEachLinePoint'
+export * from './Algorithm/resampleUint32Array'
 
-export * from './BlendModes/BlendModeRegistry'
 export * from './BlendModes/blend-modes-fast'
 export * from './BlendModes/blend-modes-perfect'
 export * from './BlendModes/blend-modes'
+export * from './BlendModes/BlendModeRegistry'
 export * from './BlendModes/toBlendModeIndexAndName'
 
+export * from './Canvas/_canvas-types'
+export * from './Canvas/canvas-blend-modes'
 export * from './Canvas/CanvasFrameRenderer'
+export * from './Canvas/CanvasPixelDataRenderer'
 export * from './Canvas/PixelCanvas'
 export * from './Canvas/ReusableCanvas'
-export * from './Canvas/canvas-blend-modes'
 
 export * from './Clipboard/getImageDataFromClipboard'
 export * from './Clipboard/writeImageDataToClipboard'
 export * from './Clipboard/writeImgBlobToClipboard'
 
+export * from './color'
+
 export * from './History/HistoryAction'
 export * from './History/HistoryManager'
 export * from './History/PixelAccumulator'
@@ -45,25 +53,27 @@ export * from './History/PixelMutator/mutatorInvert'
 export * from './History/PixelPatchTiles'
 export * from './History/PixelWriter'
 
-export * from './ImageData/ImageDataLike'
-export * from './ImageData/ReusableImageData'
+export * from './ImageData/_ImageData-types'
 export * from './ImageData/copyImageData'
 export * from './ImageData/extractImageDataBuffer'
+export * from './ImageData/ImageDataLike'
 export * from './ImageData/imageDataToAlphaMaskBuffer'
 export * from './ImageData/imageDataToDataUrl'
 export * from './ImageData/imageDataToImgBlob'
-export * from './ImageData/imageDataToUInt32Array'
+export * from './ImageData/imageDataToUint32Array'
 export * from './ImageData/imgBlobToImageData'
 export * from './ImageData/invertImageData'
 export * from './ImageData/resampleImageData'
 export * from './ImageData/resizeImageData'
+export * from './ImageData/ReusableImageData'
 export * from './ImageData/serialization'
 export * from './ImageData/uInt32ArrayToImageData'
 export * from './ImageData/writeImageData'
 export * from './ImageData/writeImageDataBuffer'
 
-export * from './IndexedImage/IndexedImage'
+export * from './IndexedImage/_indexedImage-types'
 export * from './IndexedImage/getIndexedImageColorCounts'
+export * from './IndexedImage/IndexedImage'
 export * from './IndexedImage/indexedImageToAverageColor'
 export * from './IndexedImage/indexedImageToImageData'
 export * from './IndexedImage/resampleIndexedImage'
@@ -72,12 +82,16 @@ export * from './Input/fileInputChangeToImageData'
 export * from './Input/fileToImageData'
 export * from './Input/getSupportedRasterFormats'
 
-export * from './Internal/resample32'
-export * from './Internal/resolveClipping'
-
+export * from './Mask/_mask-types'
 export * from './Mask/AlphaMask'
-export * from './Mask/BinaryMask'
 export * from './Mask/applyBinaryMaskToAlphaMask'
+export * from './Mask/BinaryMask'
+
+export * from './Mask/BinaryMask/makeBinaryMaskFromAlphaMask'
+export * from './Mask/BinaryMask/makeBinaryMaskOutline'
+export * from './Mask/BinaryMask/makeCircleBinaryMaskOutline'
+export * from './Mask/BinaryMask/makeRectBinaryMaskOutline'
+
 export * from './Mask/copyMask'
 export * from './Mask/extractMask'
 export * from './Mask/extractMaskBuffer'
@@ -90,14 +104,20 @@ export * from './MaskRect/merge2BinaryMaskRects'
 export * from './MaskRect/mergeBinaryMaskRects'
 export * from './MaskRect/subtractBinaryMaskRects'
 
-export * from './Paint/PaintBuffer'
-export * from './Paint/PaintBufferCanvasRenderer'
-export * from './Paint/makeCirclePaintAlphaMask'
-export * from './Paint/makeCirclePaintBinaryMask'
+export * from './Paint/_paint-types'
+export * from './Paint/AlphaMaskPaintBuffer'
+export * from './Paint/AlphaMaskPaintBufferCanvasRenderer'
+export * from './Paint/BinaryMaskPaintBuffer'
+export * from './Paint/BinaryMaskPaintBufferCanvasRenderer'
+export * from './Paint/ColorPaintBuffer'
+export * from './Paint/ColorPaintBufferCanvasRenderer'
+export * from './Paint/eachTileInBounds'
+export * from './Paint/makeCirclePaintMask'
 export * from './Paint/makePaintMask'
 export * from './Paint/makeRectFalloffPaintAlphaMask'
+export * from './Paint/PaintCursorRenderer'
 
-export * from './PixelData/PixelData'
+export * from './PixelData/_pixelData-types'
 export * from './PixelData/applyAlphaMaskToPixelData'
 export * from './PixelData/applyBinaryMaskToPixelData'
 export * from './PixelData/applyMaskToPixelData'
@@ -115,25 +135,30 @@ export * from './PixelData/blendPixelDataBinaryMask'
 export * from './PixelData/blendPixelDataMask'
 export * from './PixelData/blendPixelDataPaintBuffer'
 export * from './PixelData/clearPixelDataFast'
+export * from './PixelData/copyPixelData'
 export * from './PixelData/extractPixelData'
 export * from './PixelData/extractPixelDataBuffer'
 export * from './PixelData/fillPixelData'
 export * from './PixelData/fillPixelDataBinaryMask'
 export * from './PixelData/fillPixelDataFast'
 export * from './PixelData/invertPixelData'
+export * from './PixelData/PixelData'
 export * from './PixelData/pixelDataToAlphaMask'
 export * from './PixelData/reflectPixelData'
 export * from './PixelData/resamplePixelData'
+export * from './PixelData/ReusablePixelData'
 export * from './PixelData/rotatePixelData'
+export * from './PixelData/uInt32ArrayToPixelData'
 export * from './PixelData/writePaintBufferToPixelData'
 export * from './PixelData/writePixelDataBuffer'
 
-export * from './PixelTile/PixelTile'
-export * from './PixelTile/PixelTilePool'
-
+export * from './Rect/_rect-types'
 export * from './Rect/getRectsBounds'
+export * from './Rect/resolveClipping'
 export * from './Rect/trimMaskRectBounds'
 export * from './Rect/trimRectBounds'
 
-export * from './_types'
-export * from './color'
+export * from './Tile/_tile-types'
+export * from './Tile/MaskTile'
+export * from './Tile/PixelTile'
+export * from './Tile/TilePool'

package/src/ImageData/imageDataToUInt32Array.ts

@@ -1,13 +0,0 @@
-import type { ImageDataLike } from '../_types'
-
-/**
- * converts {@link ImageData} to a faster Uint32Array
- */
-export function imageDataToUInt32Array(imageData: ImageDataLike): Uint32Array {
-  return new Uint32Array(
-    imageData.data.buffer,
-    imageData.data.byteOffset,
-    // Shift right by 2 is a fast bitwise division by 4.
-    imageData.data.byteLength >> 2,
-  )
-}

package/src/Internal/helpers.ts

@@ -1,5 +0,0 @@
-// @__INLINE_MACRO__
-export const _macro_halfAndFloor = (value: number) => value >> 1
-
-// @__INLINE_MACRO__
-export const _macro_paintRectCenterOffset = (size: number) => (size - 1) >> 1

package/src/Paint/makeCirclePaintAlphaMask.ts

@@ -1,41 +0,0 @@
-import { MaskType, type PaintAlphaMask } from '../_types'
-
-export function makeCirclePaintAlphaMask(size: number, fallOff: (d: number) => number = (d) => d): PaintAlphaMask {
-  const area = size * size
-  const data = new Uint8Array(area)
-  const radius = size / 2
-  const invR = 1 / radius
-
-  const centerOffset = -Math.ceil(radius - 0.5)
-
-  for (let y = 0; y < size; y++) {
-    const rowOffset = y * size
-    const dy = y - radius + 0.5
-    const dy2 = dy * dy
-
-    for (let x = 0; x < size; x++) {
-      const dx = x - radius + 0.5
-      const distSqr = dx * dx + dy2
-
-      if (distSqr <= (radius * radius)) {
-        const dist = Math.sqrt(distSqr) * invR
-
-        // Pass 1.0 at center, 0.0 at edge
-        const strength = fallOff(1 - dist)
-        if (strength > 0) {
-          const intensity = (strength * 255) | 0
-          data[rowOffset + x] = Math.max(0, Math.min(255, intensity))
-        }
-      }
-    }
-  }
-
-  return {
-    type: MaskType.ALPHA,
-    data,
-    w: size,
-    h: size,
-    centerOffsetX: centerOffset,
-    centerOffsetY: centerOffset
-  }
-}

package/src/Paint/makeCirclePaintBinaryMask.ts

@@ -1,29 +0,0 @@
-import { MaskType, type PaintBinaryMask } from '../_types'
-
-export function makeCirclePaintBinaryMask(size: number): PaintBinaryMask {
-  const area = size * size
-  const data = new Uint8Array(area)
-  const radius = size / 2
-
-  const centerOffset = -Math.ceil(radius - 0.5)
-
-  for (let y = 0; y < size; y++) {
-    for (let x = 0; x < size; x++) {
-      const dx = x - radius + 0.5
-      const dy = y - radius + 0.5
-      const distSqr = dx * dx + dy * dy
-      if (distSqr <= (radius * radius)) {
-        data[y * size + x] = 1
-      }
-    }
-  }
-
-  return {
-    type: MaskType.BINARY,
-    data,
-    w: size,
-    h: size,
-    centerOffsetX: centerOffset,
-    centerOffsetY: centerOffset,
-  }
-}

package/src/PixelTile/PixelTile.ts

@@ -1,21 +0,0 @@
-import type { IPixelData } from '../_types'
-
-export class PixelTile implements IPixelData {
-  readonly data32: Uint32Array
-  readonly width: number
-  readonly height: number
-  readonly imageData: ImageData
-
-  constructor(
-    public id: number,
-    public tx: number,
-    public ty: number,
-    tileSize: number,
-    tileArea: number,
-  ) {
-    this.width = this.height = tileSize
-    this.data32 = new Uint32Array(tileArea)
-    const data8 = new Uint8ClampedArray(this.data32.buffer) as Uint8ClampedArray<ArrayBuffer>
-    this.imageData = new ImageData(data8, tileSize, tileSize)
-  }
-}