@loaders.gl/tiles 5.0.0-alpha.12 → 5.0.0-alpha.13

package/dist/spatial/i3s-spatial-transformer.d.ts

@@ -1,205 +0,0 @@
-import { Matrix4 } from '@math.gl/core';
-import type { TilesetCoordinateFrame, TilesetSpatialOptions, TilesetSpatialReference } from "./spatial-types.js";
-/** Minimal I3S oriented bounding box required by the spatial adapter. */
-export type I3SSpatialObb = {
-    /** Center in source CRS coordinates. */
-    center: ArrayLike<number>;
-    /** Half lengths along the oriented axes. */
-    halfSize: ArrayLike<number>;
-    /** Orientation quaternion. */
-    quaternion: ArrayLike<number>;
-};
-/** Input used to rebuild an I3S node bound in the selected output frame. */
-export type I3SSpatialBounds = {
-    /** Minimum bounding sphere encoded as source center plus radius. */
-    mbs?: ArrayLike<number>;
-    /** Oriented source bound, preferred when available. */
-    obb?: I3SSpatialObb;
-    /** Frame in which I3S vectors and quaternions are expressed. */
-    normalReferenceFrame?: string;
-};
-/** Renderer-ready positions and metadata produced for an I3S geometry resource. */
-export type I3STransformedPositions = {
-    /** Float32 offsets from the stable target origin. */
-    positions: Float32Array;
-    /** Reconstructed absolute source positions retained for normal transformation. */
-    sourcePositions: Float64Array;
-    /** Stable origin in target CRS coordinates. */
-    origin: [number, number, number];
-    /** Origin used by geographic deck.gl coordinate systems. */
-    cartographicOrigin: [number, number, number];
-    /** Renderer coordinate-system discriminator. */
-    coordinateSystem: 'cartesian' | 'lnglat-offsets';
-    /** Translation matrix used for Cartesian target offsets. */
-    modelMatrix: Matrix4;
-};
-/** Double-precision conversion geometry after I3S units, elevation and CRS placement. */
-export type I3STransformedGeometry = {
-    /** Absolute target xyz positions, before any writer-owned float32 rebasing. */
-    positions: Float64Array;
-    /** Optional unit normals in the target basis. */
-    normals?: Float32Array;
-};
-/**
- * Applies one normalized I3S horizontal CRS operation consistently to geometry, normals, origins,
- * and node bounds.
- */
-export declare class I3SSpatialTransformer {
-    /** Descriptor attached to output after all adapter-owned spatial values have been transformed. */
-    readonly spatialReference: TilesetSpatialReference;
-    /** Broad coordinate frame of the selected output CRS. */
-    readonly targetCoordinateFrame: TilesetCoordinateFrame;
-    /** Source-to-target position operation. */
-    private readonly positionTransformer;
-    /** Source-to-WGS84 geographic operation used for vector-frame conversion. */
-    private readonly sourceToGeographicTransformer;
-    /** WGS84-geographic-to-target operation used for normal finite differences. */
-    private readonly geographicToTargetTransformer;
-    /** Source frame recorded by I3S metadata. */
-    private readonly sourceCoordinateFrame;
-    /** Source Z multiplier that normalizes stored elevation values to meters. */
-    private readonly sourceVerticalUnitScale;
-    /** I3S elevation placement mode. */
-    private readonly elevationMode?;
-    /** I3S elevation offset normalized to meters. */
-    private readonly elevationOffset;
-    /** Terrain or scene provider selected for the declared placement mode. */
-    private readonly elevationProvider?;
-    /** Provider height multiplier that normalizes returned values to meters. */
-    private readonly providerUnitScale;
-    /** Optional provider-height to layer-height datum operation. */
-    private readonly providerHeightTransformer?;
-    /**
-     * Creates an I3S spatial adapter.
-     *
-     * @param spatialReference - Transformable I3S spatial descriptor.
-     * @param options - Registered geoid and custom resource options used by the shared transformer.
-     */
-    constructor(spatialReference: TilesetSpatialReference, options?: TilesetSpatialOptions);
-    /** Transform one absolute I3S source position. */
-    transformPosition(position: ArrayLike<number>): [number, number, number];
-    /** Transform one absolute I3S source position after asynchronous surface placement. */
-    transformPositionAsync(position: ArrayLike<number>): Promise<[number, number, number]>;
-    /** Transform an already placed, meter-normalized position to the requested target. */
-    private transformPlacedPosition;
-    /** Transform one absolute I3S source position to WGS84 longitude, latitude, and height. */
-    transformSourcePositionToGeographic(position: ArrayLike<number>): [number, number, number];
-    /** Transform one source position to WGS84 after asynchronous elevation placement. */
-    transformSourcePositionToGeographicAsync(position: ArrayLike<number>): Promise<[number, number, number]>;
-    /**
-     * Transform absolute Float64 positions and return stable Float32 offsets around a target origin.
-     *
-     * @param sourcePositions - Absolute positions in source CRS order.
-     * @param sourceOrigin - Stable source origin, normally the node MBS or OBB center.
-     */
-    transformPositions(sourcePositions: ArrayLike<number>, sourceOrigin: ArrayLike<number>): I3STransformedPositions;
-    /**
-     * Transform positions after asynchronously sampling any requested terrain or scene surface.
-     *
-     * @param sourcePositions - Absolute positions in source CRS order.
-     * @param sourceOrigin - Stable source origin, normally the node MBS or OBB center.
-     * @returns Renderer-ready target-frame offsets and stable origin metadata.
-     */
-    transformPositionsAsync(sourcePositions: ArrayLike<number>, sourceOrigin: ArrayLike<number>): Promise<I3STransformedPositions>;
-    /**
-     * Transforms conversion geometry without passing through renderer float32 offsets.
-     * Positions and normals share one batch of elevation samples. Source arrays remain unchanged.
-     * @param sourcePositions - Packed absolute xyz positions in source units.
-     * @param normals - Optional packed normals paired with the positions.
-     * @param normalReferenceFrame - I3S earth-centered or vertex-reference-frame declaration.
-     * @returns Absolute target positions and optional transformed normals.
-     */
-    transformGeometryAsync(sourcePositions: ArrayLike<number>, normals?: ArrayLike<number>, normalReferenceFrame?: string): Promise<I3STransformedGeometry>;
-    /** Transform already placed positions into renderer-relative target coordinates. */
-    private transformPlacedPositions;
-    /**
-     * Transform I3S normals into the selected target basis.
-     *
-     * Earth-centered normals are rotated directly. Vertex-reference-frame normals are first mapped
-     * through the local east/north/up basis at each source position.
-     *
-     * @param normals - Three-component normal vectors.
-     * @param sourcePositions - Absolute source position paired with each normal.
-     * @param normalReferenceFrame - I3S normal frame declaration.
-     */
-    transformNormals(normals: ArrayLike<number>, sourcePositions: ArrayLike<number>, normalReferenceFrame?: string): Float32Array;
-    /**
-     * Rebuild an I3S node bound from transformed corner or sphere-axis samples.
-     *
-     * @param bounds - Source MBS/OBB fields.
-     * @returns A generic tile `region` for geographic output or axis-aligned `box` otherwise.
-     */
-    transformBoundingVolume(bounds: I3SSpatialBounds): {
-        box?: number[];
-        region?: number[];
-    };
-    /** Rebuild an I3S bound in the target frame after asynchronous elevation placement. */
-    transformBoundingVolumeAsync(bounds: I3SSpatialBounds): Promise<{
-        box?: number[];
-        region?: number[];
-    }>;
-    /** Rebuild an I3S bound as a WGS84 geographic region for geographic traversal algorithms. */
-    transformBoundingVolumeToGeographic(bounds: I3SSpatialBounds): {
-        region: number[];
-    };
-    /** Rebuild an I3S bound as WGS84 geographic after asynchronous elevation placement. */
-    transformBoundingVolumeToGeographicAsync(bounds: I3SSpatialBounds): Promise<{
-        region: number[];
-    }>;
-    /** Rebuild an I3S bound as a WGS84 ECEF box for generic `Tileset3D` traversal. */
-    transformBoundingVolumeToGeocentric(bounds: I3SSpatialBounds): {
-        box: number[];
-    };
-    /** Rebuild an I3S bound as WGS84 ECEF after asynchronous elevation placement. */
-    transformBoundingVolumeToGeocentricAsync(bounds: I3SSpatialBounds): Promise<{
-        box: number[];
-    }>;
-    /** Return a WGS84 geographic MBS used by the I3S screen-threshold calculation. */
-    transformBoundingSphereToGeographic(bounds: I3SSpatialBounds): [number, number, number, number];
-    /** Return a placed WGS84 MBS used by the I3S screen-threshold calculation. */
-    transformBoundingSphereToGeographicAsync(bounds: I3SSpatialBounds): Promise<[number, number, number, number]>;
-    /**
-     * Rebuild traversal, target-output, and I3S LOD bounds from one elevation-sampling batch.
-     *
-     * @param bounds - Source MBS/OBB fields.
-     * @returns Parallel bounds in WGS84 ECEF, the selected output frame, and WGS84 geographic.
-     */
-    transformBoundsAsync(bounds: I3SSpatialBounds): Promise<{
-        boundingVolume: {
-            box: number[];
-        };
-        spatialBoundingVolume: {
-            box?: number[];
-            region?: number[];
-        };
-        i3sLodMbs: [number, number, number, number];
-    }>;
-    /**
-     * Rebuild Point Cloud traversal and target-output bounds from one elevation-sampling batch.
-     *
-     * @param bounds - Source OBB fields.
-     * @returns WGS84 geographic traversal bound plus the selected output-frame bound.
-     */
-    transformPointCloudBoundsAsync(bounds: I3SSpatialBounds): Promise<{
-        boundingVolume: {
-            region: number[];
-        };
-        spatialBoundingVolume: {
-            box?: number[];
-            region?: number[];
-        };
-    }>;
-    /** Sample a source I3S bound and normalize every sample to WGS84 geographic coordinates. */
-    private getGeographicBoundSamples;
-    /** Sample, place, and normalize one source bound to WGS84 geographic coordinates. */
-    private getGeographicBoundSamplesAsync;
-    /** Apply a provider's conservative surface range to an entire geographic bound footprint. */
-    private placeGeographicBoundSamples;
-    /** Apply source units and non-surface placement without awaiting external resources. */
-    private placeSourcePositionsSync;
-    /** Apply source units and all I3S elevation-placement modes. */
-    private placeSourcePositions;
-    /** Transform one earth-centered normal to the selected target basis. */
-    private transformEcefNormal;
-}
-//# sourceMappingURL=i3s-spatial-transformer.d.ts.map

package/dist/spatial/i3s-spatial-transformer.d.ts.map

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