Method update3D

ui/src/components/pixi/PixiRenderer.ts:2900–3045

* Called from the Pixi ticker every frame when 3D mode is active. * Projects all nodes and redraws edges.

()

   * Projects all nodes and redraws edges.
   */
  private update3D(): void {
    // Auto-rotation used to be gated on `layoutSettled` (Fix #54) to hide
    // ticker stutter while the main thread was busy in bursts during
    // indexing. After Plans D + E moved the store and embedder off the
    // main thread, that stutter source is gone, and the gate was instead
    // suppressing rotation on graphs where d3-force never reports settled
    // (large graphs, warm alphaTarget). Manual drag still updates
    // `mode3dAngle` directly in the pointer handler regardless.
    if (this.mode3dAutoRotate) {
      this.mode3dAngle += this.mode3dSpeed;
    }

    // Keep sphere bounds in sync with the layout.
    //   • While the worker simulation is running (`!layoutSettled`) we
    //     recompute every frame with allow-shrink so R tracks live
    //     positions through any transition — e.g. spread → compact,
    //     compact → spread. Without this, switching to a tighter
    //     layout leaves R stuck at the larger value and the projection
    //     collapses into a vertical cylinder (Fix #8).
    //   • Once settled, fall back to throttled only-grows so brief
    //     outward jitter doesn't trigger Z=0 hard-clamp flicker.
    this.mode3dFrameCounter++;
    if (!this.layoutSettled) {
      this.recomputeMode3DExtents(true);
    } else if (this.mode3dFrameCounter % 30 === 0) {
      this.recomputeMode3DExtents();
    }

    const invScale = this.zoomInvScale();
    const lblInv = this.labelInvScale();
    // Fold community-centroid accumulation into the projection loop so
    // the wayfinders re-aim every frame at zero extra cost (Fix #34).
    // Allocating a Map per frame is cheap (~20 entries); the per-node
    // dict lookup is a single property read.
    const trackCommunities =
      this.showCommunityLabels &&
      this.communityLabels.size > 0 &&
      this.communityAssignments !== null;
    const communitySums: Map<
      number,
      { x: number; y: number; n: number }
    > | null = trackCommunities ? new Map() : null;
    // Per-community representative Z (golden-angle bucket from
    // set3DMode), captured from the first member encountered. Reused
    // below to project each community's 2D centroid through the
    // current rotation.
    const communityZ: Map<number, number> | null = trackCommunities
      ? new Map()
      : null;
    const assignments = this.communityAssignments;
    for (const node of this.nodeArray) {
      if (!node.visible) continue;
      // Skip the dragged node — its sprite position is controlled by pointermove
      if (this.dragNode === node) continue;
      const z = this.getNodeZ(node);
      const p = this.project3d(node.x, node.y, z);
      node.sprite.position.set(p.px, p.py);