@selvajs/visualization 1.6.0-beta.9 → 1.6.0

package/dist/render.d.cts

@@ -127,6 +127,17 @@ type RenderConfig = {
    * device with a phone-sized screen. Set it to force the tier on or off.
    */
   lowPower?: boolean;
+  /**
+   * Frames averaged while the camera rests, for soft shadows and clean edges. Needs the composer,
+   * so looks without AO or bloom skip it. Costs nothing while orbiting. Default 32, or 0 on a
+   * `lowPower` device; 0 turns it off.
+   */
+  idleRefineFrames?: number;
+  /**
+   * Orbit frames slower than this fade ambient occlusion out while the camera moves, its largest
+   * cost. Needs `idleRefineFrames` to fade back in. Default 22. 0 always does; `Infinity` never does.
+   */
+  lightOrbitFrameMs?: number;
   /** Default false — switches rendering from `renderer.render` to an EffectComposer, which costs more. */
   ambientOcclusion?: boolean;
   /** Glow around emissive parts. The look decides; `night` sets it. */
@@ -365,12 +376,13 @@ interface LabelLayer {
   dispose(): void;
 }
 /**
- * Two-click distance measurement. Click a point, click a second, read the distance off a label on
- * the connecting line; a third click starts fresh.
+ * Point-to-point distance measurement. Click a start point; a rubber band and live readout follow
+ * the cursor until the second click commits it. Committed measurements stay until Escape (which
+ * first drops an unfinished start point) or until the tool is disabled.
  *
- * Picking snaps to the nearest vertex within {@link MeasureOptions.snapPixels} so measurements
- * land exactly on vertices rather than wherever the ray happened to hit — a cheap local snap
- * against the struck primitive's own vertices, no spatial index.
+ * Picking snaps to the nearest vertex of the struck triangle, segment or point within
+ * {@link MeasureOptions.snapPixels}; the hover marker turns solid when it has snapped. Meshes are
+ * picked through a BVH (`scene-pick.ts`), so hovering stays cheap on large models.
  *
  * Dormant until {@link MeasureTool.setEnabled}(true). While enabled it intercepts clicks (caller
  * forwards them and swallows the event when {@link MeasureTool.handleClick} returns true) so
@@ -381,8 +393,10 @@ interface MeasureTool {
   isEnabled(): boolean;
   /** Returns true if the tool consumed the click (caller should not also select). */
   handleClick(event: MouseEvent): boolean;
-  /** Preview the next snap point via a ghost marker. No-op when disabled; never consumes the event. */
+  /** Preview the next snap point and the rubber band. No-op when disabled; never consumes the event. */
   handleMove(event: MouseEvent): void;
+  /** Drops the unfinished start point, or every measurement when there is none. Bound to Escape. */
+  cancel(): void;
   clear(): void;
   dispose(): void;
 }

package/dist/render.d.ts

@@ -127,6 +127,17 @@ type RenderConfig = {
    * device with a phone-sized screen. Set it to force the tier on or off.
    */
   lowPower?: boolean;
+  /**
+   * Frames averaged while the camera rests, for soft shadows and clean edges. Needs the composer,
+   * so looks without AO or bloom skip it. Costs nothing while orbiting. Default 32, or 0 on a
+   * `lowPower` device; 0 turns it off.
+   */
+  idleRefineFrames?: number;
+  /**
+   * Orbit frames slower than this fade ambient occlusion out while the camera moves, its largest
+   * cost. Needs `idleRefineFrames` to fade back in. Default 22. 0 always does; `Infinity` never does.
+   */
+  lightOrbitFrameMs?: number;
   /** Default false — switches rendering from `renderer.render` to an EffectComposer, which costs more. */
   ambientOcclusion?: boolean;
   /** Glow around emissive parts. The look decides; `night` sets it. */
@@ -365,12 +376,13 @@ interface LabelLayer {
   dispose(): void;
 }
 /**
- * Two-click distance measurement. Click a point, click a second, read the distance off a label on
- * the connecting line; a third click starts fresh.
+ * Point-to-point distance measurement. Click a start point; a rubber band and live readout follow
+ * the cursor until the second click commits it. Committed measurements stay until Escape (which
+ * first drops an unfinished start point) or until the tool is disabled.
  *
- * Picking snaps to the nearest vertex within {@link MeasureOptions.snapPixels} so measurements
- * land exactly on vertices rather than wherever the ray happened to hit — a cheap local snap
- * against the struck primitive's own vertices, no spatial index.
+ * Picking snaps to the nearest vertex of the struck triangle, segment or point within
+ * {@link MeasureOptions.snapPixels}; the hover marker turns solid when it has snapped. Meshes are
+ * picked through a BVH (`scene-pick.ts`), so hovering stays cheap on large models.
  *
  * Dormant until {@link MeasureTool.setEnabled}(true). While enabled it intercepts clicks (caller
  * forwards them and swallows the event when {@link MeasureTool.handleClick} returns true) so
@@ -381,8 +393,10 @@ interface MeasureTool {
   isEnabled(): boolean;
   /** Returns true if the tool consumed the click (caller should not also select). */
   handleClick(event: MouseEvent): boolean;
-  /** Preview the next snap point via a ghost marker. No-op when disabled; never consumes the event. */
+  /** Preview the next snap point and the rubber band. No-op when disabled; never consumes the event. */
   handleMove(event: MouseEvent): void;
+  /** Drops the unfinished start point, or every measurement when there is none. Bound to Escape. */
+  cancel(): void;
   clear(): void;
   dispose(): void;
 }