@oliversalzburg/js-utils 0.0.13 → 0.0.15

package/lib/Async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Async.js","sourceRoot":"","sources":["../source/Async.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,OAA+B,EAC/B,OAAkC,EAClC,MAA+B,EAC/B,EAAE;IACF,OAAO,KAAK,OAAO,EAAE;SAClB,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;SAClC,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAA+B,EAAE,EAAE;IACrE,OAAO,GAAG,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,UAAmE,EACnE,EAAK,EACL,EAAE;IACF,IAAI;QACF,OAAO,MAAM,UAAU,EAAE,CAAC;KAC3B;IAAC,OAAO,KAAK,EAAE;QACd,OAAO,EAAE,CAAC;KACX;AACH,CAAC,CAAC"}

package/lib/async.d.ts

@@ -0,0 +1,24 @@
+import { AnyAsyncFunction, FunctionReturning } from "./core.js";
+/**
+ * Wraps the given asynchronous function in a new function that will ignore any outcome of
+ * the context as it resolves.
+ *
+ * This can be useful when providing asynchonous event handler to `.addEventlistener()`,
+ * which only expects synchronous functions.
+ * @param context The asynchronous function to exectute.
+ * @returns A function returning nothing.
+ * @group Async
+ */
+export declare const prepareAsyncContext: (context: AnyAsyncFunction) => (() => void);
+/**
+ * Executes an asynchronous function and resolves with an alternative result
+ * in case the function failed.
+ * @param executable The asynchronous function to execute.
+ * @param to The result we want to return when the function errors.
+ * @template {unknown} TExecutableReturn The return type of the function.
+ * @template {unknown} TCoalesce The type of the object to coalesce to.
+ * @returns Whatever the function resolved to, or the provided replacement,
+ * in case the function failed.
+ * @group Async
+ */
+export declare const coalesceOnRejection: <TExecutableReturn, TCoalesce>(executable: FunctionReturning<Promise<TExecutableReturn>>, to: TCoalesce) => Promise<TExecutableReturn | TCoalesce>;

package/lib/async.js

@@ -0,0 +1,37 @@
+/**
+ * Wraps the given asynchronous function in a new function that will ignore any outcome of
+ * the context as it resolves.
+ *
+ * This can be useful when providing asynchonous event handler to `.addEventlistener()`,
+ * which only expects synchronous functions.
+ * @param context The asynchronous function to exectute.
+ * @returns A function returning nothing.
+ * @group Async
+ */
+export const prepareAsyncContext = (context) => {
+    return () => {
+        void context()
+            .then(() => undefined)
+            .catch(() => undefined);
+    };
+};
+/**
+ * Executes an asynchronous function and resolves with an alternative result
+ * in case the function failed.
+ * @param executable The asynchronous function to execute.
+ * @param to The result we want to return when the function errors.
+ * @template {unknown} TExecutableReturn The return type of the function.
+ * @template {unknown} TCoalesce The type of the object to coalesce to.
+ * @returns Whatever the function resolved to, or the provided replacement,
+ * in case the function failed.
+ * @group Async
+ */
+export const coalesceOnRejection = async (executable, to) => {
+    try {
+        return await executable();
+    }
+    catch (error) {
+        return to;
+    }
+};
+//# sourceMappingURL=async.js.map

package/lib/async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.js","sourceRoot":"","sources":["../source/async.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAyB,EAAgB,EAAE;IAC7E,OAAO,GAAG,EAAE;QACV,KAAK,OAAO,EAAE;aACX,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;aACrB,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,UAAyD,EACzD,EAAa,EACb,EAAE;IACF,IAAI;QACF,OAAO,MAAM,UAAU,EAAE,CAAC;KAC3B;IAAC,OAAO,KAAK,EAAE;QACd,OAAO,EAAE,CAAC;KACX;AACH,CAAC,CAAC"}

package/lib/core.d.ts

@@ -6,6 +6,10 @@ export type ConstructorOf<T = Record<string, unknown>> = new (...args: Array<any
  * Describes literally any function.
  */
 export type AnyFunction = (...args: Array<any>) => any;
+/**
+ * Describes literally any asynchronous function.
+ */
+export type AnyAsyncFunction = (...args: Array<any>) => Promise<any>;
 /**
  * Any constructor
  */

package/lib/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../source/core.ts"],"names":[],"mappings":"AAAA,uDAAuD;AA4BvD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,IAAY,EAAU,EAAE;IAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC,CAAC"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../source/core.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAiCvD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,IAAY,EAAU,EAAE;IAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC,CAAC"}

package/lib/graphics/canvas copy.d.ts

@@ -0,0 +1,170 @@
+/// <reference types="@types/web" />
+/**
+ * Construction options for a {@linkcode Canvas}.
+ * @group Graphics
+ */
+export interface CanvasOptions {
+    /**
+     * Was this {@linkcode Canvas} created with the ability to copy the front buffer back into
+     * the back buffer?
+     */
+    readonly supportReadBack: boolean;
+}
+/**
+ * The {@linkcode Canvas} is a double-buffered construct to help with drawing to a
+ * {@linkcode !HTMLCanvasElement} with best possible performance.
+ * We utilize an {@linkcode !OffscreenCanvas} with a {@linkcode !OffscreenCanvasRenderingContext2D}
+ * to draw frames and expect to render them back to the DOM in regular intervals.
+ * @group Graphics
+ */
+export declare class Canvas {
+    #private;
+    /**
+     * The {@linkcode !HTMLCanvasElement} we're interacting with in the DOM.
+     */
+    readonly canvasDom: HTMLCanvasElement | undefined;
+    /**
+     * The width of the canvas.
+     */
+    readonly width: number;
+    /**
+     * The height of the canvas.
+     */
+    readonly height: number;
+    /**
+     * The {@linkcode !OffscreenCanvasRenderingContext2D} we're using to draw to the canvas.
+     */
+    readonly context: OffscreenCanvasRenderingContext2D | undefined;
+    /**
+     * Our back buffer.
+     */
+    buffer: Uint8ClampedArray | undefined;
+    /**
+     * The configuration that was used for this canvas.
+     */
+    readonly options: Readonly<Partial<CanvasOptions>>;
+    constructor(canvas: OffscreenCanvas);
+    /**
+     * Constructs a new {@linkcode Canvas}.
+     * @param canvas The canvas to wrap.
+     * @param worker
+     * @param options The configuration for this canvas.
+     */
+    constructor(canvas: HTMLCanvasElement, worker: Worker, options?: Partial<CanvasOptions>);
+    static reconstruct(canvasOffscreen: OffscreenCanvas): Canvas;
+    /**
+     * Draws the back buffer onto the canvas.
+     */
+    update(): void;
+    /**
+     * Draws the offscreen canvas into the DOM canvas.
+     */
+    render(): void;
+    /**
+     * Draws a slightly transparent, black rectangle over the canvas,
+     * and then reads the result back into the buffer.
+     * @param color The color to fade the buffer with. The alpha component of
+     * the color defines how strong the fade is. `0` is not at all, `255` makes
+     * it instantly black.
+     */
+    fade(color?: number): void;
+    /**
+     * Reads the front buffer back into the back buffer.
+     */
+    bufferReadBack(): void;
+    /**
+     * Returns the color of a pixel in the back buffer.
+     * @param x The X coordinate to retrieve.
+     * @param y The X coordinate to retrieve.
+     * @returns The color of the pixel at the given local.
+     */
+    getPixel32(x: number, y: number): number;
+    /**
+     * Colors a pixel in the back buffer.
+     * @param x The X coordinate to color.
+     * @param y The Y coordinate to color.
+     * @param color The color to place at the coordinate.
+     */
+    setPixel32(x: number, y: number, color: number): void;
+    /**
+     * Fills the entire back buffer with the given color.
+     * @param color The color to fill the back buffer with.
+     */
+    clearWith(color: number): void;
+    /**
+     * Fills the entire back buffer with the given color.
+     * @param color The color to fill the back buffer with.
+     */
+    blendWith(color: number): void;
+}
+/**
+ * Linearly blends a new pixel with an existing color value in a {@linkcode Canvas}.
+ *
+ * As this method is often called many times in render loops, only bounds
+ * checking is applied to the given coordinates.
+ *
+ * The coordinates are **expected to already be integers**. Supplying numbers with fractions
+ * has performance implications. Ensure you're working with integers, or truncate the
+ * coordinates before passing them in.
+ *
+ * The `alpha` value is expected to be an integer in the range from `0` to `255`.
+ * `0` meaning fully transparent, `255` meaning fully opaque.
+ * @param canvas The {@linkcode Canvas} to interact with.
+ * @param x The X coordinate at which to place the pixel.
+ * @param y The Y coordinate at which to place the pixel.
+ * @param color The color of the pixel.
+ * @param alpha The alpha value to use to blend the pixel with existing color at the location.
+ * @group Graphics
+ */
+export declare const putPixel32: (canvas: Canvas, x: number, y: number, color: number, alpha: number) => void;
+/**
+ * Additively blends a new pixel with an existing color value in a {@linkcode Canvas}.
+ *
+ * As this method is often called many times in render loops, only bounds
+ * checking is applied to the given coordinates.
+ *
+ * The coordinates are **expected to already be integers**. Supplying numbers with fractions
+ * has performance implications. Ensure you're working with integers, or truncate the
+ * coordinates before passing them in.
+ *
+ * The `alpha` value is expected to be an integer in the range from `0` to `255`.
+ * `0` meaning fully transparent, `255` meaning fully opaque.
+ * @param canvas The {@linkcode Canvas} to interact with.
+ * @param x The X coordinate at which to place the pixel.
+ * @param y The Y coordinate at which to place the pixel.
+ * @param color The color of the pixel.
+ * @param alpha The alpha value to use to blend the pixel with existing color at the location.
+ * @group Graphics
+ */
+export declare const putPixel32Add: (canvas: Canvas, x: number, y: number, color: number, alpha: number) => void;
+/**
+ * Subtractively blends a new pixel with an existing color value in a {@linkcode Canvas}.
+ *
+ * As this method is often called many times in render loops, only bounds
+ * checking is applied to the given coordinates.
+ *
+ * The coordinates are **expected to already be integers**. Supplying numbers with fractions
+ * has performance implications. Ensure you're working with integers, or truncate the
+ * coordinates before passing them in.
+ *
+ * The `alpha` value is expected to be an integer in the range from `0` to `255`.
+ * `0` meaning fully transparent, `255` meaning fully opaque.
+ * @param canvas The {@linkcode Canvas} to interact with.
+ * @param x The X coordinate at which to place the pixel.
+ * @param y The Y coordinate at which to place the pixel.
+ * @param color The color of the pixel.
+ * @param alpha The alpha value to use to blend the pixel with existing color at the location.
+ * @group Graphics
+ */
+export declare const putPixel32Sub: (canvas: Canvas, x: number, y: number, color: number, alpha: number) => void;
+/**
+ * Linearly blends a new pixel with an existing color value in a {@linkcode Canvas}.
+ * Compared to {@linkcode putPixel32}, this function supports sub-pixel placement, but is dramatically slower.
+ * @param canvas The {@linkcode Canvas} to interact with.
+ * @param x The X coordinate at which to place the pixel.
+ * @param y The Y coordinate at which to place the pixel.
+ * @param color The color of the pixel.
+ * @param alpha The alpha value to use to blend the pixel with existing color at the location.
+ * @group Graphics
+ */
+export declare const putSubPixel32: (canvas: Canvas, x: number, y: number, color: number, alpha: number) => void;

package/lib/graphics/canvas copy.js

@@ -0,0 +1,300 @@
+import { InvalidOperationError } from "../errors/InvalidOperationError.js";
+import { mustExist } from "../nil.js";
+import { blend, blendAdditive, blendSubtractive, fromRGBA, getA, getB, getG, getR, } from "./core.js";
+/**
+ * The {@linkcode Canvas} is a double-buffered construct to help with drawing to a
+ * {@linkcode !HTMLCanvasElement} with best possible performance.
+ * We utilize an {@linkcode !OffscreenCanvas} with a {@linkcode !OffscreenCanvasRenderingContext2D}
+ * to draw frames and expect to render them back to the DOM in regular intervals.
+ * @group Graphics
+ */
+export class Canvas {
+    /**
+     * The {@linkcode !HTMLCanvasElement} we're interacting with in the DOM.
+     */
+    canvasDom;
+    /**
+     * The rendering context for the canvas located in the DOM.
+     */
+    //#canvasDomContext: ImageBitmapRenderingContext;
+    /**
+     * The offscreen canvas we use for rendering.
+     */
+    #canvasOffscreen;
+    /**
+     * The width of the canvas.
+     */
+    width;
+    /**
+     * The height of the canvas.
+     */
+    height;
+    /**
+     * The {@linkcode !OffscreenCanvasRenderingContext2D} we're using to draw to the canvas.
+     */
+    context;
+    /**
+     * The {@linkcode !ImageData} object in our offscreen canvas. We usually interact with its
+     * {@linkcode Canvas.buffer buffer} directly.
+     */
+    #imageData;
+    /**
+     * Our back buffer.
+     */
+    buffer;
+    /**
+     * The configuration that was used for this canvas.
+     */
+    options;
+    constructor(canvas, worker, options) {
+        this.width = canvas.width;
+        this.height = canvas.height;
+        // @ts-expect-error this is fucked
+        if (canvas["__proto__"].toString().includes("HTMLCanvasElement")) {
+            this.options = options ?? {};
+            this.canvasDom = canvas;
+            //this.#canvasDomContext = mustExist(
+            //  this.canvasDom.getContext("bitmaprenderer", {
+            //    alpha: false,
+            //  }),
+            //  "Unable to create rendering context for DOM canvas.",
+            //);
+            this.#canvasOffscreen = this.canvasDom.transferControlToOffscreen();
+            //this.context.font = "12px sans-serif";
+            mustExist(worker).postMessage({ id: "init", canvas: this.#canvasOffscreen }, [
+                this.#canvasOffscreen,
+            ]);
+        }
+        else {
+            this.options = options ?? {};
+            this.#canvasOffscreen = canvas;
+            this.context = mustExist(this.#canvasOffscreen.getContext("2d", {
+                alpha: false,
+                desynchronized: false,
+                //willReadFrequently: this.options.supportReadBack,
+            }), "Unable to create rendering context for offscreen canvas.");
+            this.#imageData = this.context.createImageData(this.width, this.height);
+            this.buffer = this.#imageData.data;
+        }
+    }
+    static reconstruct(canvasOffscreen) {
+        const instance = new Canvas(canvasOffscreen);
+        return instance;
+    }
+    /**
+     * Draws the back buffer onto the canvas.
+     */
+    update() {
+        if (!this.context || !this.#imageData) {
+            return;
+        }
+        this.context.putImageData(this.#imageData, 0, 0);
+    }
+    /**
+     * Draws the offscreen canvas into the DOM canvas.
+     */
+    render() {
+        this.update();
+        return;
+        //const newFrame = this.#canvasOffscreen.transferToImageBitmap();
+        //this.#canvasDomContext.transferFromImageBitmap(newFrame);
+    }
+    /**
+     * Draws a slightly transparent, black rectangle over the canvas,
+     * and then reads the result back into the buffer.
+     * @param color The color to fade the buffer with. The alpha component of
+     * the color defines how strong the fade is. `0` is not at all, `255` makes
+     * it instantly black.
+     */
+    fade(color = fromRGBA(0, 0, 0, 1)) {
+        this.blendWith(color);
+    }
+    /**
+     * Reads the front buffer back into the back buffer.
+     */
+    bufferReadBack() {
+        if (!this.options.supportReadBack) {
+            throw new InvalidOperationError("To use `bufferReadBack()`, you must construct the `Canvas` with `options.supportReadBack` set to `true`.");
+        }
+        if (!this.context) {
+            return;
+        }
+        this.#imageData = this.context.getImageData(0, 0, this.width, this.height);
+        this.buffer = this.#imageData.data;
+    }
+    /**
+     * Returns the color of a pixel in the back buffer.
+     * @param x The X coordinate to retrieve.
+     * @param y The X coordinate to retrieve.
+     * @returns The color of the pixel at the given local.
+     */
+    getPixel32(x, y) {
+        if (!this.buffer) {
+            return 0;
+        }
+        const bufferOffset = (x + y * this.width) * 4;
+        return fromRGBA(this.buffer[bufferOffset + 0], this.buffer[bufferOffset + 1], this.buffer[bufferOffset + 2], this.buffer[bufferOffset + 3]);
+    }
+    /**
+     * Colors a pixel in the back buffer.
+     * @param x The X coordinate to color.
+     * @param y The Y coordinate to color.
+     * @param color The color to place at the coordinate.
+     */
+    setPixel32(x, y, color) {
+        if (!this.buffer) {
+            return;
+        }
+        const bufferOffset = (x + y * this.width) * 4;
+        this.buffer[bufferOffset + 0] = getR(color);
+        this.buffer[bufferOffset + 1] = getG(color);
+        this.buffer[bufferOffset + 2] = getB(color);
+        this.buffer[bufferOffset + 3] = getA(color);
+    }
+    /**
+     * Fills the entire back buffer with the given color.
+     * @param color The color to fill the back buffer with.
+     */
+    clearWith(color) {
+        if (!this.buffer) {
+            return;
+        }
+        const r = getR(color);
+        const g = getG(color);
+        const b = getB(color);
+        const a = getA(color);
+        for (let bufferOffset = 0; bufferOffset < this.width * this.height * 4; bufferOffset += 4) {
+            this.buffer[bufferOffset + 0] = r;
+            this.buffer[bufferOffset + 1] = g;
+            this.buffer[bufferOffset + 2] = b;
+            this.buffer[bufferOffset + 3] = a;
+        }
+    }
+    /**
+     * Fills the entire back buffer with the given color.
+     * @param color The color to fill the back buffer with.
+     */
+    blendWith(color) {
+        if (!this.buffer) {
+            return;
+        }
+        const r = getR(color);
+        const g = getG(color);
+        const b = getB(color);
+        const a = getA(color);
+        for (let bufferOffset = 0; bufferOffset < this.width * this.height * 4; bufferOffset += 4) {
+            this.buffer[bufferOffset + 0] = (a * r + (255 - a) * this.buffer[bufferOffset + 0]) >> 8;
+            this.buffer[bufferOffset + 1] = (a * g + (255 - a) * this.buffer[bufferOffset + 1]) >> 8;
+            this.buffer[bufferOffset + 2] = (a * b + (255 - a) * this.buffer[bufferOffset + 2]) >> 8;
+        }
+    }
+}
+/**
+ * Linearly blends a new pixel with an existing color value in a {@linkcode Canvas}.
+ *
+ * As this method is often called many times in render loops, only bounds
+ * checking is applied to the given coordinates.
+ *
+ * The coordinates are **expected to already be integers**. Supplying numbers with fractions
+ * has performance implications. Ensure you're working with integers, or truncate the
+ * coordinates before passing them in.
+ *
+ * The `alpha` value is expected to be an integer in the range from `0` to `255`.
+ * `0` meaning fully transparent, `255` meaning fully opaque.
+ * @param canvas The {@linkcode Canvas} to interact with.
+ * @param x The X coordinate at which to place the pixel.
+ * @param y The Y coordinate at which to place the pixel.
+ * @param color The color of the pixel.
+ * @param alpha The alpha value to use to blend the pixel with existing color at the location.
+ * @group Graphics
+ */
+export const putPixel32 = (canvas, x, y, color, alpha) => {
+    if (canvas.width < x || x < 0 || canvas.height < y || y < 0) {
+        return;
+    }
+    const srcColor = canvas.getPixel32(x, y);
+    const newColor = blend(srcColor, color, alpha);
+    canvas.setPixel32(x, y, newColor);
+};
+/**
+ * Additively blends a new pixel with an existing color value in a {@linkcode Canvas}.
+ *
+ * As this method is often called many times in render loops, only bounds
+ * checking is applied to the given coordinates.
+ *
+ * The coordinates are **expected to already be integers**. Supplying numbers with fractions
+ * has performance implications. Ensure you're working with integers, or truncate the
+ * coordinates before passing them in.
+ *
+ * The `alpha` value is expected to be an integer in the range from `0` to `255`.
+ * `0` meaning fully transparent, `255` meaning fully opaque.
+ * @param canvas The {@linkcode Canvas} to interact with.
+ * @param x The X coordinate at which to place the pixel.
+ * @param y The Y coordinate at which to place the pixel.
+ * @param color The color of the pixel.
+ * @param alpha The alpha value to use to blend the pixel with existing color at the location.
+ * @group Graphics
+ */
+export const putPixel32Add = (canvas, x, y, color, alpha) => {
+    if (canvas.width < x || x < 0 || canvas.height < y || y < 0) {
+        return;
+    }
+    const srcColor = canvas.getPixel32(x, y);
+    const newColor = blendAdditive(srcColor, color, alpha);
+    canvas.setPixel32(x, y, newColor);
+};
+/**
+ * Subtractively blends a new pixel with an existing color value in a {@linkcode Canvas}.
+ *
+ * As this method is often called many times in render loops, only bounds
+ * checking is applied to the given coordinates.
+ *
+ * The coordinates are **expected to already be integers**. Supplying numbers with fractions
+ * has performance implications. Ensure you're working with integers, or truncate the
+ * coordinates before passing them in.
+ *
+ * The `alpha` value is expected to be an integer in the range from `0` to `255`.
+ * `0` meaning fully transparent, `255` meaning fully opaque.
+ * @param canvas The {@linkcode Canvas} to interact with.
+ * @param x The X coordinate at which to place the pixel.
+ * @param y The Y coordinate at which to place the pixel.
+ * @param color The color of the pixel.
+ * @param alpha The alpha value to use to blend the pixel with existing color at the location.
+ * @group Graphics
+ */
+export const putPixel32Sub = (canvas, x, y, color, alpha) => {
+    if (canvas.width < x || x < 0 || canvas.height < y || y < 0) {
+        return;
+    }
+    const srcColor = canvas.getPixel32(x, y);
+    const newColor = blendSubtractive(srcColor, color, alpha);
+    canvas.setPixel32(x, y, newColor);
+};
+/**
+ * Linearly blends a new pixel with an existing color value in a {@linkcode Canvas}.
+ * Compared to {@linkcode putPixel32}, this function supports sub-pixel placement, but is dramatically slower.
+ * @param canvas The {@linkcode Canvas} to interact with.
+ * @param x The X coordinate at which to place the pixel.
+ * @param y The Y coordinate at which to place the pixel.
+ * @param color The color of the pixel.
+ * @param alpha The alpha value to use to blend the pixel with existing color at the location.
+ * @group Graphics
+ */
+export const putSubPixel32 = (canvas, x, y, color, alpha) => {
+    if (canvas.width < x || x < 0 || canvas.height < y || y < 0) {
+        return;
+    }
+    const xweight = x - Math.trunc(x);
+    const yweight = y - Math.trunc(y);
+    const xweightn = 1 - xweight;
+    const yweightn = 1 - yweight;
+    const alpha0 = xweightn * yweightn * alpha;
+    const alpha1 = xweight * yweightn * alpha;
+    const alpha2 = xweightn * yweight * alpha;
+    const alpha3 = xweight * yweight * alpha;
+    putPixel32(canvas, x + 0, y + 0, color, alpha0);
+    putPixel32(canvas, x + 1, y + 0, color, alpha1);
+    putPixel32(canvas, x + 0, y + 1, color, alpha2);
+    putPixel32(canvas, x + 1, y + 1, color, alpha3);
+};
+//# sourceMappingURL=canvas%20copy.js.map

package/lib/graphics/canvas copy.js.map

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