@oliversalzburg/js-utils 0.0.3 → 0.0.5

package/output/graphics/canvas.d.ts

@@ -0,0 +1,80 @@
+/// <reference types="@types/web" />
+/**
+ * A wrapper around {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement HTMLCanvasElement}
+ * to provide some convience for double-buffered drawing.
+ */
+export declare class Canvas {
+    readonly canvas: HTMLCanvasElement;
+    readonly width: number;
+    readonly height: number;
+    readonly context: CanvasRenderingContext2D;
+    readonly pixMap: ImageData;
+    readonly buffer: Uint8ClampedArray;
+    /**
+     * Constructs a new {@link Canvas}.
+     * @param canvas The canvas to wrap.
+     * @param width The width of the canvas.
+     * @param height The height of the canvas.
+     */
+    constructor(canvas: HTMLCanvasElement, width: number, height: number);
+    /**
+     * Draws the backbuffer onto the canvas.
+     */
+    update(): void;
+    /**
+     * Returns the color of a pixel in the backbuffer.
+     * @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 backbuffer.
+     * @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 backbuffer with the given color.
+     * @param color The color to fill the backbuffer with.
+     */
+    clearWith(color: number): void;
+}
+/**
+ * Linearly blends a new pixel with an existing color value in a {@link Canvas}.
+ * @param canvas The {@link 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.
+ */
+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 {@link Canvas}.
+ * @param canvas The {@link 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.
+ */
+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 {@link Canvas}.
+ * @param canvas The {@link 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.
+ */
+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 {@link Canvas}.
+ * Compared to {@link putPixel32}, this function supports sub-pixel placement, but is dramatically slower.
+ * @param canvas The {@link 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.
+ */
+export declare const putSubPixel32: (canvas: Canvas, x: number, y: number, color: number, alpha: number) => void;

package/output/graphics/canvas.js

@@ -0,0 +1,164 @@
+import { mustExist } from "../nil.js";
+import { blend, blendAdditive, blendSubtractive, fromRGBA, getA, getB, getG, getR, } from "./core.js";
+/**
+ * A wrapper around {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement HTMLCanvasElement}
+ * to provide some convience for double-buffered drawing.
+ */
+export class Canvas {
+    canvas;
+    width;
+    height;
+    context;
+    pixMap;
+    buffer;
+    /**
+     * Constructs a new {@link Canvas}.
+     * @param canvas The canvas to wrap.
+     * @param width The width of the canvas.
+     * @param height The height of the canvas.
+     */
+    constructor(canvas, width, height) {
+        this.canvas = canvas;
+        this.width = width;
+        this.height = height;
+        this.context = mustExist(this.canvas.getContext("2d"), "Unable to create rendering context.");
+        this.pixMap = this.context.createImageData(width, height);
+        this.buffer = this.pixMap.data;
+        this.context.font = "12px sans-serif";
+    }
+    /**
+     * Draws the backbuffer onto the canvas.
+     */
+    update() {
+        this.context.putImageData(this.pixMap, 0, 0);
+    }
+    /**
+     * Returns the color of a pixel in the backbuffer.
+     * @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) {
+        const bufferOffset = Math.trunc((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 backbuffer.
+     * @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) {
+        const bufferOffset = Math.trunc((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 backbuffer with the given color.
+     * @param color The color to fill the backbuffer with.
+     */
+    clearWith(color) {
+        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;
+        }
+    }
+}
+/**
+ * Linearly blends a new pixel with an existing color value in a {@link Canvas}.
+ * @param canvas The {@link 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.
+ */
+export const putPixel32 = (canvas, x, y, color, alpha) => {
+    if (canvas.width < x || x < 0 || canvas.height < y || y < 0) {
+        return;
+    }
+    x = Math.trunc(x);
+    y = Math.trunc(y);
+    if (alpha > 255) {
+        alpha = 255;
+    }
+    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 {@link Canvas}.
+ * @param canvas The {@link 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.
+ */
+export const putPixel32Add = (canvas, x, y, color, alpha) => {
+    if (canvas.width < x || x < 0 || canvas.height < y || y < 0) {
+        return;
+    }
+    x = Math.round(x);
+    y = Math.round(y);
+    if (alpha > 255) {
+        alpha = 255;
+    }
+    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 {@link Canvas}.
+ * @param canvas The {@link 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.
+ */
+export const putPixel32Sub = (canvas, x, y, color, alpha) => {
+    if (canvas.width < x || x < 0 || canvas.height < y || y < 0) {
+        return;
+    }
+    x = Math.round(x);
+    y = Math.round(y);
+    if (alpha > 255) {
+        alpha = 255;
+    }
+    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 {@link Canvas}.
+ * Compared to {@link putPixel32}, this function supports sub-pixel placement, but is dramatically slower.
+ * @param canvas The {@link 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.
+ */
+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.js.map

package/output/graphics/canvas.js.map

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

package/output/graphics/core.d.ts

@@ -0,0 +1,94 @@
+export declare const PALETTES: number[][];
+/**
+ * Constrains a color component value to single-byte range (`0`-`255`).
+ * @param c A color component value.
+ * @returns The input value constrained into single-byte range.
+ */
+export declare const safeRGBComponent: (c: number) => number;
+/**
+ * Constructs a 32bit integer value that represents an RGBA color value.
+ * @param r The R component.
+ * @param g The G component.
+ * @param b The B component.
+ * @param a The A component.
+ * @returns The constructed color value.
+ */
+export declare const fromRGBA: (r: number, g: number, b: number, a: number) => number;
+/**
+ * Constructs a 32bit integer value that represents an RGBA color value.
+ * The A component is fixed to `255`
+ * @param r The R component.
+ * @param g The G component.
+ * @param b The B component.
+ * @returns The constructed color value.
+ */
+export declare const fromRGB: (r: number, g: number, b: number) => number;
+/**
+ * Extracts the R component from a color value.
+ * @param color The color value.
+ * @returns The R component of the color value.
+ */
+export declare const getR: (color: number) => number;
+/**
+ * Extracts the G component from a color value.
+ * @param color The color value.
+ * @returns The G component of the color value.
+ */
+export declare const getG: (color: number) => number;
+/**
+ * Extracts the B component from a color value.
+ * @param color The color value.
+ * @returns The B component of the color value.
+ */
+export declare const getB: (color: number) => number;
+/**
+ * Extracts the A component from a color value.
+ * @param color The color value.
+ * @returns The A component of the color value.
+ */
+export declare const getA: (color: number) => number;
+/**
+ * Returns a new color that is a blend between a source and a destination
+ * color linerally. The alpha component in these colors is ignored. Instead, the provided
+ * `alpha` value is used to blend between the two colors.
+ * @param src The source color.
+ * @param dst The destination color.
+ * @param alpha The alpha value to use for blending.
+ * @returns The blended color.
+ */
+export declare const blend: (src: number, dst: number, alpha: number) => number;
+/**
+ * Returns a new color that is a blend between a source and a destination
+ * color additively. The alpha component in these colors is ignored. Instead, the provided
+ * `alpha` value is used to blend between the two colors.
+ * @param src The source color.
+ * @param dst The destination color.
+ * @param alpha The alpha value to use for blending.
+ * @returns The blended color.
+ */
+export declare const blendAdditive: (src: number, dst: number, alpha: number) => number;
+/**
+ * Returns a new color that is a blend between a source and a destination
+ * color subtractively. The alpha component in these colors is ignored. Instead, the provided
+ * `alpha` value is used to blend between the two colors.
+ * @param src The source color.
+ * @param dst The destination color.
+ * @param alpha The alpha value to use for blending.
+ * @returns The blended color.
+ */
+export declare const blendSubtractive: (src: number, dst: number, alpha: number) => number;
+/**
+ * Retrieves a random color from the current global palette.
+ * @returns A random color.
+ */
+export declare const somecolor: () => number;
+/**
+ * Switches the global palette to the next available preset.
+ */
+export declare const nextPalette: () => void;
+/**
+ * Converts a color value to grayscale.
+ * @param color The color to convert.
+ * @returns The grayscale value appropriate for the color.
+ */
+export declare const toGrayScale: (color: number) => number;