sweetcorn 0.2.1 → 0.2.2

package/dist/custom-processors.d.ts

@@ -0,0 +1,6 @@
+import { ArrayOrBuffer } from './types.js';
+/**
+ * A collection of pixel mutation processors that deviate from the standardized threshold map and
+ * error diffusion algorithms.
+ */
+export declare const customProcessors: Record<'white-noise' | 'threshold', (pixels: ArrayOrBuffer<number>) => void>;

package/dist/custom-processors.js

@@ -0,0 +1,25 @@
+/**
+ * A collection of pixel mutation processors that deviate from the standardized threshold map and
+ * error diffusion algorithms.
+ */
+export const customProcessors = {
+    /**
+     * White noise dithering (pretty rough and ugly)
+     */
+    'white-noise'(pixels) {
+        for (let index = 0; index < pixels.length; index++) {
+            const pixelValue = pixels[index];
+            pixels[index] = pixelValue / 255 < Math.random() ? 0 : 255;
+        }
+    },
+    /**
+     * Basic quantization. This could be represented as a threshold map of `[[128]]` but defining it
+     * like this allows it to be implemented more efficiently.
+     */
+    threshold(pixels) {
+        for (let index = 0; index < pixels.length; index++) {
+            const pixelValue = pixels[index];
+            pixels[index] = pixelValue < 128 ? 0 : 255;
+        }
+    },
+};

package/dist/index.js

@@ -1,5 +1,6 @@
-import { applyDiffusionKernel, applyThresholdMap } from './processors.js';
+import { customProcessors } from './custom-processors.js';
 import diffusionKernels from './diffusion-kernels.js';
+import { applyDiffusionKernel, applyThresholdMap } from './processors.js';
 import thresholdMaps from './threshold-maps.json' with { type: 'json' };
 let sharp;
 async function loadSharp() {
@@ -21,6 +22,8 @@ async function loadSharp() {
  * @returns A new Sharp image instance.
  */
 export default async function sweetcorn(image, options) {
+    // Clone the input image to avoid mutating it.
+    image = image.clone();
     const { algorithm } = options;
     if (!sharp)
         sharp = await loadSharp();
@@ -28,30 +31,20 @@ export default async function sweetcorn(image, options) {
     // We use gamma to linearize the colorspace, and improve the perceptual quality.
     image.gamma(2.2, 1).greyscale();
     // Get raw pixel data for this image.
-    const rawPixels = await image.raw().toBuffer({ resolveWithObject: true });
+    const { data: pixels, info } = await image.raw().toBuffer({ resolveWithObject: true });
     const thresholdMap = options.thresholdMap || thresholdMaps[algorithm];
     const diffusionKernel = options.diffusionKernel || diffusionKernels[algorithm];
+    const customProcessor = customProcessors[algorithm];
     if (thresholdMap) {
-        applyThresholdMap(rawPixels.data, rawPixels.info.width, thresholdMap);
+        applyThresholdMap(pixels, info.width, thresholdMap);
     }
     else if (diffusionKernel) {
-        applyDiffusionKernel(rawPixels.data, rawPixels.info.width, rawPixels.info.height, diffusionKernel);
-    }
-    else if (algorithm === 'white-noise') {
-        // White noise dithering (pretty rough and ugly)
-        for (let index = 0; index < rawPixels.data.length; index++) {
-            const pixelValue = rawPixels.data[index];
-            rawPixels.data[index] = pixelValue / 255 < Math.random() ? 0 : 255;
-        }
+        applyDiffusionKernel(pixels, info.width, info.height, diffusionKernel);
     }
-    else if (algorithm === 'threshold') {
-        // Basic quantization
-        for (let index = 0; index < rawPixels.data.length; index++) {
-            const pixelValue = rawPixels.data[index];
-            rawPixels.data[index] = pixelValue < 128 ? 0 : 255;
-        }
+    else if (customProcessor) {
+        customProcessor(pixels);
     }
     // Convert raw pixel data back into a Sharp image.
-    const outputImage = sharp(rawPixels.data, { raw: rawPixels.info });
+    const outputImage = sharp(pixels, { raw: info });
     return outputImage;
 }

package/dist/processors.d.ts

@@ -1,10 +1,5 @@
-/** Any array-like structure indexed by numbers and with a `length`, e.g. an `Array` or `Buffer`. */
-interface ArrayOrBuffer<T> {
-    length: number;
-    [n: number]: T;
-}
+import { ArrayOrBuffer } from './types.js';
 /** Applies a threshold map to raw pixel data for ordered dithering. */
 export declare function applyThresholdMap(pixels: ArrayOrBuffer<number>, width: number, map: number[][]): void;
 /** Applies an error diffusion kernel to raw pixel data. */
 export declare function applyDiffusionKernel(pixels: ArrayOrBuffer<number>, width: number, height: number, kernel: number[][]): void;
-export {};

package/dist/threshold-maps.json

@@ -125,11 +125,6 @@
         [224, 140, 56, 14, 98, 182],
         [238, 154, 70, 28, 112, 196]
     ],
-    "dot-vertical-5x3": [
-        [153, 51, 0, 102, 204],
-        [170, 68, 17, 119, 221],
-        [187, 85, 34, 136, 238]
-    ],
     "dot-horizontal-3x5": [
         [153, 170, 187],
         [51, 68, 85],
@@ -137,6 +132,33 @@
         [102, 119, 136],
         [204, 221, 238]
     ],
+    "dot-vertical-5x3": [
+        [153, 51, 0, 102, 204],
+        [170, 68, 17, 119, 221],
+        [187, 85, 34, 136, 238]
+    ],
+    "horizontal-checkers-6": [
+        [245, 231, 217, 210, 224, 238, 35, 21, 7, 0, 14, 28],
+        [161, 147, 133, 126, 140, 154, 119, 105, 91, 84, 98, 112],
+        [77, 63, 49, 42, 56, 70, 203, 189, 175, 168, 182, 196],
+        [35, 21, 7, 0, 14, 28, 245, 231, 217, 210, 224, 238],
+        [119, 105, 91, 84, 98, 112, 161, 147, 133, 126, 140, 154],
+        [203, 189, 175, 168, 182, 196, 77, 63, 49, 42, 56, 70]
+    ],
+    "vertical-checkers-6": [
+        [245, 161, 77, 35, 119, 203],
+        [231, 147, 63, 21, 105, 189],
+        [217, 133, 49, 7, 91, 175],
+        [210, 126, 42, 0, 84, 168],
+        [224, 140, 56, 14, 98, 182],
+        [238, 154, 70, 28, 112, 196],
+        [35, 119, 203, 245, 161, 77],
+        [21, 105, 189, 231, 147, 63],
+        [7, 91, 175, 217, 133, 49],
+        [0, 84, 168, 210, 126, 42],
+        [14, 98, 182, 224, 140, 56],
+        [28, 112, 196, 238, 154, 70]
+    ],
     "blue-noise": [
         [
             134, 22, 92, 59, 163, 190, 12, 155, 181, 119, 233, 47, 175, 12, 113, 141, 47, 183, 111, 196,

package/dist/types.d.ts

@@ -37,3 +37,8 @@ export interface SweetcornOptions {
      */
     diffusionKernel?: number[][] | undefined;
 }
+/** Any array-like structure indexed by numbers and with a `length`, e.g. an `Array` or `Buffer`. */
+export interface ArrayOrBuffer<T> {
+    length: number;
+    [n: number]: T;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sweetcorn",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "license": "MIT",
   "description": "JavaScript image dithering tools for Sharp",
   "keywords": [