@zephyr3d/scene 0.8.2 → 0.9.0

package/dist/render/rendergraph/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../../src/render/rendergraph/types.ts"],"sourcesContent":["import type { TextureFormat } from '@zephyr3d/device';\r\n\r\n// ─── Resource Descriptors ───────────────────────────────────────────────\r\n\r\n/**\r\n * Sizing mode for render graph textures.\r\n *\r\n * - 'absolute': fixed pixel dimensions\r\n * - 'backbuffer-relative': scaled relative to the backbuffer size\r\n *\r\n * @public\r\n */\r\nexport type RGSizeMode = 'absolute' | 'backbuffer-relative';\r\n\r\n/**\r\n * Descriptor for a transient texture resource within the render graph.\r\n *\r\n * Transient textures are allocated and released automatically by the graph compiler.\r\n *\r\n * @public\r\n */\r\nexport interface RGTextureDesc {\r\n  /** Debug label for this resource. */\r\n  label?: string;\r\n  /** Texture format (e.g. 'rgba8unorm', 'r32f', 'rgba16f'). */\r\n  format: TextureFormat;\r\n  /** Sizing mode. Default 'backbuffer-relative'. */\r\n  sizeMode?: RGSizeMode;\r\n  /** Width in pixels (absolute) or scale factor (backbuffer-relative, default 1.0). */\r\n  width?: number;\r\n  /** Height in pixels (absolute) or scale factor (backbuffer-relative, default 1.0). */\r\n  height?: number;\r\n  /** Number of mip levels. Default 1. */\r\n  mipLevels?: number;\r\n}\r\n\r\n// ─── Handles ────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Opaque handle referencing a resource within the render graph.\r\n *\r\n * Handles are obtained from {@link RGPassBuilder.createTexture}, {@link RenderGraph.importTexture},\r\n * or {@link RGPassBuilder.write}. They are lightweight identifiers used to declare\r\n * dependencies between passes.\r\n *\r\n * @public\r\n */\r\nexport class RGHandle {\r\n  /** @internal */\r\n  readonly _id: number;\r\n  /** @internal */\r\n  readonly _name: string;\r\n\r\n  /** @internal */\r\n  constructor(id: number, name: string) {\r\n    this._id = id;\r\n    this._name = name;\r\n  }\r\n\r\n  /** Debug-friendly name of the referenced resource. */\r\n  get name(): string {\r\n    return this._name;\r\n  }\r\n}\r\n\r\n// ─── Internal Resource Tracking ─────────────────────────────────────────\r\n\r\n/** @internal */\r\nexport type RGResourceKind = 'transient' | 'imported';\r\n\r\n/**\r\n * Internal bookkeeping for a resource within the render graph.\r\n * @internal\r\n */\r\nexport class RGResource {\r\n  readonly id: number;\r\n  readonly name: string;\r\n  readonly kind: RGResourceKind;\r\n  readonly desc: RGTextureDesc | null;\r\n  /** The pass that creates / writes this resource (null for imported until written). */\r\n  producer: RGPass | null = null;\r\n  /** Passes that read this resource. */\r\n  readonly consumers: RGPass[] = [];\r\n\r\n  constructor(id: number, name: string, kind: RGResourceKind, desc: RGTextureDesc | null) {\r\n    this.id = id;\r\n    this.name = name;\r\n    this.kind = kind;\r\n    this.desc = desc;\r\n  }\r\n}\r\n\r\n// ─── Internal Pass Tracking ─────────────────────────────────────────────\r\n\r\n// ─── Execution Context ──────────────────────────────────────────────\r\n\r\n/**\r\n * Context passed to pass execute callbacks during graph execution.\r\n *\r\n * Provides access to resolved GPU resources by their handles.\r\n *\r\n * @public\r\n */\r\nexport interface RGExecuteContext {\r\n  /**\r\n   * Resolve a handle to the actual GPU texture object.\r\n   *\r\n   * For transient resources, this returns the texture allocated by the executor.\r\n   * For imported resources, this returns the texture registered via\r\n   * {@link RenderGraphExecutor.setImportedTexture}.\r\n   *\r\n   * @param handle - Handle of the resource to resolve.\r\n   * @returns The resolved texture object (type depends on the allocator).\r\n   */\r\n  getTexture<TTexture = unknown>(handle: RGHandle): TTexture;\r\n}\r\n\r\n/**\r\n * Execute callback signature.\r\n *\r\n * The callback receives a context for resolving handles to GPU resources,\r\n * plus the user data returned from the setup function.\r\n *\r\n * @public\r\n */\r\nexport type RGExecuteFn<T = void> = (ctx: RGExecuteContext, data: T) => void;\r\n\r\n/**\r\n * Internal bookkeeping for a pass within the render graph.\r\n * @internal\r\n */\r\nexport class RGPass<T = unknown> {\r\n  readonly index: number;\r\n  readonly name: string;\r\n  /** Resources this pass reads (dependencies). */\r\n  readonly reads: RGResource[] = [];\r\n  /** Resources this pass creates or writes. */\r\n  readonly writes: RGResource[] = [];\r\n  /** Whether this pass has side effects and must not be culled. */\r\n  hasSideEffect = false;\r\n  /** User data returned from the setup function. */\r\n  data: T | null = null;\r\n  /** Execute callback. */\r\n  executeFn: RGExecuteFn<T> | null = null;\r\n  /** Set during compilation: true if this pass is needed. */\r\n  alive = true;\r\n\r\n  constructor(index: number, name: string) {\r\n    this.index = index;\r\n    this.name = name;\r\n  }\r\n}\r\n\r\n// ─── Pass Builder ───────────────────────────────────────────────────────\r\n\r\n/**\r\n * Builder interface used within the setup callback of {@link RenderGraph.addPass}\r\n * to declare a pass's resource requirements.\r\n *\r\n * @public\r\n */\r\nexport interface RGPassBuilder {\r\n  /**\r\n   * Declare a read dependency on an existing resource.\r\n   *\r\n   * The resource must have been created by a prior pass or imported into the graph.\r\n   *\r\n   * @param handle - Handle of the resource to read.\r\n   */\r\n  read(handle: RGHandle): void;\r\n\r\n  /**\r\n   * Declare that this pass writes to an existing resource (typically an imported resource).\r\n   *\r\n   * @param handle - Handle of the resource to write to.\r\n   */\r\n  write(handle: RGHandle): void;\r\n\r\n  /**\r\n   * Create a new transient texture resource that this pass will produce.\r\n   *\r\n   * @param desc - Texture descriptor.\r\n   * @returns A handle referencing the newly created resource.\r\n   */\r\n  createTexture(desc: RGTextureDesc): RGHandle;\r\n\r\n  /**\r\n   * Mark this pass as having side effects.\r\n   *\r\n   * Side-effect passes are never culled by the graph compiler, regardless of\r\n   * whether their outputs are consumed. Use this for GPU readback, picking,\r\n   * debug overlays, etc.\r\n   */\r\n  sideEffect(): void;\r\n\r\n  /**\r\n   * Set the execution callback for this pass.\r\n   *\r\n   * @param fn - Callback invoked during graph execution.\r\n   */\r\n  setExecute<D>(fn: RGExecuteFn<D>): void;\r\n}\r\n\r\n// ─── Compiled Graph ─────────────────────────────────────────────────────\r\n\r\n/**\r\n * Lifetime information for a resource within the compiled graph.\r\n *\r\n * @public\r\n */\r\nexport interface RGResourceLifetime {\r\n  /** The resource. */\r\n  readonly resource: RGResource;\r\n  /** Index of the first pass that uses (produces or reads) this resource. */\r\n  readonly firstUse: number;\r\n  /** Index of the last pass that uses this resource. */\r\n  readonly lastUse: number;\r\n}\r\n\r\n/**\r\n * Result of compiling a render graph.\r\n *\r\n * Contains the ordered list of passes to execute and lifetime information\r\n * for automatic resource management.\r\n *\r\n * @public\r\n */\r\nexport interface CompiledRenderGraph {\r\n  /** Topologically sorted passes (only non-culled passes). */\r\n  readonly orderedPasses: ReadonlyArray<RGPass>;\r\n  /** Resource lifetime information keyed by resource ID. */\r\n  readonly lifetimes: ReadonlyMap<number, RGResourceLifetime>;\r\n}\r\n\r\n// ─── Texture Allocator ──────────────────────────────────────────────\r\n\r\n/**\r\n * Resolved dimensions for a texture allocation.\r\n * @public\r\n */\r\nexport interface RGResolvedSize {\r\n  width: number;\r\n  height: number;\r\n}\r\n\r\n/**\r\n * Interface for allocating and releasing transient textures.\r\n *\r\n * Implement this to bridge the render graph with your GPU device's resource pool.\r\n * The executor calls {@link allocate} before a resource's first use and\r\n * {@link release} after its last use.\r\n *\r\n * @typeParam TTexture - The concrete texture type (e.g. `Texture2D`).\r\n * @public\r\n */\r\nexport interface RGTextureAllocator<TTexture = unknown> {\r\n  /**\r\n   * Allocate a transient texture matching the given descriptor and resolved size.\r\n   *\r\n   * @param desc - The texture descriptor from the pass builder.\r\n   * @param size - The resolved pixel dimensions.\r\n   * @returns The allocated texture object.\r\n   */\r\n  allocate(desc: RGTextureDesc, size: RGResolvedSize): TTexture;\r\n\r\n  /**\r\n   * Release a previously allocated transient texture back to the pool.\r\n   *\r\n   * @param texture - The texture to release.\r\n   */\r\n  release(texture: TTexture): void;\r\n}\r\n"],"names":["RGHandle","id","name","_id","_name","RGResource","kind","desc","producer","consumers","RGPass","index","reads","writes","hasSideEffect","data","executeFn","alive"],"mappings":"AAoCA;AAEA;;;;;;;;AAQC,IACM,MAAMA,QAAAA,CAAAA;qBAEX,GAAqB;qBAErB,KAAuB;AAEvB,qBACA,WAAA,CAAYC,EAAU,EAAEC,IAAY,CAAE;QACpC,IAAI,CAACC,GAAG,GAAGF,EAAAA;QACX,IAAI,CAACG,KAAK,GAAGF,IAAAA;AACf;2DAGA,IAAIA,IAAe,GAAA;QACjB,OAAO,IAAI,CAACE,KAAK;AACnB;AACF;AAOA;;;AAGC,IACM,MAAMC,UAAAA,CAAAA;IACFJ,EAAW;IACXC,IAAa;IACbI,IAAqB;IACrBC,IAA2B;2FAEpCC,WAA0B,IAAK;AAC/B,2CACSC,SAAsB,GAAA,EAAE;AAEjC,IAAA,WAAA,CAAYR,EAAU,EAAEC,IAAY,EAAEI,IAAoB,EAAEC,IAA0B,CAAE;QACtF,IAAI,CAACN,EAAE,GAAGA,EAAAA;QACV,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACI,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACC,IAAI,GAAGA,IAAAA;AACd;AACF;AAqCA;;;AAGC,IACM,MAAMG,MAAAA,CAAAA;IACFC,KAAc;IACdT,IAAa;AACtB,qDACSU,KAAsB,GAAA,EAAE;AACjC,kDACSC,MAAuB,GAAA,EAAE;sEAElCC,gBAAgB,KAAM;uDAEtBC,OAAiB,IAAK;6BAEtBC,YAAmC,IAAK;gEAExCC,QAAQ,IAAK;IAEb,WAAYN,CAAAA,KAAa,EAAET,IAAY,CAAE;QACvC,IAAI,CAACS,KAAK,GAAGA,KAAAA;QACb,IAAI,CAACT,IAAI,GAAGA,IAAAA;AACd;AACF;;;;"}
+{"version":3,"file":"types.js","sources":["../../../src/render/rendergraph/types.ts"],"sourcesContent":["import type { TextureFormat } from '@zephyr3d/device';\r\n\r\n// ─── Resource Descriptors ───────────────────────────────────────────────\r\n\r\n/**\r\n * Sizing mode for render graph textures.\r\n *\r\n * - 'absolute': fixed pixel dimensions\r\n * - 'backbuffer-relative': scaled relative to the backbuffer size\r\n *\r\n * @public\r\n */\r\nexport type RGSizeMode = 'absolute' | 'backbuffer-relative';\r\n\r\n/**\r\n * Descriptor for a transient texture resource within the render graph.\r\n *\r\n * Transient textures are allocated and released automatically by the graph compiler.\r\n *\r\n * @public\r\n */\r\nexport interface RGTextureDesc {\r\n  /** Debug label for this resource. */\r\n  label?: string;\r\n  /** Texture format (e.g. 'rgba8unorm', 'r32f', 'rgba16f'). */\r\n  format: TextureFormat;\r\n  /** Sizing mode. Default 'backbuffer-relative'. */\r\n  sizeMode?: RGSizeMode;\r\n  /** Width in pixels (absolute) or scale factor (backbuffer-relative, default 1.0). */\r\n  width?: number;\r\n  /** Height in pixels (absolute) or scale factor (backbuffer-relative, default 1.0). */\r\n  height?: number;\r\n  /** Number of mip levels. Default 1. */\r\n  mipLevels?: number;\r\n}\r\n\r\n// ─── Handles ────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Opaque handle referencing a resource within the render graph.\r\n *\r\n * Handles are obtained from {@link RGPassBuilder.createTexture}, {@link RenderGraph.importTexture},\r\n * or {@link RGPassBuilder.write}. They are lightweight identifiers used to declare\r\n * dependencies between passes.\r\n *\r\n * @public\r\n */\r\nexport class RGHandle {\r\n  /** @internal */\r\n  readonly _id: number;\r\n  /** @internal */\r\n  readonly _name: string;\r\n\r\n  /** @internal */\r\n  constructor(id: number, name: string) {\r\n    this._id = id;\r\n    this._name = name;\r\n  }\r\n\r\n  /** Debug-friendly name of the referenced resource. */\r\n  get name(): string {\r\n    return this._name;\r\n  }\r\n}\r\n\r\n// ─── Internal Resource Tracking ─────────────────────────────────────────\r\n\r\n/** @public */\r\nexport type RGResourceKind = 'transient' | 'imported';\r\n\r\n/**\r\n * Internal bookkeeping for a resource within the render graph.\r\n * @public\r\n */\r\nexport class RGResource {\r\n  readonly id: number;\r\n  readonly name: string;\r\n  readonly kind: RGResourceKind;\r\n  readonly desc: RGTextureDesc | null;\r\n  /** The pass that creates / writes this resource (null for imported until written). */\r\n  producer: RGPass | null = null;\r\n  /** Passes that read this resource. */\r\n  readonly consumers: RGPass[] = [];\r\n\r\n  constructor(id: number, name: string, kind: RGResourceKind, desc: RGTextureDesc | null) {\r\n    this.id = id;\r\n    this.name = name;\r\n    this.kind = kind;\r\n    this.desc = desc;\r\n  }\r\n}\r\n\r\n// ─── Internal Pass Tracking ─────────────────────────────────────────────\r\n\r\n// ─── Execution Context ──────────────────────────────────────────────\r\n\r\n/**\r\n * Context passed to pass execute callbacks during graph execution.\r\n *\r\n * Provides access to resolved GPU resources by their handles.\r\n *\r\n * @public\r\n */\r\nexport interface RGExecuteContext {\r\n  /**\r\n   * Resolve a handle to the actual GPU texture object.\r\n   *\r\n   * For transient resources, this returns the texture allocated by the executor.\r\n   * For imported resources, this returns the texture registered via\r\n   * {@link RenderGraphExecutor.setImportedTexture}.\r\n   *\r\n   * @param handle - Handle of the resource to resolve.\r\n   * @returns The resolved texture object (type depends on the allocator).\r\n   */\r\n  getTexture<TTexture = unknown>(handle: RGHandle): TTexture;\r\n}\r\n\r\n/**\r\n * Execute callback signature.\r\n *\r\n * The callback receives a context for resolving handles to GPU resources,\r\n * plus the user data returned from the setup function.\r\n *\r\n * @public\r\n */\r\nexport type RGExecuteFn<T = void> = (ctx: RGExecuteContext, data: T) => void;\r\n\r\n/**\r\n * Internal bookkeeping for a pass within the render graph.\r\n * @public\r\n */\r\nexport class RGPass<T = unknown> {\r\n  readonly index: number;\r\n  readonly name: string;\r\n  /** Resources this pass reads (dependencies). */\r\n  readonly reads: RGResource[] = [];\r\n  /** Resources this pass creates or writes. */\r\n  readonly writes: RGResource[] = [];\r\n  /** Whether this pass has side effects and must not be culled. */\r\n  hasSideEffect = false;\r\n  /** User data returned from the setup function. */\r\n  data: T | null = null;\r\n  /** Execute callback. */\r\n  executeFn: RGExecuteFn<T> | null = null;\r\n  /** Set during compilation: true if this pass is needed. */\r\n  alive = true;\r\n\r\n  constructor(index: number, name: string) {\r\n    this.index = index;\r\n    this.name = name;\r\n  }\r\n}\r\n\r\n// ─── Pass Builder ───────────────────────────────────────────────────────\r\n\r\n/**\r\n * Builder interface used within the setup callback of {@link RenderGraph.addPass}\r\n * to declare a pass's resource requirements.\r\n *\r\n * @public\r\n */\r\nexport interface RGPassBuilder {\r\n  /**\r\n   * Declare a read dependency on an existing resource.\r\n   *\r\n   * The resource must have been created by a prior pass or imported into the graph.\r\n   *\r\n   * @param handle - Handle of the resource to read.\r\n   */\r\n  read(handle: RGHandle): void;\r\n\r\n  /**\r\n   * Declare that this pass writes to an existing resource (typically an imported resource).\r\n   *\r\n   * @param handle - Handle of the resource to write to.\r\n   */\r\n  write(handle: RGHandle): void;\r\n\r\n  /**\r\n   * Create a new transient texture resource that this pass will produce.\r\n   *\r\n   * @param desc - Texture descriptor.\r\n   * @returns A handle referencing the newly created resource.\r\n   */\r\n  createTexture(desc: RGTextureDesc): RGHandle;\r\n\r\n  /**\r\n   * Mark this pass as having side effects.\r\n   *\r\n   * Side-effect passes are never culled by the graph compiler, regardless of\r\n   * whether their outputs are consumed. Use this for GPU readback, picking,\r\n   * debug overlays, etc.\r\n   */\r\n  sideEffect(): void;\r\n\r\n  /**\r\n   * Set the execution callback for this pass.\r\n   *\r\n   * @param fn - Callback invoked during graph execution.\r\n   */\r\n  setExecute<D>(fn: RGExecuteFn<D>): void;\r\n}\r\n\r\n// ─── Compiled Graph ─────────────────────────────────────────────────────\r\n\r\n/**\r\n * Lifetime information for a resource within the compiled graph.\r\n *\r\n * @public\r\n */\r\nexport interface RGResourceLifetime {\r\n  /** The resource. */\r\n  readonly resource: RGResource;\r\n  /** Index of the first pass that uses (produces or reads) this resource. */\r\n  readonly firstUse: number;\r\n  /** Index of the last pass that uses this resource. */\r\n  readonly lastUse: number;\r\n}\r\n\r\n/**\r\n * Result of compiling a render graph.\r\n *\r\n * Contains the ordered list of passes to execute and lifetime information\r\n * for automatic resource management.\r\n *\r\n * @public\r\n */\r\nexport interface CompiledRenderGraph {\r\n  /** Topologically sorted passes (only non-culled passes). */\r\n  readonly orderedPasses: ReadonlyArray<RGPass>;\r\n  /** Resource lifetime information keyed by resource ID. */\r\n  readonly lifetimes: ReadonlyMap<number, RGResourceLifetime>;\r\n}\r\n\r\n// ─── Texture Allocator ──────────────────────────────────────────────\r\n\r\n/**\r\n * Resolved dimensions for a texture allocation.\r\n * @public\r\n */\r\nexport interface RGResolvedSize {\r\n  width: number;\r\n  height: number;\r\n}\r\n\r\n/**\r\n * Interface for allocating and releasing transient textures.\r\n *\r\n * Implement this to bridge the render graph with your GPU device's resource pool.\r\n * The executor calls {@link allocate} before a resource's first use and\r\n * {@link release} after its last use.\r\n *\r\n * @typeParam TTexture - The concrete texture type (e.g. `Texture2D`).\r\n * @public\r\n */\r\nexport interface RGTextureAllocator<TTexture = unknown> {\r\n  /**\r\n   * Allocate a transient texture matching the given descriptor and resolved size.\r\n   *\r\n   * @param desc - The texture descriptor from the pass builder.\r\n   * @param size - The resolved pixel dimensions.\r\n   * @returns The allocated texture object.\r\n   */\r\n  allocate(desc: RGTextureDesc, size: RGResolvedSize): TTexture;\r\n\r\n  /**\r\n   * Release a previously allocated transient texture back to the pool.\r\n   *\r\n   * @param texture - The texture to release.\r\n   */\r\n  release(texture: TTexture): void;\r\n}\r\n"],"names":["RGHandle","id","name","_id","_name","RGResource","kind","desc","producer","consumers","RGPass","index","reads","writes","hasSideEffect","data","executeFn","alive"],"mappings":"AAoCA;AAEA;;;;;;;;AAQC,IACM,MAAMA,QAAAA,CAAAA;qBAEX,GAAqB;qBAErB,KAAuB;AAEvB,qBACA,WAAA,CAAYC,EAAU,EAAEC,IAAY,CAAE;QACpC,IAAI,CAACC,GAAG,GAAGF,EAAAA;QACX,IAAI,CAACG,KAAK,GAAGF,IAAAA;AACf;2DAGA,IAAIA,IAAe,GAAA;QACjB,OAAO,IAAI,CAACE,KAAK;AACnB;AACF;AAOA;;;AAGC,IACM,MAAMC,UAAAA,CAAAA;IACFJ,EAAW;IACXC,IAAa;IACbI,IAAqB;IACrBC,IAA2B;2FAEpCC,WAA0B,IAAK;AAC/B,2CACSC,SAAsB,GAAA,EAAE;AAEjC,IAAA,WAAA,CAAYR,EAAU,EAAEC,IAAY,EAAEI,IAAoB,EAAEC,IAA0B,CAAE;QACtF,IAAI,CAACN,EAAE,GAAGA,EAAAA;QACV,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACI,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACC,IAAI,GAAGA,IAAAA;AACd;AACF;AAqCA;;;AAGC,IACM,MAAMG,MAAAA,CAAAA;IACFC,KAAc;IACdT,IAAa;AACtB,qDACSU,KAAsB,GAAA,EAAE;AACjC,kDACSC,MAAuB,GAAA,EAAE;sEAElCC,gBAAgB,KAAM;uDAEtBC,OAAiB,IAAK;6BAEtBC,YAAmC,IAAK;gEAExCC,QAAQ,IAAK;IAEb,WAAYN,CAAAA,KAAa,EAAET,IAAY,CAAE;QACvC,IAAI,CAACS,KAAK,GAAGA,KAAAA;QACb,IAAI,CAACT,IAAI,GAAGA,IAAAA;AACd;AACF;;;;"}

package/dist/render/sky.js

@@ -5,6 +5,7 @@ import { getDefaultAtmosphereParams, getAerialPerspectiveLut, renderAtmosphereLU
 import { Matrix4x4, Disposable, DRef, Vector4, Vector2, Vector3, CubeFace, objectKeys } from '@zephyr3d/base';
 import { Primitive } from './primitive.js';
 import { BoxShape } from '../shapes/box.js';
+import '../shapes/capsule.js';
 import '../shapes/cylinder.js';
 import '../shapes/torus.js';
 import '../shapes/plane.js';
@@ -74,6 +75,7 @@ const defaultSkyWorldMatrix = Matrix4x4.identity();
     _cloudIntensity;
     _debugAerialPerspective;
     _wind;
+    _skyboxRotation;
     _skyWorldMatrix;
     _lastSunDir;
     _lastSunColor;
@@ -115,6 +117,7 @@ const defaultSkyWorldMatrix = Matrix4x4.identity();
         this._cloudy = 0.45;
         this._cloudIntensity = 15;
         this._wind = new Vector2(0, 0);
+        this._skyboxRotation = new Vector3(0, 0, 0);
         this._skyWorldMatrix = defaultSkyWorldMatrix;
         this._lastSunDir = SkyRenderer._getSunDir(null);
         this._lastSunColor = SkyRenderer._getSunColor(null);
@@ -424,7 +427,9 @@ const defaultSkyWorldMatrix = Matrix4x4.identity();
    */ get irradianceSHFB() {
         if (!this._irradianceSHFB.get()) {
             const device = getDevice();
-            const texture = device.createTexture2D('rgba32f', 3, 3, {
+            const texCaps = device.getDeviceCaps().textureCaps;
+            const format = !device.getDeviceCaps().framebufferCaps.supportFloatBlending && texCaps.supportHalfFloatColorBuffer ? 'rgba16f' : 'rgba32f';
+            const texture = device.createTexture2D(format, 3, 3, {
                 mipmapping: false
             });
             this._irradianceSHFB.set(device.createFrameBuffer([
@@ -446,12 +451,25 @@ const defaultSkyWorldMatrix = Matrix4x4.identity();
             }
         }
     }
+    /**
+   * Additional euler rotation (in degrees) applied to skybox.
+   */ get skyboxRotation() {
+        return this._skyboxRotation;
+    }
+    set skyboxRotation(val) {
+        if (!val.equalsTo(this._skyboxRotation)) {
+            this._skyboxRotation.set(val);
+            if (this._skyType === 'skybox') {
+                this.invalidate();
+            }
+        }
+    }
     /** @internal */ get skyWorldMatrix() {
         return this._skyWorldMatrix;
     }
     set skyWorldMatrix(val) {
         val = val ?? defaultSkyWorldMatrix;
-        if (val !== this._skyWorldMatrix) {
+        if (!val.equalsTo(this._skyWorldMatrix)) {
             this._skyWorldMatrix = val;
             this.invalidate();
         }
@@ -523,12 +541,9 @@ const defaultSkyWorldMatrix = Matrix4x4.identity();
             this.renderSkyDistantLut(ctx, this._bakedSkyboxTexture.get());
             if (ctx.scene.env.light.radianceMap && (ctx.scene.env.light.radianceMap === this.radianceMap || this._irradianceSH.get() && ctx.scene.env.light.irradianceSH === this.irradianceSH || this._irradianceSHFB.get() && ctx.scene.env.light.irradianceSHFB === this.irradianceSHFB)) {
                 prefilterCubemap(this._bakedSkyboxTexture.get(), 'ggx', this.radianceFramebuffer, this._radianceConvSamples);
-                if (ctx.device.type === 'webgl' || !ctx.device.getDeviceCaps().framebufferCaps.supportFloatBlending) {
-                    this._shProjector.projectCubemapToTexture(this._bakedSkyboxTexture.get(), this.irradianceSHFB);
-                } else {
-                    this._shProjector.projectCubemap(this._bakedSkyboxTexture.get(), this.irradianceSH);
-                }
-                ctx.scene.env.light.irradianceSH = this.irradianceSH;
+                this._shProjector.projectCubemapToTexture(this._bakedSkyboxTexture.get(), this.irradianceSHFB);
+                ctx.scene.env.light.irradianceSHFB = this.irradianceSHFB;
+                ctx.scene.env.light.irradianceSH = null;
                 ctx.scene.env.light.irradianceWindow = this._shWindowWeights;
             }
         }
@@ -702,7 +717,9 @@ const defaultSkyWorldMatrix = Matrix4x4.identity();
     }
     /** @internal */ _updateSkyboxTexture() {
         if (this._panoramaAsset) {
-            getEngine().resourceManager.fetchTexture(this._panoramaAsset).then((tex)=>{
+            getEngine().resourceManager.fetchTexture(this._panoramaAsset, {
+                linearColorSpace: true
+            }).then((tex)=>{
                 if (!tex.isTexture2D()) {
                     console.error(`Invalid panorama texture asset: ${this._panoramaAsset}`);
                 } else {