three-cad-viewer 4.3.4 → 4.3.6

package/src/rendering/material-presets.ts

@@ -1,289 +0,0 @@
-/**
- * Built-in material presets for Studio mode.
- *
- * 31 presets organized by category: metals (polished & matte/brushed),
- * plastics, glass & transparent, rubber & elastomers, painted surfaces,
- * and natural/other materials.
- *
- * These are pure data definitions — no textures, no runtime cost.
- * The `builtin` field is intentionally omitted; it is used by user-defined
- * materials to reference these presets, not by presets themselves.
- *
- * All color values are in sRGB color space (0-1 per channel).
- * The material factory converts sRGB to linear when creating Three.js materials.
- * Presets with neutral color (plastics, paints) rely on the leaf node's
- * color field for the actual tint via fallback in the material factory.
- *
- */
-
-import type { MaterialAppearance } from "../core/types.js";
-
-// =============================================================================
-// Preset Dictionary
-// =============================================================================
-
-/**
- * Built-in material presets keyed by preset name.
- *
- * Usage: look up a preset by the `material` tag on a leaf node, or via
- * `"builtin:<name>"` strings in the materials table.
- */
-export const MATERIAL_PRESETS: Record<string, MaterialAppearance> = {
-  // ---------------------------------------------------------------------------
-  // Metals -- Polished
-  // ---------------------------------------------------------------------------
-
-  "chrome": {
-    name: "Chrome",
-    color: [0.98, 0.98, 0.98, 1],
-    metalness: 1.0,
-    roughness: 0.05,
-  },
-
-  "polished-steel": {
-    name: "Polished Steel",
-    color: [0.91, 0.91, 0.92, 1],
-    metalness: 1.0,
-    roughness: 0.1,
-  },
-
-  "polished-aluminum": {
-    name: "Polished Aluminum",
-    color: [0.916, 0.923, 0.924, 1],
-    metalness: 1.0,
-    roughness: 0.1,
-  },
-
-  "gold": {
-    name: "Gold",
-    color: [1, 0.93, 0, 1],
-    metalness: 1.0,
-    roughness: 0.1,
-  },
-
-  "copper": {
-    name: "Copper",
-    color: [0.98, 0.82, 0.76, 1],
-    metalness: 1.0,
-    roughness: 0.15,
-  },
-
-  "brass": {
-    name: "Brass",
-    color: [0.95, 0.9, 0.7, 1],
-    metalness: 1.0,
-    roughness: 0.15,
-  },
-
-  // ---------------------------------------------------------------------------
-  // Metals -- Matte / Brushed
-  // ---------------------------------------------------------------------------
-
-  "stainless-steel": {
-    name: "Stainless Steel",
-    color: [0.91, 0.91, 0.92, 1],
-    metalness: 1.0,
-    roughness: 0.4,
-  },
-
-  "brushed-aluminum": {
-    name: "Brushed Aluminum",
-    color: [0.916, 0.923, 0.924, 1],
-    metalness: 1.0,
-    roughness: 0.35,
-    anisotropy: 0.5,
-  },
-
-  "cast-iron": {
-    name: "Cast Iron",
-    color: [0.68, 0.68, 0.69, 1],
-    metalness: 0.9,
-    roughness: 0.7,
-  },
-
-  "titanium": {
-    name: "Titanium",
-    color: [0.81, 0.79, 0.77, 1],
-    metalness: 1.0,
-    roughness: 0.45,
-  },
-
-  "galvanized": {
-    name: "Galvanized",
-    color: [0.88, 0.88, 0.9, 1],
-    metalness: 0.8,
-    roughness: 0.5,
-  },
-
-  // ---------------------------------------------------------------------------
-  // Plastics
-  // ---------------------------------------------------------------------------
-
-  "plastic-glossy": {
-    name: "Plastic (Glossy)",
-    color: [0.91, 0.91, 0.91, 1],
-    metalness: 0.0,
-    roughness: 0.4,
-  },
-
-  "plastic-matte": {
-    name: "Plastic (Matte)",
-    color: [0.91, 0.91, 0.91, 1],
-    metalness: 0.0,
-    roughness: 0.6,
-  },
-
-  "abs-black": {
-    name: "ABS Black",
-    color: [0.25, 0.25, 0.25, 1],
-    metalness: 0.0,
-    roughness: 0.4,
-  },
-
-  "nylon": {
-    name: "Nylon",
-    color: [0.95, 0.94, 0.92, 1],
-    metalness: 0.0,
-    roughness: 0.55,
-  },
-
-  "acrylic-clear": {
-    name: "Acrylic (Clear)",
-    color: [1, 1, 1, 1],
-    metalness: 0.0,
-    roughness: 0.0,
-    transmission: 0.95,
-    ior: 1.49,
-  },
-
-  // ---------------------------------------------------------------------------
-  // Glass & Transparent
-  // ---------------------------------------------------------------------------
-
-  "glass-clear": {
-    name: "Glass (Clear)",
-    color: [1, 1, 1, 1],
-    metalness: 0.0,
-    roughness: 0.0,
-    transmission: 1.0,
-    ior: 1.52,
-    thickness: 2.0,
-  },
-
-  "glass-tinted": {
-    name: "Glass (Tinted)",
-    color: [0.8, 0.91, 0.95, 1],
-    metalness: 0.0,
-    roughness: 0.0,
-    transmission: 0.9,
-    ior: 1.52,
-    thickness: 3.0,
-  },
-
-  "glass-frosted": {
-    name: "Glass (Frosted)",
-    color: [1, 1, 1, 1],
-    metalness: 0.0,
-    roughness: 0.3,
-    transmission: 0.85,
-    ior: 1.52,
-    thickness: 2.0,
-  },
-
-  // ---------------------------------------------------------------------------
-  // Rubber & Elastomers
-  // ---------------------------------------------------------------------------
-
-  "rubber-black": {
-    name: "Rubber (Black)",
-    color: [0.31, 0.31, 0.31, 1],
-    metalness: 0.0,
-    roughness: 0.9,
-  },
-
-  "rubber-gray": {
-    name: "Rubber (Gray)",
-    color: [0.63, 0.63, 0.63, 1],
-    metalness: 0.0,
-    roughness: 0.85,
-  },
-
-  "rubber-red": {
-    name: "Rubber (Red)",
-    color: [0.85, 0.35, 0.35, 1],
-    metalness: 0.0,
-    roughness: 0.8,
-  },
-
-  // ---------------------------------------------------------------------------
-  // Painted Surfaces
-  // ---------------------------------------------------------------------------
-
-  "paint-matte": {
-    name: "Paint (Matte)",
-    color: [0.91, 0.91, 0.91, 1],
-    metalness: 0.0,
-    roughness: 0.7,
-  },
-
-  "paint-glossy": {
-    name: "Paint (Glossy)",
-    color: [0.91, 0.91, 0.91, 1],
-    metalness: 0.0,
-    roughness: 0.15,
-  },
-
-  "paint-metallic": {
-    name: "Paint (Metallic)",
-    color: [0.91, 0.91, 0.91, 1],
-    metalness: 0.5,
-    roughness: 0.25,
-  },
-
-  "car-paint": {
-    name: "Car Paint",
-    color: [0.91, 0, 0, 1],
-    metalness: 0.5,
-    roughness: 0.2,
-    clearcoat: 1.0,
-    clearcoatRoughness: 0.03,
-  },
-
-  // ---------------------------------------------------------------------------
-  // Natural / Other
-  // ---------------------------------------------------------------------------
-
-  "ceramic-white": {
-    name: "Ceramic (White)",
-    color: [0.98, 0.98, 0.97, 1],
-    metalness: 0.0,
-    roughness: 0.1,
-  },
-
-  "carbon-fiber": {
-    name: "Carbon Fiber",
-    color: [0.25, 0.25, 0.25, 1],
-    metalness: 0.3,
-    roughness: 0.35,
-    anisotropy: 0.3,
-  },
-
-  "concrete": {
-    name: "Concrete",
-    color: [0.83, 0.82, 0.8, 1],
-    metalness: 0.0,
-    roughness: 0.85,
-  },
-};
-
-// =============================================================================
-// Sorted Name List
-// =============================================================================
-
-/**
- * Sorted list of all built-in material preset names.
- *
- * Useful for UI dropdowns, validation, and programmatic enumeration.
- * Derived from MATERIAL_PRESETS keys at module load time.
- */
-export const MATERIAL_PRESET_NAMES: string[] = Object.keys(MATERIAL_PRESETS).sort();

package/src/rendering/raycast.ts

@@ -1,291 +0,0 @@
-import * as THREE from "three";
-import { KeyMapper, isMesh, isPoints, isLine } from "../utils/utils.js";
-import { isObjectGroup, type ObjectGroup } from "../scene/objectgroup.js";
-import type { Camera } from "../camera/camera.js";
-
-/**
- * Filter types for topology-based raycasting.
- */
-export const TopoFilter: {
-  none: null;
-  vertex: "vertex";
-  edge: "edge";
-  face: "face";
-  solid: "solid";
-} = {
-  none: null,
-  vertex: "vertex",
-  edge: "edge",
-  face: "face",
-  solid: "solid",
-};
-
-export type TopoFilterType = typeof TopoFilter[keyof typeof TopoFilter];
-
-interface RaycastFilters {
-  topoFilter: TopoFilterType[];
-}
-
-interface RaycastCallback {
-  (event: { mouse?: "left" | "right"; shift?: boolean; key?: string }): void;
-}
-
-/**
- * Represents a picked object from raycasting.
- * Can represent either a single shape or all faces of a solid.
- */
-export class PickedObject {
-  obj: ObjectGroup;
-  fromSolid: boolean;
-
-  /**
-   * Create a PickedObject.
-   * @param objectGroup - The picked ObjectGroup.
-   * @param fromSolid - Whether this pick is from a solid selection.
-   */
-  constructor(objectGroup: ObjectGroup, fromSolid: boolean) {
-    this.obj = objectGroup;
-    this.fromSolid = fromSolid;
-  }
-
-  /**
-   * Returns all the faces ObjectGroups that define the solid from the picked object.
-   */
-  private _getSolidObjectGroups(solidSubObject: ObjectGroup): ObjectGroup[] {
-    const solidGroup = solidSubObject.parent!.parent!;
-    let facesGroup: THREE.Object3D | undefined;
-    for (let i = 0; i < solidGroup.children.length; i++) {
-      const child = solidGroup.children[i];
-      if (child.name === solidGroup.name + "|faces") {
-        facesGroup = child;
-        break;
-      }
-    }
-
-    return (facesGroup?.children || []).filter(isObjectGroup);
-  }
-
-  /**
-   * If the picked object is part of a solid, returns all the faces ObjectGroups that define the solid.
-   * Otherwise, returns the picked object.
-   */
-  objs(): ObjectGroup[] {
-    if (this.fromSolid) {
-      return this._getSolidObjectGroups(this.obj);
-    } else {
-      return [this.obj];
-    }
-  }
-}
-
-/**
- * Handles mouse-based raycasting for object selection in the 3D scene.
- * Supports topology filtering and provides click/keyboard callbacks.
- */
-class Raycaster {
-  camera: Camera | null;
-  group: THREE.Object3D | null;
-  domElement: HTMLElement | null;
-  width: number;
-  height: number;
-  threshold: number;
-  callback: RaycastCallback;
-  raycaster: THREE.Raycaster;
-  raycastMode: boolean;
-  lastPosition: THREE.Vector3 | null;
-  mouse: THREE.Vector2;
-  mouseMoved: boolean;
-  filters: RaycastFilters;
-
-  /**
-   * Create a Raycaster for object picking.
-   * @param camera - The camera used for ray projection.
-   * @param domElement - The DOM element to listen for events.
-   * @param width - Viewport width in pixels.
-   * @param height - Viewport height in pixels.
-   * @param threshold - Point picking threshold in world units.
-   * @param group - The scene group to raycast against.
-   * @param callback - Callback for pick events.
-   */
-  constructor(
-    camera: Camera,
-    domElement: HTMLElement,
-    width: number,
-    height: number,
-    threshold: number,
-    group: THREE.Object3D,
-    callback: RaycastCallback
-  ) {
-    this.camera = camera;
-    this.group = group;
-    this.domElement = domElement;
-    this.width = width;
-    this.height = height;
-    this.threshold = threshold;
-    this.callback = callback;
-
-    this.raycaster = new THREE.Raycaster();
-    this.raycastMode = false;
-
-    this.lastPosition = null;
-
-    this.mouse = new THREE.Vector2();
-    this.mouseMoved = false;
-    this.filters = {
-      topoFilter: [TopoFilter.none],
-    };
-  }
-
-  /**
-   * Dispose of event listeners and clean up resources.
-   */
-  dispose(): void {
-    if (this.domElement) {
-      this.domElement.removeEventListener("mousemove", this.onPointerMove);
-      this.domElement.removeEventListener("mouseup", this.onMouseKeyUp);
-      this.domElement.removeEventListener("mousedown", this.onMouseKeyDown);
-    }
-    // Keyboard listener is on document (canvas doesn't receive focus)
-    document.removeEventListener("keydown", this.onKeyDown);
-    this.raycastMode = false;
-    this.group = null;
-    this.domElement = null;
-    this.camera = null;
-  }
-
-  /**
-   * Initialize event listeners and enable raycast mode.
-   */
-  init(): void {
-    if (!this.domElement) return;
-    this.domElement.addEventListener("mousemove", this.onPointerMove);
-    this.domElement.addEventListener("mouseup", this.onMouseKeyUp, false);
-    this.domElement.addEventListener("mousedown", this.onMouseKeyDown, false);
-    // Use document-level listener for keyboard (canvas doesn't receive focus)
-    document.addEventListener("keydown", this.onKeyDown, false);
-    this.raycastMode = true;
-  }
-
-  /**
-   * Retrieve all the valid intersected objects by a ray caster from the mouse.
-   */
-  getIntersectedObjs(): THREE.Intersection[] {
-    if (!this.camera || !this.group) return [];
-    this.raycaster.setFromCamera(this.mouse, this.camera.getCamera());
-    this.raycaster.params.Points!.threshold =
-      this.threshold / this.camera.getZoom();
-    this.raycaster.params.Line2 = { threshold: 4 };
-    const objects = this.raycaster.intersectObjects([this.group], true);
-    const validObjs: THREE.Intersection[] = [];
-    for (const obj of objects) {
-      const object = obj.object;
-      // Accept Mesh (faces), Points (vertices), and Line (edges)
-      const isValidType = isMesh(object) || isPoints(object) || isLine(object);
-      if (isValidType && object.visible && !Array.isArray(object.material) && object.material.visible) {
-        validObjs.push(obj);
-      }
-    }
-    return validObjs;
-  }
-
-  /**
-   * Retrieve all the valid intersected objects by a ray caster from the mouse.
-   * The objects are sorted by their distance from the ray. (The closest first)
-   */
-  getValidIntersectedObjs(): THREE.Intersection[] {
-    const validObjs: THREE.Intersection[] = [];
-    if (this.mouseMoved) {
-      const objects = this.getIntersectedObjs();
-
-      for (const object of objects) {
-        const obj = object.object;
-        // Accept Mesh (faces), Points (vertices), and Line (edges)
-        const isValidType = isMesh(obj) || isPoints(obj) || isLine(obj);
-        if (!isValidType) continue;
-        if (!obj.visible || Array.isArray(obj.material) || !obj.material.visible) continue;
-
-        const objectGroup = object.object.parent;
-        if (!isObjectGroup(objectGroup)) continue;
-
-        if (!objectGroup.shapeInfo) continue; // clipping plane
-
-        const topo = objectGroup.shapeInfo.topo;
-
-        // Check if topology is acceptable given the topology filters
-        const isSolid = objectGroup.subtype === "solid";
-        const isSubShapeOfSolid =
-          this.filters.topoFilter.includes(TopoFilter.solid) && isSolid;
-
-        // topo is a string from shapeInfo, check if it matches any filter
-        const topoMatchesFilter = this.filters.topoFilter.some(
-          (filter) => filter === topo
-        );
-        const valid =
-          isSubShapeOfSolid ||
-          this.filters.topoFilter.includes(TopoFilter.none) ||
-          topoMatchesFilter;
-
-        if (valid) {
-          validObjs.push(object);
-        }
-      }
-    }
-    return validObjs;
-  }
-
-  /**
-   * Handle left mouse button down event
-   */
-  onMouseKeyDown = (e: MouseEvent): void => {
-    if (this.raycastMode && this.camera) {
-      if (e.button == THREE.MOUSE.LEFT || e.button == THREE.MOUSE.RIGHT) {
-        this.lastPosition = this.camera.getPosition().clone();
-      }
-    }
-  };
-
-  /**
-   * Handle left mouse button up event
-   */
-  onMouseKeyUp = (e: MouseEvent): void => {
-    if (this.raycastMode && this.camera && this.lastPosition) {
-      if (e.button == THREE.MOUSE.LEFT) {
-        if (this.lastPosition.distanceTo(this.camera.getPosition()) < 1e-6) {
-          this.callback({ mouse: "left", shift: KeyMapper.get(e, "shift") });
-        }
-      } else if (e.button == THREE.MOUSE.RIGHT) {
-        if (this.lastPosition.distanceTo(this.camera.getPosition()) < 1e-6) {
-          this.callback({ mouse: "right" });
-        }
-      }
-    }
-  };
-
-  /**
-   * Handle key down event
-   */
-  onKeyDown = (e: KeyboardEvent): void => {
-    if (this.raycastMode) {
-      if (e.key == "Backspace") {
-        this.callback({ key: "Backspace" });
-      } else if (e.key == "Escape") {
-        this.callback({ key: "Escape" });
-      }
-    }
-  };
-
-  /**
-   * Get the current mouse position
-   */
-  onPointerMove = (e: MouseEvent): void => {
-    if (!this.domElement) return;
-    const rect = this.domElement.getBoundingClientRect();
-    const offsetX = rect.x + window.scrollX;
-    const offsetY = rect.y + window.scrollY;
-    this.mouse.x = ((e.pageX - offsetX) / this.width) * 2 - 1;
-    this.mouse.y = -((e.pageY - offsetY) / this.height) * 2 + 1;
-    this.mouseMoved = true;
-  };
-}
-
-export { Raycaster };