@guinetik/gcanvas 1.0.4 → 2.0.0

package/dist/js/schwarzschild.js

@@ -0,0 +1,1015 @@
+/**
+ * Schwarzschild Metric - General Relativity Demo
+ *
+ * Visualization of the Schwarzschild solution to Einstein's field equations.
+ * Shows the metric tensor components and geodesic motion with orbital precession.
+ *
+ * Metric: ds² = -(1-rs/r)c²dt² + (1-rs/r)⁻¹dr² + r²dΩ²
+ * where rs = 2GM/c² is the Schwarzschild radius
+ */
+
+import { Game, Painter, Camera3D } from "/gcanvas.es.min.js";
+import { GameObject } from "/gcanvas.es.min.js";
+import { Rectangle } from "/gcanvas.es.min.js";
+import { TextShape } from "/gcanvas.es.min.js";
+import { Position } from "/gcanvas.es.min.js";
+import { Tensor } from "/gcanvas.es.min.js";
+import { flammEmbeddingHeight } from "/gcanvas.es.min.js";
+import {
+  keplerianOmega,
+  schwarzschildPrecessionRate,
+  orbitalRadiusSimple,
+  updateTrail,
+  createTrailPoint,
+} from "/gcanvas.es.min.js";
+import { verticalLayout, applyLayout } from "/gcanvas.es.min.js";
+import { Tooltip } from "/gcanvas.es.min.js";
+import { Button } from "/gcanvas.es.min.js";
+
+// Configuration
+const CONFIG = {
+  // Grid parameters - match spacetime.js for clean visuals
+  gridSize: 20,
+  gridResolution: 40,
+  baseGridScale: 15,
+
+  // Mobile breakpoint
+  mobileWidth: 600,
+
+  // Physics (geometrized units: G = c = 1)
+  schwarzschildRadius: 2.0, // rs = 2M in geometrized units
+  massRange: [1.0, 4.0], // Mass range for shuffling
+
+  // Embedding diagram - visible funnel depth
+  embeddingScale: 180, // Deeper funnel like Kerr
+
+  // 3D view
+  rotationX: 0.5,
+  rotationY: 0.3,
+  perspective: 900, // Match Kerr for similar depth perception
+
+  // Orbit parameters
+  orbitSemiMajor: 10, // Semi-major axis (in units of M)
+  orbitEccentricity: 0.3, // Orbital eccentricity
+  angularMomentum: 4.0, // Specific angular momentum L/m
+
+  // Animation
+  autoRotateSpeed: 0.1,
+  orbitSpeed: 0.5, // Base orbital angular velocity
+  precessionFactor: 0.15, // GR precession rate
+
+  // Black hole visualization - mass-proportional sizing (rubber sheet analogy)
+  // "Heavier objects dent the fabric more" - intuitive for users
+  blackHoleSizeBase: 8, // Base size of black hole sphere
+  blackHoleSizeMassScale: 6, // Additional size per unit mass
+
+  // Visual
+  gridColor: "rgba(0, 180, 255, 0.3)",
+  gridHighlight: "rgba(100, 220, 255, 0.5)",
+  horizonColor: "rgba(255, 50, 50, 0.8)",
+  photonSphereColor: "rgba(255, 200, 50, 0.6)",
+  iscoColor: "rgba(50, 255, 150, 0.6)",
+  orbiterColor: "#4af",
+  orbiterGlow: "rgba(100, 180, 255, 0.6)",
+};
+
+/**
+ * MetricPanelGO - Displays the Schwarzschild metric tensor components
+ * Uses verticalLayout for automatic positioning
+ * Responsive for mobile screens
+ */
+class MetricPanelGO extends GameObject {
+  constructor(game, options = {}) {
+    // Responsive sizing
+    const isMobile = game.width < CONFIG.mobileWidth;
+    const panelWidth = isMobile ? 240 : 320;
+    const panelHeight = isMobile ? 130 : 150;
+    const lineHeight = isMobile ? 14 : 16;
+    const valueOffset = isMobile ? 125 : 160;
+
+    super(game, {
+      ...options,
+      width: panelWidth,
+      height: panelHeight,
+      anchor: Position.BOTTOM_LEFT,
+    });
+
+    // Background
+    this.bgRect = new Rectangle({
+      width: panelWidth,
+      height: panelHeight,
+      color: "rgba(0, 0, 0, 0.7)",
+    });
+
+    // Define all features as data with descriptions for tooltips
+    this.features = {
+      title: {
+        text: "Schwarzschild Metric Tensor",
+        font: "bold 13px monospace",
+        color: "#7af",
+        height: lineHeight + 4,
+        desc: "The Schwarzschild metric describes spacetime geometry around a non-rotating, spherically symmetric mass. It was the first exact solution to Einstein's field equations (1916).",
+      },
+      equation: {
+        text: "ds² = gμν dxμ dxν",
+        font: "12px monospace",
+        color: "#888",
+        height: lineHeight,
+        desc: "The line element ds² measures spacetime intervals. It uses the metric tensor gμν to convert coordinate differences into proper distances/times.",
+      },
+      mass: {
+        text: "M = 1.00",
+        font: "12px monospace",
+        color: "#888",
+        height: lineHeight + 8,
+        desc: "Mass of the black hole (in geometrized units where G = c = 1).\nClick anywhere to randomize between 1.0 and 4.0.",
+      },
+      gtt: {
+        text: "g_tt = -(1 - rs/r)",
+        font: "11px monospace",
+        color: "#f88",
+        height: lineHeight,
+        value: "= -0.800",
+        desc: "Time-time component: Controls how time flows.\nNegative sign indicates timelike direction.\nApproaches 0 at the event horizon (time freezes for distant observers).",
+      },
+      grr: {
+        text: "g_rr = (1 - rs/r)⁻¹",
+        font: "11px monospace",
+        color: "#8f8",
+        height: lineHeight,
+        value: "= 1.250",
+        desc: "Radial-radial component: Controls radial distances.\nDiverges at rs (coordinate singularity).\nRadial distances stretch near the black hole.",
+      },
+      gthth: {
+        text: "g_θθ = r²",
+        font: "11px monospace",
+        color: "#88f",
+        height: lineHeight,
+        value: "= 100.00",
+        desc: "Theta-theta component: Angular metric in the polar direction.\nSame as flat space - angles are unaffected by the mass.",
+      },
+      gphph: {
+        text: "g_φφ = r²sin²θ",
+        font: "11px monospace",
+        color: "#f8f",
+        height: lineHeight + 8,
+        value: "= 100.00",
+        desc: "Phi-phi component: Angular metric in azimuthal direction.\nAt equator (θ=π/2), sin²θ = 1.\nSpherical symmetry preserved.",
+      },
+      rs: {
+        text: "rs = 2M = 2.00",
+        font: "10px monospace",
+        color: "#f55",
+        height: lineHeight - 2,
+        desc: "Schwarzschild Radius (Event Horizon)\nThe point of no return - even light cannot escape from within.\nFor the Sun: rs ≈ 3 km. For Earth: rs ≈ 9 mm.",
+      },
+      rph: {
+        text: "r_photon = 1.5rs = 3.00",
+        font: "10px monospace",
+        color: "#fa5",
+        height: lineHeight - 2,
+        desc: "Photon Sphere\nUnstable circular orbit for light.\nPhotons can orbit here, but any perturbation sends them spiraling in or out.",
+      },
+      risco: {
+        text: "r_ISCO = 3rs = 6.00",
+        font: "10px monospace",
+        color: "#5f8",
+        height: lineHeight + 8,
+        desc: "Innermost Stable Circular Orbit (ISCO)\nThe closest stable orbit for massive particles.\nWithin this radius, orbits require constant thrust to maintain.",
+      },
+      pos: {
+        text: "Orbiter: r = 10.00, φ = 0.00",
+        font: "10px monospace",
+        color: "#aaa",
+        height: lineHeight,
+        desc: "Current position of the test particle in Schwarzschild coordinates.\nr = radial distance, φ = orbital angle.",
+      },
+    };
+
+    // Store panel dimensions for hit testing
+    this.panelWidth = panelWidth;
+    this.panelHeight = panelHeight;
+
+    // Create TextShapes from features
+    const rowItems = [];
+    for (const [key, config] of Object.entries(this.features)) {
+      config.shape = new TextShape(config.text, {
+        font: config.font,
+        color: config.color,
+        align: "left",
+        baseline: "top",
+        height: config.height,
+      });
+      rowItems.push(config.shape);
+
+      if (config.value) {
+        config.valueShape = new TextShape(config.value, {
+          font: config.font,
+          color: "#fff",
+          align: "left",
+          baseline: "top",
+        });
+      }
+    }
+
+    // Apply vertical layout
+    const layout = verticalLayout(rowItems, {
+      spacing: 5,
+      padding: 0,
+      align: "start",
+      centerItems: false,
+    });
+    applyLayout(rowItems, layout.positions, {
+      offsetX: -panelWidth / 2,
+      offsetY: -panelHeight / 2,
+    });
+
+    // Position value shapes next to their labels
+    for (const config of Object.values(this.features)) {
+      if (config.valueShape) {
+        config.valueShape.x = config.shape.x + valueOffset;
+        config.valueShape.y = config.shape.y;
+      }
+    }
+  }
+
+  setMetricValues(r, rs, mass, theta = Math.PI / 2) {
+    const metric = Tensor.schwarzschild(r, rs, theta);
+    const f = this.features;
+
+    f.gtt.valueShape.text = `= ${metric.get(0, 0).toFixed(4)}`;
+    f.grr.valueShape.text = `= ${metric.get(1, 1).toFixed(4)}`;
+    f.gthth.valueShape.text = `= ${metric.get(2, 2).toFixed(2)}`;
+    f.gphph.valueShape.text = `= ${metric.get(3, 3).toFixed(2)}`;
+
+    f.mass.shape.text = `M = ${mass.toFixed(2)}`;
+    f.rs.shape.text = `rs = 2M = ${rs.toFixed(2)}`;
+    f.rph.shape.text = `r_photon = 1.5rs = ${Tensor.photonSphereRadius(rs).toFixed(2)}`;
+    f.risco.shape.text = `r_ISCO = 3rs = ${Tensor.iscoRadius(rs).toFixed(2)}`;
+  }
+
+  setOrbiterPosition(r, phi) {
+    this.features.pos.shape.text = `Orbiter: r = ${r.toFixed(2)}, φ = ${(phi % (2 * Math.PI)).toFixed(2)}`;
+  }
+
+  /**
+   * Get the feature at a given screen position (for tooltip hit testing).
+   * @param {number} screenX - Screen X coordinate
+   * @param {number} screenY - Screen Y coordinate
+   * @returns {object|null} Feature config with desc, or null if not over panel
+   */
+  getFeatureAt(screenX, screenY) {
+    // Convert screen coords to local panel coords
+    const localX = screenX - this.x;
+    const localY = screenY - this.y;
+
+    // Check if within panel bounds
+    if (
+      localX < -this.panelWidth / 2 ||
+      localX > this.panelWidth / 2 ||
+      localY < -this.panelHeight / 2 ||
+      localY > this.panelHeight / 2
+    ) {
+      return null;
+    }
+
+    // Find which feature row we're over
+    for (const config of Object.values(this.features)) {
+      const shape = config.shape;
+      const rowTop = shape.y;
+      const rowBottom = shape.y + (config.height || 16);
+
+      if (localY >= rowTop && localY <= rowBottom) {
+        return config;
+      }
+    }
+
+    return null;
+  }
+
+  draw() {
+    super.draw();
+    this.bgRect.render();
+
+    for (const config of Object.values(this.features)) {
+      config.shape.render();
+      if (config.valueShape) config.valueShape.render();
+    }
+  }
+}
+
+class SchwarzschildDemo extends Game {
+  constructor(canvas) {
+    super(canvas);
+    // Black background - it's space!
+    this.backgroundColor = "#000";
+    this.enableFluidSize();
+  }
+
+  init() {
+    super.init();
+    this.time = 0;
+
+    // Mass (in geometrized units where G = c = 1)
+    this.mass = 1.0;
+    this.rs = 2 * this.mass; // Schwarzschild radius
+
+    // Initialize grid scale (will be updated for screen size)
+    this.gridScale = CONFIG.baseGridScale;
+
+    // Camera with inertia for smooth drag
+    this.camera = new Camera3D({
+      rotationX: CONFIG.rotationX,
+      rotationY: CONFIG.rotationY,
+      perspective: CONFIG.perspective,
+      minRotationX: -0.5,
+      maxRotationX: 1.5,
+      autoRotate: true,
+      autoRotateSpeed: CONFIG.autoRotateSpeed,
+      autoRotateAxis: "y",
+      inertia: true,
+      friction: 0.95,
+      velocityScale: 2.0,
+    });
+    this.camera.enableMouseControl(this.canvas);
+
+    // Orbital state (using r, phi in equatorial plane)
+    this.orbitR = CONFIG.orbitSemiMajor;
+    this.orbitPhi = 0;
+    this.orbitVr = 0; // Radial velocity
+    this.orbitL = CONFIG.angularMomentum; // Angular momentum per unit mass
+    this.precessionAngle = 0;
+
+    // Trail stores actual positions
+    this.orbitTrail = [];
+
+    // Initialize grid vertices
+    this.initGrid();
+
+    // Fixed grid scale (like spacetime.js)
+    this.gridScale = CONFIG.baseGridScale;
+
+    // Create metric panel
+    this.metricPanel = new MetricPanelGO(this, { name: "metricPanel" });
+    this.pipeline.add(this.metricPanel);
+
+    // Create tooltip for explanations (responsive)
+    const isMobileTooltip = this.width < CONFIG.mobileWidth;
+    this.tooltip = new Tooltip(this, {
+      maxWidth: isMobileTooltip ? 200 : 280,
+      font: `${isMobileTooltip ? 9 : 11}px monospace`,
+      padding: isMobileTooltip ? 6 : 10,
+      bgColor: "rgba(20, 20, 30, 0.95)",
+    });
+    this.pipeline.add(this.tooltip);
+
+    // Track what's being hovered for tooltip
+    this.hoveredFeature = null;
+
+    // Mouse move for tooltip
+    this.canvas.addEventListener("mousemove", (e) => this.handleMouseMove(e));
+    this.canvas.addEventListener("mouseleave", () => this.tooltip.hide());
+
+    // Button to shuffle parameters (positioned below the chart, same width)
+    const isMobile = this.width < CONFIG.mobileWidth;
+    const graphW = isMobile ? 120 : 160;
+    const graphH = isMobile ? 70 : 100;
+    const graphX = this.width - graphW - (isMobile ? 15 : 20);
+    const graphY = isMobile ? 80 : 220; // Desktop moved down to avoid info div
+
+    this.shuffleBtn = new Button(this, {
+      width: graphW,
+      height: isMobile ? 30 : 36,
+      anchor: Position.TOP_LEFT,
+      anchorRelative: this.metricPanel,
+      anchorOffsetX: -10,
+      anchorOffsetY: -60,
+      text: "Shuffle Mass",
+      font: `${isMobile ? 10 : 12}px monospace`,
+      colorDefaultBg: "rgba(20, 20, 40, 0.8)",
+      colorDefaultStroke: "#7af",
+      colorDefaultText: "#8af",
+      colorHoverBg: "rgba(40, 30, 60, 0.9)",
+      colorHoverStroke: "#aff",
+      colorHoverText: "#aff",
+      colorPressedBg: "rgba(60, 40, 80, 1)",
+      colorPressedStroke: "#fff",
+      colorPressedText: "#fff",
+      onClick: () => this.shuffleParameters(),
+    });
+    this.pipeline.add(this.shuffleBtn);
+  }
+
+  handleMouseMove(e) {
+    const rect = this.canvas.getBoundingClientRect();
+    const mouseX = e.clientX - rect.left;
+    const mouseY = e.clientY - rect.top;
+
+    // Check if over metric panel
+    const feature = this.metricPanel.getFeatureAt(mouseX, mouseY);
+    if (feature && feature.desc) {
+      if (this.hoveredFeature !== feature) {
+        this.hoveredFeature = feature;
+        this.tooltip.show(feature.desc, mouseX, mouseY);
+      }
+      return;
+    }
+
+    // Check if over effective potential graph (responsive)
+    const isMobile = this.width < CONFIG.mobileWidth;
+    const graphW = isMobile ? 120 : 160;
+    const graphH = isMobile ? 70 : 100;
+    const graphX = this.width - graphW - (isMobile ? 15 : 20);
+    const graphY = isMobile ? 80 : 220; // Desktop moved down to avoid info div
+
+    if (
+      mouseX >= graphX - 10 &&
+      mouseX <= graphX + graphW + 10 &&
+      mouseY >= graphY - 10 &&
+      mouseY <= graphY + graphH + 30
+    ) {
+      if (this.hoveredFeature !== "graph") {
+        this.hoveredFeature = "graph";
+        this.tooltip.show(
+          "Effective Potential V_eff(r)\n\nShows the combined gravitational and centrifugal potential.\n\nThe blue dot marks the orbiter's current position.\n\nLocal minima = stable orbits\nLocal maxima = unstable orbits\n\nThe GR term (-ML²/r³) creates the inner peak that doesn't exist in Newtonian gravity.",
+          mouseX,
+          mouseY,
+        );
+      }
+      return;
+    }
+
+    // Not over anything - hide tooltip
+    if (this.hoveredFeature) {
+      this.hoveredFeature = null;
+      this.tooltip.hide();
+    }
+  }
+
+  initGrid() {
+    const { gridSize, gridResolution } = CONFIG;
+    this.gridVertices = [];
+
+    for (let i = 0; i <= gridResolution; i++) {
+      const row = [];
+      for (let j = 0; j <= gridResolution; j++) {
+        const x = (i / gridResolution - 0.5) * 2 * gridSize;
+        const z = (j / gridResolution - 0.5) * 2 * gridSize;
+        row.push({ x, y: 0, z });
+      }
+      this.gridVertices.push(row);
+    }
+  }
+
+  shuffleParameters() {
+    // Randomize mass
+    this.mass =
+      CONFIG.massRange[0] +
+      Math.random() * (CONFIG.massRange[1] - CONFIG.massRange[0]);
+    this.rs = 2 * this.mass;
+
+    // Randomize orbit (keep it outside ISCO using Tensor utility)
+    const isco = Tensor.iscoRadius(this.rs);
+    this.orbitR = isco + 2 + Math.random() * 8;
+    this.orbitPhi = Math.random() * Math.PI * 2;
+    this.orbitL = 3.5 + Math.random() * 2;
+    this.precessionAngle = 0;
+
+    // Clear trail for fresh start
+    this.orbitTrail = [];
+  }
+
+  /**
+   * Flamm's paraboloid embedding using shared gr.js module.
+   * Inverted so it looks like a gravity well going DOWN.
+   */
+  getEmbeddingHeight(r) {
+    const height = flammEmbeddingHeight(
+      r,
+      this.rs,
+      this.mass,
+      CONFIG.gridSize,
+      CONFIG.embeddingScale,
+    );
+    // Clamp to non-negative to prevent grid lines appearing above the flat plane
+    return Math.max(0, height);
+  }
+
+  /**
+   * Effective potential for geodesic motion
+   * V_eff = -M/r + L²/(2r²) - ML²/r³
+   * Uses Tensor.effectivePotential static utility
+   */
+  effectivePotential(r) {
+    return Tensor.effectivePotential(this.mass, this.orbitL, r);
+  }
+
+  /**
+   * Update geodesic motion using orbital.js utilities.
+   * Simplified for visualization while maintaining GR character.
+   */
+  updateGeodesic(dt) {
+    const r = this.orbitR;
+
+    // Kepler's 3rd law angular velocity
+    const baseOmega = keplerianOmega(r, this.mass, CONFIG.orbitSpeed);
+
+    // Update orbital angle
+    this.orbitPhi += baseOmega * dt;
+
+    // Radial oscillation for eccentricity effect
+    this.orbitR = orbitalRadiusSimple(
+      CONFIG.orbitSemiMajor,
+      CONFIG.orbitEccentricity,
+      this.orbitPhi,
+    );
+
+    // Keep orbit bounded outside ISCO
+    const minR = Tensor.iscoRadius(this.rs) + 1;
+    if (this.orbitR < minR) this.orbitR = minR;
+
+    // GR precession: orbit doesn't close, rotates over time
+    const precessionRate = schwarzschildPrecessionRate(
+      r,
+      this.rs,
+      CONFIG.precessionFactor,
+    );
+    this.precessionAngle += precessionRate * dt;
+
+    // Store current position in trail
+    const totalAngle = this.orbitPhi + this.precessionAngle;
+    updateTrail(this.orbitTrail, createTrailPoint(this.orbitR, totalAngle), 80);
+  }
+
+  update(dt) {
+    super.update(dt);
+    this.time += dt;
+
+    this.camera.update(dt);
+    this.updateGeodesic(dt);
+
+    // Update grid with Flamm's paraboloid embedding
+    const { gridResolution } = CONFIG;
+    for (let i = 0; i <= gridResolution; i++) {
+      for (let j = 0; j <= gridResolution; j++) {
+        const vertex = this.gridVertices[i][j];
+        // Function already clamps at horizon, no need for extra clamp here
+        const r = Math.sqrt(vertex.x * vertex.x + vertex.z * vertex.z);
+        vertex.y = this.getEmbeddingHeight(r);
+      }
+    }
+
+    // Update metric panel
+    if (this.metricPanel) {
+      this.metricPanel.setMetricValues(this.orbitR, this.rs, this.mass);
+      this.metricPanel.setOrbiterPosition(this.orbitR, this.orbitPhi);
+    }
+  }
+
+  render() {
+    const w = this.width;
+    const h = this.height;
+    const cx = w / 2;
+    const cy = h / 2; // Centered to see full well depth
+
+    super.render();
+
+    // Draw grid
+    this.drawGrid(cx, cy);
+
+    // Draw event horizon
+    this.drawHorizon(cx, cy);
+
+    // Draw orbiter
+    this.drawOrbiter(cx, cy);
+
+    // Draw effective potential graph
+    this.drawEffectivePotential();
+
+    // Draw controls
+    this.drawControls(w, h);
+  }
+
+  drawKeyRadii(cx, cy) {
+    const radii = [
+      { r: this.rs, color: CONFIG.horizonColor, label: "rs" },
+      { r: this.rs * 1.5, color: CONFIG.photonSphereColor, label: "r_ph" },
+      { r: this.rs * 3, color: CONFIG.iscoColor, label: "ISCO" },
+    ];
+
+    for (const { r, color, label } of radii) {
+      const segments = 48;
+      Painter.useCtx((ctx) => {
+        ctx.strokeStyle = color;
+        ctx.lineWidth = 1.5;
+        ctx.setLineDash([5, 5]);
+        ctx.beginPath();
+
+        for (let i = 0; i <= segments; i++) {
+          const angle = (i / segments) * Math.PI * 2;
+          const x = Math.cos(angle) * r;
+          const z = Math.sin(angle) * r;
+          const y = this.getEmbeddingHeight(r);
+
+          const p = this.camera.project(
+            x * this.gridScale,
+            y,
+            z * this.gridScale,
+          );
+
+          if (i === 0) {
+            ctx.moveTo(cx + p.x, cy + p.y);
+          } else {
+            ctx.lineTo(cx + p.x, cy + p.y);
+          }
+        }
+        ctx.stroke();
+        ctx.setLineDash([]);
+      });
+    }
+  }
+
+  drawGrid(cx, cy) {
+    const { gridResolution, gridColor, gridHighlight } = CONFIG;
+    const gridScale = this.gridScale;
+
+    const projected = this.gridVertices.map((row) =>
+      row.map((v) => {
+        const p = this.camera.project(v.x * gridScale, v.y, v.z * gridScale);
+        return { x: cx + p.x, y: cy + p.y, z: p.z };
+      }),
+    );
+
+    // Draw grid lines
+    for (let i = 0; i <= gridResolution; i++) {
+      const isMain = i % 5 === 0;
+      Painter.useCtx((ctx) => {
+        ctx.strokeStyle = isMain ? gridHighlight : gridColor;
+        ctx.lineWidth = isMain ? 1.2 : 0.6;
+        ctx.beginPath();
+        for (let j = 0; j <= gridResolution; j++) {
+          const p = projected[i][j];
+          if (j === 0) ctx.moveTo(p.x, p.y);
+          else ctx.lineTo(p.x, p.y);
+        }
+        ctx.stroke();
+      });
+    }
+
+    for (let j = 0; j <= gridResolution; j++) {
+      const isMain = j % 5 === 0;
+      Painter.useCtx((ctx) => {
+        ctx.strokeStyle = isMain ? gridHighlight : gridColor;
+        ctx.lineWidth = isMain ? 1.2 : 0.6;
+        ctx.beginPath();
+        for (let i = 0; i <= gridResolution; i++) {
+          const p = projected[i][j];
+          if (i === 0) ctx.moveTo(p.x, p.y);
+          else ctx.lineTo(p.x, p.y);
+        }
+        ctx.stroke();
+      });
+    }
+  }
+
+  drawHorizon(cx, cy) {
+    // Draw filled event horizon - the BLACK hole
+    const segments = 32;
+    const r = this.rs;
+    const y = this.getEmbeddingHeight(r + 0.1);
+
+    // Project center for black hole body
+    const centerP = this.camera.project(0, y + 10, 0);
+    const centerX = cx + centerP.x;
+    const centerY = cy + centerP.y;
+
+    // Mass-proportional sizing: heavier = bigger (rubber sheet intuition)
+    const baseSize =
+      CONFIG.blackHoleSizeBase + this.mass * CONFIG.blackHoleSizeMassScale;
+    const size = baseSize * centerP.scale;
+
+    // Draw dark glow around black hole
+    Painter.useCtx((ctx) => {
+      const gradient = ctx.createRadialGradient(
+        centerX,
+        centerY,
+        size,
+        centerX,
+        centerY,
+        size * 3,
+      );
+      gradient.addColorStop(0, "rgba(80, 40, 120, 0.6)");
+      gradient.addColorStop(1, "transparent");
+      ctx.fillStyle = gradient;
+      ctx.beginPath();
+      ctx.arc(centerX, centerY, size * 3, 0, Math.PI * 2);
+      ctx.fill();
+    });
+
+    // Draw the black hole (actually black!)
+    Painter.useCtx((ctx) => {
+      ctx.fillStyle = "#000";
+      ctx.beginPath();
+      ctx.arc(centerX, centerY, size, 0, Math.PI * 2);
+      ctx.fill();
+
+      // Event horizon ring (accretion disk hint)
+      ctx.strokeStyle = "rgba(150, 100, 200, 0.8)";
+      ctx.lineWidth = 2;
+      ctx.beginPath();
+      ctx.arc(centerX, centerY, size * 1.3, 0, Math.PI * 2);
+      ctx.stroke();
+    });
+
+    // Draw event horizon circle on the grid
+    Painter.useCtx((ctx) => {
+      ctx.strokeStyle = CONFIG.horizonColor;
+      ctx.lineWidth = 2;
+      ctx.beginPath();
+
+      for (let i = 0; i <= segments; i++) {
+        const angle = (i / segments) * Math.PI * 2;
+        const x = Math.cos(angle) * r;
+        const z = Math.sin(angle) * r;
+
+        const p = this.camera.project(
+          x * this.gridScale,
+          y,
+          z * this.gridScale,
+        );
+
+        if (i === 0) ctx.moveTo(cx + p.x, cy + p.y);
+        else ctx.lineTo(cx + p.x, cy + p.y);
+      }
+      ctx.closePath();
+      ctx.stroke();
+    });
+  }
+
+  drawOrbiter(cx, cy) {
+    // Apply precession to orbit
+    const totalAngle = this.orbitPhi + this.precessionAngle;
+
+    // Position in orbital plane
+    const orbiterX = Math.cos(totalAngle) * this.orbitR;
+    const orbiterZ = Math.sin(totalAngle) * this.orbitR;
+    const orbiterY = this.getEmbeddingHeight(this.orbitR);
+
+    const p = this.camera.project(
+      orbiterX * this.gridScale,
+      orbiterY,
+      orbiterZ * this.gridScale,
+    );
+
+    const screenX = cx + p.x;
+    const screenY = cy + p.y;
+    const size = 5 * p.scale;
+
+    // Glow
+    Painter.useCtx((ctx) => {
+      const gradient = ctx.createRadialGradient(
+        screenX,
+        screenY,
+        0,
+        screenX,
+        screenY,
+        size * 4,
+      );
+      gradient.addColorStop(0, CONFIG.orbiterGlow);
+      gradient.addColorStop(1, "transparent");
+      ctx.fillStyle = gradient;
+      ctx.beginPath();
+      ctx.arc(screenX, screenY, size * 4, 0, Math.PI * 2);
+      ctx.fill();
+    });
+
+    // Body
+    Painter.useCtx((ctx) => {
+      const gradient = ctx.createRadialGradient(
+        screenX - size * 0.3,
+        screenY - size * 0.3,
+        0,
+        screenX,
+        screenY,
+        size,
+      );
+      gradient.addColorStop(0, "#fff");
+      gradient.addColorStop(0.5, CONFIG.orbiterColor);
+      gradient.addColorStop(1, CONFIG.orbiterGlow);
+      ctx.fillStyle = gradient;
+      ctx.beginPath();
+      ctx.arc(screenX, screenY, size, 0, Math.PI * 2);
+      ctx.fill();
+    });
+
+    // Draw full orbital path
+    this.drawOrbitPath(cx, cy);
+
+    // Draw trailing tail
+    this.drawOrbitalTrail(cx, cy);
+  }
+
+  drawOrbitPath(cx, cy) {
+    const segments = 64;
+
+    Painter.useCtx((ctx) => {
+      ctx.strokeStyle = "rgba(100, 180, 255, 0.25)";
+      ctx.lineWidth = 1.5;
+      ctx.beginPath();
+
+      for (let i = 0; i <= segments; i++) {
+        // Full circle with precession applied
+        const angle = (i / segments) * Math.PI * 2 + this.precessionAngle;
+        const phi = (i / segments) * Math.PI * 2;
+
+        // Same radius formula as the orbiter
+        const r = orbitalRadiusSimple(
+          CONFIG.orbitSemiMajor,
+          CONFIG.orbitEccentricity,
+          phi,
+        );
+
+        const x = Math.cos(angle) * r;
+        const z = Math.sin(angle) * r;
+        const y = this.getEmbeddingHeight(r);
+
+        const p = this.camera.project(
+          x * this.gridScale,
+          y,
+          z * this.gridScale,
+        );
+
+        if (i === 0) {
+          ctx.moveTo(cx + p.x, cy + p.y);
+        } else {
+          ctx.lineTo(cx + p.x, cy + p.y);
+        }
+      }
+
+      ctx.closePath();
+      ctx.stroke();
+    });
+  }
+
+  drawOrbitalTrail(cx, cy) {
+    if (this.orbitTrail.length < 2) return;
+
+    Painter.useCtx((ctx) => {
+      ctx.lineCap = "round";
+
+      for (let i = 1; i < this.orbitTrail.length; i++) {
+        const t = i / this.orbitTrail.length;
+        const point = this.orbitTrail[i];
+        const prevPoint = this.orbitTrail[i - 1];
+
+        const trailY = this.getEmbeddingHeight(point.r);
+        const prevY = this.getEmbeddingHeight(prevPoint.r);
+
+        const p = this.camera.project(
+          point.x * this.gridScale,
+          trailY,
+          point.z * this.gridScale,
+        );
+
+        const prevP = this.camera.project(
+          prevPoint.x * this.gridScale,
+          prevY,
+          prevPoint.z * this.gridScale,
+        );
+
+        const alpha = (1 - t) * 0.5;
+        ctx.strokeStyle = `rgba(100, 180, 255, ${alpha})`;
+        ctx.lineWidth = (1 - t) * 2.5 * p.scale;
+        ctx.beginPath();
+        ctx.moveTo(cx + prevP.x, cy + prevP.y);
+        ctx.lineTo(cx + p.x, cy + p.y);
+        ctx.stroke();
+      }
+    });
+  }
+
+  drawEffectivePotential() {
+    // Responsive graph sizing
+    const isMobile = this.width < CONFIG.mobileWidth;
+    const graphW = isMobile ? 120 : 160;
+    const graphH = isMobile ? 70 : 100;
+    const graphX = this.width - graphW - (isMobile ? 15 : 20);
+    const graphY = isMobile ? 80 : 220; // Desktop moved down to avoid info div
+
+    Painter.useCtx((ctx) => {
+      // Background
+      ctx.fillStyle = "rgba(0, 0, 0, 0.5)";
+      ctx.fillRect(graphX - 10, graphY - 10, graphW + 20, graphH + 40);
+
+      // Title
+      ctx.fillStyle = "#888";
+      ctx.font = "10px monospace";
+      ctx.textAlign = "center";
+      ctx.fillText("Effective Potential V_eff(r)", graphX + graphW / 2, graphY);
+
+      // Axes
+      ctx.strokeStyle = "#444";
+      ctx.lineWidth = 1;
+      ctx.beginPath();
+      ctx.moveTo(graphX, graphY + graphH);
+      ctx.lineTo(graphX + graphW, graphY + graphH);
+      ctx.moveTo(graphX, graphY + 10);
+      ctx.lineTo(graphX, graphY + graphH);
+      ctx.stroke();
+
+      // Labels
+      ctx.fillStyle = "#666";
+      ctx.font = "8px monospace";
+      ctx.textAlign = "left";
+      ctx.fillText("r", graphX + graphW - 10, graphY + graphH + 12);
+      ctx.fillText("V", graphX - 8, graphY + 15);
+
+      // Plot V_eff
+      ctx.strokeStyle = "#8f8";
+      ctx.lineWidth = 1.5;
+      ctx.beginPath();
+
+      const rMin = this.rs * 1.2;
+      const rMax = 20;
+      let firstPoint = true;
+
+      for (let i = 0; i <= 100; i++) {
+        const r = rMin + (i / 100) * (rMax - rMin);
+        const V = this.effectivePotential(r);
+
+        const px = graphX + ((r - rMin) / (rMax - rMin)) * graphW;
+        const py = graphY + graphH - 20 - (V + 0.1) * 300;
+
+        if (py > graphY + 10 && py < graphY + graphH) {
+          if (firstPoint) {
+            ctx.moveTo(px, py);
+            firstPoint = false;
+          } else {
+            ctx.lineTo(px, py);
+          }
+        }
+      }
+      ctx.stroke();
+
+      // Current position marker
+      const currentPx =
+        graphX + ((this.orbitR - rMin) / (rMax - rMin)) * graphW;
+      const currentV = this.effectivePotential(this.orbitR);
+      const currentPy = graphY + graphH - 20 - (currentV + 0.1) * 300;
+
+      if (currentPy > graphY + 10 && currentPy < graphY + graphH) {
+        ctx.fillStyle = CONFIG.orbiterColor;
+        ctx.beginPath();
+        ctx.arc(currentPx, currentPy, 4, 0, Math.PI * 2);
+        ctx.fill();
+      }
+
+      // Mark ISCO
+      const iscoPx = graphX + ((3 * this.rs - rMin) / (rMax - rMin)) * graphW;
+      ctx.strokeStyle = CONFIG.iscoColor;
+      ctx.setLineDash([2, 2]);
+      ctx.beginPath();
+      ctx.moveTo(iscoPx, graphY + 10);
+      ctx.lineTo(iscoPx, graphY + graphH);
+      ctx.stroke();
+      ctx.setLineDash([]);
+    });
+  }
+
+  drawControls(w, h) {
+    const isMobile = w < CONFIG.mobileWidth;
+    const fontSize = isMobile ? 8 : 10;
+    const margin = isMobile ? 10 : 15;
+
+    Painter.useCtx((ctx) => {
+      ctx.fillStyle = "#445";
+      ctx.font = `${fontSize}px monospace`;
+      ctx.textAlign = "right";
+
+      if (isMobile) {
+        ctx.fillText("drag to rotate", w - margin, h - 25);
+        ctx.fillStyle = "#553";
+        ctx.fillText("Curvature exaggerated", w - margin, h - 10);
+      } else {
+        ctx.fillText("drag to rotate", w - margin, h - 45);
+        ctx.fillText(
+          "Flamm's paraboloid embedding  |  Geodesic precession",
+          w - margin,
+          h - 30,
+        );
+        ctx.fillStyle = "#553";
+        ctx.fillText(
+          "Curvature exaggerated for visibility (rubber sheet analogy)",
+          w - margin,
+          h - 15,
+        );
+      }
+    });
+  }
+}
+
+window.addEventListener("load", () => {
+  const canvas = document.getElementById("game");
+  const demo = new SchwarzschildDemo(canvas);
+  demo.start();
+});