@realsee/equirect-toolbox 1.0.0

package/README.md

@@ -0,0 +1,184 @@
+# @realsee/equirect-toolbox
+
+Node.js command-line tools for working with equirectangular panoramas. The package can render perspective (rectlinear) screenshots and convert between equirectangular images and six-face cube maps.
+
+## Features
+
+- Render a perspective screenshot from an equirectangular panorama with Euler angles, a rotation matrix, or a quaternion.
+- Convert an equirectangular panorama to six cube-face images.
+- Convert six cube-face images described by a `cube.json` manifest back to an equirectangular panorama.
+- Run from npm without a browser or a separate Three.js application.
+
+## Requirements
+
+- Node.js 20 or 22. The supported range is declared as `^20 || ^22` in `package.json`.
+- A platform supported by the native dependencies `gl` and `@napi-rs/canvas`.
+
+## Installation
+
+Install the package in a project:
+
+```bash
+npm install @realsee/equirect-toolbox
+```
+
+The package provides the `equirect-toolbox` executable. It can be invoked with `npx`:
+
+```bash
+npx equirect-toolbox --help
+```
+
+Or invoke the binary from an npm script or from `node_modules/.bin` after installation.
+
+## CLI usage
+
+### `rectlinear`
+
+Render a perspective screenshot from an equirectangular image:
+
+```bash
+equirect-toolbox rectlinear \
+  --input equirect.jpg \
+  --output perspective.jpg \
+  --config rectlinear-matrix.json
+```
+
+`--quality` controls JPEG output quality and defaults to `95`:
+
+```bash
+equirect-toolbox rectlinear \
+  -i equirect.jpg \
+  -o perspective.jpg \
+  -c rectlinear-matrix.json \
+  --quality 90
+```
+
+The output format is selected from the output file extension (`.jpg`, `.jpeg`, or `.png`).
+
+#### Generate a rectlinear config
+
+Use one of the built-in configuration templates as a starting point:
+
+```bash
+equirect-toolbox rectlinear --init-config euler --output rectlinear-euler.json
+equirect-toolbox rectlinear --init-config matrix --output rectlinear-matrix.json
+equirect-toolbox rectlinear --init-config quaternion --output rectlinear-quaternion.json
+```
+
+The generated file can be edited and passed with `--config`.
+
+#### Rectlinear config format
+
+All rectlinear configs contain a viewport and a camera field:
+
+```json
+{
+  "viewport": {
+    "width": 1920,
+    "height": 1080
+  },
+  "camera": {
+    "vfov": 60,
+    "yaw": 0,
+    "pitch": 0,
+    "roll": 0
+  }
+}
+```
+
+- `viewport.width` and `viewport.height` are the output dimensions in pixels.
+- `camera.vfov` is the vertical field of view in degrees.
+- The camera orientation can be specified in one of three forms:
+  - Euler angles: `yaw`, `pitch`, and `roll`, in degrees.
+  - A row-major `3x3` rotation matrix.
+  - A quaternion with `x`, `y`, `z`, and `w` components.
+
+The package includes the schema and templates in `configs/schema` and `configs/templates`. The generated templates are also available in the source repository.
+
+### `equirect2cube`
+
+Convert an equirectangular panorama into six cube-face images and a manifest:
+
+```bash
+equirect-toolbox equirect2cube \
+  --input equirect.jpg \
+  --output cube.json
+```
+
+When `cube.json` does not exist, the command creates it and uses JPEG paths by default. The face size is calculated automatically from the input image and rounded up to a power of two.
+
+When `cube.json` already exists, its six paths and file extensions determine where and how the face images are written. This means the command does not need separate `--format` or `--face-size` options.
+
+To create an empty manifest without converting an image:
+
+```bash
+equirect-toolbox equirect2cube \
+  --init-cube-json \
+  --output cube.json
+```
+
+JPEG quality defaults to `95`:
+
+```bash
+equirect-toolbox equirect2cube \
+  -i equirect.jpg \
+  -o cube.json \
+  --quality 90
+```
+
+### `cube2equirect`
+
+Convert the six cube faces referenced by a manifest into an equirectangular panorama:
+
+```bash
+equirect-toolbox cube2equirect \
+  --input cube.json \
+  --output equirect.jpg
+```
+
+The input must be a `cube.json` manifest. The six images must have the same square, power-of-two dimensions. The output dimensions are four times the face size by two times the face size.
+
+You can also initialize a manifest with this command:
+
+```bash
+equirect-toolbox cube2equirect \
+  --init-cube-json \
+  --output cube.json
+```
+
+## `cube.json` manifest
+
+A manifest contains one path for each cube face:
+
+```json
+{
+  "px": "cube_px.jpg",
+  "nx": "cube_nx.jpg",
+  "py": "cube_py.jpg",
+  "ny": "cube_ny.jpg",
+  "pz": "cube_pz.jpg",
+  "nz": "cube_nz.jpg"
+}
+```
+
+The paths are resolved relative to the directory containing `cube.json`, not relative to the current working directory.
+
+| Key  | Cube face  |
+| ---- | ---------- |
+| `px` | positive X |
+| `nx` | negative X |
+| `py` | positive Y |
+| `ny` | negative Y |
+| `pz` | positive Z |
+| `nz` | negative Z |
+
+The file extension in each path selects the output image format. Use `.jpg`/`.jpeg` for JPEG or `.png` for PNG. The manifest schema is included at `configs/schema/cube.schema.json`.
+
+## Package contents
+
+The published package contains:
+
+- `dist`: compiled JavaScript, declarations, declaration maps, and source maps.
+- `configs/schema`: JSON Schemas used to validate rectlinear configs and cube manifests.
+- `configs/templates`: ready-to-copy configuration and manifest templates.
+- `README.md` and package metadata.

package/configs/schema/cube.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Cube face manifest",
+  "description": "The six image files that make up a cubemap. Paths are resolved relative to this JSON file.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["px", "nx", "py", "ny", "pz", "nz"],
+  "properties": {
+    "px": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Right (+X) face image path."
+    },
+    "nx": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Left (-X) face image path."
+    },
+    "py": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Top (+Y) face image path."
+    },
+    "ny": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Bottom (-Y) face image path."
+    },
+    "pz": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Front (+Z) face image path."
+    },
+    "nz": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Back (-Z) face image path."
+    }
+  }
+}

package/configs/schema/rectlinear.schema.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Equirectangular rectlinear screenshot configuration",
+  "description": "Configuration for rendering a perspective (rectlinear) screenshot from an equirectangular panorama.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["viewport", "camera"],
+  "properties": {
+    "viewport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["width", "height"],
+      "properties": {
+        "width": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Output width in pixels."
+        },
+        "height": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Output height in pixels."
+        }
+      }
+    },
+    "camera": {
+      "type": "object",
+      "unevaluatedProperties": false,
+      "allOf": [
+        {
+          "title": "Camera intrinsics",
+          "type": "object",
+          "required": ["vfov"],
+          "properties": {
+            "vfov": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "exclusiveMaximum": 180,
+              "description": "Vertical field of view in degrees."
+            }
+          }
+        },
+        {
+          "title": "Camera extrinsics",
+          "oneOf": [
+            {
+              "title": "Euler extrinsics",
+              "type": "object",
+              "required": ["yaw", "pitch", "roll"],
+              "properties": {
+                "yaw": {
+                  "type": "number",
+                  "description": "Euler yaw in degrees."
+                },
+                "pitch": {
+                  "type": "number",
+                  "description": "Euler pitch in degrees."
+                },
+                "roll": {
+                  "type": "number",
+                  "description": "Euler roll in degrees."
+                }
+              }
+            },
+            {
+              "title": "Matrix extrinsics",
+              "type": "object",
+              "required": ["matrix"],
+              "properties": {
+                "matrix": {
+                  "type": "array",
+                  "description": "Row-major 3x3 camera rotation matrix.",
+                  "minItems": 9,
+                  "maxItems": 9,
+                  "items": {
+                    "type": "number"
+                  }
+                }
+              }
+            },
+            {
+              "title": "Quaternion extrinsics",
+              "type": "object",
+              "required": ["quaternion"],
+              "properties": {
+                "quaternion": {
+                  "type": "object",
+                  "description": "Camera rotation quaternion.",
+                  "additionalProperties": false,
+                  "required": ["x", "y", "z", "w"],
+                  "properties": {
+                    "x": { "type": "number" },
+                    "y": { "type": "number" },
+                    "z": { "type": "number" },
+                    "w": { "type": "number" }
+                  }
+                }
+              }
+            }
+          ]
+        }
+      ]
+    }
+  }
+}

package/configs/templates/cube.json

@@ -0,0 +1,8 @@
+{
+  "px": "cube_px.jpg",
+  "nx": "cube_nx.jpg",
+  "py": "cube_py.jpg",
+  "ny": "cube_ny.jpg",
+  "pz": "cube_pz.jpg",
+  "nz": "cube_nz.jpg"
+}

package/configs/templates/rectlinear-euler.json

@@ -0,0 +1,12 @@
+{
+  "viewport": {
+    "width": 1920,
+    "height": 1080
+  },
+  "camera": {
+    "vfov": 60,
+    "yaw": 0,
+    "roll": 0,
+    "pitch": 0
+  }
+}

package/configs/templates/rectlinear-matrix.json

@@ -0,0 +1,10 @@
+{
+  "viewport": {
+    "width": 1920,
+    "height": 1080
+  },
+  "camera": {
+    "vfov": 60,
+    "matrix": [1, 0, 0, 0, 1, 0, 0, 0, 1]
+  }
+}

package/configs/templates/rectlinear-quaternion.json

@@ -0,0 +1,15 @@
+{
+  "viewport": {
+    "width": 1920,
+    "height": 1080
+  },
+  "camera": {
+    "vfov": 60,
+    "quaternion": {
+      "x": 0,
+      "y": 0,
+      "z": 0,
+      "w": 0
+    }
+  }
+}

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+export declare function createProgram(): Command;
+export declare function main(argv?: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BpC,wBAAgB,aAAa,IAAI,OAAO,CAuGvC;AAED,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE"}

package/dist/cli.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { resolve } from "path";
+import { fileURLToPath } from "url";
+export function createProgram() {
+    const program = new Command();
+    program.name("equirect-toolbox").description("Command-line tools for equirectangular panoramas");
+    const rectlinear = program
+        .command("rectlinear")
+        .description("Render a perspective screenshot from an equirectangular panorama")
+        .option("-i, --input <path>", "input equirectangular image")
+        .option("-o, --output <path>", "output image or generated config path")
+        .option("-c, --config <path>", "rectlinear JSON config path")
+        .option("--init-config <type>", "generate a config template: euler, matrix, or quaternion")
+        .option("--quality <quality>", "JPEG quality from 0 to 100", parseQuality, 95);
+    rectlinear.action(async (options) => {
+        if (options.initConfig !== undefined) {
+            if (!options.output) {
+                throw new Error("The --output option is required when using --init-config.");
+            }
+            const { initializeRectlinearConfig } = await import("./rectlinear.js");
+            initializeRectlinearConfig(options.initConfig, options.output);
+            return;
+        }
+        if (!options.input || !options.output || !options.config) {
+            throw new Error("The --input, --output, and --config options are required for rectlinear rendering.");
+        }
+        const { renderRectlinear } = await import("./rectlinear.js");
+        await renderRectlinear({
+            input: options.input,
+            output: options.output,
+            config: options.config,
+            quality: options.quality,
+        });
+    });
+    const equirect2cube = program
+        .command("equirect2cube")
+        .description("Convert an equirectangular panorama to six cube face images")
+        .option("-i, --input <path>", "input equirectangular image")
+        .option("-o, --output <path>", "output cube.json manifest path")
+        .option("--init-cube-json", "generate a cube.json template")
+        .option("--quality <quality>", "JPEG quality from 0 to 100", parseQuality, 95);
+    equirect2cube.action(async (options) => {
+        if (options.initCubeJson) {
+            if (!options.output) {
+                throw new Error("The --output option is required when using --init-cube-json.");
+            }
+            const { initializeCubeJson } = await import("./lib/cube-manifest.js");
+            initializeCubeJson(options.output);
+            return;
+        }
+        if (!options.input || !options.output) {
+            throw new Error("The --input and --output options are required for equirect2cube rendering.");
+        }
+        const { convertEquirectToCube } = await import("./equirect2cube.js");
+        await convertEquirectToCube({
+            input: options.input,
+            output: options.output,
+            quality: options.quality,
+        });
+    });
+    const cube2equirect = program
+        .command("cube2equirect")
+        .description("Convert six cube face images described by cube.json to an equirectangular panorama")
+        .option("-i, --input <path>", "cube.json manifest path")
+        .option("-o, --output <path>", "output equirectangular image or generated cube.json path")
+        .option("--init-cube-json", "generate a cube.json template")
+        .option("--quality <quality>", "JPEG quality from 0 to 100", parseQuality, 95);
+    cube2equirect.action(async (options) => {
+        if (options.initCubeJson) {
+            if (!options.output) {
+                throw new Error("The --output option is required when using --init-cube-json.");
+            }
+            const { initializeCubeJson } = await import("./lib/cube-manifest.js");
+            initializeCubeJson(options.output);
+            return;
+        }
+        if (!options.input || !options.output) {
+            throw new Error("The --input cube.json and --output options are required for cube2equirect rendering.");
+        }
+        const { convertCubeToEquirect } = await import("./cube2equirect.js");
+        await convertCubeToEquirect({
+            input: options.input,
+            output: options.output,
+            quality: options.quality,
+        });
+    });
+    return program;
+}
+export async function main(argv = process.argv) {
+    await createProgram().parseAsync(normalizeArguments(argv));
+}
+function normalizeArguments(argv) {
+    return argv.map((argument) => {
+        if (argument === "-init-config")
+            return "--init-config";
+        if (argument.startsWith("-init-config="))
+            return `--init-config=${argument.slice("-init-config=".length)}`;
+        return argument;
+    });
+}
+function parseQuality(value) {
+    const quality = Number(value);
+    if (!Number.isInteger(quality) || quality < 0 || quality > 100) {
+        throw new Error("JPEG quality must be an integer from 0 to 100.");
+    }
+    return quality;
+}
+const entryPath = process.argv[1];
+if (entryPath && resolve(entryPath) === resolve(fileURLToPath(import.meta.url))) {
+    main().catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/cube2equirect.d.ts

@@ -0,0 +1,7 @@
+export type CubeToEquirectOptions = {
+    input: string;
+    output: string;
+    quality?: number;
+};
+export declare function convertCubeToEquirect(options: CubeToEquirectOptions): Promise<void>;
+//# sourceMappingURL=cube2equirect.d.ts.map

package/dist/cube2equirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cube2equirect.d.ts","sourceRoot":"","sources":["../src/cube2equirect.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AA6BF,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDzF"}

package/dist/cube2equirect.js

@@ -0,0 +1,77 @@
+import * as THREE from "three";
+import { loadImage } from "@napi-rs/canvas";
+import { readCubeManifest } from "./lib/cube-manifest.js";
+import { createHeadlessRenderer } from "./lib/headless-three.js";
+import { getOutputFormat, isPowerOfTwo, writeCanvasImage, cubeFaceKeys, } from "./lib/cube-output.js";
+const vertexShader = `
+varying vec2 vUv;
+void main() {
+  vUv = uv;
+  gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+}
+`;
+const fragmentShader = `
+varying vec2 vUv;
+uniform samplerCube tDiffuse;
+
+#define TAU 6.2831852
+#define PI 3.1415926
+
+void main() {
+  float theta = TAU * vUv.x;
+  float phi = PI * (vUv.y - 0.5);
+  float distance = abs(cos(phi));
+  float dx = -sin(theta) * distance;
+  float dy = sin(phi);
+  float dz = -cos(theta) * distance;
+  vec3 target = vec3(dx, dy, dz);
+  gl_FragColor = textureCube(tDiffuse, target);
+}
+`;
+export async function convertCubeToEquirect(options) {
+    const manifest = readCubeManifest(options.input);
+    const images = await Promise.all(cubeFaceKeys.map((faceKey) => loadImage(manifest[faceKey])));
+    const size = images[0].width;
+    for (const image of images) {
+        if (!isPowerOfTwo(image.width) || !isPowerOfTwo(image.height)) {
+            throw new Error("Cube images must have power-of-two dimensions.");
+        }
+        if (image.width !== size || image.height !== size) {
+            throw new Error("Cube images must all have the same square dimensions.");
+        }
+    }
+    const outputWidth = size * 4;
+    const outputHeight = size * 2;
+    const format = getOutputFormat(options.output);
+    const quality = options.quality ?? 95;
+    const { canvas, renderer } = await createHeadlessRenderer(outputWidth, outputHeight);
+    let cubeTexture;
+    let material;
+    try {
+        cubeTexture = new THREE.CubeTexture(images);
+        cubeTexture.format = THREE.RGBAFormat;
+        cubeTexture.needsUpdate = true;
+        const camera = new THREE.OrthographicCamera(-1, 1, 0.5, -0.5, 1, 10);
+        camera.position.setZ(2);
+        const geometry = new THREE.PlaneGeometry(2, 1);
+        material = new THREE.ShaderMaterial({
+            uniforms: {
+                tDiffuse: { value: cubeTexture },
+            },
+            vertexShader,
+            fragmentShader,
+        });
+        const mesh = new THREE.Mesh(geometry, material);
+        const scene = new THREE.Scene();
+        scene.add(mesh);
+        renderer.setSize(outputWidth, outputHeight, false);
+        renderer.render(scene, camera);
+        writeCanvasImage(canvas, options.output, format, quality);
+    }
+    finally {
+        cubeTexture?.dispose();
+        material?.dispose();
+        renderer.dispose();
+    }
+}
+//# sourceMappingURL=cube2equirect.js.map

package/dist/cube2equirect.js.map

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

package/dist/equirect2cube.d.ts

@@ -0,0 +1,7 @@
+export type EquirectToCubeOptions = {
+    input: string;
+    output: string;
+    quality?: number;
+};
+export declare function convertEquirectToCube(options: EquirectToCubeOptions): Promise<void>;
+//# sourceMappingURL=equirect2cube.d.ts.map

package/dist/equirect2cube.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equirect2cube.d.ts","sourceRoot":"","sources":["../src/equirect2cube.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAWF,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDzF"}