@zephyr3d/scene 0.9.0 → 0.9.2

package/dist/render/screenrendertarget.js

@@ -2,7 +2,11 @@ import { Matrix4x4 } from '@zephyr3d/base';
 import { getEngine } from '../app/api.js';
 import { RenderTarget } from './rendertarget.js';
 
-class ScreenRenderTarget extends RenderTarget {
+/**
+ * Render target backed by the engine screen adapter.
+ *
+ * @public
+ */ class ScreenRenderTarget extends RenderTarget {
     screenAdapter;
     constructor(screenAdapter){
         super();

package/dist/render/screenrendertarget.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenrendertarget.js","sources":["../../src/render/screenrendertarget.ts"],"sourcesContent":["import { Matrix4x4 } from '@zephyr3d/base';\r\nimport type { Nullable } from '@zephyr3d/base';\r\nimport type { ScreenAdapter } from '../app/screen';\r\nimport { getEngine } from '../app/api';\r\nimport { RenderTarget } from './rendertarget';\r\n\r\nexport class ScreenRenderTarget extends RenderTarget {\r\n  private readonly screenAdapter: ScreenAdapter;\r\n  constructor(screenAdapter?: ScreenAdapter) {\r\n    super();\r\n    this.screenAdapter = screenAdapter ?? getEngine().screen;\r\n  }\r\n  getVersion() {\r\n    return this.screenAdapter.version;\r\n  }\r\n  calcViewport(outViewport?: Nullable<number[]>): number[] {\r\n    outViewport = outViewport ?? [];\r\n    const transform = this.screenAdapter.transform;\r\n    outViewport[0] = transform.croppedViewport.x;\r\n    outViewport[1] = transform.croppedViewport.y;\r\n    outViewport[2] = transform.croppedViewport.width;\r\n    outViewport[3] = transform.croppedViewport.height;\r\n    return outViewport;\r\n  }\r\n  calcRelativeViewport(outViewport?: Nullable<number[]>): number[] {\r\n    outViewport = outViewport ?? [];\r\n    const transform = this.screenAdapter.transform;\r\n    outViewport[0] = transform.croppedViewport.x - transform.viewportX;\r\n    outViewport[1] = transform.croppedViewport.y - transform.viewportY;\r\n    outViewport[2] = transform.croppedViewport.width;\r\n    outViewport[3] = transform.croppedViewport.height;\r\n    return outViewport;\r\n  }\r\n  calcOrthographicProjection(nearClip: number, farClip: number, outMatrix?: Matrix4x4): Matrix4x4 {\r\n    const matrix = outMatrix ?? new Matrix4x4();\r\n    const transform = this.screenAdapter.transform;\r\n    const left = transform.croppedViewport.x;\r\n    const right = transform.croppedViewport.x + transform.croppedViewport.width;\r\n    const bottom = transform.croppedViewport.y + transform.croppedViewport.height;\r\n    const top = transform.croppedViewport.y;\r\n    return matrix.ortho(left, right, bottom, top, nearClip, farClip);\r\n  }\r\n  calcPerspectiveProjection(\r\n    fov: number,\r\n    nearClip: number,\r\n    farClip: number,\r\n    outMatrix?: Matrix4x4\r\n  ): Matrix4x4 {\r\n    const matrix = outMatrix ?? new Matrix4x4();\r\n    const transform = this.screenAdapter.transform;\r\n    const aspect = transform.viewportHeight !== 0 ? transform.viewportWidth / transform.viewportHeight : 1;\r\n    const h = nearClip * Math.tan(fov * 0.5);\r\n    const w = h * aspect;\r\n    let left = -w + (2 * w * (transform.croppedViewport.x - transform.viewportX)) / transform.viewportWidth;\r\n    let right =\r\n      w -\r\n      (2 *\r\n        w *\r\n        (transform.viewportX +\r\n          transform.viewportWidth -\r\n          transform.croppedViewport.x -\r\n          transform.croppedViewport.width)) /\r\n        transform.viewportWidth;\r\n    let bottom =\r\n      -h + (2 * w * (transform.croppedViewport.y - transform.viewportY)) / transform.viewportHeight;\r\n    let top =\r\n      h -\r\n      (2 *\r\n        h *\r\n        (transform.viewportY +\r\n          transform.viewportHeight -\r\n          transform.croppedViewport.y -\r\n          transform.croppedViewport.height)) /\r\n        transform.viewportHeight;\r\n    return matrix.frustum(left, right, bottom, top, nearClip, farClip);\r\n  }\r\n}\r\n"],"names":["ScreenRenderTarget","RenderTarget","screenAdapter","getEngine","screen","getVersion","version","calcViewport","outViewport","transform","croppedViewport","x","y","width","height","calcRelativeViewport","viewportX","viewportY","calcOrthographicProjection","nearClip","farClip","outMatrix","matrix","Matrix4x4","left","right","bottom","top","ortho","calcPerspectiveProjection","fov","aspect","viewportHeight","viewportWidth","h","Math","tan","w","frustum"],"mappings":";;;;AAMO,MAAMA,kBAA2BC,SAAAA,YAAAA,CAAAA;IACrBC,aAA6B;AAC9C,IAAA,WAAA,CAAYA,aAA6B,CAAE;QACzC,KAAK,EAAA;AACL,QAAA,IAAI,CAACA,aAAa,GAAGA,aAAAA,IAAiBC,YAAYC,MAAM;AAC1D;IACAC,UAAa,GAAA;AACX,QAAA,OAAO,IAAI,CAACH,aAAa,CAACI,OAAO;AACnC;AACAC,IAAAA,YAAAA,CAAaC,WAAgC,EAAY;AACvDA,QAAAA,WAAAA,GAAcA,eAAe,EAAE;AAC/B,QAAA,MAAMC,SAAY,GAAA,IAAI,CAACP,aAAa,CAACO,SAAS;AAC9CD,QAAAA,WAAW,CAAC,CAAE,CAAA,GAAGC,SAAUC,CAAAA,eAAe,CAACC,CAAC;AAC5CH,QAAAA,WAAW,CAAC,CAAE,CAAA,GAAGC,SAAUC,CAAAA,eAAe,CAACE,CAAC;AAC5CJ,QAAAA,WAAW,CAAC,CAAE,CAAA,GAAGC,SAAUC,CAAAA,eAAe,CAACG,KAAK;AAChDL,QAAAA,WAAW,CAAC,CAAE,CAAA,GAAGC,SAAUC,CAAAA,eAAe,CAACI,MAAM;QACjD,OAAON,WAAAA;AACT;AACAO,IAAAA,oBAAAA,CAAqBP,WAAgC,EAAY;AAC/DA,QAAAA,WAAAA,GAAcA,eAAe,EAAE;AAC/B,QAAA,MAAMC,SAAY,GAAA,IAAI,CAACP,aAAa,CAACO,SAAS;QAC9CD,WAAW,CAAC,EAAE,GAAGC,SAAAA,CAAUC,eAAe,CAACC,CAAC,GAAGF,SAAAA,CAAUO,SAAS;QAClER,WAAW,CAAC,EAAE,GAAGC,SAAAA,CAAUC,eAAe,CAACE,CAAC,GAAGH,SAAAA,CAAUQ,SAAS;AAClET,QAAAA,WAAW,CAAC,CAAE,CAAA,GAAGC,SAAUC,CAAAA,eAAe,CAACG,KAAK;AAChDL,QAAAA,WAAW,CAAC,CAAE,CAAA,GAAGC,SAAUC,CAAAA,eAAe,CAACI,MAAM;QACjD,OAAON,WAAAA;AACT;AACAU,IAAAA,0BAAAA,CAA2BC,QAAgB,EAAEC,OAAe,EAAEC,SAAqB,EAAa;QAC9F,MAAMC,MAAAA,GAASD,aAAa,IAAIE,SAAAA,EAAAA;AAChC,QAAA,MAAMd,SAAY,GAAA,IAAI,CAACP,aAAa,CAACO,SAAS;AAC9C,QAAA,MAAMe,IAAOf,GAAAA,SAAAA,CAAUC,eAAe,CAACC,CAAC;QACxC,MAAMc,KAAAA,GAAQhB,UAAUC,eAAe,CAACC,CAAC,GAAGF,SAAAA,CAAUC,eAAe,CAACG,KAAK;QAC3E,MAAMa,MAAAA,GAASjB,UAAUC,eAAe,CAACE,CAAC,GAAGH,SAAAA,CAAUC,eAAe,CAACI,MAAM;AAC7E,QAAA,MAAMa,GAAMlB,GAAAA,SAAAA,CAAUC,eAAe,CAACE,CAAC;AACvC,QAAA,OAAOU,OAAOM,KAAK,CAACJ,MAAMC,KAAOC,EAAAA,MAAAA,EAAQC,KAAKR,QAAUC,EAAAA,OAAAA,CAAAA;AAC1D;AACAS,IAAAA,yBAAAA,CACEC,GAAW,EACXX,QAAgB,EAChBC,OAAe,EACfC,SAAqB,EACV;QACX,MAAMC,MAAAA,GAASD,aAAa,IAAIE,SAAAA,EAAAA;AAChC,QAAA,MAAMd,SAAY,GAAA,IAAI,CAACP,aAAa,CAACO,SAAS;QAC9C,MAAMsB,MAAAA,GAAStB,SAAUuB,CAAAA,cAAc,KAAK,CAAA,GAAIvB,UAAUwB,aAAa,GAAGxB,SAAUuB,CAAAA,cAAc,GAAG,CAAA;AACrG,QAAA,MAAME,CAAIf,GAAAA,QAAAA,GAAWgB,IAAKC,CAAAA,GAAG,CAACN,GAAM,GAAA,GAAA,CAAA;AACpC,QAAA,MAAMO,IAAIH,CAAIH,GAAAA,MAAAA;AACd,QAAA,IAAIP,OAAO,CAACa,CAAAA,GAAI,CAAC,GAAIA,KAAK5B,SAAAA,CAAUC,eAAe,CAACC,CAAC,GAAGF,SAAAA,CAAUO,SAAS,CAAD,GAAMP,UAAUwB,aAAa;QACvG,IAAIR,KAAAA,GACFY,CACA,GAAC,CACCA,GAAAA,CAAAA,IACC5B,SAAUO,CAAAA,SAAS,GAClBP,SAAAA,CAAUwB,aAAa,GACvBxB,UAAUC,eAAe,CAACC,CAAC,GAC3BF,SAAUC,CAAAA,eAAe,CAACG,KAAI,CAChCJ,GAAAA,SAAAA,CAAUwB,aAAa;AAC3B,QAAA,IAAIP,SACF,CAACQ,CAAAA,GAAI,CAAC,GAAIG,KAAK5B,SAAAA,CAAUC,eAAe,CAACE,CAAC,GAAGH,SAAAA,CAAUQ,SAAS,CAAD,GAAMR,UAAUuB,cAAc;QAC/F,IAAIL,GAAAA,GACFO,CACA,GAAC,CACCA,GAAAA,CAAAA,IACCzB,SAAUQ,CAAAA,SAAS,GAClBR,SAAAA,CAAUuB,cAAc,GACxBvB,UAAUC,eAAe,CAACE,CAAC,GAC3BH,SAAUC,CAAAA,eAAe,CAACI,MAAK,CACjCL,GAAAA,SAAAA,CAAUuB,cAAc;AAC5B,QAAA,OAAOV,OAAOgB,OAAO,CAACd,MAAMC,KAAOC,EAAAA,MAAAA,EAAQC,KAAKR,QAAUC,EAAAA,OAAAA,CAAAA;AAC5D;AACF;;;;"}
+{"version":3,"file":"screenrendertarget.js","sources":["../../src/render/screenrendertarget.ts"],"sourcesContent":["import { Matrix4x4 } from '@zephyr3d/base';\r\nimport type { Nullable } from '@zephyr3d/base';\r\nimport type { ScreenAdapter } from '../app/screen';\r\nimport { getEngine } from '../app/api';\r\nimport { RenderTarget } from './rendertarget';\r\n\r\n/**\r\n * Render target backed by the engine screen adapter.\r\n *\r\n * @public\r\n */\r\nexport class ScreenRenderTarget extends RenderTarget {\r\n  private readonly screenAdapter: ScreenAdapter;\r\n  constructor(screenAdapter?: ScreenAdapter) {\r\n    super();\r\n    this.screenAdapter = screenAdapter ?? getEngine().screen;\r\n  }\r\n  getVersion() {\r\n    return this.screenAdapter.version;\r\n  }\r\n  calcViewport(outViewport?: Nullable<number[]>): number[] {\r\n    outViewport = outViewport ?? [];\r\n    const transform = this.screenAdapter.transform;\r\n    outViewport[0] = transform.croppedViewport.x;\r\n    outViewport[1] = transform.croppedViewport.y;\r\n    outViewport[2] = transform.croppedViewport.width;\r\n    outViewport[3] = transform.croppedViewport.height;\r\n    return outViewport;\r\n  }\r\n  calcRelativeViewport(outViewport?: Nullable<number[]>): number[] {\r\n    outViewport = outViewport ?? [];\r\n    const transform = this.screenAdapter.transform;\r\n    outViewport[0] = transform.croppedViewport.x - transform.viewportX;\r\n    outViewport[1] = transform.croppedViewport.y - transform.viewportY;\r\n    outViewport[2] = transform.croppedViewport.width;\r\n    outViewport[3] = transform.croppedViewport.height;\r\n    return outViewport;\r\n  }\r\n  calcOrthographicProjection(nearClip: number, farClip: number, outMatrix?: Matrix4x4): Matrix4x4 {\r\n    const matrix = outMatrix ?? new Matrix4x4();\r\n    const transform = this.screenAdapter.transform;\r\n    const left = transform.croppedViewport.x;\r\n    const right = transform.croppedViewport.x + transform.croppedViewport.width;\r\n    const bottom = transform.croppedViewport.y + transform.croppedViewport.height;\r\n    const top = transform.croppedViewport.y;\r\n    return matrix.ortho(left, right, bottom, top, nearClip, farClip);\r\n  }\r\n  calcPerspectiveProjection(\r\n    fov: number,\r\n    nearClip: number,\r\n    farClip: number,\r\n    outMatrix?: Matrix4x4\r\n  ): Matrix4x4 {\r\n    const matrix = outMatrix ?? new Matrix4x4();\r\n    const transform = this.screenAdapter.transform;\r\n    const aspect = transform.viewportHeight !== 0 ? transform.viewportWidth / transform.viewportHeight : 1;\r\n    const h = nearClip * Math.tan(fov * 0.5);\r\n    const w = h * aspect;\r\n    let left = -w + (2 * w * (transform.croppedViewport.x - transform.viewportX)) / transform.viewportWidth;\r\n    let right =\r\n      w -\r\n      (2 *\r\n        w *\r\n        (transform.viewportX +\r\n          transform.viewportWidth -\r\n          transform.croppedViewport.x -\r\n          transform.croppedViewport.width)) /\r\n        transform.viewportWidth;\r\n    let bottom =\r\n      -h + (2 * w * (transform.croppedViewport.y - transform.viewportY)) / transform.viewportHeight;\r\n    let top =\r\n      h -\r\n      (2 *\r\n        h *\r\n        (transform.viewportY +\r\n          transform.viewportHeight -\r\n          transform.croppedViewport.y -\r\n          transform.croppedViewport.height)) /\r\n        transform.viewportHeight;\r\n    return matrix.frustum(left, right, bottom, top, nearClip, farClip);\r\n  }\r\n}\r\n"],"names":["ScreenRenderTarget","RenderTarget","screenAdapter","getEngine","screen","getVersion","version","calcViewport","outViewport","transform","croppedViewport","x","y","width","height","calcRelativeViewport","viewportX","viewportY","calcOrthographicProjection","nearClip","farClip","outMatrix","matrix","Matrix4x4","left","right","bottom","top","ortho","calcPerspectiveProjection","fov","aspect","viewportHeight","viewportWidth","h","Math","tan","w","frustum"],"mappings":"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"}

package/dist/render/sky.js

@@ -156,7 +156,7 @@ const defaultSkyWorldMatrix = Matrix4x4.identity();
     /** @internal */ get panoramaTextureAsset() {
         return this._panoramaAsset;
     }
-    set panoramaTextureAsset(id) {
+    /** @internal */ set panoramaTextureAsset(id) {
         if (id !== this._panoramaAsset) {
             this._panoramaAsset = id ?? '';
             if (!this._panoramaAsset) {
@@ -169,7 +169,7 @@ const defaultSkyWorldMatrix = Matrix4x4.identity();
     /** @internal */ get skyboxTextureSize() {
         return this._skyboxTextureSize;
     }
-    set skyboxTextureSize(size) {
+    /** @internal */ set skyboxTextureSize(size) {
         if (size !== this._skyboxTextureSize) {
             this._skyboxTextureSize = size;
             this._updateSkyboxTexture();
@@ -467,7 +467,7 @@ const defaultSkyWorldMatrix = Matrix4x4.identity();
     /** @internal */ get skyWorldMatrix() {
         return this._skyWorldMatrix;
     }
-    set skyWorldMatrix(val) {
+    /** @internal */ set skyWorldMatrix(val) {
         val = val ?? defaultSkyWorldMatrix;
         if (!val.equalsTo(this._skyWorldMatrix)) {
             this._skyWorldMatrix = val;
@@ -489,7 +489,7 @@ const defaultSkyWorldMatrix = Matrix4x4.identity();
     /** @internal */ get aerialPerspectiveDebug() {
         return this._debugAerialPerspective;
     }
-    set aerialPerspectiveDebug(val) {
+    /** @internal */ set aerialPerspectiveDebug(val) {
         this._debugAerialPerspective = val;
     }
     /** @internal */ get fogPresents() {