@richardmcquiston01/core-image 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Richard McQuiston
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,31 @@
-# Temporary Holding Version
+# @richardmcquiston01/core-image
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Image processing core for laser, CNC and other maker-machine workflows: a filter registry (dithering, tone, edge/morphology, transforms, test grids), image I/O helpers, and grayscale heightmap-to-STL conversion.
+
+Part of [maker-image-tools](https://github.com/RichardMcQuiston01/maker-image-tools).
+
+## Install
+
+```sh
+npm i @richardmcquiston01/core-image
+```
+
+## Usage
+
+```ts
+import {
+  createFilterRegistry,
+  imageToHeightmapStl,
+  loadImageData,
+} from "@richardmcquiston01/core-image";
+
+const image: ImageData = await loadImageData(blob);
+const registry = createFilterRegistry();
+const stl: string = imageToHeightmapStl(image);
+```
+
+Requires an environment with `ImageData` (browser, or a polyfill in Node). ESM only.
+
+## License
+
+MIT

package/dist/filters/dither.d.ts

@@ -0,0 +1,35 @@
+import type { Filter, FilterOptions } from "../types.js";
+/** Options shared by every error-diffusion dithering filter. */
+export interface DitherOptions extends FilterOptions {
+    /** Grayscale cutoff (0-255) above which a pixel is quantized to white. Defaults to 128. */
+    threshold?: number;
+}
+/** Options for Bayer (ordered) dithering. */
+export interface BayerDitherOptions extends FilterOptions {
+    /** Size of the (square) Bayer matrix. Defaults to 4. */
+    matrixSize?: 2 | 4 | 8;
+}
+/** Options for blue-noise (ordered) dithering. Currently no tunable fields. */
+export type BlueNoiseDitherOptions = FilterOptions;
+/** Floyd-Steinberg error-diffusion dithering (Floyd & Steinberg, 1976). */
+export declare const ditherFloydSteinberg: Filter<DitherOptions>;
+/** Atkinson dithering (Bill Atkinson, Apple). Only diffuses 6/8 of the error,
+ * which intentionally clips instead of fully spreading it, giving higher local contrast. */
+export declare const ditherAtkinson: Filter<DitherOptions>;
+/** Jarvis, Judice & Ninke error-diffusion dithering (1976). */
+export declare const ditherJarvisJudiceNinke: Filter<DitherOptions>;
+/** Stucki error-diffusion dithering (1981). */
+export declare const ditherStucki: Filter<DitherOptions>;
+/** Sierra error-diffusion dithering (Frankie Sierra). */
+export declare const ditherSierra: Filter<DitherOptions>;
+/** Burkes error-diffusion dithering (Daniel Burkes, 1988). */
+export declare const ditherBurkes: Filter<DitherOptions>;
+/** Bayer ordered dithering: compares each pixel against a tiled NxN threshold matrix. */
+export declare const ditherBayer: Filter<BayerDitherOptions>;
+/**
+ * Blue-noise ordered dithering using Interleaved Gradient Noise (IGN) as a
+ * cheap, real-time-graphics approximation of a true blue-noise texture --
+ * this is not a void-and-cluster blue-noise dither, just visually similar.
+ */
+export declare const ditherBlueNoise: Filter<BlueNoiseDitherOptions>;
+//# sourceMappingURL=dither.d.ts.map

package/dist/filters/dither.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dither.d.ts","sourceRoot":"","sources":["../../src/filters/dither.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGzD,gEAAgE;AAChE,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,6CAA6C;AAC7C,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,wDAAwD;IACxD,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACxB;AAED,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAgGnD,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,aAAa,CAGtD,CAAC;AAWF;4FAC4F;AAC5F,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,aAAa,CAGhD,CAAC;AAiBF,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,aAAa,CAGzD,CAAC;AAiBF,+CAA+C;AAC/C,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,aAAa,CAG9C,CAAC;AAeF,yDAAyD;AACzD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,aAAa,CAG9C,CAAC;AAYF,8DAA8D;AAC9D,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,aAAa,CAG9C,CAAC;AAoCF,yFAAyF;AACzF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,kBAAkB,CAmBlD,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,sBAAsB,CAiB1D,CAAC"}

package/dist/filters/dither.js

@@ -0,0 +1,228 @@
+import { createImageData, getPixel } from "../pixel.js";
+const DEFAULT_THRESHOLD = 128;
+/** Builds a kernel of normalized weights from integer numerators and a shared divisor. */
+function buildKernel(divisor, taps) {
+    return taps.map(([dx, dy, numerator]) => ({ dx, dy, weight: numerator / divisor }));
+}
+function luma(r, g, b) {
+    return r * 0.299 + g * 0.587 + b * 0.114;
+}
+/** Converts image to a working grayscale buffer (one float per pixel, 0-255 range). */
+function toGrayscaleBuffer(image) {
+    const { width, height, data } = image;
+    const gray = new Float32Array(width * height);
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const i = (y * width + x) * 4;
+            const p = i;
+            gray[y * width + x] = luma(data[p] ?? 0, data[p + 1] ?? 0, data[p + 2] ?? 0);
+        }
+    }
+    return gray;
+}
+/** Writes a pure black/white pixel into `output` at `idx`, carrying over `image`'s alpha at (x, y). */
+function writeBinaryPixel(output, image, x, y, idx, value) {
+    const [, , , a] = getPixel(image, x, y);
+    const oi = idx * 4;
+    output.data[oi] = value;
+    output.data[oi + 1] = value;
+    output.data[oi + 2] = value;
+    output.data[oi + 3] = a;
+}
+/**
+ * Shared error-diffusion engine. Walks the grayscale buffer left-to-right,
+ * top-to-bottom, quantizing each pixel to 0/255 and pushing the resulting
+ * error onto not-yet-visited neighbors per `kernel`. Out-of-bounds neighbors
+ * are simply skipped (their share of the error is dropped at image edges).
+ */
+function diffuseErrorDither(image, threshold, kernel) {
+    const { width, height } = image;
+    const gray = toGrayscaleBuffer(image);
+    const output = createImageData(width, height);
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const idx = y * width + x;
+            const oldValue = gray[idx] ?? 0;
+            const newValue = oldValue > threshold ? 255 : 0;
+            const error = oldValue - newValue;
+            writeBinaryPixel(output, image, x, y, idx, newValue);
+            for (const tap of kernel) {
+                const nx = x + tap.dx;
+                const ny = y + tap.dy;
+                if (nx < 0 || nx >= width || ny < 0 || ny >= height)
+                    continue;
+                const nIdx = ny * width + nx;
+                gray[nIdx] = (gray[nIdx] ?? 0) + error * tap.weight;
+            }
+        }
+    }
+    return output;
+}
+const FLOYD_STEINBERG_KERNEL = buildKernel(16, [
+    [1, 0, 7],
+    [-1, 1, 3],
+    [0, 1, 5],
+    [1, 1, 1],
+]);
+/** Floyd-Steinberg error-diffusion dithering (Floyd & Steinberg, 1976). */
+export const ditherFloydSteinberg = (image, options) => {
+    const threshold = options.threshold ?? DEFAULT_THRESHOLD;
+    return diffuseErrorDither(image, threshold, FLOYD_STEINBERG_KERNEL);
+};
+const ATKINSON_KERNEL = buildKernel(8, [
+    [1, 0, 1],
+    [2, 0, 1],
+    [-1, 1, 1],
+    [0, 1, 1],
+    [1, 1, 1],
+    [0, 2, 1],
+]);
+/** Atkinson dithering (Bill Atkinson, Apple). Only diffuses 6/8 of the error,
+ * which intentionally clips instead of fully spreading it, giving higher local contrast. */
+export const ditherAtkinson = (image, options) => {
+    const threshold = options.threshold ?? DEFAULT_THRESHOLD;
+    return diffuseErrorDither(image, threshold, ATKINSON_KERNEL);
+};
+const JARVIS_JUDICE_NINKE_KERNEL = buildKernel(48, [
+    [1, 0, 7],
+    [2, 0, 5],
+    [-2, 1, 3],
+    [-1, 1, 5],
+    [0, 1, 7],
+    [1, 1, 5],
+    [2, 1, 3],
+    [-2, 2, 1],
+    [-1, 2, 3],
+    [0, 2, 5],
+    [1, 2, 3],
+    [2, 2, 1],
+]);
+/** Jarvis, Judice & Ninke error-diffusion dithering (1976). */
+export const ditherJarvisJudiceNinke = (image, options) => {
+    const threshold = options.threshold ?? DEFAULT_THRESHOLD;
+    return diffuseErrorDither(image, threshold, JARVIS_JUDICE_NINKE_KERNEL);
+};
+const STUCKI_KERNEL = buildKernel(42, [
+    [1, 0, 8],
+    [2, 0, 4],
+    [-2, 1, 2],
+    [-1, 1, 4],
+    [0, 1, 8],
+    [1, 1, 4],
+    [2, 1, 2],
+    [-2, 2, 1],
+    [-1, 2, 2],
+    [0, 2, 4],
+    [1, 2, 2],
+    [2, 2, 1],
+]);
+/** Stucki error-diffusion dithering (1981). */
+export const ditherStucki = (image, options) => {
+    const threshold = options.threshold ?? DEFAULT_THRESHOLD;
+    return diffuseErrorDither(image, threshold, STUCKI_KERNEL);
+};
+const SIERRA_KERNEL = buildKernel(32, [
+    [1, 0, 5],
+    [2, 0, 3],
+    [-2, 1, 2],
+    [-1, 1, 4],
+    [0, 1, 5],
+    [1, 1, 4],
+    [2, 1, 2],
+    [-1, 2, 2],
+    [0, 2, 3],
+    [1, 2, 2],
+]);
+/** Sierra error-diffusion dithering (Frankie Sierra). */
+export const ditherSierra = (image, options) => {
+    const threshold = options.threshold ?? DEFAULT_THRESHOLD;
+    return diffuseErrorDither(image, threshold, SIERRA_KERNEL);
+};
+const BURKES_KERNEL = buildKernel(32, [
+    [1, 0, 8],
+    [2, 0, 4],
+    [-2, 1, 2],
+    [-1, 1, 4],
+    [0, 1, 8],
+    [1, 1, 4],
+    [2, 1, 2],
+]);
+/** Burkes error-diffusion dithering (Daniel Burkes, 1988). */
+export const ditherBurkes = (image, options) => {
+    const threshold = options.threshold ?? DEFAULT_THRESHOLD;
+    return diffuseErrorDither(image, threshold, BURKES_KERNEL);
+};
+/**
+ * Recursively builds the NxN Bayer matrix (N a power of two) with entries
+ * 0..N^2-1, using the standard blockwise construction:
+ * M(2n) = [[4*M(n), 4*M(n)+2], [4*M(n)+3, 4*M(n)+1]]
+ */
+function buildBayerMatrix(size) {
+    if (size === 2) {
+        return [
+            [0, 2],
+            [3, 1],
+        ];
+    }
+    const half = size / 2;
+    const base = buildBayerMatrix(half);
+    const matrix = Array.from({ length: size }, () => new Array(size).fill(0));
+    for (let y = 0; y < half; y++) {
+        for (let x = 0; x < half; x++) {
+            const v = base[y]?.[x] ?? 0;
+            matrix[y][x] = 4 * v;
+            matrix[y][x + half] = 4 * v + 2;
+            matrix[y + half][x] = 4 * v + 3;
+            matrix[y + half][x + half] = 4 * v + 1;
+        }
+    }
+    return matrix;
+}
+/** Builds an NxN matrix of 0-255 dithering thresholds from the raw Bayer matrix. */
+function buildBayerThresholdMatrix(size) {
+    const raw = buildBayerMatrix(size);
+    const n2 = size * size;
+    return raw.map((row) => row.map((value) => ((value + 0.5) / n2) * 255));
+}
+/** Bayer ordered dithering: compares each pixel against a tiled NxN threshold matrix. */
+export const ditherBayer = (image, options) => {
+    const size = options.matrixSize ?? 4;
+    const thresholds = buildBayerThresholdMatrix(size);
+    const { width, height } = image;
+    const gray = toGrayscaleBuffer(image);
+    const output = createImageData(width, height);
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const idx = y * width + x;
+            const value = gray[idx] ?? 0;
+            const threshold = thresholds[y % size]?.[x % size] ?? 0;
+            const newValue = value > threshold ? 255 : 0;
+            writeBinaryPixel(output, image, x, y, idx, newValue);
+        }
+    }
+    return output;
+};
+function fractional(v) {
+    return v - Math.floor(v);
+}
+/**
+ * Blue-noise ordered dithering using Interleaved Gradient Noise (IGN) as a
+ * cheap, real-time-graphics approximation of a true blue-noise texture --
+ * this is not a void-and-cluster blue-noise dither, just visually similar.
+ */
+export const ditherBlueNoise = (image) => {
+    const { width, height } = image;
+    const gray = toGrayscaleBuffer(image);
+    const output = createImageData(width, height);
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const idx = y * width + x;
+            const value = gray[idx] ?? 0;
+            const threshold = 255 * fractional(52.9829189 * fractional(0.06711056 * x + 0.00583715 * y));
+            const newValue = value > threshold ? 255 : 0;
+            writeBinaryPixel(output, image, x, y, idx, newValue);
+        }
+    }
+    return output;
+};
+//# sourceMappingURL=dither.js.map

package/dist/filters/dither.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dither.js","sourceRoot":"","sources":["../../src/filters/dither.ts"],"names":[],"mappings":"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"}

package/dist/filters/edge-morphology.d.ts

@@ -0,0 +1,61 @@
+import type { Filter, FilterOptions } from "../types.js";
+export interface HalftoneOptions extends FilterOptions {
+    /** Grid cell size in pixels. Default 8. */
+    cellSize?: number;
+    /** Screen rotation in degrees, applied around the image center. Default 0. */
+    angle?: number;
+    /** Dot shape used to render darkness within each cell. Default "circle". */
+    shape?: "circle" | "line";
+}
+/**
+ * Classic halftone screen: grayscales the image, then renders each grid cell
+ * as a black dot/line sized proportionally to how dark that cell's source
+ * pixels were on average. Output alpha is copied from the input and plays no
+ * part in the darkness computation.
+ */
+export declare const halftone: Filter<HalftoneOptions>;
+export interface MorphologyOptions extends FilterOptions {
+    /** Neighborhood radius; the structuring element is a (2r+1)x(2r+1) square. Default 1. */
+    radius?: number;
+}
+/**
+ * Binary erosion at threshold 128: a dark pixel survives only if every pixel
+ * in its square neighborhood is also dark (out-of-bounds counts as
+ * background). Output is pure black/white; alpha is copied from the input.
+ */
+export declare const erode: Filter<MorphologyOptions>;
+/**
+ * Binary dilation at threshold 128: a background pixel becomes foreground if
+ * any pixel in its square neighborhood is dark. Output is pure black/white;
+ * alpha is copied from the input.
+ */
+export declare const dilate: Filter<MorphologyOptions>;
+/** Opening: erode then dilate, removing small isolated foreground specks. */
+export declare const morphOpen: Filter<MorphologyOptions>;
+/** Closing: dilate then erode, filling small isolated background gaps. */
+export declare const morphClose: Filter<MorphologyOptions>;
+export interface SobelEdgeOptions extends FilterOptions {
+    /**
+     * When provided, output is binarized: white where the gradient magnitude
+     * is >= threshold, black otherwise. When omitted, output is the raw
+     * grayscale magnitude map (clamped to 0-255).
+     */
+    threshold?: number;
+}
+/** Standard 3x3 Sobel edge detector on the grayscale image; alpha is copied from the input. */
+export declare const sobelEdgeDetect: Filter<SobelEdgeOptions>;
+export interface CannyEdgeOptions extends FilterOptions {
+    /** Magnitude (0-255 scale) below which a pixel is never an edge. Default 50. */
+    lowThreshold?: number;
+    /** Magnitude (0-255 scale) above which a pixel is always a strong edge. Default 100. */
+    highThreshold?: number;
+    /** Standard deviation of the Gaussian pre-blur. Default 1.4. */
+    gaussianSigma?: number;
+}
+/**
+ * Classic Canny pipeline: grayscale -> Gaussian blur -> Sobel gradients ->
+ * non-maximum suppression -> double threshold + 8-connected hysteresis.
+ * Output is pure black/white; alpha is copied from the input.
+ */
+export declare const cannyEdgeDetect: Filter<CannyEdgeOptions>;
+//# sourceMappingURL=edge-morphology.d.ts.map

package/dist/filters/edge-morphology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-morphology.d.ts","sourceRoot":"","sources":["../../src/filters/edge-morphology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA4IzD,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC3B;AAOD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,eAAe,CA6E5C,CAAC;AAEF,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,iBAAiB,CAwB3C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,iBAAiB,CAwB5C,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,iBAAiB,CACR,CAAC;AAEzC,0EAA0E;AAC1E,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,iBAAiB,CACT,CAAC;AAEzC,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,+FAA+F;AAC/F,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,CAkBpD,CAAC;AAEF,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,CAiGpD,CAAC"}