@rings-webgpu/core 1.0.30 → 1.0.32

package/dist/types/index.d.ts

@@ -428,6 +428,10 @@ export * from "./loader/parser/kmz/dataDef/global";
 export * from "./loader/parser/kmz/dataDef/point";
 export * from "./loader/parser/kmz/dataDef/template";
 export * from "./loader/parser/kmz/dataDef/wayline";
+export * from "./loader/parser/las/LASLoader";
+export * from "./loader/parser/las/LASParser";
+export * from "./loader/parser/las/LASTypes";
+export * from "./loader/parser/las/LASUtils";
 export * from "./loader/parser/ply/PlyLoader";
 export * from "./loader/parser/ply/PlyParser";
 export * from "./loader/parser/ply/PlyTypes";

package/dist/types/loader/parser/las/LASLoader.d.ts

@@ -0,0 +1,45 @@
+import { LASData, LASBinaryData, LASParsedData } from "./LASTypes";
+/**
+ * LAS file loader
+ * Parses both ASCII (Log ASCII Standard) and Binary (LIDAR Point Cloud) LAS format files
+ */
+export declare class LASLoader {
+    /**
+     * Parse LAS file (supports both ASCII text and binary buffer)
+     * @param input LAS file content as string or ArrayBuffer
+     * @returns Parsed LAS data (ASCII or Binary)
+     */
+    parse(input: string | ArrayBuffer): Promise<LASParsedData>;
+    /**
+     * Parse ASCII LAS (Log ASCII Standard) format
+     * @param text LAS file content as string
+     * @returns Parsed ASCII LAS data
+     */
+    parseText(text: string): Promise<LASData>;
+    /**
+     * Parse binary LAS (LIDAR Point Cloud) format
+     * @param buffer LAS file content as ArrayBuffer
+     * @returns Parsed binary LAS data
+     */
+    parseBinary(buffer: ArrayBuffer): Promise<LASBinaryData>;
+    /**
+     * Parse version information section (~VERSION)
+     */
+    private parseMetadata;
+    /**
+     * Parse well information section (~WELL)
+     */
+    private parseWellParams;
+    /**
+     * Parse curve information section (~CURVE)
+     */
+    private parseCurveParams;
+    /**
+     * Parse headers (column names) from curve section
+     */
+    private parseHeaders;
+    /**
+     * Parse ASCII data section (~A)
+     */
+    private parseData;
+}

package/dist/types/loader/parser/las/LASParser.d.ts

@@ -0,0 +1,39 @@
+import { ParserBase } from "../ParserBase";
+import { ParserFormat } from "../ParserFormat";
+import { LASVisualizationMode } from "./LASTypes";
+/**
+ * LAS format parser
+ * Organizes parsed LAS data (from LASLoader) into renderable objects
+ * Supports multiple visualization modes: point cloud, curve, and well trajectory
+ */
+export declare class LASParser extends ParserBase {
+    static format: ParserFormat;
+    visualizationMode: LASVisualizationMode;
+    parseBuffer(buffer: ArrayBuffer): Promise<void>;
+    /**
+     * Create visualization from parsed LAS data
+     */
+    private createVisualization;
+    /**
+     * Create point cloud visualization from binary LAS data
+     */
+    private createBinaryPointCloudVisualization;
+    verification(): boolean;
+    /**
+     * Create point cloud visualization from LAS data
+     * Depth as Z axis, curve values as X/Y axes
+     */
+    private createPointCloudVisualization;
+    /**
+     * Create curve visualization using FatLineRenderer
+     * Depth as Z axis, normalized curve value as X axis
+     */
+    private createCurveVisualization;
+    /**
+     * Create well trajectory visualization
+     * TODO: Implement when well trajectory data is available
+     */
+    private createWellTrajectoryVisualization;
+    private normalizeValue;
+    private mapValueToColor;
+}

package/dist/types/loader/parser/las/LASTypes.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Type definitions for LAS format
+ * Supports both ASCII (Log ASCII Standard) and Binary (LIDAR Point Cloud) formats
+ */
+export interface LASMetadata {
+    version: number;
+    wrap: boolean;
+}
+export interface LASWellParams {
+    [key: string]: {
+        unit: string;
+        value: string | number;
+        description: string;
+    };
+}
+export interface LASCurveParams {
+    [key: string]: {
+        unit: string;
+        value: string;
+        description: string;
+    };
+}
+/**
+ * ASCII LAS (Log ASCII Standard) data structure
+ */
+export interface LASData {
+    headers: string[];
+    data: Array<Array<string | number>>;
+    wellParams: LASWellParams;
+    curveParams: LASCurveParams;
+    metadata: LASMetadata;
+    nullValue: number;
+}
+/**
+ * Binary LAS (LIDAR Point Cloud) data structure
+ */
+export interface LASBinaryData {
+    format: 'binary';
+    version: number;
+    pointDataFormat: number;
+    numPoints: number;
+    positions: Float32Array;
+    colors: Uint8Array;
+    bbox: {
+        xMin: number;
+        xMax: number;
+        yMin: number;
+        yMax: number;
+        zMin: number;
+        zMax: number;
+    };
+    scale: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    offset: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+/**
+ * Union type for both ASCII and Binary LAS data
+ */
+export type LASParsedData = LASData | LASBinaryData;
+export declare enum LASVisualizationMode {
+    PointCloud = "pointcloud",// Point cloud mode (depth as Z, curve values as X/Y)
+    Curve = "curve",// Curve mode (3D curve using FatLine)
+    WellTrajectory = "trajectory"
+}

package/dist/types/loader/parser/las/LASUtils.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Utility functions for LAS file parsing
+ */
+export declare class LASUtils {
+    /**
+     * Split array into chunks of specified size
+     */
+    static chunk<T>(arr: T[], size: number): T[][];
+    /**
+     * Remove comments from text (lines starting with #)
+     */
+    static removeComment(str: string): string;
+    /**
+     * Convert string to number or string
+     * Returns number if string represents a valid number, otherwise returns string
+     */
+    static convertToValue(s: string): number | string;
+    /**
+     * Parse a LAS section from text
+     * @param text Full LAS file text
+     * @param sectionName Section name (e.g., 'VERSION', 'WELL', 'CURVE')
+     * @returns Section content as string
+     */
+    static parseSection(text: string, sectionName: string): string;
+    /**
+     * Parse a parameter line from LAS file
+     * Format: MNEM.UNIT  VALUE  :DESCRIPTION
+     * @param line Parameter line text
+     * @returns Parsed parameter object
+     */
+    static parseParameterLine(line: string): {
+        mnemonic: string;
+        unit: string;
+        value: string;
+        description: string;
+    };
+}

package/dist/types/loader/parser/tileRenderer/TilesRenderer.d.ts

@@ -123,6 +123,7 @@ export declare class TilesRenderer {
     protected rtcOffset: Vector3 | null;
     protected _root: Tile | null;
     protected _activeTiles: Set<Tile>;
+    protected _delayedHideTiles: Set<Tile>;
     readonly group: Object3D;
     cameras: Camera3D[];
     private _cameraMap;
@@ -206,6 +207,15 @@ export declare class TilesRenderer {
      * Set tile active state
      */
     setTileActive(tile: Tile, active: boolean): void;
+    /**
+     * Get children tiles that are loading and will be active
+     * Check if child is used in current frame (will be displayed) but not yet loaded
+     */
+    private _getLoadingChildrenThatWillBeActive;
+    /**
+     * Check and process delayed hide tiles when a child finishes loading
+     */
+    private _checkDelayedHideTiles;
     /**
      * Set tile visibility
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rings-webgpu/core",
-  "version": "1.0.30",
+  "version": "1.0.32",
   "description": "Rings webgpu Engine",
   "main": "index.js",
   "exports": {