@babylonjs/lite-compat 1.39.2 → 1.39.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +16 -2
- package/README.md +1 -1
- package/index.d.ts +132 -10
- package/index.js +406 -18
- package/index.js.map +1 -1
- package/{meshes-DWnDIh1l.js → meshes-FwqJpX7D.js} +26 -4
- package/meshes-FwqJpX7D.js.map +1 -0
- package/navigation.d.ts +36 -6
- package/navigation.js +1 -1
- package/package.json +5 -5
- package/meshes-DWnDIh1l.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,22 +1,36 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
## @babylonjs/lite v1.39.
|
|
3
|
+
## @babylonjs/lite v1.39.3
|
|
4
|
+
|
|
5
|
+
### ⚠️ BREAKING CHANGES
|
|
6
|
+
|
|
7
|
+
- **scene:** add per-family scene collections for text, depth-hosted sprites, and billboards ([#907](https://github.com/BabylonJS/Babylon-Lite/pull/907))
|
|
4
8
|
|
|
5
9
|
### ✨ Features
|
|
6
10
|
|
|
11
|
+
- **compat:** wrap native SSAO2 rendering pipeline ([#908](https://github.com/BabylonJS/Babylon-Lite/pull/908))
|
|
12
|
+
- add public texture pixel readback ([#906](https://github.com/BabylonJS/Babylon-Lite/pull/906))
|
|
13
|
+
- **compat:** wrap HTML-in-Canvas polyfill lifecycle ([#903](https://github.com/BabylonJS/Babylon-Lite/pull/903))
|
|
14
|
+
- **compat:** support texture replacement and stub indirect submeshes ([#901](https://github.com/BabylonJS/Babylon-Lite/pull/901))
|
|
7
15
|
- **compat:** sync bent normals and BJS 9.35 APIs ([#896](https://github.com/BabylonJS/Babylon-Lite/pull/896))
|
|
8
16
|
- **engine:** add createDevice for early WebGPU device acquisition ([#900](https://github.com/BabylonJS/Babylon-Lite/pull/900))
|
|
9
17
|
|
|
10
18
|
### 🐛 Bug Fixes
|
|
11
19
|
|
|
20
|
+
- **ktx2:** retry failed transcoder WASM fetches ([#905](https://github.com/BabylonJS/Babylon-Lite/pull/905))
|
|
21
|
+
- **texture:** restore HTML texture elements relocated by HTML-in-Canvas polyfills ([#897](https://github.com/BabylonJS/Babylon-Lite/pull/897))
|
|
12
22
|
- **build:** rewrite all static Lite error messages ([#899](https://github.com/BabylonJS/Babylon-Lite/pull/899))
|
|
13
23
|
- **demos:** repair ambient occlusion deployment and controls ([#894](https://github.com/BabylonJS/Babylon-Lite/pull/894))
|
|
14
24
|
|
|
25
|
+
### 🏗️ Build & CI
|
|
26
|
+
|
|
27
|
+
- add dependency review workflow ([#904](https://github.com/BabylonJS/Babylon-Lite/pull/904))
|
|
28
|
+
|
|
15
29
|
### 🔧 Other Changes
|
|
16
30
|
|
|
17
31
|
- Clone rotation fix ([#893](https://github.com/BabylonJS/Babylon-Lite/pull/893))
|
|
18
32
|
|
|
19
|
-
**Full Changelog**: https://github.com/BabylonJS/Babylon-Lite/compare/npm-lite-v1.39.0...npm-lite-v1.39.
|
|
33
|
+
**Full Changelog**: https://github.com/BabylonJS/Babylon-Lite/compare/npm-lite-v1.39.0...npm-lite-v1.39.3
|
|
20
34
|
|
|
21
35
|
## @babylonjs/lite v1.39.0
|
|
22
36
|
|
package/README.md
CHANGED
|
@@ -128,7 +128,7 @@ overloads within a supported area may still be absent.
|
|
|
128
128
|
| CSG / CSG2 | ✅ | over Lite boolean ops |
|
|
129
129
|
| Gizmos (position/rotation/scale/bounding-box/light/camera + `GizmoManager`) | ⚡ | over Lite gizmo suite; `isEnabled` toggles per-axis interactivity (display-only when disabled) |
|
|
130
130
|
| Materials (`StandardMaterial`, `PBRMaterial`, metallic-rough / spec-gloss, `NodeMaterial`) | ⚡ | Includes native bent-normal IBL occlusion and cloned loaded PBR materials; BJS parallax scale semantics, Gaussian-splat plugins, preprocessed `ShaderMaterial`, `MultiMaterial`, `BackgroundMaterial`, and `OpenPBRMaterial` remain unsupported |
|
|
131
|
-
| Textures (`Texture`, `RawTexture`, `RawTexture2DArray`, `RawTexture3D`, `DynamicTexture`, `HtmlTexture`, `ExternalTexture`, cube textures) | ⚡ |
|
|
131
|
+
| Textures (`Texture`, `RawTexture`, `RawTexture2DArray`, `RawTexture3D`, `DynamicTexture`, `HtmlTexture`, `ExternalTexture`, cube textures) | ⚡ | URL textures support ready-image replacement with material rebinding. Texture/scatter processors support exact constant-only paths; textured operands need BJS's missing procedural render-target pipeline and throw. Arrays, base-level 3D volumes, dynamic/HTML/external textures, and cube environments work; `RenderTargetTexture` / `MirrorTexture` remain unsupported |
|
|
132
132
|
| Animation (keyframe `Animation`, easing, `Animatable`, `AnimationGroup` incl. weighted/additive blend) | ⚡ | All standard easing classes, including `PowerEase` / `BezierCurveEase`, reuse Lite's native functional curves; `beginAnimation` / `beginDirectAnimation` delegate supported float/vector/quaternion tracks to Lite property animation; unsupported tracks use an explicit compat evaluator; structural groups remain compat-owned; loaded glTF skeletal blending supported; root-motion analysis/controller APIs throw |
|
|
133
133
|
| Morph targets (`MorphTarget` / `MorphTargetManager`) | ✅ | over Lite morph targets, including named loader-produced targets and live influence writes |
|
|
134
134
|
| Sprites (`SpriteManager` / `Sprite`) | ⚡ | camera-facing billboards; `SpriteMap` / packed atlas unsupported |
|
package/index.d.ts
CHANGED
|
@@ -3707,7 +3707,13 @@ export declare class IncrementValueAction extends Action {
|
|
|
3707
3707
|
/** Babylon.js `InitializeCSG2Async()` — load the Manifold runtime before any `CSG2` use. */
|
|
3708
3708
|
export declare function InitializeCSG2Async(): Promise<void>;
|
|
3709
3709
|
|
|
3710
|
-
/**
|
|
3710
|
+
/**
|
|
3711
|
+
* Babylon.js `InstallHtmlInCanvasPolyfill`.
|
|
3712
|
+
*
|
|
3713
|
+
* The installed polyfill would redirect Lite to an incompatible positional
|
|
3714
|
+
* upload API, so exposing the installer without changing Lite's hot path would
|
|
3715
|
+
* break otherwise-working HTML textures.
|
|
3716
|
+
*/
|
|
3711
3717
|
export declare function InstallHtmlInCanvasPolyfill(): never;
|
|
3712
3718
|
|
|
3713
3719
|
/** Babylon.js `InstancedMesh` — hardware instances are not modelled; use thin instances. */
|
|
@@ -3785,7 +3791,13 @@ export declare interface ISceneLoaderProgressEvent {
|
|
|
3785
3791
|
/** Babylon.js internal polyfill-state query. Compat never installs the unsupported polyfill. */
|
|
3786
3792
|
export declare function _IsHtmlInCanvasPolyfillInstalled(): boolean;
|
|
3787
3793
|
|
|
3788
|
-
/**
|
|
3794
|
+
/**
|
|
3795
|
+
* Babylon.js `IsHtmlInCanvasSupportedNatively`.
|
|
3796
|
+
*
|
|
3797
|
+
* The legacy polyfill uses a positional upload signature that Lite's existing
|
|
3798
|
+
* HTML texture module cannot consume without adding feature branches to a
|
|
3799
|
+
* module already included by HTML-texture users.
|
|
3800
|
+
*/
|
|
3789
3801
|
export declare function IsHtmlInCanvasSupportedNatively(): never;
|
|
3790
3802
|
|
|
3791
3803
|
/** Babylon.js `IsHtmlInCanvasUploadSupported` — kept in lockstep with the unavailable upload helper. */
|
|
@@ -5085,7 +5097,8 @@ export declare class PBRMetallicRoughnessMaterial extends PBRMaterial {
|
|
|
5085
5097
|
export declare class PBRSheenConfiguration {
|
|
5086
5098
|
private readonly _props;
|
|
5087
5099
|
private readonly _markDirty;
|
|
5088
|
-
|
|
5100
|
+
private readonly _watchTexture;
|
|
5101
|
+
constructor(_props: SheenProps, _markDirty: () => void, _watchTexture: (texture: BaseTexture | null) => void);
|
|
5089
5102
|
get isEnabled(): boolean;
|
|
5090
5103
|
set isEnabled(value: boolean);
|
|
5091
5104
|
get intensity(): number;
|
|
@@ -5098,9 +5111,9 @@ export declare class PBRSheenConfiguration {
|
|
|
5098
5111
|
get texture(): BaseTexture | null;
|
|
5099
5112
|
set texture(value: BaseTexture | null);
|
|
5100
5113
|
private _texture;
|
|
5114
|
+
private _textureAssigned;
|
|
5101
5115
|
/** Enumerate the sheen texture slot for `Material.getActiveTextures`. */
|
|
5102
|
-
getActiveTextures(): BaseTexture[];
|
|
5103
|
-
}
|
|
5116
|
+
getActiveTextures(): BaseTexture[];
|
|
5104
5117
|
|
|
5105
5118
|
/**
|
|
5106
5119
|
* Babylon.js `PBRSpecularGlossinessMaterial` — the spec/gloss workflow is
|
|
@@ -5632,6 +5645,27 @@ export declare class PostProcess {
|
|
|
5632
5645
|
constructor();
|
|
5633
5646
|
}
|
|
5634
5647
|
|
|
5648
|
+
/** Babylon.js post-process pipeline shape consumed by the manager. */
|
|
5649
|
+
export declare interface PostProcessRenderPipeline {
|
|
5635
5650
|
readonly isSupported: boolean;
|
|
5636
5651
|
dispose(): void;
|
|
5652
|
+
}
|
|
5653
|
+
|
|
5654
|
+
/** Babylon.js-compatible post-process pipeline registry for native Lite-backed pipelines. */
|
|
5655
|
+
export declare class PostProcessRenderPipelineManager {
|
|
5656
|
+
private readonly _renderPipelines;
|
|
5657
|
+
private readonly _onNewPipelineAddedObservable;
|
|
5658
|
+
private readonly _onPipelineRemovedObservable;
|
|
5659
|
+
get onNewPipelineAddedObservable(): Observable<PostProcessRenderPipeline>;
|
|
5660
|
+
get onPipelineRemovedObservable(): Observable<PostProcessRenderPipeline>;
|
|
5661
|
+
get supportedPipelines(): PostProcessRenderPipeline[];
|
|
5662
|
+
addPipeline(renderPipeline: PostProcessRenderPipeline): void;
|
|
5663
|
+
removePipeline(renderPipelineName: string): void;
|
|
5664
|
+
attachCamerasToRenderPipeline(renderPipelineName: string, cameras: Camera[] | Camera, unique?: boolean): void;
|
|
5665
|
+
detachCamerasFromRenderPipeline(renderPipelineName: string, cameras: Camera[] | Camera): void;
|
|
5666
|
+
enableEffectInPipeline(renderPipelineName: string, renderEffectName: string, cameras: Camera[] | Camera): void;
|
|
5667
|
+
disableEffectInPipeline(renderPipelineName: string, renderEffectName: string, cameras: Camera[] | Camera): void;
|
|
5668
|
+
update(): void;
|
|
5637
5669
|
dispose(): void;
|
|
5670
|
+
}
|
|
5671
|
+
|
|
5638
5672
|
/**
|
|
5639
5673
|
* Babylon.js-compatible power easing class.
|
|
5640
5674
|
*/
|
|
@@ -5750,6 +5784,11 @@ export declare class QuinticEase extends EasingFunction {
|
|
|
5750
5784
|
*/
|
|
5751
5785
|
export declare function RandomGUID(): string;
|
|
5752
5786
|
|
|
5787
|
+
declare type Ratio = number | {
|
|
5788
|
+
ssaoRatio?: number;
|
|
5789
|
+
blurRatio?: number;
|
|
5790
|
+
};
|
|
5791
|
+
|
|
5753
5792
|
/**
|
|
5754
5793
|
* Babylon.js `RawTexture` — a texture created from raw pixel bytes. Backed by
|
|
5755
5794
|
* Babylon Lite's `createTexture2DFromPixels`; the GPU handle is available
|
|
@@ -6118,11 +6157,13 @@ export declare class Scene extends AbstractScene {
|
|
|
6118
6157
|
/** Babylon.js fog-mode c
|
|
6119
6158
|
private readonly _retiredParticleSystems;
|
|
6120
6159
|
private _disposed;
|
|
6121
6160
|
private _ambientColor;
|
|
6122
6161
|
private _environmentIntensity;
|
|
6123
|
-
private _imageProcessingConfiguration;
|
|
6124
6162
|
/** Babylon.js `scene.uniqueId` — a process-unique numeric id. */
|
|
6163
|
+
private _imageProcessingConfiguration;
|
|
6164
|
+
private _postProcessRenderPipelineManager;
|
|
6125
6165
|
/** Babylon.js `scene.uniqueId` — a process-unique numeric id. */
|
|
6126
6166
|
readonly uniqueId: number;
|
|
6127
6167
|
constructor(engine: WebGPUEngine);
|
|
6128
6168
|
private _attachPointerEvents;
|
|
6129
6169
|
private _detachPointerEvents;
|
|
6130
6170
|
getEngine(): WebGPUEngine;
|
|
6171
|
+
get postProcessRenderPipelineManager(): PostProcessRenderPipelineManager;
|
|
6131
6172
|
/** Babylon.js `scene.getClassName()`. */
|
|
6132
6173
|
getClassName(): string;
|
|
6133
6174
|
/** Babylon.js `scene.getUniqueId()` — the process-unique scene id. */
|
|
@@ -6801,8 +6842,77 @@ export declare class SpriteRenderer {
|
|
|
6801
6842
|
*/
|
|
6802
6843
|
render(sprites: readonly ThinSpriteLike[], _deltaTime?: number, _view?: unknown, _projection?: unknown): void;
|
|
6803
6844
|
|
|
6845
|
+
/** Babylon.js-shaped adapter over Babylon Lite's native scene SSAO pipeline. */
|
|
6804
6846
|
export declare class SSAO2RenderingPipeline {
|
|
6805
|
-
|
|
6847
|
+
private static _uniqueIdSource;
|
|
6848
|
+
readonly SSAOOriginalSceneColorEffect = "SSAOOriginalSceneColorEffect";
|
|
6849
|
+
readonly SSAORenderEffect = "SSAORenderEffect";
|
|
6850
|
+
readonly SSAOBlurHRenderEffect = "SSAOBlurHRenderEffect";
|
|
6851
|
+
readonly SSAOBlurVRenderEffect = "SSAOBlurVRenderEffect";
|
|
6852
|
+
readonly SSAOCombineRenderEffect = "SSAOCombineRenderEffect";
|
|
6853
|
+
readonly isSupported: boolean;
|
|
6854
|
+
readonly uniqueId: number;
|
|
6806
6855
|
private readonly _scene;
|
|
6856
|
+
private readonly _ratio;
|
|
6857
|
+
private readonly _forceGeometryBuffer;
|
|
6858
|
+
private readonly _textureType;
|
|
6859
|
+
private readonly _resolutionScale;
|
|
6860
|
+
private _native;
|
|
6861
|
+
private _camera;
|
|
6862
|
+
private _disposed;
|
|
6863
|
+
private _radius;
|
|
6864
|
+
private _totalStrength;
|
|
6865
|
+
private _base;
|
|
6866
|
+
private _maxZ;
|
|
6867
|
+
private _minZAspect;
|
|
6868
|
+
private _epsilon;
|
|
6869
|
+
private _samples;
|
|
6870
|
+
private _expensiveBlur;
|
|
6871
|
+
private _bypassBlur;
|
|
6872
|
+
private _bilateralSamples;
|
|
6873
|
+
private _bilateralSoften;
|
|
6874
|
+
private _bilateralTolerance;
|
|
6875
|
+
private _useViewportInCombineStage;
|
|
6876
|
+
private _textureSamples;
|
|
6877
|
+
private readonly _warned;
|
|
6878
|
+
readonly cameras: Camera[];
|
|
6879
|
+
constructor(name: string, scene: Scene, ratio: Ratio, cameras?: Camera[], forceGeometryBuffer?: boolean | object, textureType?: number);
|
|
6880
|
+
get radius(): number;
|
|
6881
|
+
set radius(value: number);
|
|
6882
|
+
get totalStrength(): number;
|
|
6883
|
+
set totalStrength(value: number);
|
|
6884
|
+
get base(): number;
|
|
6885
|
+
set base(value: number);
|
|
6886
|
+
get maxZ(): number;
|
|
6887
|
+
set maxZ(value: number);
|
|
6888
|
+
get minZAspect(): number;
|
|
6889
|
+
set minZAspect(value: number);
|
|
6890
|
+
get epsilon(): number;
|
|
6891
|
+
set epsilon(value: number);
|
|
6892
|
+
get samples(): number;
|
|
6893
|
+
set samples(value: number);
|
|
6894
|
+
get expensiveBlur(): boolean;
|
|
6895
|
+
get bypassBlur(): boolean;
|
|
6896
|
+
set bypassBlur(value: boolean);
|
|
6897
|
+
get bilateralSamples(): number;
|
|
6898
|
+
set bilateralSamples(value: number);
|
|
6899
|
+
get bilateralSoften(): number;
|
|
6900
|
+
set bilateralSoften(value: number);
|
|
6901
|
+
get bilateralTolerance(): number;
|
|
6902
|
+
set bilateralTolerance(value: number);
|
|
6903
|
+
get useViewportInCombineStage(): boolean;
|
|
6904
|
+
set useViewportInCombineStage(value: boolean);
|
|
6905
|
+
set expensiveBlur(value: boolean);
|
|
6906
|
+
get textureSamples(): number;
|
|
6907
|
+
set textureSamples(value: number);
|
|
6908
|
+
getClassName(): string;
|
|
6909
|
+
get name(): string;
|
|
6910
|
+
get engine(): AbstractEngine;
|
|
6911
|
+
get scene(): Scene;
|
|
6912
|
+
static get IsSupported(): boolean;
|
|
6913
|
+
static Parse(source: Record<string, unknown>, scene: Scene): SSAO2RenderingPipeline;
|
|
6914
|
+
isReady(): boolean;
|
|
6915
|
+
serialize(): Record<string, unknown>;
|
|
6807
6916
|
dispose(_disableGeometryBufferRenderer?: boolean): void;
|
|
6917
|
+
private _warnUnsupported;
|
|
6808
6918
|
}
|
|
6809
6919
|
|
|
6810
6920
|
export declare class StandardMaterial extends PushMaterial {
|
|
6811
6921
|
/** Diffuse colour as the app set it. Kept apart from `_lite.diffuseColor`, which is forced to white
|
|
@@ -6985,6 +7095,12 @@ export declare class StringDictionary<T> {
|
|
|
6985
7095
|
forEach(callback: (key: string, value: T) => void): void;
|
|
6986
7096
|
}
|
|
6987
7097
|
|
|
7098
|
+
/** Babylon.js `SubMesh`; pass-specific indirect drawing requires Lite renderer integration. */
|
|
7099
|
+
export declare class SubMesh {
|
|
7100
|
+
constructor(_materialIndex: number, _verticesStart: number, _verticesCount: number, _indexStart: number, _indexCount: number, _mesh: AbstractMesh, _renderingMesh?: Mesh, _createBoundingBox?: boolean, _addToMesh?: boolean);
|
|
7101
|
+
setIndirectDrawBuffer(_buffer: unknown | null, _byteOffset: number, _renderPassId: number): void;
|
|
7102
|
+
}
|
|
7103
|
+
|
|
6988
7104
|
export declare class SurfaceMagnetismBehavior {
|
|
6989
7105
|
constructor();
|
|
6990
7106
|
}
|
|
@@ -7067,9 +7183,9 @@ export declare class Texture extends BaseTexture {
|
|
|
7067
7183
|
hasAlpha: boolean;
|
|
7068
7184
|
coordinatesIndex: number;
|
|
7069
7185
|
/** Babylon.js sampling mode passed at construction (`NEAREST_SAMPLINGMODE` = 1, etc.). */
|
|
7070
|
-
readonly samplingMode: number;
|
|
7071
7186
|
constructor(url: string, sceneOrEngine: Scene | {
|
|
7187
|
+
samplingMode: number;
|
|
7072
7188
|
constructor(url: string, sceneOrEngine: Scene | {
|
|
7073
7189
|
_lite: EngineContext;
|
|
7074
|
-
}, noMipmapOrOptions?: unknown, invertY?: boolean, _samplingMode?: number, onLoad?: (() => void) | null);
|
|
7075
7190
|
private readonly _noMipmap;
|
|
7191
|
+
}, noMipmapOrOptions?: unknown, invertY?: boolean, _samplingMode?: number, onLoad?: (() => void) | null);
|
|
7076
7192
|
private _noMipmap;
|
|
7077
7193
|
getClassName(): string;
|
|
7078
7194
|
/**
|
|
7079
7195
|
* Babylon.js `texture.clone()` — a new `Texture` over the same source URL.
|
|
@@ -7077,6 +7193,12 @@ export declare class Texture extends BaseTexture {
|
|
|
7077
7193
|
* handle (tracked against the same scene so it is ready at build).
|
|
7078
7194
|
*/
|
|
7079
7195
|
clone(): Texture;
|
|
7196
|
+
/**
|
|
7197
|
+
* Babylon.js `Texture.replaceImage` — reuse another ready URL texture's Lite
|
|
7198
|
+
* handle without reloading it. Wrapper UV state remains local; loading state
|
|
7199
|
+
* follows the source so later clones resolve the same image.
|
|
7200
|
+
*/
|
|
7201
|
+
replaceImage(source: Texture): boolean;
|
|
7080
7202
|
whenReadyAsync(): Promise<void>;
|
|
7081
7203
|
/** Babylon.js `Texture.onLoadObservable`, allocated only when code subscribes. */
|
|
7082
7204
|
get onLoadObservable(): Observable<Texture>;
|
|
@@ -7326,7 +7448,7 @@ export declare class UniformBuffer {
|
|
|
7326
7448
|
private _setInteger;
|
|
7327
7449
|
}
|
|
7328
7450
|
|
|
7329
|
-
/** Babylon.js `UninstallHtmlInCanvasPolyfill
|
|
7451
|
+
/** Babylon.js `UninstallHtmlInCanvasPolyfill`; paired with the structurally blocked installer. */
|
|
7330
7452
|
export declare function UninstallHtmlInCanvasPolyfill(): never;
|
|
7331
7453
|
|
|
7332
7454
|
/** Babylon.js `UniversalCamera` — touch-friendly free camera. */
|