@playcanvas/splat-transform 0.14.0 → 0.14.1

package/README.md

@@ -67,6 +67,7 @@ Actions can be repeated and applied in any order:
 -V, --filter-value     <name,cmp,value> Keep splats where <name> <cmp> <value>
                                           cmp ∈ {lt,lte,gt,gte,eq,neq}
 -p, --params           <key=val,...>    Pass parameters to .mjs generator script
+-l, --lod              <n>              Specify the level of detail of this model, n >= 0.
 ```
 
 ## Global Options
@@ -74,6 +75,7 @@ Actions can be repeated and applied in any order:
 ```none
 -h, --help                              Show this help and exit
 -v, --version                           Show version and exit
+-q, --quiet                             Suppress non-error output
 -w, --overwrite                         Overwrite output file if it exists
 -c, --cpu                               Use CPU for SOG spherical harmonic compression
 -i, --iterations       <n>              Iterations for SOG SH compression (more=better). Default: 10

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { randomBytes } from 'crypto';
 import { open, readFile as readFile$1, unlink, mkdir, lstat, rename } from 'node:fs/promises';
 import { join, dirname, resolve as resolve$2, basename } from 'node:path';
-import { stdout, hrtime, exit } from 'node:process';
+import { hrtime, exit } from 'node:process';
 import { parseArgs } from 'node:util';
 import { Buffer as Buffer$1 } from 'node:buffer';
 import os from 'node:os';
@@ -58527,7 +58527,7 @@ class TextureHandler extends ResourceHandler {
 		}
 }
 
-var version = "0.14.0";
+var version = "0.14.1";
 
 class Column {
     name;
@@ -58644,6 +58644,73 @@ class DataTable {
     }
 }
 
+/**
+ * Simple logger utility. Currently supports quiet mode. Designed to be extended for multiple log
+ * levels in the future.
+ */
+class Logger {
+    level = 'normal';
+    setLevel(level) {
+        this.level = level;
+    }
+    setQuiet(quiet) {
+        this.level = quiet ? 'silent' : 'normal';
+    }
+    /**
+     * Log informational messages (file operations, progress, etc.). Suppressed in quiet mode.
+     * @param {...any} args - The arguments to log.
+     */
+    info(...args) {
+        if (this.level !== 'silent') {
+            console.log(...args);
+        }
+    }
+    /**
+     * Log warning messages. Suppressed in quiet mode.
+     * @param {...any} args - The arguments to log.
+     */
+    warn(...args) {
+        if (this.level !== 'silent') {
+            console.warn(...args);
+        }
+    }
+    /**
+     * Log error messages. Always shown, even in quiet mode.
+     * @param {...any} args - The arguments to log.
+     */
+    error(...args) {
+        console.error(...args);
+    }
+    /**
+     * Log debug/verbose messages. Currently treated the same as info, but can be filtered
+     * separately in the future.
+     * @param {...any} args - The arguments to log.
+     */
+    debug(...args) {
+        if (this.level !== 'silent') {
+            console.log(...args);
+        }
+    }
+    /**
+     * Write progress indicators directly to stdout (without newline). Suppressed in quiet mode.
+     * @param text - The text to write.
+     */
+    progress(text) {
+        if (this.level !== 'silent') {
+            process.stdout.write(text);
+        }
+    }
+    /**
+     * Check if logger is in quiet/silent mode.
+     * @returns True if the logger is in quiet/silent mode, false otherwise.
+     */
+    isQuiet() {
+        return this.level === 'silent';
+    }
+}
+// Export singleton instance
+const logger = new Logger();
+
 /* eslint-disable indent */
 const kSqrt03_02 = Math.sqrt(3.0 / 2.0);
 const kSqrt01_03 = Math.sqrt(1.0 / 3.0);
@@ -60853,7 +60920,7 @@ const generateOrdering = (dataTable, indices) => {
         const ylen = My - my;
         const zlen = Mz - mz;
         if (!isFinite(xlen) || !isFinite(ylen) || !isFinite(zlen)) {
-            console.log('invalid extents', xlen, ylen, zlen);
+            logger.debug('invalid extents', xlen, ylen, zlen);
             return;
         }
         // all points are identical
@@ -60889,7 +60956,7 @@ const generateOrdering = (dataTable, indices) => {
                 ++end;
             }
             if (end - start > 256) {
-                // console.log('sorting', end - start);
+                // logger.debug('sorting', end - start);
                 generate(indices.subarray(start, end));
             }
             start = end;
@@ -61096,7 +61163,7 @@ const createDevice = async () => {
     await graphicsDevice.createDevice();
     // print gpu info
     const info = graphicsDevice.gpuAdapter.info;
-    console.log(`Created gpu device="${info.device || '-'}" arch="${info.architecture || '-'}" descr="${info.description || '-'}"`);
+    logger.debug(`Created gpu device="${info.device || '-'}" arch="${info.architecture || '-'}" descr="${info.description || '-'}"`);
     // create the application
     const app = new Application(canvas, { graphicsDevice });
     // create external backbuffer
@@ -61639,7 +61706,7 @@ const kmeans = async (points, k, iterations, device) => {
     const labels = new Uint32Array(points.numRows);
     let converged = false;
     let steps = 0;
-    console.log(`Running k-means clustering: dims=${points.numColumns} points=${points.numRows} clusters=${k} iterations=${iterations}...`);
+    logger.debug(`Running k-means clustering: dims=${points.numColumns} points=${points.numRows} clusters=${k} iterations=${iterations}...`);
     while (!converged) {
         if (gpuClustering) {
             await gpuClustering.execute(points, centroids, labels);
@@ -61665,12 +61732,12 @@ const kmeans = async (points, k, iterations, device) => {
         if (steps >= iterations) {
             converged = true;
         }
-        stdout.write('#');
+        logger.progress('#');
     }
     if (gpuClustering) {
         gpuClustering.destroy();
     }
-    console.log(' done 🎉');
+    logger.debug(' done 🎉');
     return { centroids, labels };
 };
 
@@ -61766,7 +61833,7 @@ const writeSog = async (fileHandle, dataTable, outputFilename, options, indices
     const layout = identity; // rectChunks;
     const write = async (filename, data, w = width, h = height) => {
         const pathname = resolve$2(dirname(outputFilename), filename);
-        console.log(`writing '${pathname}'...`);
+        logger.info(`writing '${pathname}'...`);
         // construct the encoder on first use
         if (!webPCodec) {
             webPCodec = await WebPCodec.create();
@@ -62192,7 +62259,7 @@ const calcBound = (dataTable, indices) => {
         const m = b.getMin();
         const M = b.getMax();
         if (!isFinite(m.x) || !isFinite(m.y) || !isFinite(m.z) || !isFinite(M.x) || !isFinite(M.y) || !isFinite(M.z)) {
-            console.warn('Skipping invalid bounding box:', { m, M, index });
+            logger.warn('Skipping invalid bounding box:', { m, M, index });
             continue;
         }
         min[0] = Math.min(min[0], m.x);
@@ -62336,7 +62403,7 @@ const writeLod = async (fileHandle, dataTable, outputFilename, options) => {
             }
             // write file unit to sog
             const outputFile = await open(pathname, 'w');
-            console.log(`writing ${pathname}...`);
+            logger.info(`writing ${pathname}...`);
             await writeSog(outputFile, unitDataTable, pathname, options, indices);
             await outputFile.close();
         }
@@ -62461,7 +62528,7 @@ const getOutputFormat = (filename) => {
 const readFile = async (filename, options, params) => {
     const inputFormat = getInputFormat(filename);
     let result;
-    console.log(`reading '${filename}'...`);
+    logger.info(`reading '${filename}'...`);
     if (inputFormat === 'mjs') {
         result = [await readMjs(filename, params)];
     }
@@ -62501,7 +62568,7 @@ const readFile = async (filename, options, params) => {
 const writeFile = async (filename, dataTable, options) => {
     // get the output format, throws on failure
     const outputFormat = getOutputFormat(filename);
-    console.log(`writing '${filename}'...`);
+    logger.info(`writing '${filename}'...`);
     // write to a temporary file and rename on success
     const tmpFilename = `.${basename(filename)}.${process.pid}.${Date.now()}.${randomBytes(6).toString('hex')}.tmp`;
     const tmpPathname = join(dirname(filename), tmpFilename);
@@ -62614,6 +62681,7 @@ const parseArguments = () => {
             overwrite: { type: 'boolean', short: 'w', default: false },
             help: { type: 'boolean', short: 'h', default: false },
             version: { type: 'boolean', short: 'v', default: false },
+            quiet: { type: 'boolean', short: 'q', default: false },
             cpu: { type: 'boolean', short: 'c', default: false },
             iterations: { type: 'string', short: 'i', default: '10' },
             'lod-select': { type: 'string', short: 'O', default: '' },
@@ -62671,6 +62739,7 @@ const parseArguments = () => {
         overwrite: v.overwrite,
         help: v.help,
         version: v.version,
+        quiet: v.quiet,
         cpu: v.cpu,
         iterations: parseInteger(v.iterations),
         lodSelect: v['lod-select'].split(',').filter(v => !!v).map(parseInteger),
@@ -62830,6 +62899,7 @@ ACTIONS (can be repeated, in any order)
 GLOBAL OPTIONS
     -h, --help                              Show this help and exit
     -v, --version                           Show version and exit
+    -q, --quiet                             Suppress non-error output
     -w, --overwrite                         Overwrite output file if it exists
     -c, --cpu                               Use CPU for SOG spherical harmonic compression
     -i, --iterations       <n>              Iterations for SOG SH compression (more=better). Default: 10
@@ -62855,17 +62925,19 @@ EXAMPLES
     splat-transform -O 0,1,2 -C 1024 -X 32 input.lcc output/lod-meta.json
 `;
 const main = async () => {
-    console.log(`splat-transform v${version}`);
     const startTime = hrtime();
     // read args
     const { files, options } = parseArguments();
+    // configure logger
+    logger.setQuiet(options.quiet);
+    logger.info(`splat-transform v${version}`);
     // show version and exit
     if (options.version) {
         exit(0);
     }
     // invalid args or show help
     if (files.length < 2 || options.help) {
-        console.error(usage);
+        logger.error(usage);
         exit(1);
     }
     const inputArgs = files.slice(0, -1);
@@ -62878,7 +62950,7 @@ const main = async () => {
     else {
         // check overwrite before doing any work
         if (await fileExists(outputFilename)) {
-            console.error(`File '${outputFilename}' already exists. Use -w option to overwrite.`);
+            logger.error(`File '${outputFilename}' already exists. Use -w option to overwrite.`);
             exit(1);
         }
     }
@@ -62905,17 +62977,17 @@ const main = async () => {
         if (dataTable.numRows === 0) {
             throw new Error('No splats to write');
         }
-        console.log(`Loaded ${dataTable.numRows} gaussians`);
+        logger.info(`Loaded ${dataTable.numRows} gaussians`);
         // write file
         await writeFile(outputFilename, dataTable, options);
     }
     catch (err) {
         // handle errors
-        console.error(err);
+        logger.error(err);
         exit(1);
     }
     const endTime = hrtime(startTime);
-    console.log(`done in ${endTime[0] + endTime[1] / 1e9}s`);
+    logger.info(`done in ${endTime[0] + endTime[1] / 1e9}s`);
     // something in webgpu seems to keep the process alive after returning
     // from main so force exit
     exit(0);