spacemap 0.1.4 → 0.1.5

package/index.d.ts

@@ -1587,6 +1587,9 @@ export declare interface PolylineOptions {
     widthPx?: number;
     /** 0 to 1. */
     opacity?: number;
+    /** A dash and a gap in screen pixels, written as the flat map takes them:
+     *  `"4 3"`. Solid when left out. */
+    dash?: string;
     /** Fade the line toward its last point, the way an orbit trail fades
      *  behind a body. */
     fade?: boolean;
@@ -2035,6 +2038,17 @@ export declare class SpaceMap {
      * is nothing to choose once a host has said what it looks like.
      */
     setBodyAppearance(id: string, appearance: BodyAppearance): this;
+    /**
+     * Keep these bodies in sight from however far: named, with their orbits,
+     * where the map would let a small or distant one drop out and would give
+     * its name up to a bigger neighbour's. A hidden layer does not take them
+     * either. An id the map has not loaded yet is pinned once it has. Each call
+     * replaces the last; an empty list gives the map its own judgement back.
+     *
+     * A moon is only drawn inside the system the camera is in, pinned or not:
+     * pin its planet to mark it from outside.
+     */
+    setPinnedBodies(ids: readonly string[]): this;
     /** A cap's radius as an angle, from whichever of the two ways the host gave
      *  it. A radius in kilometres needs the body's own radius, which an
      *  unloaded body has not published yet. */
@@ -2114,6 +2128,9 @@ export declare interface SurfacePolygonOptions extends SurfaceShapeOptions {
 export declare interface SurfacePolylineOptions extends SurfaceShapeOptions {
     /** Join the last place back to the first. */
     closed?: boolean;
+    /** A dash and a gap in screen pixels, written as the flat map takes them:
+     *  `"4 3"`. Solid when left out. */
+    dash?: string;
 }
 
 /** A shape on a body's surface, for as long as the host keeps it. */

package/index.js

@@ -6789,6 +6789,7 @@ var VisibilityController = class {
 	scaledSystem = SYSTEM_DISTANCE_RATIO_THRESHOLDS;
 	fullMoonIds = /* @__PURE__ */ new Set();
 	moonVisibilityCache = /* @__PURE__ */ new Map();
+	pinned = /* @__PURE__ */ new Set();
 	constructor(bodies, getProbeStore = () => null, getEarthSatGroupFilter = () => null, getSmallBodyFilter = () => null, getLayers = () => ALL_LAYERS) {
 		this.bodies = bodies;
 		this.getProbeStore = getProbeStore;
@@ -6885,8 +6886,19 @@ var VisibilityController = class {
 		this.moonVisibilityCache.set(moon.data.id, vis);
 		return vis;
 	}
+	setPinned(ids) {
+		this.pinned = new Set(ids);
+	}
+	isPinned(id) {
+		return this.pinned.has(id);
+	}
 	getPlanetVisibility(body, camDistThreeJS) {
-		if (this.getLayers().hidesBody(body.data.objectType, body.data.parentId)) return VISIBILITY.HIDE;
+		const pinned = this.pinned.has(body.data.id);
+		const vis = this.ratioVisibility(body, camDistThreeJS, pinned);
+		return pinned && vis !== VISIBILITY.CLOSE ? VISIBILITY.FULL : vis;
+	}
+	ratioVisibility(body, camDistThreeJS, pinned) {
+		if (!pinned && this.getLayers().hidesBody(body.data.objectType, body.data.parentId)) return VISIBILITY.HIDE;
 		if (body.data.orbitalSource === OrbitalSource.SPICE_PROBE) return this.getProbeVisibility(body);
 		const earthFilter = this.getEarthSatGroupFilter();
 		if (earthFilter && body.data.parentId === "naif-399" && !earthFilter.has(body.data.id)) return VISIBILITY.HIDE;
@@ -6939,7 +6951,7 @@ var VisibilityController = class {
 		return sysNaif !== null && this.isInFocusedSystem(`naif-${sysNaif}`);
 	}
 	hasFullRendering(body) {
-		if (!this.activeSystemId) return true;
+		if (!this.activeSystemId || this.pinned.has(body.data.id)) return true;
 		if (this.isInActiveSystem(isTopLevelParent(body.data.parentId) ? body.data.id : body.data.parentId)) return true;
 		if (body.data.orbitalSource !== OrbitalSource.SPICE_PROBE) return false;
 		const ps = this.getProbeStore();
@@ -12286,8 +12298,9 @@ function makeTrailMaterial(color, brightness = TRAIL_DIM) {
 		`
 	});
 }
-function makeFatTrailMaterial(color, lineWidth, brightness = TRAIL_DIM) {
+function makeFatTrailMaterial(color, lineWidth, brightness = TRAIL_DIM, dash) {
 	return new ShaderMaterial({
+		defines: dash ? { DASHED: "" } : {},
 		transparent: true,
 		depthWrite: false,
 		side: DoubleSide,
@@ -12298,7 +12311,8 @@ function makeFatTrailMaterial(color, lineWidth, brightness = TRAIL_DIM) {
 			uAlphaMin: { value: 0 },
 			uShowFull: { value: 0 },
 			uLineWidth: { value: lineWidth },
-			uResolution: { value: TRAIL_RESOLUTION }
+			uResolution: { value: TRAIL_RESOLUTION },
+			uDash: { value: new Vector2(dash?.[0] ?? 0, dash?.[1] ?? 0) }
 		},
 		vertexShader: `
 			#include <common>
@@ -12312,6 +12326,11 @@ function makeFatTrailMaterial(color, lineWidth, brightness = TRAIL_DIM) {
 			attribute float trailAlpha;
 			attribute float fullAlpha;
 			varying float vAlpha;
+			#ifdef DASHED
+			attribute float lineDistance;
+			varying float vDistW;
+			varying float vW;
+			#endif
 			void main() {
 				vAlpha = mix(trailAlpha, fullAlpha, uShowFull);
 				vec3 currRel = position + uCenterOffset;
@@ -12328,6 +12347,13 @@ function makeFatTrailMaterial(color, lineWidth, brightness = TRAIL_DIM) {
 				vec2 perp = vec2(-dirN.y, dirN.x) * side * uLineWidth * 0.5;
 				vec2 offsetNDC = perp / (uResolution * 0.5);
 				gl_Position = vec4((currNDC + offsetNDC) * currClip.w, currClip.zw);
+				#ifdef DASHED
+				// Carried times w and divided back out per fragment, which undoes
+				// the perspective a varying is interpolated with: the dashes are
+				// even on screen however much nearer one end is.
+				vDistW = lineDistance * currClip.w;
+				vW = currClip.w;
+				#endif
 				#include <logdepthbuf_vertex>
 			}
 		`,
@@ -12337,7 +12363,15 @@ function makeFatTrailMaterial(color, lineWidth, brightness = TRAIL_DIM) {
 			uniform float uAlphaMultiplier;
 			uniform float uAlphaMin;
 			varying float vAlpha;
+			#ifdef DASHED
+			uniform vec2 uDash;
+			varying float vDistW;
+			varying float vW;
+			#endif
 			void main() {
+				#ifdef DASHED
+				if (mod(vDistW / vW, uDash.x + uDash.y) > uDash.x) discard;
+				#endif
 				gl_FragColor = vec4(uColor, clamp(max(vAlpha * uAlphaMultiplier, uAlphaMin), 0.0, 1.0));
 				#include <logdepthbuf_fragment>
 			}
@@ -14142,7 +14176,7 @@ function cullOverlappingLabels(bodyObjects, screenWidth, screenHeight, camera, f
 		c.isCapped = body.data.objectType === ObjectType.MOON ? ctx.visibility.getMoonVisibility(body) === VISIBILITY.CAPPED : false;
 		c.isMinor = bo.isMinor;
 		c.isFocused = isFocused;
-		c.isSelected = isFocused || isHovered;
+		c.isSelected = isFocused || isHovered || ctx.visibility.isPinned(body.data.id);
 		c.dist = bo.cachedDist;
 	}
 	_candidates.length = _candidatesActive;
@@ -17768,10 +17802,18 @@ function buildThinLineFromArrays(posArr, trailAlphas, fullAlphas, total, color)
 	line.renderOrder = TRAIL_RENDER_ORDER;
 	return line;
 }
-function buildFatLineFromThin(capacity, posArr, trailAlphas, fullAlphas, total, color, lineWidth, brightness) {
+function writeLineDistances(geometry, src, n) {
+	const attr = geometry.getAttribute("lineDistance");
+	const arr = attr.array;
+	const m = Math.min(n, arr.length / 2);
+	for (let i = 0; i < m; i++) arr[2 * i] = arr[2 * i + 1] = src[i];
+	attr.needsUpdate = true;
+}
+function buildFatLineFromThin(capacity, posArr, trailAlphas, fullAlphas, total, color, lineWidth, brightness, dash) {
 	const geometry = makeFatTrailGeometry(capacity);
+	if (dash) geometry.setAttribute("lineDistance", new Float32BufferAttribute(new Float32Array(2 * capacity), 1));
 	writeFatTrailVertices(geometry, posArr, trailAlphas, fullAlphas, total);
-	const mesh = new Mesh(geometry, makeFatTrailMaterial(color, lineWidth, brightness));
+	const mesh = new Mesh(geometry, makeFatTrailMaterial(color, lineWidth, brightness, dash));
 	mesh.matrixAutoUpdate = false;
 	mesh.renderOrder = TRAIL_RENDER_ORDER;
 	return mesh;
@@ -20183,7 +20225,7 @@ function updateBodyVisibility(bodyObjects, camera, ctx, focusTruePos, focusedBod
 			isClose = !subPixel;
 			showLabel = !isClose;
 		}
-		if (bo.isMinor && !isFocused && trail) trail.visible = false;
+		if (bo.isMinor && !isFocused && trail && !ctx.visibility.isPinned(body.data.id)) trail.visible = false;
 		if (suppressHeliocentricTrails && trail?.visible) {
 			const oc = trail.userData.orbitCenter;
 			if (oc && oc.distanceToSquared(_focusV3.set(fp[0], fp[1], fp[2])) > HELIO_CENTER_DIST_SQ) trail.visible = false;
@@ -22732,6 +22774,8 @@ var PromotionRegistry = class {
 	defaults = /* @__PURE__ */ new Set();
 	userPromoted = /* @__PURE__ */ new Set();
 	autoPromoted = /* @__PURE__ */ new Set();
+	pinned = /* @__PURE__ */ new Set();
+	pinPromoted = /* @__PURE__ */ new Set();
 	groupTargets = null;
 	groupMode = "none";
 	smallBodyZone = null;
@@ -22741,6 +22785,7 @@ var PromotionRegistry = class {
 		this.deps = deps;
 		deps.ctx.bodies.onBodiesAdded(() => {
 			this.onBodiesAdded();
+			this.buildPinned();
 			this.autoPromoteAsteroidMoons();
 			this.reevaluateEarthSatMode();
 			if (this.smallBodyZone !== null) this.refreshSmallBodyEmphasis();
@@ -22930,6 +22975,31 @@ var PromotionRegistry = class {
 		if (toRemove.length === 0) return;
 		this.tearDownBodies(toRemove, this.autoPromoted);
 	}
+	setPinned(ids) {
+		this.pinned = new Set(ids);
+		const focusedId = this.deps.getFocusedId();
+		const dropped = [...this.pinPromoted].filter((id) => !this.pinned.has(id));
+		if (focusedId && dropped.includes(focusedId)) {
+			this.pinPromoted.delete(focusedId);
+			this.userPromoted.add(focusedId);
+			this.emitUserPromotedCount();
+		}
+		this.tearDownBodies(dropped.filter((id) => id !== focusedId), this.pinPromoted);
+		this.buildPinned();
+	}
+	buildPinned() {
+		let built = false;
+		for (const id of this.pinned) {
+			const body = this.deps.ctx.getBody(id);
+			if (!body || isSurfaceFeature(body) || body.data.objectType === ObjectType.MOON) continue;
+			if (!this.buildBodyInstance(body)) continue;
+			built = true;
+			if (this.userPromoted.delete(id)) this.pinPromoted.add(id);
+		}
+		if (!built) return;
+		this.emitUserPromotedCount();
+		this.finalizeBuilds();
+	}
 	clearUserPromoted() {
 		const focusedId = this.deps.getFocusedId();
 		const toRemove = [...this.userPromoted].filter((id) => id !== focusedId);
@@ -24866,6 +24936,10 @@ var SceneRenderer = class SceneRenderer {
 	setBodyAppearance(id, appearance) {
 		this.appearances.set(id, appearance);
 	}
+	setPinnedBodies(ids) {
+		this.ctx.visibility.setPinned(ids);
+		this.focusController.promotion.setPinned(ids);
+	}
 	setNorthReference(id) {
 		this.cameraUp.setNorthReference(id);
 	}
@@ -25484,6 +25558,153 @@ var MarkerExtension = class {
 	}
 };
 
+//#endregion
+//#region src/lib/scene/extensions/screen.ts
+var REACH = 3;
+var right = new Vector3();
+var up = new Vector3();
+var forward = new Vector3();
+function parseDash(pattern) {
+	const [dash, gap = dash] = (pattern ?? "").split(/[\s,]+/).filter(Boolean).map(Number);
+	return dash > 0 && gap > 0 ? [dash, gap] : null;
+}
+function aim(camera, viewportPx) {
+	right.set(1, 0, 0).applyQuaternion(camera.quaternion);
+	up.set(0, 1, 0).applyQuaternion(camera.quaternion);
+	forward.set(0, 0, -1).applyQuaternion(camera.quaternion);
+	return viewportPx / (2 * Math.tan(camera.getEffectiveFOV() * Math.PI / 360));
+}
+function view(points, i, camera, out) {
+	const x = points[i * 3] - camera.position.x;
+	const y = points[i * 3 + 1] - camera.position.y;
+	const z = points[i * 3 + 2] - camera.position.z;
+	out[0] = x * right.x + y * right.y + z * right.z;
+	out[1] = x * up.x + y * up.y + z * up.z;
+	out[2] = x * forward.x + y * forward.y + z * forward.z;
+}
+function reachesBehind(points, count, camera) {
+	forward.set(0, 0, -1).applyQuaternion(camera.quaternion);
+	const { x, y, z } = camera.position;
+	for (let i = 0; i < count; i++) if ((points[i * 3] - x) * forward.x + (points[i * 3 + 1] - y) * forward.y + (points[i * 3 + 2] - z) * forward.z < camera.near * 2) return true;
+	return false;
+}
+function screenLengths(points, count, camera, viewportPx, out) {
+	const focal = aim(camera, viewportPx);
+	const at = [
+		0,
+		0,
+		0
+	];
+	let length = 0;
+	let lastX = 0;
+	let lastY = 0;
+	let seen = false;
+	for (let i = 0; i < count; i++) {
+		view(points, i, camera, at);
+		if (at[2] > camera.near) {
+			const px = at[0] / at[2] * focal;
+			const py = at[1] / at[2] * focal;
+			if (seen) length += Math.hypot(px - lastX, py - lastY);
+			lastX = px;
+			lastY = py;
+			seen = true;
+		}
+		out[i] = length;
+	}
+}
+var SeenLine = class {
+	points = new Float32Array(0);
+	alphas = new Float32Array(0);
+	lengths = new Float32Array(0);
+	count = 0;
+	a = [
+		0,
+		0,
+		0
+	];
+	b = [
+		0,
+		0,
+		0
+	];
+	see(points, alphas, count, camera, viewportPx) {
+		if (this.alphas.length < count * 4) {
+			this.points = new Float32Array(count * 12);
+			this.alphas = new Float32Array(count * 4);
+			this.lengths = new Float32Array(count * 4);
+		}
+		this.count = 0;
+		const focal = aim(camera, viewportPx);
+		const halfW = viewportPx * camera.aspect * REACH / 2;
+		const halfH = viewportPx * REACH / 2;
+		const near = camera.near * 2;
+		let { a, b } = this;
+		let joined = false;
+		let length = 0;
+		let lastX = 0;
+		let lastY = 0;
+		if (count > 0) view(points, 0, camera, a);
+		for (let i = 0; i + 1 < count; i++, [a, b] = [b, a]) {
+			view(points, i + 1, camera, b);
+			let from = 0;
+			let to = 1;
+			for (let plane = 0; plane < 5 && from <= to; plane++) {
+				const ga = edge(plane, a, focal, halfW, halfH, near);
+				const gb = edge(plane, b, focal, halfW, halfH, near);
+				if (ga < 0 && gb < 0) to = -1;
+				else if (ga < 0) from = Math.max(from, ga / (ga - gb));
+				else if (gb < 0) to = Math.min(to, ga / (ga - gb));
+			}
+			if (from > to) {
+				joined = false;
+				continue;
+			}
+			const depth = a[2] + (b[2] - a[2]) * from;
+			const x = (a[0] + (b[0] - a[0]) * from) / depth * focal;
+			const y = (a[1] + (b[1] - a[1]) * from) / depth * focal;
+			if (!joined || from > 0) {
+				if (this.count > 0) {
+					this.copy(this.count - 1, 0);
+					this.put(points, alphas, i, from, length, 0);
+				}
+				this.put(points, alphas, i, from, length, 1);
+				lastX = x;
+				lastY = y;
+			}
+			const endDepth = a[2] + (b[2] - a[2]) * to;
+			const endX = (a[0] + (b[0] - a[0]) * to) / endDepth * focal;
+			const endY = (a[1] + (b[1] - a[1]) * to) / endDepth * focal;
+			length += Math.hypot(endX - lastX, endY - lastY);
+			lastX = endX;
+			lastY = endY;
+			this.put(points, alphas, i, to, length, 1);
+			joined = to === 1;
+		}
+	}
+	put(points, alphas, i, t, length, shown) {
+		const at = this.count++;
+		for (let k = 0; k < 3; k++) {
+			const from = points[i * 3 + k];
+			this.points[at * 3 + k] = from + (points[i * 3 + 3 + k] - from) * t;
+		}
+		this.alphas[at] = (alphas[i] + (alphas[i + 1] - alphas[i]) * t) * shown;
+		this.lengths[at] = length;
+	}
+	copy(from, shown) {
+		const at = this.count++;
+		this.points.copyWithin(at * 3, from * 3, from * 3 + 3);
+		this.alphas[at] = this.alphas[from] * shown;
+		this.lengths[at] = this.lengths[from];
+	}
+};
+function edge(plane, at, focal, halfW, halfH, near) {
+	if (plane === 0) return at[2] - near;
+	if (plane === 1) return halfW * at[2] - focal * at[0];
+	if (plane === 2) return halfW * at[2] + focal * at[0];
+	if (plane === 3) return halfH * at[2] - focal * at[1];
+	return halfH * at[2] + focal * at[1];
+}
+
 //#endregion
 //#region src/lib/scene/extensions/polyline.ts
 var REDRAW_EPSILON$1 = 1e-9;
@@ -25493,6 +25714,7 @@ var PolylineExtension = class {
 	color;
 	widthPx;
 	opacity;
+	dash;
 	fade;
 	closed;
 	local;
@@ -25500,6 +25722,7 @@ var PolylineExtension = class {
 	mesh = null;
 	scratch = new Float32Array(0);
 	alphas = new Float32Array(0);
+	seen = new SeenLine();
 	capacity = 0;
 	lastOrigin = [
 		0,
@@ -25514,6 +25737,7 @@ var PolylineExtension = class {
 		this.color = options.color ?? "#ffffff";
 		this.widthPx = options.widthPx ?? 2;
 		this.opacity = options.opacity ?? 1;
+		this.dash = parseDash(options.dash);
 		this.fade = options.fade ?? false;
 		this.closed = options.closed ?? false;
 		this.local = new Float64Array(0);
@@ -25534,6 +25758,10 @@ var PolylineExtension = class {
 		}
 		if (count > points.length) this.local.copyWithin(points.length * 3, 0, 3);
 		this.count = count;
+		if (this.alphas.length < count) {
+			this.scratch = new Float32Array(count * 3);
+			this.alphas = new Float32Array(count);
+		}
 		if (count > this.capacity) this.rebuild(count);
 		this.fillAlphas();
 		this.dirty = true;
@@ -25552,38 +25780,35 @@ var PolylineExtension = class {
 		this.removeSelf?.();
 		this.removeSelf = null;
 	}
-	update({ jd, basis, camera, ctx }) {
-		const mesh = this.mesh;
-		if (!mesh) return;
+	update({ jd, basis, camera, viewportPx, ctx }) {
 		const world = this.wanted && this.count >= 2 ? resolveAnchor(this.anchor, ctx, jd) : null;
-		mesh.visible = world !== null;
-		if (!world) return;
+		if (this.mesh) this.mesh.visible = world !== null;
+		if (!this.mesh || !world) return;
 		const origin = [
 			world[0] - basis[0],
 			world[1] - basis[1],
 			world[2] - basis[2]
 		];
-		if (this.dirty || Math.abs(origin[0] - this.lastOrigin[0]) > REDRAW_EPSILON$1 || Math.abs(origin[1] - this.lastOrigin[1]) > REDRAW_EPSILON$1 || Math.abs(origin[2] - this.lastOrigin[2]) > REDRAW_EPSILON$1) {
-			this.writeVertices(mesh, origin);
+		const moved = this.dirty || Math.abs(origin[0] - this.lastOrigin[0]) > REDRAW_EPSILON$1 || Math.abs(origin[1] - this.lastOrigin[1]) > REDRAW_EPSILON$1 || Math.abs(origin[2] - this.lastOrigin[2]) > REDRAW_EPSILON$1;
+		if (moved) {
+			for (let i = 0; i < this.count * 3; i++) this.scratch[i] = this.local[i] + origin[i % 3];
 			this.lastOrigin = origin;
-			this.dirty = false;
 		}
-		mesh.material.uniforms.uCenterOffset.value.copy(camera.position).negate();
-	}
-	writeVertices(mesh, origin) {
-		for (let i = 0; i < this.count; i++) {
-			this.scratch[i * 3] = this.local[i * 3] + origin[0];
-			this.scratch[i * 3 + 1] = this.local[i * 3 + 1] + origin[1];
-			this.scratch[i * 3 + 2] = this.local[i * 3 + 2] + origin[2];
-		}
-		writeFatTrailVertices(mesh.geometry, this.scratch, this.alphas, this.alphas, this.count);
+		const cut = this.dash !== null || reachesBehind(this.scratch, this.count, camera);
+		if (cut) {
+			const { seen } = this;
+			seen.see(this.scratch, this.alphas, this.count, camera, viewportPx);
+			if (seen.count > this.capacity) this.rebuild(seen.count);
+			writeFatTrailVertices(this.mesh.geometry, seen.points, seen.alphas, seen.alphas, seen.count);
+			if (this.dash) writeLineDistances(this.mesh.geometry, seen.lengths, seen.count);
+		} else if (moved) writeFatTrailVertices(this.mesh.geometry, this.scratch, this.alphas, this.alphas, this.count);
+		this.dirty = cut;
+		this.mesh.material.uniforms.uCenterOffset.value.copy(camera.position).negate();
 	}
 	rebuild(capacity) {
 		this.disposeMesh();
 		this.dirty = true;
-		this.scratch = new Float32Array(capacity * 3);
-		this.alphas = new Float32Array(capacity);
-		const mesh = buildFatLineFromThin(capacity, this.scratch, this.alphas, this.alphas, capacity, this.color, this.widthPx, 1);
+		const mesh = buildFatLineFromThin(capacity, this.scratch, this.alphas, this.alphas, 0, this.color, this.widthPx, 1, this.dash ?? void 0);
 		mesh.frustumCulled = false;
 		this.object.add(mesh);
 		this.mesh = mesh;
@@ -26772,6 +26997,7 @@ var SurfaceShapeExtension = class {
 	color;
 	widthPx;
 	opacity;
+	dash;
 	fillColor;
 	fillOpacity;
 	dirs = new Float64Array(0);
@@ -26779,6 +27005,7 @@ var SurfaceShapeExtension = class {
 	line = null;
 	scratch = new Float32Array(0);
 	alphas = new Float32Array(0);
+	lengths = new Float32Array(0);
 	fanDirs = new Float64Array(0);
 	fill = null;
 	fillScratch = new Float32Array(0);
@@ -26798,6 +27025,7 @@ var SurfaceShapeExtension = class {
 		this.color = options.color ?? "#ffffff";
 		this.widthPx = options.widthPx ?? 2;
 		this.opacity = options.opacity ?? 1;
+		this.dash = parseDash(options.dash);
 		this.fillColor = options.fill ?? null;
 		this.fillOpacity = options.fillOpacity ?? .25;
 		this.object.matrixAutoUpdate = false;
@@ -26830,7 +27058,7 @@ var SurfaceShapeExtension = class {
 		this.removeSelf?.();
 		this.removeSelf = null;
 	}
-	update({ jd, basis, camera, ctx }) {
+	update({ jd, basis, camera, viewportPx, ctx }) {
 		const body = this.wanted && this.count >= 2 ? ctx.getBody(this.body) : void 0;
 		const centre = body && bodyCentre(body, ctx, jd);
 		if (this.line) this.line.visible = !!centre;
@@ -26847,6 +27075,10 @@ var SurfaceShapeExtension = class {
 		if (this.line) {
 			this.place(this.dirs, this.count, q, scale, origin, this.scratch);
 			writeFatTrailVertices(this.line.geometry, this.scratch, this.alphas, this.alphas, this.count);
+			if (this.dash) {
+				screenLengths(this.scratch, this.count, camera, viewportPx, this.lengths);
+				writeLineDistances(this.line.geometry, this.lengths, this.count);
+			}
 			this.line.material.uniforms.uCenterOffset.value.copy(camera.position).negate();
 		}
 		if (this.fill) {
@@ -26875,7 +27107,8 @@ var SurfaceShapeExtension = class {
 		if (this.count < 2 || this.widthPx <= 0) return;
 		this.scratch = new Float32Array(this.count * 3);
 		this.alphas = new Float32Array(this.count).fill(this.opacity);
-		const line = buildFatLineFromThin(this.count, this.scratch, this.alphas, this.alphas, this.count, this.color, this.widthPx, 1);
+		this.lengths = new Float32Array(this.count);
+		const line = buildFatLineFromThin(this.count, this.scratch, this.alphas, this.alphas, this.count, this.color, this.widthPx, 1, this.dash ?? void 0);
 		line.frustumCulled = false;
 		line.renderOrder = SURFACE_RENDER_ORDER;
 		this.object.add(line);
@@ -27914,6 +28147,10 @@ var SpaceMap = class {
 		this.requireRenderer().setBodyAppearance(id, appearance);
 		return this;
 	}
+	setPinnedBodies(ids) {
+		this.requireRenderer().setPinnedBodies(ids);
+		return this;
+	}
 	capRadiusDeg(options) {
 		if (options.radiusDeg !== void 0) return options.radiusDeg;
 		const bodyRadiusKm = this.getBody(options.body)?.radiusKm;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "spacemap",
-	"version": "0.1.4",
+	"version": "0.1.5",
 	"description": "The map of the Solar System from spacemap.co, on your website!",
 	"keywords": ["solar system", "spacecraft", "orbits", "map", "three.js"],
 	"homepage": "https://spacemap.co",