three-zoo 0.9.4 → 0.10.0

package/dist/{Sky.d.ts → SkyLight.d.ts}

@@ -3,7 +3,7 @@ import { HemisphereLight } from "three";
 /**
  * Configuration options for HDR color extraction.
  */
-export interface SkyOptions {
+export interface SkyLightOptions {
     /** Number of brightest pixels to average for sky color (default: 100) */
     skySampleCount?: number;
     /** Number of pixels to average for ground color (default: 100) */
@@ -16,7 +16,7 @@ export interface SkyOptions {
 /**
  * Hemisphere light with HDR environment map support for automatic sky/ground color extraction.
  */
-export declare class Sky extends HemisphereLight {
+export declare class SkyLight extends HemisphereLight {
     /**
      * Sets sky and ground colors from an HDR texture.
      * Analyzes upper hemisphere for sky color and lower hemisphere for ground color.
@@ -24,7 +24,7 @@ export declare class Sky extends HemisphereLight {
      * @param texture - HDR texture to analyze (must have image data)
      * @param options - Configuration options for color extraction
      */
-    setColorsFromHDRTexture(texture: Texture, options?: SkyOptions): void;
+    setColorsFromHDRTexture(texture: Texture, options?: SkyLightOptions): void;
     /**
      * Inserts pixel into sorted array, maintaining size limit.
      */

package/dist/Sun.d.ts

@@ -53,6 +53,27 @@ export declare class Sun extends DirectionalLight {
      * @param box3 - 3D bounding box to cover with shadows
      */
     configureShadowsForBoundingBox(box3: Box3): void;
+    /**
+     * Sets sun direction, color and intensity based on brightest point in HDR environment map.
+     *
+     * @param texture - HDR texture to analyze (must have image data)
+     * @param distance - Distance to place sun from origin
+     * @param intensityScale - Multiplier for intensity derived from luminance (default: 1)
+     */
+    setFromHDRTexture(texture: Texture, intensityScale?: number, distance?: number): void;
+    /**
+     * Sets sun color based on brightest point in HDR environment map.
+     *
+     * @param texture - HDR texture to analyze (must have image data)
+     */
+    setColorFromHDRTexture(texture: Texture): void;
+    /**
+     * Sets sun intensity based on luminance of brightest point in HDR environment map.
+     *
+     * @param texture - HDR texture to analyze (must have image data)
+     * @param scale - Multiplier for intensity (default: 1)
+     */
+    setIntensityFromHDRTexture(texture: Texture, scale?: number): void;
     /**
      * Sets sun direction based on brightest point in HDR environment map.
      *
@@ -60,4 +81,11 @@ export declare class Sun extends DirectionalLight {
      * @param distance - Distance to place sun from origin
      */
     setDirectionFromHDRTexture(texture: Texture, distance?: number): void;
+    /**
+     * Finds the brightest pixel in an HDR texture.
+     *
+     * @param texture - HDR texture to analyze
+     * @returns Index and luminance of brightest pixel
+     */
+    private findBrightestPixel;
 }

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { DualFovCamera } from "./DualFovCamera";
 export { SceneTraversal } from "./SceneTraversal";
 export { SkinnedMeshBaker } from "./SkinnedMeshBaker";
-export { Sky } from "./Sky";
+export { SkyLight } from "./SkyLight";
 export { StandardToBasicConverter } from "./StandardToBasicConverter";
 export { StandardToLambertConverter } from "./StandardToLambertConverter";
 export { StandardToPhongConverter } from "./StandardToPhongConverter";

package/dist/index.js

@@ -569,7 +569,7 @@ const GROUND_SAMPLE_THRESHOLD = 0.75;
 /**
  * Hemisphere light with HDR environment map support for automatic sky/ground color extraction.
  */
-class Sky extends HemisphereLight {
+class SkyLight extends HemisphereLight {
     /**
      * Sets sky and ground colors from an HDR texture.
      * Analyzes upper hemisphere for sky color and lower hemisphere for ground color.
@@ -1587,6 +1587,42 @@ class Sun extends DirectionalLight {
         camera.updateWorldMatrix(true, false);
         camera.updateProjectionMatrix();
     }
+    /**
+     * Sets sun direction, color and intensity based on brightest point in HDR environment map.
+     *
+     * @param texture - HDR texture to analyze (must have image data)
+     * @param distance - Distance to place sun from origin
+     * @param intensityScale - Multiplier for intensity derived from luminance (default: 1)
+     */
+    setFromHDRTexture(texture, intensityScale = 1, distance = 1) {
+        this.setColorFromHDRTexture(texture);
+        this.setIntensityFromHDRTexture(texture, intensityScale);
+        this.setDirectionFromHDRTexture(texture, distance);
+    }
+    /**
+     * Sets sun color based on brightest point in HDR environment map.
+     *
+     * @param texture - HDR texture to analyze (must have image data)
+     */
+    setColorFromHDRTexture(texture) {
+        const { index } = this._private_findBrightestPixel(texture);
+        const data = texture.image.data;
+        const r = data[index];
+        const g = data[index + 1];
+        const b = data[index + 2];
+        const maxChannel = Math.max(r, g, b, 1);
+        this.color.setRGB(r / maxChannel, g / maxChannel, b / maxChannel);
+    }
+    /**
+     * Sets sun intensity based on luminance of brightest point in HDR environment map.
+     *
+     * @param texture - HDR texture to analyze (must have image data)
+     * @param scale - Multiplier for intensity (default: 1)
+     */
+    setIntensityFromHDRTexture(texture, scale = 1) {
+        const { luminance } = this._private_findBrightestPixel(texture);
+        this.intensity = luminance * scale;
+    }
     /**
      * Sets sun direction based on brightest point in HDR environment map.
      *
@@ -1594,12 +1630,30 @@ class Sun extends DirectionalLight {
      * @param distance - Distance to place sun from origin
      */
     setDirectionFromHDRTexture(texture, distance = 1) {
-        const data = texture.image.data;
+        const { index } = this._private_findBrightestPixel(texture);
         const width = texture.image.width;
         const height = texture.image.height;
+        const step = texture.format === RGBAFormat ? RGBA_CHANNEL_COUNT : RGB_CHANNEL_COUNT;
+        // Convert to spherical coordinates
+        const pixelIndex = index / step;
+        const x = pixelIndex % width;
+        const y = Math.floor(pixelIndex / width);
+        const u = x / width;
+        const v = y / height;
+        const elevation = v * Math.PI;
+        const azimuth = u * -Math.PI * 2 - Math.PI / 2;
+        this.position.setFromSphericalCoords(distance, elevation, azimuth);
+    }
+    /**
+     * Finds the brightest pixel in an HDR texture.
+     *
+     * @param texture - HDR texture to analyze
+     * @returns Index and luminance of brightest pixel
+     */
+    _private_findBrightestPixel(texture) {
+        const data = texture.image.data;
         let maxLuminance = 0;
         let maxIndex = 0;
-        // Find brightest pixel
         const step = texture.format === RGBAFormat ? RGBA_CHANNEL_COUNT : RGB_CHANNEL_COUNT;
         for (let i = 0; i < data.length; i += step) {
             const r = data[i];
@@ -1611,17 +1665,9 @@ class Sun extends DirectionalLight {
                 maxIndex = i;
             }
         }
-        // Convert to spherical coordinates
-        const pixelIndex = maxIndex / step;
-        const x = pixelIndex % width;
-        const y = Math.floor(pixelIndex / width);
-        const u = x / width;
-        const v = y / height;
-        const elevation = v * Math.PI;
-        const azimuth = u * -Math.PI * 2 - Math.PI / 2;
-        this.position.setFromSphericalCoords(distance, elevation, azimuth);
+        return { index: maxIndex, luminance: maxLuminance };
     }
 }
 
-export { DualFovCamera, SceneTraversal, SkinnedMeshBaker, Sky, StandardToBasicConverter, StandardToLambertConverter, StandardToPhongConverter, StandardToPhysicalConverter, StandardToToonConverter, Sun };
+export { DualFovCamera, SceneTraversal, SkinnedMeshBaker, SkyLight, StandardToBasicConverter, StandardToLambertConverter, StandardToPhongConverter, StandardToPhysicalConverter, StandardToToonConverter, Sun };
 //# sourceMappingURL=index.js.map