@onerjs/core 8.30.9 → 8.31.1

package/Cameras/geospatialCameraMovement.d.ts

@@ -0,0 +1,66 @@
+import { CameraMovement } from "./cameraMovement.js";
+import type { GeospatialLimits } from "./Limits/geospatialLimits.js";
+import { Vector3 } from "../Maths/math.vector.js";
+import type { MeshPredicate } from "../Culling/ray.core.js";
+import type { Scene } from "../scene.js";
+import type { PickingInfo } from "../Collisions/pickingInfo.js";
+import type { Nullable } from "../types.js";
+/**
+ * @experimental
+ * This class is subject to change as the geospatial camera evolves.
+ *
+ * Geospatial-specific camera movement system that extends the base movement with
+ * raycasting and altitude-aware zoom constraints.
+ *
+ * This class encapsulates geospatial camera movement logic:
+ * - Dragging in a way which keeps cursor anchored to globe
+ * - Latitude-based pan speed dampening
+ * - Zoom speed scaling based on distance to center
+ * - Raycasting to determine zoom constraints based on terrain/globe
+ * - Altitude-based zoom clamping
+ * - Zoom direction calculation (towards cursor vs along look vector)
+ */
+export declare class GeospatialCameraMovement extends CameraMovement {
+    limits: GeospatialLimits;
+    private _cameraCenter;
+    private _cameraLookAt;
+    /** Predicate function to determine which meshes to pick against (e.g., globe mesh) */
+    pickPredicate?: MeshPredicate;
+    computedPerFrameZoomVector: Vector3;
+    zoomToCursor: boolean;
+    /**
+     * Enables rotation around a specific point, instead of default rotation around center
+     * @internal
+     */
+    alternateRotationPt?: Vector3;
+    private _tempPickingRay;
+    private _storedZoomPickDistance;
+    private _hitPointRadius?;
+    private _dragPlane;
+    private _dragPlaneNormal;
+    private _dragPlaneOriginPointEcef;
+    private _dragPlaneHitPointLocal;
+    private _previousDragPlaneHitPointLocal;
+    constructor(scene: Scene, limits: GeospatialLimits, cameraPosition: Vector3, _cameraCenter: Vector3, _cameraLookAt: Vector3, pickPredicate?: MeshPredicate);
+    startDrag(pointerX: number, pointerY: number): void;
+    stopDrag(): void;
+    /**
+     * The previous drag plane hit point in local space is stored to compute the movement delta.
+     * As the drag movement occurs, we will continuously recalculate this point. The delta between the previous and current hit points is the delta we will apply to the camera's localtranslation
+     * @param hitPointRadius The distance between the world origin (center of globe) and the initial drag hit point
+     * @param ray The ray from the camera to the new cursor location
+     * @param localToEcefResult The matrix to convert from local to ECEF space
+     */
+    private _recalculateDragPlaneHitPoint;
+    handleDrag(pointerX: number, pointerY: number): void;
+    /** @override */
+    computeCurrentFrameDeltas(): void;
+    private _handleZoom;
+    private _clampZoomDistance;
+    pickAlongVector(vector: Vector3): Nullable<PickingInfo>;
+}
+/**
+ * Helper to build east/north/up basis vectors at a world position.
+ * @internal
+ */
+export declare function ComputeLocalBasisToRefs(worldPos: Vector3, refEast: Vector3, refNorth: Vector3, refUp: Vector3): void;

package/Cameras/geospatialCameraMovement.js

@@ -0,0 +1,199 @@
+import { CameraMovement } from "./cameraMovement.js";
+import { Epsilon } from "../Maths/math.constants.js";
+import { Matrix, TmpVectors, Vector3 } from "../Maths/math.vector.js";
+import { Plane } from "../Maths/math.plane.js";
+import { Ray } from "../Culling/ray.js";
+import { Vector3Distance } from "../Maths/math.vector.functions.js";
+/**
+ * @experimental
+ * This class is subject to change as the geospatial camera evolves.
+ *
+ * Geospatial-specific camera movement system that extends the base movement with
+ * raycasting and altitude-aware zoom constraints.
+ *
+ * This class encapsulates geospatial camera movement logic:
+ * - Dragging in a way which keeps cursor anchored to globe
+ * - Latitude-based pan speed dampening
+ * - Zoom speed scaling based on distance to center
+ * - Raycasting to determine zoom constraints based on terrain/globe
+ * - Altitude-based zoom clamping
+ * - Zoom direction calculation (towards cursor vs along look vector)
+ */
+export class GeospatialCameraMovement extends CameraMovement {
+    constructor(scene, limits, cameraPosition, _cameraCenter, _cameraLookAt, pickPredicate) {
+        super(scene, cameraPosition);
+        this.limits = limits;
+        this._cameraCenter = _cameraCenter;
+        this._cameraLookAt = _cameraLookAt;
+        this.computedPerFrameZoomVector = new Vector3();
+        this.zoomToCursor = true;
+        this._hitPointRadius = undefined;
+        this._dragPlane = new Plane(0, 0, 0, 0);
+        this._dragPlaneNormal = Vector3.Zero();
+        this._dragPlaneOriginPointEcef = Vector3.Zero();
+        this._dragPlaneHitPointLocal = Vector3.Zero();
+        this._previousDragPlaneHitPointLocal = Vector3.Zero();
+        this.computedPerFrameZoomVector.copyFrom(this._cameraLookAt);
+        this.pickPredicate = pickPredicate;
+        this._tempPickingRay = new Ray(this._cameraPosition, this._cameraLookAt);
+        this.panInertia = 0;
+        this.rotationInertia = 0;
+        this.rotationXSpeed = Math.PI / 500; // Move 1/500th of a half circle per pixel
+        this.rotationYSpeed = Math.PI / 500; // Move 1/500th of a half circle per pixel
+    }
+    startDrag(pointerX, pointerY) {
+        const pickResult = this._scene.pick(pointerX, pointerY, this.pickPredicate);
+        if (pickResult.pickedPoint && pickResult.ray) {
+            // Store radius from earth center to pickedPoint, used when calculating drag plane
+            this._hitPointRadius = pickResult.pickedPoint.length();
+            this._recalculateDragPlaneHitPoint(this._hitPointRadius, pickResult.ray, TmpVectors.Matrix[0]);
+            this._previousDragPlaneHitPointLocal.copyFrom(this._dragPlaneHitPointLocal);
+        }
+        else {
+            this._hitPointRadius = undefined; // can't drag without a hit on the globe
+        }
+    }
+    stopDrag() {
+        this._hitPointRadius = undefined;
+    }
+    /**
+     * The previous drag plane hit point in local space is stored to compute the movement delta.
+     * As the drag movement occurs, we will continuously recalculate this point. The delta between the previous and current hit points is the delta we will apply to the camera's localtranslation
+     * @param hitPointRadius The distance between the world origin (center of globe) and the initial drag hit point
+     * @param ray The ray from the camera to the new cursor location
+     * @param localToEcefResult The matrix to convert from local to ECEF space
+     */
+    _recalculateDragPlaneHitPoint(hitPointRadius, ray, localToEcefResult) {
+        // Use the camera's geocentric normal to find the dragPlaneOriginPoint which lives at hitPointRadius along the camera's geocentric normal
+        this._cameraPosition.normalizeToRef(this._dragPlaneNormal);
+        this._dragPlaneNormal.scaleToRef(hitPointRadius, this._dragPlaneOriginPointEcef);
+        // The dragPlaneOffsetVector will later be recalculated when drag occurs, and the delta between the offset vectors will be applied to localTranslation
+        ComputeLocalBasisToRefs(this._dragPlaneOriginPointEcef, TmpVectors.Vector3[0], TmpVectors.Vector3[1], TmpVectors.Vector3[2]);
+        const localToEcef = Matrix.FromXYZAxesToRef(TmpVectors.Vector3[0], TmpVectors.Vector3[1], TmpVectors.Vector3[2], localToEcefResult);
+        localToEcef.setTranslationFromFloats(this._dragPlaneOriginPointEcef.x, this._dragPlaneOriginPointEcef.y, this._dragPlaneOriginPointEcef.z);
+        const ecefToLocal = localToEcef.invertToRef(TmpVectors.Matrix[1]);
+        // Now create a plane at that point, perpendicular to the camera's geocentric normal
+        Plane.FromPositionAndNormalToRef(this._dragPlaneOriginPointEcef, this._dragPlaneNormal, this._dragPlane);
+        // Lastly, find the _dragPlaneHitPoint where the ray intersects the _dragPlane.
+        if (IntersectRayWithPlaneToRef(ray, this._dragPlane, this._dragPlaneHitPointLocal)) {
+            // If hit, convert the drag plane hit point into the local space.
+            Vector3.TransformCoordinatesToRef(this._dragPlaneHitPointLocal, ecefToLocal, this._dragPlaneHitPointLocal);
+        }
+    }
+    handleDrag(pointerX, pointerY) {
+        if (this._hitPointRadius) {
+            const pickResult = this._scene.pick(pointerX, pointerY);
+            if (pickResult.ray) {
+                const localToEcef = TmpVectors.Matrix[0];
+                this._recalculateDragPlaneHitPoint(this._hitPointRadius, pickResult.ray, localToEcef);
+                const delta = this._dragPlaneHitPointLocal.subtractToRef(this._previousDragPlaneHitPointLocal, TmpVectors.Vector3[6]);
+                this._previousDragPlaneHitPointLocal.copyFrom(this._dragPlaneHitPointLocal);
+                Vector3.TransformNormalToRef(delta, localToEcef, delta);
+                this._dragPlaneOriginPointEcef.addInPlace(delta);
+                this.panAccumulatedPixels.subtractInPlace(delta);
+            }
+        }
+    }
+    /** @override */
+    computeCurrentFrameDeltas() {
+        const cameraCenter = this._cameraCenter;
+        // If a pan drag is occurring, stop zooming.
+        const isDragging = this._hitPointRadius !== undefined;
+        if (isDragging) {
+            this._zoomSpeedMultiplier = 0;
+            this._zoomVelocity = 0;
+        }
+        else {
+            // Scales zoom movement speed based on camera distance to origin (so long as no active pan is occurring)
+            this._zoomSpeedMultiplier = Vector3Distance(this._cameraPosition, cameraCenter) * 0.01;
+        }
+        // Before zero-ing out pixel deltas, capture if we have any active zoom in this frame (compared to zoom from inertia)
+        const activeZoom = Math.abs(this.zoomAccumulatedPixels) > 0;
+        super.computeCurrentFrameDeltas();
+        this._handleZoom(activeZoom);
+    }
+    _handleZoom(activeZoom) {
+        if (Math.abs(this.zoomDeltaCurrentFrame) > Epsilon) {
+            let pickDistance;
+            if (!activeZoom) {
+                // During inertia, use the previously stored pick distance
+                // TODO fix this to work with raycasting
+                pickDistance = this._storedZoomPickDistance;
+            }
+            else {
+                // Active zoom - pick and store the distance
+                const pickResult = this._scene.pick(this._scene.pointerX, this._scene.pointerY, this.pickPredicate);
+                if (pickResult.hit && pickResult.pickedPoint && pickResult.ray && this.zoomToCursor) {
+                    // Store both the zoom direction and the pick distance for use during inertia
+                    pickResult.ray.direction.normalizeToRef(this.computedPerFrameZoomVector);
+                    pickDistance = pickResult.distance;
+                    this._storedZoomPickDistance = pickDistance;
+                }
+                else {
+                    // If no hit under cursor, zoom along lookVector instead
+                    this._cameraLookAt.normalizeToRef(this.computedPerFrameZoomVector);
+                    const lookPickResult = this.pickAlongVector(this.computedPerFrameZoomVector);
+                    pickDistance = lookPickResult?.distance;
+                    this._storedZoomPickDistance = pickDistance;
+                }
+            }
+            // Clamp distance based on limits and update center
+            this._clampZoomDistance(this.zoomDeltaCurrentFrame, pickDistance);
+        }
+    }
+    _clampZoomDistance(requestedDistance, pickResultDistance) {
+        // If pickResult is defined
+        if (requestedDistance > 0) {
+            if (pickResultDistance !== undefined) {
+                // If there is a pick, allow movement up to pick - minAltitude
+                if (pickResultDistance - this.limits.altitudeMin < 0) {
+                    this.zoomDeltaCurrentFrame = 0;
+                }
+                this.zoomDeltaCurrentFrame = Math.min(requestedDistance, pickResultDistance - this.limits.altitudeMin);
+            }
+            else {
+                this.zoomDeltaCurrentFrame = requestedDistance;
+            }
+        }
+        if (requestedDistance < 0) {
+            const maxZoomOut = this.limits.radiusMax ? this.limits.radiusMax - this._cameraPosition.length() : Number.POSITIVE_INFINITY;
+            this.zoomDeltaCurrentFrame = Math.max(requestedDistance, -maxZoomOut);
+        }
+        return this.zoomDeltaCurrentFrame;
+    }
+    pickAlongVector(vector) {
+        this._tempPickingRay.origin.copyFrom(this._cameraPosition);
+        this._tempPickingRay.direction.copyFrom(vector);
+        return this._scene.pickWithRay(this._tempPickingRay, this.pickPredicate);
+    }
+}
+function IntersectRayWithPlaneToRef(ray, plane, ref) {
+    // Distance along the ray to the plane; null if no hit
+    const dist = ray.intersectsPlane(plane);
+    if (dist !== null && dist >= 0) {
+        ray.origin.addToRef(ray.direction.scaleToRef(dist, TmpVectors.Vector3[0]), ref);
+        return true;
+    }
+    return false;
+}
+/**
+ * Helper to build east/north/up basis vectors at a world position.
+ * @internal
+ */
+export function ComputeLocalBasisToRefs(worldPos, refEast, refNorth, refUp) {
+    // up = normalized position (geocentric normal)
+    refUp.copyFrom(worldPos).normalize();
+    // east = normalize(worldNorth × up)
+    // (cross product of Earth rotation axis with up gives east except near poles)
+    const worldNorth = Vector3.LeftHandedForwardReadOnly; // (0,0,1)
+    Vector3.CrossToRef(worldNorth, refUp, refEast);
+    // at poles, cross with worldRight instead
+    if (refEast.lengthSquared() < Epsilon) {
+        Vector3.CrossToRef(Vector3.Right(), refUp, refEast);
+    }
+    refEast.normalize();
+    // north = up × east (completes right-handed basis)
+    Vector3.CrossToRef(refUp, refEast, refNorth);
+    refNorth.normalize();
+}
+//# sourceMappingURL=geospatialCameraMovement.js.map

package/Cameras/geospatialCameraMovement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geospatialCameraMovement.js","sourceRoot":"","sources":["../../../../dev/core/src/Cameras/geospatialCameraMovement.ts"],"names":[],"mappings":"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","sourcesContent":["import { CameraMovement } from \"./cameraMovement\";\r\nimport { Epsilon } from \"../Maths/math.constants\";\r\nimport type { GeospatialLimits } from \"./Limits/geospatialLimits\";\r\nimport { Matrix, TmpVectors, Vector3 } from \"../Maths/math.vector\";\r\nimport type { MeshPredicate } from \"../Culling/ray.core\";\r\nimport { Plane } from \"../Maths/math.plane\";\r\nimport { Ray } from \"../Culling/ray\";\r\nimport type { Scene } from \"../scene\";\r\nimport { Vector3Distance } from \"../Maths/math.vector.functions\";\r\nimport type { PickingInfo } from \"../Collisions/pickingInfo\";\r\nimport type { Nullable } from \"../types\";\r\n\r\n/**\r\n * @experimental\r\n * This class is subject to change as the geospatial camera evolves.\r\n *\r\n * Geospatial-specific camera movement system that extends the base movement with\r\n * raycasting and altitude-aware zoom constraints.\r\n *\r\n * This class encapsulates geospatial camera movement logic:\r\n * - Dragging in a way which keeps cursor anchored to globe\r\n * - Latitude-based pan speed dampening\r\n * - Zoom speed scaling based on distance to center\r\n * - Raycasting to determine zoom constraints based on terrain/globe\r\n * - Altitude-based zoom clamping\r\n * - Zoom direction calculation (towards cursor vs along look vector)\r\n */\r\nexport class GeospatialCameraMovement extends CameraMovement {\r\n    /** Predicate function to determine which meshes to pick against (e.g., globe mesh) */\r\n    public pickPredicate?: MeshPredicate;\r\n    public computedPerFrameZoomVector: Vector3 = new Vector3();\r\n\r\n    public zoomToCursor: boolean = true;\r\n\r\n    /**\r\n     * Enables rotation around a specific point, instead of default rotation around center\r\n     * @internal\r\n     */\r\n    public alternateRotationPt?: Vector3;\r\n\r\n    private _tempPickingRay: Ray;\r\n    private _storedZoomPickDistance: number | undefined;\r\n\r\n    private _hitPointRadius?: number = undefined;\r\n    private _dragPlane: Plane = new Plane(0, 0, 0, 0);\r\n    private _dragPlaneNormal: Vector3 = Vector3.Zero();\r\n    private _dragPlaneOriginPointEcef: Vector3 = Vector3.Zero();\r\n    private _dragPlaneHitPointLocal: Vector3 = Vector3.Zero();\r\n    private _previousDragPlaneHitPointLocal: Vector3 = Vector3.Zero();\r\n\r\n    constructor(\r\n        scene: Scene,\r\n        public limits: GeospatialLimits,\r\n        cameraPosition: Vector3,\r\n        private _cameraCenter: Vector3,\r\n        private _cameraLookAt: Vector3,\r\n        pickPredicate?: MeshPredicate\r\n    ) {\r\n        super(scene, cameraPosition);\r\n        this.computedPerFrameZoomVector.copyFrom(this._cameraLookAt);\r\n        this.pickPredicate = pickPredicate;\r\n        this._tempPickingRay = new Ray(this._cameraPosition, this._cameraLookAt);\r\n        this.panInertia = 0;\r\n        this.rotationInertia = 0;\r\n        this.rotationXSpeed = Math.PI / 500; // Move 1/500th of a half circle per pixel\r\n        this.rotationYSpeed = Math.PI / 500; // Move 1/500th of a half circle per pixel\r\n    }\r\n\r\n    public startDrag(pointerX: number, pointerY: number) {\r\n        const pickResult = this._scene.pick(pointerX, pointerY, this.pickPredicate);\r\n        if (pickResult.pickedPoint && pickResult.ray) {\r\n            // Store radius from earth center to pickedPoint, used when calculating drag plane\r\n            this._hitPointRadius = pickResult.pickedPoint.length();\r\n\r\n            this._recalculateDragPlaneHitPoint(this._hitPointRadius, pickResult.ray, TmpVectors.Matrix[0]);\r\n            this._previousDragPlaneHitPointLocal.copyFrom(this._dragPlaneHitPointLocal);\r\n        } else {\r\n            this._hitPointRadius = undefined; // can't drag without a hit on the globe\r\n        }\r\n    }\r\n\r\n    public stopDrag() {\r\n        this._hitPointRadius = undefined;\r\n    }\r\n\r\n    /**\r\n     * The previous drag plane hit point in local space is stored to compute the movement delta.\r\n     * As the drag movement occurs, we will continuously recalculate this point. The delta between the previous and current hit points is the delta we will apply to the camera's localtranslation\r\n     * @param hitPointRadius The distance between the world origin (center of globe) and the initial drag hit point\r\n     * @param ray The ray from the camera to the new cursor location\r\n     * @param localToEcefResult The matrix to convert from local to ECEF space\r\n     */\r\n    private _recalculateDragPlaneHitPoint(hitPointRadius: number, ray: Ray, localToEcefResult: Matrix): void {\r\n        // Use the camera's geocentric normal to find the dragPlaneOriginPoint which lives at hitPointRadius along the camera's geocentric normal\r\n        this._cameraPosition.normalizeToRef(this._dragPlaneNormal);\r\n        this._dragPlaneNormal.scaleToRef(hitPointRadius, this._dragPlaneOriginPointEcef);\r\n\r\n        // The dragPlaneOffsetVector will later be recalculated when drag occurs, and the delta between the offset vectors will be applied to localTranslation\r\n        ComputeLocalBasisToRefs(this._dragPlaneOriginPointEcef, TmpVectors.Vector3[0], TmpVectors.Vector3[1], TmpVectors.Vector3[2]);\r\n        const localToEcef = Matrix.FromXYZAxesToRef(TmpVectors.Vector3[0], TmpVectors.Vector3[1], TmpVectors.Vector3[2], localToEcefResult);\r\n        localToEcef.setTranslationFromFloats(this._dragPlaneOriginPointEcef.x, this._dragPlaneOriginPointEcef.y, this._dragPlaneOriginPointEcef.z);\r\n        const ecefToLocal = localToEcef.invertToRef(TmpVectors.Matrix[1]);\r\n\r\n        // Now create a plane at that point, perpendicular to the camera's geocentric normal\r\n        Plane.FromPositionAndNormalToRef(this._dragPlaneOriginPointEcef, this._dragPlaneNormal, this._dragPlane);\r\n\r\n        // Lastly, find the _dragPlaneHitPoint where the ray intersects the _dragPlane.\r\n        if (IntersectRayWithPlaneToRef(ray, this._dragPlane, this._dragPlaneHitPointLocal)) {\r\n            // If hit, convert the drag plane hit point into the local space.\r\n            Vector3.TransformCoordinatesToRef(this._dragPlaneHitPointLocal, ecefToLocal, this._dragPlaneHitPointLocal);\r\n        }\r\n    }\r\n\r\n    public handleDrag(pointerX: number, pointerY: number) {\r\n        if (this._hitPointRadius) {\r\n            const pickResult = this._scene.pick(pointerX, pointerY);\r\n            if (pickResult.ray) {\r\n                const localToEcef = TmpVectors.Matrix[0];\r\n                this._recalculateDragPlaneHitPoint(this._hitPointRadius, pickResult.ray, localToEcef);\r\n\r\n                const delta = this._dragPlaneHitPointLocal.subtractToRef(this._previousDragPlaneHitPointLocal, TmpVectors.Vector3[6]);\r\n                this._previousDragPlaneHitPointLocal.copyFrom(this._dragPlaneHitPointLocal);\r\n\r\n                Vector3.TransformNormalToRef(delta, localToEcef, delta);\r\n                this._dragPlaneOriginPointEcef.addInPlace(delta);\r\n\r\n                this.panAccumulatedPixels.subtractInPlace(delta);\r\n            }\r\n        }\r\n    }\r\n\r\n    /** @override */\r\n    public override computeCurrentFrameDeltas(): void {\r\n        const cameraCenter = this._cameraCenter;\r\n\r\n        // If a pan drag is occurring, stop zooming.\r\n        const isDragging = this._hitPointRadius !== undefined;\r\n        if (isDragging) {\r\n            this._zoomSpeedMultiplier = 0;\r\n            this._zoomVelocity = 0;\r\n        } else {\r\n            // Scales zoom movement speed based on camera distance to origin (so long as no active pan is occurring)\r\n            this._zoomSpeedMultiplier = Vector3Distance(this._cameraPosition, cameraCenter) * 0.01;\r\n        }\r\n\r\n        // Before zero-ing out pixel deltas, capture if we have any active zoom in this frame (compared to zoom from inertia)\r\n        const activeZoom = Math.abs(this.zoomAccumulatedPixels) > 0;\r\n        super.computeCurrentFrameDeltas();\r\n\r\n        this._handleZoom(activeZoom);\r\n    }\r\n\r\n    private _handleZoom(activeZoom: boolean) {\r\n        if (Math.abs(this.zoomDeltaCurrentFrame) > Epsilon) {\r\n            let pickDistance: number | undefined;\r\n\r\n            if (!activeZoom) {\r\n                // During inertia, use the previously stored pick distance\r\n                // TODO fix this to work with raycasting\r\n                pickDistance = this._storedZoomPickDistance;\r\n            } else {\r\n                // Active zoom - pick and store the distance\r\n                const pickResult = this._scene.pick(this._scene.pointerX, this._scene.pointerY, this.pickPredicate);\r\n\r\n                if (pickResult.hit && pickResult.pickedPoint && pickResult.ray && this.zoomToCursor) {\r\n                    // Store both the zoom direction and the pick distance for use during inertia\r\n                    pickResult.ray.direction.normalizeToRef(this.computedPerFrameZoomVector);\r\n                    pickDistance = pickResult.distance;\r\n                    this._storedZoomPickDistance = pickDistance;\r\n                } else {\r\n                    // If no hit under cursor, zoom along lookVector instead\r\n                    this._cameraLookAt.normalizeToRef(this.computedPerFrameZoomVector);\r\n                    const lookPickResult = this.pickAlongVector(this.computedPerFrameZoomVector);\r\n                    pickDistance = lookPickResult?.distance;\r\n                    this._storedZoomPickDistance = pickDistance;\r\n                }\r\n            }\r\n\r\n            // Clamp distance based on limits and update center\r\n            this._clampZoomDistance(this.zoomDeltaCurrentFrame, pickDistance);\r\n        }\r\n    }\r\n\r\n    private _clampZoomDistance(requestedDistance: number, pickResultDistance: number | undefined): number {\r\n        // If pickResult is defined\r\n        if (requestedDistance > 0) {\r\n            if (pickResultDistance !== undefined) {\r\n                // If there is a pick, allow movement up to pick - minAltitude\r\n                if (pickResultDistance - this.limits.altitudeMin < 0) {\r\n                    this.zoomDeltaCurrentFrame = 0;\r\n                }\r\n                this.zoomDeltaCurrentFrame = Math.min(requestedDistance, pickResultDistance - this.limits.altitudeMin);\r\n            } else {\r\n                this.zoomDeltaCurrentFrame = requestedDistance;\r\n            }\r\n        }\r\n\r\n        if (requestedDistance < 0) {\r\n            const maxZoomOut = this.limits.radiusMax ? this.limits.radiusMax - this._cameraPosition.length() : Number.POSITIVE_INFINITY;\r\n            this.zoomDeltaCurrentFrame = Math.max(requestedDistance, -maxZoomOut);\r\n        }\r\n\r\n        return this.zoomDeltaCurrentFrame;\r\n    }\r\n\r\n    public pickAlongVector(vector: Vector3): Nullable<PickingInfo> {\r\n        this._tempPickingRay.origin.copyFrom(this._cameraPosition);\r\n        this._tempPickingRay.direction.copyFrom(vector);\r\n        return this._scene.pickWithRay(this._tempPickingRay, this.pickPredicate);\r\n    }\r\n}\r\n\r\nfunction IntersectRayWithPlaneToRef(ray: Ray, plane: Plane, ref: Vector3): boolean {\r\n    // Distance along the ray to the plane; null if no hit\r\n    const dist = ray.intersectsPlane(plane);\r\n\r\n    if (dist !== null && dist >= 0) {\r\n        ray.origin.addToRef(ray.direction.scaleToRef(dist, TmpVectors.Vector3[0]), ref);\r\n        return true;\r\n    }\r\n\r\n    return false;\r\n}\r\n\r\n/**\r\n * Helper to build east/north/up basis vectors at a world position.\r\n * @internal\r\n */\r\nexport function ComputeLocalBasisToRefs(worldPos: Vector3, refEast: Vector3, refNorth: Vector3, refUp: Vector3) {\r\n    // up = normalized position (geocentric normal)\r\n    refUp.copyFrom(worldPos).normalize();\r\n\r\n    // east = normalize(worldNorth × up)\r\n    // (cross product of Earth rotation axis with up gives east except near poles)\r\n    const worldNorth = Vector3.LeftHandedForwardReadOnly; // (0,0,1)\r\n    Vector3.CrossToRef(worldNorth, refUp, refEast);\r\n\r\n    // at poles, cross with worldRight instead\r\n    if (refEast.lengthSquared() < Epsilon) {\r\n        Vector3.CrossToRef(Vector3.Right(), refUp, refEast);\r\n    }\r\n    refEast.normalize();\r\n\r\n    // north = up × east (completes right-handed basis)\r\n    Vector3.CrossToRef(refUp, refEast, refNorth);\r\n    refNorth.normalize();\r\n}\r\n"]}

package/Engines/Native/nativeInterfaces.d.ts

@@ -329,15 +329,23 @@ interface INativeDataStreamConstructor {
     readonly VALIDATION_NATIVE_DATA: number;
     readonly VALIDATION_BOOLEAN: number;
 }
+export declare enum NativeTraceLevel {
+    Mark = 1,
+    Log = 2
+}
 /** @internal */
 export interface INative {
     Engine: INativeEngineConstructor;
-    Camera: INativeCameraConstructor;
-    Canvas: INativeCanvasConstructor;
-    Image: INativeImageConstructor;
-    Path2D: INativePath2DConstructor;
-    XMLHttpRequest: any;
-    DeviceInputSystem: IDeviceInputSystemConstructor;
     NativeDataStream: INativeDataStreamConstructor;
+    Camera?: INativeCameraConstructor;
+    Canvas?: INativeCanvasConstructor;
+    Image?: INativeImageConstructor;
+    Path2D?: INativePath2DConstructor;
+    XMLHttpRequest?: typeof XMLHttpRequest;
+    DeviceInputSystem?: IDeviceInputSystemConstructor;
+    enablePerformanceLogging?(level?: NativeTraceLevel): void;
+    disablePerformanceLogging?(): void;
+    startPerformanceCounter?(counter: string): unknown;
+    endPerformanceCounter?(counter: unknown): void;
 }
 export {};

package/Engines/Native/nativeInterfaces.js

@@ -1,2 +1,7 @@
-export {};
+// Note: These values need to match those in Babylon Native's NativeTracing plugin.
+export var NativeTraceLevel;
+(function (NativeTraceLevel) {
+    NativeTraceLevel[NativeTraceLevel["Mark"] = 1] = "Mark";
+    NativeTraceLevel[NativeTraceLevel["Log"] = 2] = "Log";
+})(NativeTraceLevel || (NativeTraceLevel = {}));
 //# sourceMappingURL=nativeInterfaces.js.map

package/Engines/Native/nativeInterfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"nativeInterfaces.js","sourceRoot":"","sources":["../../../../../dev/core/src/Engines/Native/nativeInterfaces.ts"],"names":[],"mappings":"","sourcesContent":["/* eslint-disable @typescript-eslint/naming-convention */\r\nimport type { DeviceType } from \"../../DeviceInput/InputDevices/deviceEnums\";\r\nimport type { IDeviceInputSystem } from \"../../DeviceInput/inputInterfaces\";\r\nimport type { InternalTexture } from \"../../Materials/Textures/internalTexture\";\r\nimport type { Nullable } from \"../../types\";\r\nimport type { ICanvas, IImage, IPath2D } from \"../ICanvas\";\r\nimport type { NativeData, NativeDataStream } from \"./nativeDataStream\";\r\n\r\nexport type NativeTexture = NativeData;\r\nexport type NativeFramebuffer = NativeData;\r\nexport type NativeVertexArrayObject = NativeData;\r\nexport type NativeProgram = NativeData;\r\nexport type NativeUniform = NativeData;\r\n\r\n/** @internal */\r\nexport type NativeFrameStats = {\r\n    /** @internal */\r\n    gpuTimeNs: number;\r\n};\r\n\r\n/** @internal */\r\nexport interface INativeEngine {\r\n    dispose(): void;\r\n\r\n    requestAnimationFrame(callback: () => void): void;\r\n    setDeviceLostCallback(callback: () => void): void;\r\n\r\n    createVertexArray(): NativeData;\r\n\r\n    createIndexBuffer(dataBuffer: ArrayBuffer, dataByteOffset: number, dataByteLength: number, is32Bits: boolean, dynamic: boolean): NativeData;\r\n    recordIndexBuffer(vertexArray: NativeData, indexBuffer: NativeData): void;\r\n    updateDynamicIndexBuffer(indexBuffer: NativeData, data: ArrayBuffer, dataByteOffset: number, dataByteLength: number, startIndex: number): void;\r\n\r\n    createVertexBuffer(dataBuffer: ArrayBuffer, dataByteOffset: number, dataByteLength: number, dynamic: boolean): NativeData;\r\n    recordVertexBuffer(\r\n        vertexArray: NativeData,\r\n        vertexBuffer: NativeData,\r\n        location: number,\r\n        byteOffset: number,\r\n        byteStride: number,\r\n        numElements: number,\r\n        type: number,\r\n        normalized: boolean,\r\n        instanceDivisor: number\r\n    ): void;\r\n    updateDynamicVertexBuffer(vertexBuffer: NativeData, dataBuffer: ArrayBuffer, dataByteOffset: number, dataByteLength: number, vertexByteOffset?: number): void;\r\n\r\n    createProgram(vertexShader: string, fragmentShader: string): NativeProgram;\r\n    createProgramAsync(vertexShader: string, fragmentShader: string, onSuccess: () => void, onError: (error: Error) => void): NativeProgram;\r\n    getUniforms(shaderProgram: NativeProgram, uniformsNames: string[]): WebGLUniformLocation[];\r\n    getAttributes(shaderProgram: NativeProgram, attributeNames: string[]): number[];\r\n\r\n    createTexture(): NativeTexture;\r\n    initializeTexture(texture: NativeTexture, width: number, height: number, hasMips: boolean, format: number, renderTarget: boolean, srgb: boolean, samples: number): void;\r\n    loadTexture(texture: NativeTexture, data: ArrayBufferView, generateMips: boolean, invertY: boolean, srgb: boolean, onSuccess: () => void, onError: () => void): void;\r\n    loadRawTexture(texture: NativeTexture, data: ArrayBufferView, width: number, height: number, format: number, generateMips: boolean, invertY: boolean): void;\r\n    loadRawTexture2DArray(\r\n        texture: NativeTexture,\r\n        data: Nullable<ArrayBufferView>,\r\n        width: number,\r\n        height: number,\r\n        depth: number,\r\n        format: number,\r\n        generateMipMaps: boolean,\r\n        invertY: boolean\r\n    ): void;\r\n    loadCubeTexture(texture: NativeTexture, data: Array<ArrayBufferView>, generateMips: boolean, invertY: boolean, srgb: boolean, onSuccess: () => void, onError: () => void): void;\r\n    loadCubeTextureWithMips(texture: NativeTexture, data: Array<Array<ArrayBufferView>>, invertY: boolean, srgb: boolean, onSuccess: () => void, onError: () => void): void;\r\n    getTextureWidth(texture: NativeTexture): number;\r\n    getTextureHeight(texture: NativeTexture): number;\r\n    deleteTexture(texture: NativeTexture): void;\r\n    readTexture(\r\n        texture: NativeTexture,\r\n        mipLevel: number,\r\n        x: number,\r\n        y: number,\r\n        width: number,\r\n        height: number,\r\n        buffer: Nullable<ArrayBuffer>,\r\n        bufferOffset: number,\r\n        bufferLength: number\r\n    ): Promise<ArrayBuffer>;\r\n\r\n    createImageBitmap(data: ArrayBuffer | IImage): ImageBitmap;\r\n    resizeImageBitmap(image: ImageBitmap, bufferWidth: number, bufferHeight: number): Uint8Array;\r\n\r\n    createFrameBuffer(\r\n        texture: Nullable<NativeTexture>,\r\n        width: number,\r\n        height: number,\r\n        generateStencilBuffer: boolean,\r\n        generateDepthBuffer: boolean,\r\n        samples: number\r\n    ): NativeFramebuffer;\r\n\r\n    getRenderWidth(): number;\r\n    getRenderHeight(): number;\r\n\r\n    setHardwareScalingLevel(level: number): void;\r\n\r\n    setViewPort(x: number, y: number, width: number, height: number): void;\r\n\r\n    setCommandDataStream(dataStream: NativeDataStream): void;\r\n    submitCommands(): void;\r\n\r\n    populateFrameStats(stats: NativeFrameStats): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeEngineInfo {\r\n    version: string;\r\n    nonFloatVertexBuffers: true;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeEngineConstructor {\r\n    prototype: INativeEngine;\r\n    new (info: INativeEngineInfo): INativeEngine;\r\n\r\n    readonly PROTOCOL_VERSION: number;\r\n\r\n    readonly CAPS_LIMITS_MAX_TEXTURE_SIZE: number;\r\n    readonly CAPS_LIMITS_MAX_TEXTURE_LAYERS: number;\r\n\r\n    readonly TEXTURE_NEAREST_NEAREST: number;\r\n    readonly TEXTURE_LINEAR_LINEAR: number;\r\n    readonly TEXTURE_LINEAR_LINEAR_MIPLINEAR: number;\r\n    readonly TEXTURE_NEAREST_NEAREST_MIPNEAREST: number;\r\n    readonly TEXTURE_NEAREST_LINEAR_MIPNEAREST: number;\r\n    readonly TEXTURE_NEAREST_LINEAR_MIPLINEAR: number;\r\n    readonly TEXTURE_NEAREST_LINEAR: number;\r\n    readonly TEXTURE_NEAREST_NEAREST_MIPLINEAR: number;\r\n    readonly TEXTURE_LINEAR_NEAREST_MIPNEAREST: number;\r\n    readonly TEXTURE_LINEAR_NEAREST_MIPLINEAR: number;\r\n    readonly TEXTURE_LINEAR_LINEAR_MIPNEAREST: number;\r\n    readonly TEXTURE_LINEAR_NEAREST: number;\r\n\r\n    readonly DEPTH_TEST_LESS: number;\r\n    readonly DEPTH_TEST_LEQUAL: number;\r\n    readonly DEPTH_TEST_EQUAL: number;\r\n    readonly DEPTH_TEST_GEQUAL: number;\r\n    readonly DEPTH_TEST_GREATER: number;\r\n    readonly DEPTH_TEST_NOTEQUAL: number;\r\n    readonly DEPTH_TEST_NEVER: number;\r\n    readonly DEPTH_TEST_ALWAYS: number;\r\n\r\n    readonly ADDRESS_MODE_WRAP: number;\r\n    readonly ADDRESS_MODE_MIRROR: number;\r\n    readonly ADDRESS_MODE_CLAMP: number;\r\n    readonly ADDRESS_MODE_BORDER: number;\r\n    readonly ADDRESS_MODE_MIRROR_ONCE: number;\r\n\r\n    readonly TEXTURE_FORMAT_BC1: number;\r\n    readonly TEXTURE_FORMAT_BC2: number;\r\n    readonly TEXTURE_FORMAT_BC3: number;\r\n    readonly TEXTURE_FORMAT_BC4: number;\r\n    readonly TEXTURE_FORMAT_BC5: number;\r\n    readonly TEXTURE_FORMAT_BC6H: number;\r\n    readonly TEXTURE_FORMAT_BC7: number;\r\n    readonly TEXTURE_FORMAT_ETC1: number;\r\n    readonly TEXTURE_FORMAT_ETC2: number;\r\n    readonly TEXTURE_FORMAT_ETC2A: number;\r\n    readonly TEXTURE_FORMAT_ETC2A1: number;\r\n    readonly TEXTURE_FORMAT_PTC12: number;\r\n    readonly TEXTURE_FORMAT_PTC14: number;\r\n    readonly TEXTURE_FORMAT_PTC12A: number;\r\n    readonly TEXTURE_FORMAT_PTC14A: number;\r\n    readonly TEXTURE_FORMAT_PTC22: number;\r\n    readonly TEXTURE_FORMAT_PTC24: number;\r\n    readonly TEXTURE_FORMAT_ATC: number;\r\n    readonly TEXTURE_FORMAT_ATCE: number;\r\n    readonly TEXTURE_FORMAT_ATCI: number;\r\n    readonly TEXTURE_FORMAT_ASTC4x4: number;\r\n    readonly TEXTURE_FORMAT_ASTC5x4: number;\r\n    readonly TEXTURE_FORMAT_ASTC5x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC6x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC6x6: number;\r\n    readonly TEXTURE_FORMAT_ASTC8x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC8x6: number;\r\n    readonly TEXTURE_FORMAT_ASTC8x8: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x6: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x8: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x10: number;\r\n    readonly TEXTURE_FORMAT_ASTC12x10: number;\r\n    readonly TEXTURE_FORMAT_ASTC12x12: number;\r\n\r\n    readonly TEXTURE_FORMAT_R1: number;\r\n    readonly TEXTURE_FORMAT_A8: number;\r\n    readonly TEXTURE_FORMAT_R8: number;\r\n    readonly TEXTURE_FORMAT_R8I: number;\r\n    readonly TEXTURE_FORMAT_R8U: number;\r\n    readonly TEXTURE_FORMAT_R8S: number;\r\n    readonly TEXTURE_FORMAT_R16: number;\r\n    readonly TEXTURE_FORMAT_R16I: number;\r\n    readonly TEXTURE_FORMAT_R16U: number;\r\n    readonly TEXTURE_FORMAT_R16F: number;\r\n    readonly TEXTURE_FORMAT_R16S: number;\r\n    readonly TEXTURE_FORMAT_R32I: number;\r\n    readonly TEXTURE_FORMAT_R32U: number;\r\n    readonly TEXTURE_FORMAT_R32F: number;\r\n    readonly TEXTURE_FORMAT_RG8: number;\r\n    readonly TEXTURE_FORMAT_RG8I: number;\r\n    readonly TEXTURE_FORMAT_RG8U: number;\r\n    readonly TEXTURE_FORMAT_RG8S: number;\r\n    readonly TEXTURE_FORMAT_RG16: number;\r\n    readonly TEXTURE_FORMAT_RG16I: number;\r\n    readonly TEXTURE_FORMAT_RG16U: number;\r\n    readonly TEXTURE_FORMAT_RG16F: number;\r\n    readonly TEXTURE_FORMAT_RG16S: number;\r\n    readonly TEXTURE_FORMAT_RG32I: number;\r\n    readonly TEXTURE_FORMAT_RG32U: number;\r\n    readonly TEXTURE_FORMAT_RG32F: number;\r\n    readonly TEXTURE_FORMAT_RGB8: number;\r\n    readonly TEXTURE_FORMAT_RGB8I: number;\r\n    readonly TEXTURE_FORMAT_RGB8U: number;\r\n    readonly TEXTURE_FORMAT_RGB8S: number;\r\n    readonly TEXTURE_FORMAT_RGB9E5F: number;\r\n    readonly TEXTURE_FORMAT_BGRA8: number;\r\n    readonly TEXTURE_FORMAT_RGBA8: number;\r\n    readonly TEXTURE_FORMAT_RGBA8I: number;\r\n    readonly TEXTURE_FORMAT_RGBA8U: number;\r\n    readonly TEXTURE_FORMAT_RGBA8S: number;\r\n    readonly TEXTURE_FORMAT_RGBA16: number;\r\n    readonly TEXTURE_FORMAT_RGBA16I: number;\r\n    readonly TEXTURE_FORMAT_RGBA16U: number;\r\n    readonly TEXTURE_FORMAT_RGBA16F: number;\r\n    readonly TEXTURE_FORMAT_RGBA16S: number;\r\n    readonly TEXTURE_FORMAT_RGBA32I: number;\r\n    readonly TEXTURE_FORMAT_RGBA32U: number;\r\n    readonly TEXTURE_FORMAT_RGBA32F: number;\r\n    readonly TEXTURE_FORMAT_B5G6R5: number;\r\n    readonly TEXTURE_FORMAT_R5G6B5: number;\r\n    readonly TEXTURE_FORMAT_BGRA4: number;\r\n    readonly TEXTURE_FORMAT_RGBA4: number;\r\n    readonly TEXTURE_FORMAT_BGR5A1: number;\r\n    readonly TEXTURE_FORMAT_RGB5A1: number;\r\n    readonly TEXTURE_FORMAT_RGB10A2: number;\r\n    readonly TEXTURE_FORMAT_RG11B10F: number;\r\n\r\n    readonly TEXTURE_FORMAT_D16: number;\r\n    readonly TEXTURE_FORMAT_D24: number;\r\n    readonly TEXTURE_FORMAT_D24S8: number;\r\n    readonly TEXTURE_FORMAT_D32: number;\r\n    readonly TEXTURE_FORMAT_D16F: number;\r\n    readonly TEXTURE_FORMAT_D24F: number;\r\n    readonly TEXTURE_FORMAT_D32F: number;\r\n    readonly TEXTURE_FORMAT_D0S8: number;\r\n\r\n    readonly ATTRIB_TYPE_INT8: number;\r\n    readonly ATTRIB_TYPE_UINT8: number;\r\n    readonly ATTRIB_TYPE_INT16: number;\r\n    readonly ATTRIB_TYPE_UINT16: number;\r\n    readonly ATTRIB_TYPE_FLOAT: number;\r\n\r\n    readonly ALPHA_DISABLE: number;\r\n    readonly ALPHA_ADD: number;\r\n    readonly ALPHA_COMBINE: number;\r\n    readonly ALPHA_SUBTRACT: number;\r\n    readonly ALPHA_MULTIPLY: number;\r\n    readonly ALPHA_MAXIMIZED: number;\r\n    readonly ALPHA_ONEONE: number;\r\n    readonly ALPHA_PREMULTIPLIED: number;\r\n    readonly ALPHA_PREMULTIPLIED_PORTERDUFF: number;\r\n    readonly ALPHA_INTERPOLATE: number;\r\n    readonly ALPHA_SCREENMODE: number;\r\n\r\n    readonly STENCIL_TEST_LESS: number;\r\n    readonly STENCIL_TEST_LEQUAL: number;\r\n    readonly STENCIL_TEST_EQUAL: number;\r\n    readonly STENCIL_TEST_GEQUAL: number;\r\n    readonly STENCIL_TEST_GREATER: number;\r\n    readonly STENCIL_TEST_NOTEQUAL: number;\r\n    readonly STENCIL_TEST_NEVER: number;\r\n    readonly STENCIL_TEST_ALWAYS: number;\r\n\r\n    readonly STENCIL_OP_FAIL_S_ZERO: number;\r\n    readonly STENCIL_OP_FAIL_S_KEEP: number;\r\n    readonly STENCIL_OP_FAIL_S_REPLACE: number;\r\n    readonly STENCIL_OP_FAIL_S_INCR: number;\r\n    readonly STENCIL_OP_FAIL_S_INCRSAT: number;\r\n    readonly STENCIL_OP_FAIL_S_DECR: number;\r\n    readonly STENCIL_OP_FAIL_S_DECRSAT: number;\r\n    readonly STENCIL_OP_FAIL_S_INVERT: number;\r\n\r\n    readonly STENCIL_OP_FAIL_Z_ZERO: number;\r\n    readonly STENCIL_OP_FAIL_Z_KEEP: number;\r\n    readonly STENCIL_OP_FAIL_Z_REPLACE: number;\r\n    readonly STENCIL_OP_FAIL_Z_INCR: number;\r\n    readonly STENCIL_OP_FAIL_Z_INCRSAT: number;\r\n    readonly STENCIL_OP_FAIL_Z_DECR: number;\r\n    readonly STENCIL_OP_FAIL_Z_DECRSAT: number;\r\n    readonly STENCIL_OP_FAIL_Z_INVERT: number;\r\n\r\n    readonly STENCIL_OP_PASS_Z_ZERO: number;\r\n    readonly STENCIL_OP_PASS_Z_KEEP: number;\r\n    readonly STENCIL_OP_PASS_Z_REPLACE: number;\r\n    readonly STENCIL_OP_PASS_Z_INCR: number;\r\n    readonly STENCIL_OP_PASS_Z_INCRSAT: number;\r\n    readonly STENCIL_OP_PASS_Z_DECR: number;\r\n    readonly STENCIL_OP_PASS_Z_DECRSAT: number;\r\n    readonly STENCIL_OP_PASS_Z_INVERT: number;\r\n\r\n    readonly COMMAND_DELETEVERTEXARRAY: NativeData;\r\n    readonly COMMAND_DELETEINDEXBUFFER: NativeData;\r\n    readonly COMMAND_DELETEVERTEXBUFFER: NativeData;\r\n    readonly COMMAND_SETPROGRAM: NativeData;\r\n    readonly COMMAND_SETMATRIX: NativeData;\r\n    readonly COMMAND_SETMATRIX3X3: NativeData;\r\n    readonly COMMAND_SETMATRIX2X2: NativeData;\r\n    readonly COMMAND_SETMATRICES: NativeData;\r\n    readonly COMMAND_SETINT: NativeData;\r\n    readonly COMMAND_SETINTARRAY: NativeData;\r\n    readonly COMMAND_SETINTARRAY2: NativeData;\r\n    readonly COMMAND_SETINTARRAY3: NativeData;\r\n    readonly COMMAND_SETINTARRAY4: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY2: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY3: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY4: NativeData;\r\n    readonly COMMAND_SETTEXTURESAMPLING: NativeData;\r\n    readonly COMMAND_SETTEXTUREWRAPMODE: NativeData;\r\n    readonly COMMAND_SETTEXTUREANISOTROPICLEVEL: NativeData;\r\n    readonly COMMAND_SETTEXTURE: NativeData;\r\n    readonly COMMAND_UNSETTEXTURE: NativeData;\r\n    readonly COMMAND_DISCARDALLTEXTURES: NativeData;\r\n    readonly COMMAND_BINDVERTEXARRAY: NativeData;\r\n    readonly COMMAND_SETSTATE: NativeData;\r\n    readonly COMMAND_DELETEPROGRAM: NativeData;\r\n    readonly COMMAND_SETZOFFSET: NativeData;\r\n    readonly COMMAND_SETZOFFSETUNITS: NativeData;\r\n    readonly COMMAND_SETDEPTHTEST: NativeData;\r\n    readonly COMMAND_SETDEPTHWRITE: NativeData;\r\n    readonly COMMAND_SETCOLORWRITE: NativeData;\r\n    readonly COMMAND_SETBLENDMODE: NativeData;\r\n    readonly COMMAND_SETFLOAT: NativeData;\r\n    readonly COMMAND_SETFLOAT2: NativeData;\r\n    readonly COMMAND_SETFLOAT3: NativeData;\r\n    readonly COMMAND_SETFLOAT4: NativeData;\r\n    readonly COMMAND_BINDFRAMEBUFFER: NativeData;\r\n    readonly COMMAND_UNBINDFRAMEBUFFER: NativeData;\r\n    readonly COMMAND_DELETEFRAMEBUFFER: NativeData;\r\n    readonly COMMAND_DRAWINDEXED: NativeData;\r\n    readonly COMMAND_DRAWINDEXEDINSTANCED: NativeData;\r\n    readonly COMMAND_DRAW: NativeData;\r\n    readonly COMMAND_DRAWINSTANCED: NativeData;\r\n    readonly COMMAND_CLEAR: NativeData;\r\n    readonly COMMAND_SETSTENCIL: NativeData;\r\n    readonly COMMAND_SETVIEWPORT: NativeData;\r\n    readonly COMMAND_SETSCISSOR: NativeData;\r\n    readonly COMMAND_COPYTEXTURE: NativeData;\r\n}\r\n\r\n/** @internal */\r\nexport interface INativeCamera {\r\n    createVideo(constraints: MediaTrackConstraints): any;\r\n    updateVideoTexture(texture: Nullable<InternalTexture>, video: HTMLVideoElement, invertY: boolean): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeCameraConstructor {\r\n    prototype: INativeCamera;\r\n    new (): INativeCamera;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeCanvasConstructor {\r\n    prototype: ICanvas;\r\n    new (): ICanvas;\r\n\r\n    loadTTFAsync(fontName: string, buffer: ArrayBuffer): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeImageConstructor {\r\n    prototype: IImage;\r\n    new (): IImage;\r\n}\r\n\r\n/** @internal */\r\ninterface INativePath2DConstructor {\r\n    prototype: IPath2D;\r\n    new (d?: string): IPath2D;\r\n}\r\n\r\n/** @internal */\r\ninterface IDeviceInputSystemConstructor {\r\n    prototype: IDeviceInputSystem;\r\n    new (\r\n        onDeviceConnected: (deviceType: DeviceType, deviceSlot: number) => void,\r\n        onDeviceDisconnected: (deviceType: DeviceType, deviceSlot: number) => void,\r\n        onInputChanged: (deviceType: DeviceType, deviceSlot: number, inputIndex: number, currentState: number) => void\r\n    ): IDeviceInputSystem;\r\n}\r\n\r\n/** @internal */\r\nexport interface INativeDataStream {\r\n    writeBuffer(buffer: ArrayBuffer, length: number): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeDataStreamConstructor {\r\n    prototype: INativeDataStream;\r\n    new (requestFlushCallback: () => void): INativeDataStream;\r\n\r\n    readonly VALIDATION_ENABLED: boolean;\r\n    readonly VALIDATION_UINT_32: number;\r\n    readonly VALIDATION_INT_32: number;\r\n    readonly VALIDATION_FLOAT_32: number;\r\n    readonly VALIDATION_UINT_32_ARRAY: number;\r\n    readonly VALIDATION_INT_32_ARRAY: number;\r\n    readonly VALIDATION_FLOAT_32_ARRAY: number;\r\n    readonly VALIDATION_NATIVE_DATA: number;\r\n    readonly VALIDATION_BOOLEAN: number;\r\n}\r\n\r\n/** @internal */\r\nexport interface INative {\r\n    Engine: INativeEngineConstructor;\r\n    Camera: INativeCameraConstructor;\r\n    Canvas: INativeCanvasConstructor;\r\n    Image: INativeImageConstructor;\r\n    Path2D: INativePath2DConstructor;\r\n    XMLHttpRequest: any; // TODO: how to do this?\r\n    DeviceInputSystem: IDeviceInputSystemConstructor;\r\n    NativeDataStream: INativeDataStreamConstructor;\r\n}\r\n"]}
+{"version":3,"file":"nativeInterfaces.js","sourceRoot":"","sources":["../../../../../dev/core/src/Engines/Native/nativeInterfaces.ts"],"names":[],"mappings":"AAgaA,mFAAmF;AACnF,MAAM,CAAN,IAAkB,gBAGjB;AAHD,WAAkB,gBAAgB;IAC9B,uDAAQ,CAAA;IACR,qDAAO,CAAA;AACX,CAAC,EAHiB,gBAAgB,KAAhB,gBAAgB,QAGjC","sourcesContent":["/* eslint-disable @typescript-eslint/naming-convention */\r\nimport type { DeviceType } from \"../../DeviceInput/InputDevices/deviceEnums\";\r\nimport type { IDeviceInputSystem } from \"../../DeviceInput/inputInterfaces\";\r\nimport type { InternalTexture } from \"../../Materials/Textures/internalTexture\";\r\nimport type { Nullable } from \"../../types\";\r\nimport type { ICanvas, IImage, IPath2D } from \"../ICanvas\";\r\nimport type { NativeData, NativeDataStream } from \"./nativeDataStream\";\r\n\r\nexport type NativeTexture = NativeData;\r\nexport type NativeFramebuffer = NativeData;\r\nexport type NativeVertexArrayObject = NativeData;\r\nexport type NativeProgram = NativeData;\r\nexport type NativeUniform = NativeData;\r\n\r\n/** @internal */\r\nexport type NativeFrameStats = {\r\n    /** @internal */\r\n    gpuTimeNs: number;\r\n};\r\n\r\n/** @internal */\r\nexport interface INativeEngine {\r\n    dispose(): void;\r\n\r\n    requestAnimationFrame(callback: () => void): void;\r\n    setDeviceLostCallback(callback: () => void): void;\r\n\r\n    createVertexArray(): NativeData;\r\n\r\n    createIndexBuffer(dataBuffer: ArrayBuffer, dataByteOffset: number, dataByteLength: number, is32Bits: boolean, dynamic: boolean): NativeData;\r\n    recordIndexBuffer(vertexArray: NativeData, indexBuffer: NativeData): void;\r\n    updateDynamicIndexBuffer(indexBuffer: NativeData, data: ArrayBuffer, dataByteOffset: number, dataByteLength: number, startIndex: number): void;\r\n\r\n    createVertexBuffer(dataBuffer: ArrayBuffer, dataByteOffset: number, dataByteLength: number, dynamic: boolean): NativeData;\r\n    recordVertexBuffer(\r\n        vertexArray: NativeData,\r\n        vertexBuffer: NativeData,\r\n        location: number,\r\n        byteOffset: number,\r\n        byteStride: number,\r\n        numElements: number,\r\n        type: number,\r\n        normalized: boolean,\r\n        instanceDivisor: number\r\n    ): void;\r\n    updateDynamicVertexBuffer(vertexBuffer: NativeData, dataBuffer: ArrayBuffer, dataByteOffset: number, dataByteLength: number, vertexByteOffset?: number): void;\r\n\r\n    createProgram(vertexShader: string, fragmentShader: string): NativeProgram;\r\n    createProgramAsync(vertexShader: string, fragmentShader: string, onSuccess: () => void, onError: (error: Error) => void): NativeProgram;\r\n    getUniforms(shaderProgram: NativeProgram, uniformsNames: string[]): WebGLUniformLocation[];\r\n    getAttributes(shaderProgram: NativeProgram, attributeNames: string[]): number[];\r\n\r\n    createTexture(): NativeTexture;\r\n    initializeTexture(texture: NativeTexture, width: number, height: number, hasMips: boolean, format: number, renderTarget: boolean, srgb: boolean, samples: number): void;\r\n    loadTexture(texture: NativeTexture, data: ArrayBufferView, generateMips: boolean, invertY: boolean, srgb: boolean, onSuccess: () => void, onError: () => void): void;\r\n    loadRawTexture(texture: NativeTexture, data: ArrayBufferView, width: number, height: number, format: number, generateMips: boolean, invertY: boolean): void;\r\n    loadRawTexture2DArray(\r\n        texture: NativeTexture,\r\n        data: Nullable<ArrayBufferView>,\r\n        width: number,\r\n        height: number,\r\n        depth: number,\r\n        format: number,\r\n        generateMipMaps: boolean,\r\n        invertY: boolean\r\n    ): void;\r\n    loadCubeTexture(texture: NativeTexture, data: Array<ArrayBufferView>, generateMips: boolean, invertY: boolean, srgb: boolean, onSuccess: () => void, onError: () => void): void;\r\n    loadCubeTextureWithMips(texture: NativeTexture, data: Array<Array<ArrayBufferView>>, invertY: boolean, srgb: boolean, onSuccess: () => void, onError: () => void): void;\r\n    getTextureWidth(texture: NativeTexture): number;\r\n    getTextureHeight(texture: NativeTexture): number;\r\n    deleteTexture(texture: NativeTexture): void;\r\n    readTexture(\r\n        texture: NativeTexture,\r\n        mipLevel: number,\r\n        x: number,\r\n        y: number,\r\n        width: number,\r\n        height: number,\r\n        buffer: Nullable<ArrayBuffer>,\r\n        bufferOffset: number,\r\n        bufferLength: number\r\n    ): Promise<ArrayBuffer>;\r\n\r\n    createImageBitmap(data: ArrayBuffer | IImage): ImageBitmap;\r\n    resizeImageBitmap(image: ImageBitmap, bufferWidth: number, bufferHeight: number): Uint8Array;\r\n\r\n    createFrameBuffer(\r\n        texture: Nullable<NativeTexture>,\r\n        width: number,\r\n        height: number,\r\n        generateStencilBuffer: boolean,\r\n        generateDepthBuffer: boolean,\r\n        samples: number\r\n    ): NativeFramebuffer;\r\n\r\n    getRenderWidth(): number;\r\n    getRenderHeight(): number;\r\n\r\n    setHardwareScalingLevel(level: number): void;\r\n\r\n    setViewPort(x: number, y: number, width: number, height: number): void;\r\n\r\n    setCommandDataStream(dataStream: NativeDataStream): void;\r\n    submitCommands(): void;\r\n\r\n    populateFrameStats(stats: NativeFrameStats): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeEngineInfo {\r\n    version: string;\r\n    nonFloatVertexBuffers: true;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeEngineConstructor {\r\n    prototype: INativeEngine;\r\n    new (info: INativeEngineInfo): INativeEngine;\r\n\r\n    readonly PROTOCOL_VERSION: number;\r\n\r\n    readonly CAPS_LIMITS_MAX_TEXTURE_SIZE: number;\r\n    readonly CAPS_LIMITS_MAX_TEXTURE_LAYERS: number;\r\n\r\n    readonly TEXTURE_NEAREST_NEAREST: number;\r\n    readonly TEXTURE_LINEAR_LINEAR: number;\r\n    readonly TEXTURE_LINEAR_LINEAR_MIPLINEAR: number;\r\n    readonly TEXTURE_NEAREST_NEAREST_MIPNEAREST: number;\r\n    readonly TEXTURE_NEAREST_LINEAR_MIPNEAREST: number;\r\n    readonly TEXTURE_NEAREST_LINEAR_MIPLINEAR: number;\r\n    readonly TEXTURE_NEAREST_LINEAR: number;\r\n    readonly TEXTURE_NEAREST_NEAREST_MIPLINEAR: number;\r\n    readonly TEXTURE_LINEAR_NEAREST_MIPNEAREST: number;\r\n    readonly TEXTURE_LINEAR_NEAREST_MIPLINEAR: number;\r\n    readonly TEXTURE_LINEAR_LINEAR_MIPNEAREST: number;\r\n    readonly TEXTURE_LINEAR_NEAREST: number;\r\n\r\n    readonly DEPTH_TEST_LESS: number;\r\n    readonly DEPTH_TEST_LEQUAL: number;\r\n    readonly DEPTH_TEST_EQUAL: number;\r\n    readonly DEPTH_TEST_GEQUAL: number;\r\n    readonly DEPTH_TEST_GREATER: number;\r\n    readonly DEPTH_TEST_NOTEQUAL: number;\r\n    readonly DEPTH_TEST_NEVER: number;\r\n    readonly DEPTH_TEST_ALWAYS: number;\r\n\r\n    readonly ADDRESS_MODE_WRAP: number;\r\n    readonly ADDRESS_MODE_MIRROR: number;\r\n    readonly ADDRESS_MODE_CLAMP: number;\r\n    readonly ADDRESS_MODE_BORDER: number;\r\n    readonly ADDRESS_MODE_MIRROR_ONCE: number;\r\n\r\n    readonly TEXTURE_FORMAT_BC1: number;\r\n    readonly TEXTURE_FORMAT_BC2: number;\r\n    readonly TEXTURE_FORMAT_BC3: number;\r\n    readonly TEXTURE_FORMAT_BC4: number;\r\n    readonly TEXTURE_FORMAT_BC5: number;\r\n    readonly TEXTURE_FORMAT_BC6H: number;\r\n    readonly TEXTURE_FORMAT_BC7: number;\r\n    readonly TEXTURE_FORMAT_ETC1: number;\r\n    readonly TEXTURE_FORMAT_ETC2: number;\r\n    readonly TEXTURE_FORMAT_ETC2A: number;\r\n    readonly TEXTURE_FORMAT_ETC2A1: number;\r\n    readonly TEXTURE_FORMAT_PTC12: number;\r\n    readonly TEXTURE_FORMAT_PTC14: number;\r\n    readonly TEXTURE_FORMAT_PTC12A: number;\r\n    readonly TEXTURE_FORMAT_PTC14A: number;\r\n    readonly TEXTURE_FORMAT_PTC22: number;\r\n    readonly TEXTURE_FORMAT_PTC24: number;\r\n    readonly TEXTURE_FORMAT_ATC: number;\r\n    readonly TEXTURE_FORMAT_ATCE: number;\r\n    readonly TEXTURE_FORMAT_ATCI: number;\r\n    readonly TEXTURE_FORMAT_ASTC4x4: number;\r\n    readonly TEXTURE_FORMAT_ASTC5x4: number;\r\n    readonly TEXTURE_FORMAT_ASTC5x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC6x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC6x6: number;\r\n    readonly TEXTURE_FORMAT_ASTC8x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC8x6: number;\r\n    readonly TEXTURE_FORMAT_ASTC8x8: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x6: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x8: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x10: number;\r\n    readonly TEXTURE_FORMAT_ASTC12x10: number;\r\n    readonly TEXTURE_FORMAT_ASTC12x12: number;\r\n\r\n    readonly TEXTURE_FORMAT_R1: number;\r\n    readonly TEXTURE_FORMAT_A8: number;\r\n    readonly TEXTURE_FORMAT_R8: number;\r\n    readonly TEXTURE_FORMAT_R8I: number;\r\n    readonly TEXTURE_FORMAT_R8U: number;\r\n    readonly TEXTURE_FORMAT_R8S: number;\r\n    readonly TEXTURE_FORMAT_R16: number;\r\n    readonly TEXTURE_FORMAT_R16I: number;\r\n    readonly TEXTURE_FORMAT_R16U: number;\r\n    readonly TEXTURE_FORMAT_R16F: number;\r\n    readonly TEXTURE_FORMAT_R16S: number;\r\n    readonly TEXTURE_FORMAT_R32I: number;\r\n    readonly TEXTURE_FORMAT_R32U: number;\r\n    readonly TEXTURE_FORMAT_R32F: number;\r\n    readonly TEXTURE_FORMAT_RG8: number;\r\n    readonly TEXTURE_FORMAT_RG8I: number;\r\n    readonly TEXTURE_FORMAT_RG8U: number;\r\n    readonly TEXTURE_FORMAT_RG8S: number;\r\n    readonly TEXTURE_FORMAT_RG16: number;\r\n    readonly TEXTURE_FORMAT_RG16I: number;\r\n    readonly TEXTURE_FORMAT_RG16U: number;\r\n    readonly TEXTURE_FORMAT_RG16F: number;\r\n    readonly TEXTURE_FORMAT_RG16S: number;\r\n    readonly TEXTURE_FORMAT_RG32I: number;\r\n    readonly TEXTURE_FORMAT_RG32U: number;\r\n    readonly TEXTURE_FORMAT_RG32F: number;\r\n    readonly TEXTURE_FORMAT_RGB8: number;\r\n    readonly TEXTURE_FORMAT_RGB8I: number;\r\n    readonly TEXTURE_FORMAT_RGB8U: number;\r\n    readonly TEXTURE_FORMAT_RGB8S: number;\r\n    readonly TEXTURE_FORMAT_RGB9E5F: number;\r\n    readonly TEXTURE_FORMAT_BGRA8: number;\r\n    readonly TEXTURE_FORMAT_RGBA8: number;\r\n    readonly TEXTURE_FORMAT_RGBA8I: number;\r\n    readonly TEXTURE_FORMAT_RGBA8U: number;\r\n    readonly TEXTURE_FORMAT_RGBA8S: number;\r\n    readonly TEXTURE_FORMAT_RGBA16: number;\r\n    readonly TEXTURE_FORMAT_RGBA16I: number;\r\n    readonly TEXTURE_FORMAT_RGBA16U: number;\r\n    readonly TEXTURE_FORMAT_RGBA16F: number;\r\n    readonly TEXTURE_FORMAT_RGBA16S: number;\r\n    readonly TEXTURE_FORMAT_RGBA32I: number;\r\n    readonly TEXTURE_FORMAT_RGBA32U: number;\r\n    readonly TEXTURE_FORMAT_RGBA32F: number;\r\n    readonly TEXTURE_FORMAT_B5G6R5: number;\r\n    readonly TEXTURE_FORMAT_R5G6B5: number;\r\n    readonly TEXTURE_FORMAT_BGRA4: number;\r\n    readonly TEXTURE_FORMAT_RGBA4: number;\r\n    readonly TEXTURE_FORMAT_BGR5A1: number;\r\n    readonly TEXTURE_FORMAT_RGB5A1: number;\r\n    readonly TEXTURE_FORMAT_RGB10A2: number;\r\n    readonly TEXTURE_FORMAT_RG11B10F: number;\r\n\r\n    readonly TEXTURE_FORMAT_D16: number;\r\n    readonly TEXTURE_FORMAT_D24: number;\r\n    readonly TEXTURE_FORMAT_D24S8: number;\r\n    readonly TEXTURE_FORMAT_D32: number;\r\n    readonly TEXTURE_FORMAT_D16F: number;\r\n    readonly TEXTURE_FORMAT_D24F: number;\r\n    readonly TEXTURE_FORMAT_D32F: number;\r\n    readonly TEXTURE_FORMAT_D0S8: number;\r\n\r\n    readonly ATTRIB_TYPE_INT8: number;\r\n    readonly ATTRIB_TYPE_UINT8: number;\r\n    readonly ATTRIB_TYPE_INT16: number;\r\n    readonly ATTRIB_TYPE_UINT16: number;\r\n    readonly ATTRIB_TYPE_FLOAT: number;\r\n\r\n    readonly ALPHA_DISABLE: number;\r\n    readonly ALPHA_ADD: number;\r\n    readonly ALPHA_COMBINE: number;\r\n    readonly ALPHA_SUBTRACT: number;\r\n    readonly ALPHA_MULTIPLY: number;\r\n    readonly ALPHA_MAXIMIZED: number;\r\n    readonly ALPHA_ONEONE: number;\r\n    readonly ALPHA_PREMULTIPLIED: number;\r\n    readonly ALPHA_PREMULTIPLIED_PORTERDUFF: number;\r\n    readonly ALPHA_INTERPOLATE: number;\r\n    readonly ALPHA_SCREENMODE: number;\r\n\r\n    readonly STENCIL_TEST_LESS: number;\r\n    readonly STENCIL_TEST_LEQUAL: number;\r\n    readonly STENCIL_TEST_EQUAL: number;\r\n    readonly STENCIL_TEST_GEQUAL: number;\r\n    readonly STENCIL_TEST_GREATER: number;\r\n    readonly STENCIL_TEST_NOTEQUAL: number;\r\n    readonly STENCIL_TEST_NEVER: number;\r\n    readonly STENCIL_TEST_ALWAYS: number;\r\n\r\n    readonly STENCIL_OP_FAIL_S_ZERO: number;\r\n    readonly STENCIL_OP_FAIL_S_KEEP: number;\r\n    readonly STENCIL_OP_FAIL_S_REPLACE: number;\r\n    readonly STENCIL_OP_FAIL_S_INCR: number;\r\n    readonly STENCIL_OP_FAIL_S_INCRSAT: number;\r\n    readonly STENCIL_OP_FAIL_S_DECR: number;\r\n    readonly STENCIL_OP_FAIL_S_DECRSAT: number;\r\n    readonly STENCIL_OP_FAIL_S_INVERT: number;\r\n\r\n    readonly STENCIL_OP_FAIL_Z_ZERO: number;\r\n    readonly STENCIL_OP_FAIL_Z_KEEP: number;\r\n    readonly STENCIL_OP_FAIL_Z_REPLACE: number;\r\n    readonly STENCIL_OP_FAIL_Z_INCR: number;\r\n    readonly STENCIL_OP_FAIL_Z_INCRSAT: number;\r\n    readonly STENCIL_OP_FAIL_Z_DECR: number;\r\n    readonly STENCIL_OP_FAIL_Z_DECRSAT: number;\r\n    readonly STENCIL_OP_FAIL_Z_INVERT: number;\r\n\r\n    readonly STENCIL_OP_PASS_Z_ZERO: number;\r\n    readonly STENCIL_OP_PASS_Z_KEEP: number;\r\n    readonly STENCIL_OP_PASS_Z_REPLACE: number;\r\n    readonly STENCIL_OP_PASS_Z_INCR: number;\r\n    readonly STENCIL_OP_PASS_Z_INCRSAT: number;\r\n    readonly STENCIL_OP_PASS_Z_DECR: number;\r\n    readonly STENCIL_OP_PASS_Z_DECRSAT: number;\r\n    readonly STENCIL_OP_PASS_Z_INVERT: number;\r\n\r\n    readonly COMMAND_DELETEVERTEXARRAY: NativeData;\r\n    readonly COMMAND_DELETEINDEXBUFFER: NativeData;\r\n    readonly COMMAND_DELETEVERTEXBUFFER: NativeData;\r\n    readonly COMMAND_SETPROGRAM: NativeData;\r\n    readonly COMMAND_SETMATRIX: NativeData;\r\n    readonly COMMAND_SETMATRIX3X3: NativeData;\r\n    readonly COMMAND_SETMATRIX2X2: NativeData;\r\n    readonly COMMAND_SETMATRICES: NativeData;\r\n    readonly COMMAND_SETINT: NativeData;\r\n    readonly COMMAND_SETINTARRAY: NativeData;\r\n    readonly COMMAND_SETINTARRAY2: NativeData;\r\n    readonly COMMAND_SETINTARRAY3: NativeData;\r\n    readonly COMMAND_SETINTARRAY4: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY2: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY3: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY4: NativeData;\r\n    readonly COMMAND_SETTEXTURESAMPLING: NativeData;\r\n    readonly COMMAND_SETTEXTUREWRAPMODE: NativeData;\r\n    readonly COMMAND_SETTEXTUREANISOTROPICLEVEL: NativeData;\r\n    readonly COMMAND_SETTEXTURE: NativeData;\r\n    readonly COMMAND_UNSETTEXTURE: NativeData;\r\n    readonly COMMAND_DISCARDALLTEXTURES: NativeData;\r\n    readonly COMMAND_BINDVERTEXARRAY: NativeData;\r\n    readonly COMMAND_SETSTATE: NativeData;\r\n    readonly COMMAND_DELETEPROGRAM: NativeData;\r\n    readonly COMMAND_SETZOFFSET: NativeData;\r\n    readonly COMMAND_SETZOFFSETUNITS: NativeData;\r\n    readonly COMMAND_SETDEPTHTEST: NativeData;\r\n    readonly COMMAND_SETDEPTHWRITE: NativeData;\r\n    readonly COMMAND_SETCOLORWRITE: NativeData;\r\n    readonly COMMAND_SETBLENDMODE: NativeData;\r\n    readonly COMMAND_SETFLOAT: NativeData;\r\n    readonly COMMAND_SETFLOAT2: NativeData;\r\n    readonly COMMAND_SETFLOAT3: NativeData;\r\n    readonly COMMAND_SETFLOAT4: NativeData;\r\n    readonly COMMAND_BINDFRAMEBUFFER: NativeData;\r\n    readonly COMMAND_UNBINDFRAMEBUFFER: NativeData;\r\n    readonly COMMAND_DELETEFRAMEBUFFER: NativeData;\r\n    readonly COMMAND_DRAWINDEXED: NativeData;\r\n    readonly COMMAND_DRAWINDEXEDINSTANCED: NativeData;\r\n    readonly COMMAND_DRAW: NativeData;\r\n    readonly COMMAND_DRAWINSTANCED: NativeData;\r\n    readonly COMMAND_CLEAR: NativeData;\r\n    readonly COMMAND_SETSTENCIL: NativeData;\r\n    readonly COMMAND_SETVIEWPORT: NativeData;\r\n    readonly COMMAND_SETSCISSOR: NativeData;\r\n    readonly COMMAND_COPYTEXTURE: NativeData;\r\n}\r\n\r\n/** @internal */\r\nexport interface INativeCamera {\r\n    createVideo(constraints: MediaTrackConstraints): any;\r\n    updateVideoTexture(texture: Nullable<InternalTexture>, video: HTMLVideoElement, invertY: boolean): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeCameraConstructor {\r\n    prototype: INativeCamera;\r\n    new (): INativeCamera;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeCanvasConstructor {\r\n    prototype: ICanvas;\r\n    new (): ICanvas;\r\n\r\n    loadTTFAsync(fontName: string, buffer: ArrayBuffer): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeImageConstructor {\r\n    prototype: IImage;\r\n    new (): IImage;\r\n}\r\n\r\n/** @internal */\r\ninterface INativePath2DConstructor {\r\n    prototype: IPath2D;\r\n    new (d?: string): IPath2D;\r\n}\r\n\r\n/** @internal */\r\ninterface IDeviceInputSystemConstructor {\r\n    prototype: IDeviceInputSystem;\r\n    new (\r\n        onDeviceConnected: (deviceType: DeviceType, deviceSlot: number) => void,\r\n        onDeviceDisconnected: (deviceType: DeviceType, deviceSlot: number) => void,\r\n        onInputChanged: (deviceType: DeviceType, deviceSlot: number, inputIndex: number, currentState: number) => void\r\n    ): IDeviceInputSystem;\r\n}\r\n\r\n/** @internal */\r\nexport interface INativeDataStream {\r\n    writeBuffer(buffer: ArrayBuffer, length: number): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeDataStreamConstructor {\r\n    prototype: INativeDataStream;\r\n    new (requestFlushCallback: () => void): INativeDataStream;\r\n\r\n    readonly VALIDATION_ENABLED: boolean;\r\n    readonly VALIDATION_UINT_32: number;\r\n    readonly VALIDATION_INT_32: number;\r\n    readonly VALIDATION_FLOAT_32: number;\r\n    readonly VALIDATION_UINT_32_ARRAY: number;\r\n    readonly VALIDATION_INT_32_ARRAY: number;\r\n    readonly VALIDATION_FLOAT_32_ARRAY: number;\r\n    readonly VALIDATION_NATIVE_DATA: number;\r\n    readonly VALIDATION_BOOLEAN: number;\r\n}\r\n\r\n// Note: These values need to match those in Babylon Native's NativeTracing plugin.\r\nexport const enum NativeTraceLevel {\r\n    Mark = 1,\r\n    Log = 2,\r\n}\r\n\r\n/** @internal */\r\nexport interface INative {\r\n    // NativeEngine plugin\r\n    Engine: INativeEngineConstructor;\r\n    NativeDataStream: INativeDataStreamConstructor;\r\n\r\n    // NativeCamera plugin\r\n    Camera?: INativeCameraConstructor;\r\n\r\n    // NativeCanvas plugin\r\n    Canvas?: INativeCanvasConstructor;\r\n    Image?: INativeImageConstructor;\r\n    Path2D?: INativePath2DConstructor;\r\n\r\n    // Native XMLHttpRequest polyfill\r\n    XMLHttpRequest?: typeof XMLHttpRequest;\r\n\r\n    // NativeInput plugin\r\n    DeviceInputSystem?: IDeviceInputSystemConstructor;\r\n\r\n    // NativeTracing plugin\r\n    enablePerformanceLogging?(level?: NativeTraceLevel): void;\r\n    disablePerformanceLogging?(): void;\r\n    startPerformanceCounter?(counter: string): unknown;\r\n    endPerformanceCounter?(counter: unknown): void;\r\n}\r\n"]}

package/Engines/nativeEngine.js

@@ -2052,7 +2052,7 @@ export class NativeEngine extends Engine {
      * @returns IImage interface
      */
     createCanvasImage() {
-        if (!_native.Canvas) {
+        if (!_native.Image) {
             throw new Error("Native Canvas plugin not available.");
         }
         const image = new _native.Image();
@@ -2064,7 +2064,7 @@ export class NativeEngine extends Engine {
      * @param d SVG path string
      */
     createCanvasPath2D(d) {
-        if (!_native.Canvas) {
+        if (!_native.Path2D) {
             throw new Error("Native Canvas plugin not available.");
         }
         const path2d = new _native.Path2D(d);