@mark1russell7/visuals 0.2.2 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -59,6 +59,8 @@ const stage = createStage(document.body, {
59
59
 
60
60
  `createStage` gives `undefined` for a browser with no WebGL 2. It does not throw. Then show a different picture of the same data.
61
61
 
62
+ `stageSupported` of the entry `.` tells if the browser has WebGL 2. Use it before a dynamic `import()` of the module that makes the stage. Then a browser with no WebGL 2 does not load `three`.
63
+
62
64
  ## What a stage does
63
65
 
64
66
  - A drag turns the content. The wheel changes the distance after a click in the picture, so the page scrolls until then.
@@ -105,7 +107,9 @@ const near: StageView = (frame) => ({ ...front(frame), distance: 4 });
105
107
 
106
108
  An extent with the field `surface` has a ball around its center, for example a globe. The camera stays out of the ball.
107
109
 
108
- - The turn and the zoom become slower near the surface. So a small region does not go out of the picture with one drag.
110
+ - In a drag, the surface at the middle of the picture follows the pointer, at each height of the camera. So a small region does not go out of the picture with one drag.
111
+ - Near the surface, an arrow key moves the surface by one eighth of the height of the picture.
112
+ - The zoom becomes slower near the surface.
109
113
  - A move between two views changes the height above the surface by a constant factor in each step.
110
114
  - `capView` shows a cap of the ball. A cap of half of the ball shows all of the ball.
111
115
 
@@ -189,7 +193,7 @@ const stage = createStage(document.body, {
189
193
  The views of a globe:
190
194
 
191
195
  - `globeView(place, degrees)` shows the cap of the Earth around a place. The default shows a half of the Earth.
192
- - `regionView(regions)` shows each region of a list, from above their middle.
196
+ - `regionView(regions)` shows each region of a list, from above their middle. The regions fill the width or the height of the picture.
193
197
 
194
198
  The functions of the globe maths have no state. A test in Node.js uses them:
195
199
 
@@ -409,13 +413,15 @@ The entry `.` has pure functions. A page with no WebGL 2 and a test in Node.js u
409
413
  | `fitDistance`, `capDistance` | The distance at which the camera shows points, or a cap of a ball. |
410
414
  | `cameraPosition`, `viewOf` | The position of a camera from its place, and the place from its position. |
411
415
  | `placeBetween`, `moveAt`, `easeInOut` | A place on the way between two places, and the place at a time of a move. |
412
- | `ballView` | A view that shows points on a ball, from above their middle. |
416
+ | `ballView` | A view that shows points on a ball, from above their middle. The points fill the width or the height of the picture. |
413
417
  | `clampPlace`, `stageLimits` | A place in the limits of a stage, and the limits from the content. |
414
418
  | `reachOf`, `nearDepth` | The radius of the ball that holds the content, and the nearest depth that the camera draws. |
415
419
  | `keyAction` | The action of a key. |
420
+ | `turnAcross`, `speedAt` | The turn that moves the surface of a ball by the height of the picture, and the zoom speed at a height. |
416
421
  | `screenPoint` | The point of a picture that shows a point of the world, in CSS pixels. |
417
422
  | `highlightOf`, `isClick` | The highlight of a record, and the difference between a click and a drag. |
418
423
  | `approach` | One step of a value to its goal, for a part that changes with time. |
424
+ | `stageSupported` | True when the browser can show a stage. It gives false in Node.js. |
419
425
 
420
426
  The space of a stage has the y axis up. A place has a target, a polar angle from the y axis, an azimuth around it and a distance.
421
427
 
@@ -109,13 +109,35 @@ function clampPlace(place, limits) {
109
109
  * This function gives the height of a camera above the surface of a stage, as a part of its distance from the target.
110
110
  *
111
111
  * `surface` is the radius of the ball around the target that the camera stays out of. A stage with no ball has the value 0.
112
- * The result is the factor of the turn speed and the zoom speed of a camera: near the surface, a camera moves slowly.
112
+ * The result is the factor of the zoom speed of a camera: near the surface, a camera moves slowly.
113
113
  * The result is 0.02 at least, so a camera on the surface can move away.
114
114
  */
115
115
  function speedAt(distance, surface) {
116
116
  if (!(distance > 0)) return 1;
117
117
  return Math.min(Math.max((distance - surface) / distance, .02), 1);
118
118
  }
119
+ /** The default vertical angle of the picture of a stage, in degrees. */
120
+ const FIELD_OF_VIEW = 32;
121
+ /** The smallest result of `turnAcross`, in radians. A camera on a ball, or in it, can thus turn. */
122
+ const SMALLEST_TURN = 1e-6;
123
+ /**
124
+ * This function gives the turn of a camera around a ball that moves the surface by the height of the picture, in radians.
125
+ *
126
+ * `surface` is the radius of the ball around the target. `fieldOfView` is the vertical angle of the picture, in degrees.
127
+ *
128
+ * The result is exact for the surface at the middle of the picture. Thus that surface follows the pointer in a drag.
129
+ * The ball is round, so a long drag moves that surface by a smaller distance than the pointer.
130
+ * Thus the surface does not go before the pointer.
131
+ *
132
+ * The result is `Infinity` for a stage with no ball, because such a stage has no surface that follows the pointer.
133
+ * A turn about the up axis moves a point between the equator and a pole of the ball by a smaller distance.
134
+ */
135
+ function turnAcross(distance, surface, fieldOfView) {
136
+ const half = fieldOfView * Math.PI / 360;
137
+ if (!(surface > 0) || !(distance > 0) || !(half > 0 && half < Math.PI / 2)) return Number.POSITIVE_INFINITY;
138
+ const shown = 2 * (distance - surface) * Math.tan(half);
139
+ return Math.max(shown / surface, SMALLEST_TURN);
140
+ }
119
141
  /**
120
142
  * This function gives the place at a part of the way between two places. `part` goes from 0 to 1.
121
143
  *
@@ -182,22 +204,36 @@ function capView(angles, angle, margin = FIT_MARGIN) {
182
204
  /**
183
205
  * This function makes a view of points on the ball of the content. The camera is above the middle of the points, and the picture shows each point.
184
206
  *
185
- * The middle is the center of the box of the points. `margin` is the space around the points, as a factor of the height above the ball.
207
+ * The middle is the center of the box of the points. The camera is at the smallest distance that shows each point in the width and in the height of the picture.
208
+ * Thus wide points fill a wide picture. `margin` is the space around the points, as a factor of the height above the ball.
186
209
  * A list with no points gives a view of all of the ball from the front. Points with their middle at the center of the ball give the same view.
187
210
  */
188
211
  function ballView(points, margin = FIT_MARGIN) {
189
212
  let found;
190
213
  return (frame) => {
191
- const { center } = frame.extent;
214
+ const { extent } = frame;
215
+ const { center } = extent;
192
216
  if (found === void 0 || found.center.x !== center.x || found.center.y !== center.y || found.center.z !== center.z) found = {
193
217
  center,
194
- view: capOf(points, center, margin)
218
+ angles: middleOf(points, center)
219
+ };
220
+ const { angles } = found;
221
+ if (angles === void 0) return capView({
222
+ polar: Math.PI / 2,
223
+ azimuth: 0
224
+ }, Math.PI / 2, margin)(frame);
225
+ const surface = surfaceOf(extent);
226
+ const height = Math.max(fitDistance(points, center, angles, frame.fieldOfView, frame.aspect) - surface, 0);
227
+ return {
228
+ target: center,
229
+ polar: angles.polar,
230
+ azimuth: angles.azimuth,
231
+ distance: surface > 0 ? surface + height * margin : 1
195
232
  };
196
- return found.view(frame);
197
233
  };
198
234
  }
199
- /** This function makes the view of the cap of a ball around `center` that holds each point. */
200
- function capOf(points, center, margin) {
235
+ /** This function gives the direction from `center` to the middle of the box of the points. It gives `undefined` when the middle has no direction. */
236
+ function middleOf(points, center) {
201
237
  const low = {
202
238
  x: 1e400,
203
239
  y: 1e400,
@@ -222,29 +258,16 @@ function capOf(points, center, margin) {
222
258
  z: (low.z + high.z) / 2 - center.z
223
259
  };
224
260
  const length = Math.hypot(middle.x, middle.y, middle.z);
225
- if (!(length > 0) || !Number.isFinite(length)) return capView({
226
- polar: Math.PI / 2,
227
- azimuth: 0
228
- }, Math.PI / 2, margin);
229
- let angle = 0;
230
- for (const point of points) {
231
- const x = point.x - center.x;
232
- const y = point.y - center.y;
233
- const z = point.z - center.z;
234
- const distance = Math.hypot(x, y, z);
235
- if (!(distance > 0)) continue;
236
- const cosine = (x * middle.x + y * middle.y + z * middle.z) / (distance * length);
237
- angle = Math.max(angle, Math.acos(Math.min(Math.max(cosine, -1), 1)));
238
- }
261
+ if (!(length > 0) || !Number.isFinite(length)) return void 0;
239
262
  const { polar, azimuth } = viewOf(middle, {
240
263
  x: 0,
241
264
  y: 0,
242
265
  z: 0
243
266
  });
244
- return capView({
267
+ return {
245
268
  polar,
246
269
  azimuth
247
- }, angle, margin);
270
+ };
248
271
  }
249
272
  /** This function gives the radius of the ball around the center of an extent that holds the ball of the extent and each corner. */
250
273
  function reachOf(extent) {
@@ -287,6 +310,6 @@ function stageLimits(frame, views, polar) {
287
310
  far: (maxDistance + reach) * 1.5
288
311
  };
289
312
  }
290
- export { viewOf as _, nearDepth as a, surfaceOf as c, clampPlace as d, fitDistance as f, viewAxes as g, turnBetween as h, fitView as i, cameraPosition as l, speedAt as m, ballView as n, reachOf as o, placeBetween as p, capView as r, stageLimits as s, FIT_MARGIN as t, capDistance as u };
313
+ export { turnBetween as _, nearDepth as a, surfaceOf as c, capDistance as d, clampPlace as f, turnAcross as g, speedAt as h, fitView as i, FIELD_OF_VIEW as l, placeBetween as m, ballView as n, reachOf as o, fitDistance as p, capView as r, stageLimits as s, FIT_MARGIN as t, cameraPosition as u, viewAxes as v, viewOf as y };
291
314
 
292
- //# sourceMappingURL=extent-CALhBZU-.js.map
315
+ //# sourceMappingURL=extent-DC0qrxC5.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extent-DC0qrxC5.js","names":[],"sources":["../src/view.ts","../src/extent.ts"],"sourcesContent":["import type { Point3 } from \"@mark1russell7/layout-contract\";\n\n/**\n * The direction of a view: where the camera is, as seen from the point that it looks at.\n * The space of a stage has the y axis up.\n */\nexport interface ViewAngles {\n /** The angle from the up axis to the camera, in radians. At 0, the camera looks down from above. */\n readonly polar: number;\n /** The angle around the up axis, in radians. At 0, the camera is on the positive z side of the point. */\n readonly azimuth: number;\n}\n\n/** A place of a camera: the point that it looks at, the angles of its view and its distance from the point. */\nexport interface Place extends ViewAngles {\n readonly target: Point3;\n readonly distance: number;\n}\n\n/** The three axes of a camera, as unit vectors in the space of the stage. */\nexport interface ViewAxes {\n /** The vector from the point that the camera looks at to the camera. */\n readonly back: Point3;\n /** The vector to the right side of the picture. */\n readonly right: Point3;\n /** The vector to the top of the picture. */\n readonly up: Point3;\n}\n\n/** The limits of the place of a camera. */\nexport interface PlaceLimits {\n /** The smallest polar angle. At 0, the azimuth of a camera has no meaning. */\n readonly minPolar: number;\n /** The largest polar angle. */\n readonly maxPolar: number;\n /** The smallest distance from the target. */\n readonly minDistance: number;\n /** The largest distance from the target. */\n readonly maxDistance: number;\n}\n\n/** This function gives the axes of the camera of a view. At a polar angle of 0, the top of the picture is the negative z axis. */\nexport function viewAxes(view: ViewAngles): ViewAxes {\n const sinPolar = Math.sin(view.polar);\n const cosPolar = Math.cos(view.polar);\n const sinAzimuth = Math.sin(view.azimuth);\n const cosAzimuth = Math.cos(view.azimuth);\n return {\n back: { x: sinPolar * sinAzimuth, y: cosPolar, z: sinPolar * cosAzimuth },\n right: { x: cosAzimuth, y: 0, z: 0 - sinAzimuth },\n up: { x: 0 - cosPolar * sinAzimuth, y: sinPolar, z: 0 - cosPolar * cosAzimuth },\n };\n}\n\n/** This function gives the dot product of the vector from `origin` to `point` with `axis`. */\nfunction along(point: Point3, origin: Point3, axis: Point3): number {\n return (point.x - origin.x) * axis.x + (point.y - origin.y) * axis.y + (point.z - origin.z) * axis.z;\n}\n\n/**\n * This function gives the smallest distance from `target` at which a camera shows each point.\n *\n * The camera looks at `target` along the direction of `view`. `fov` is the vertical angle of the picture in degrees,\n * and `aspect` is the width of the picture divided by its height.\n * The function gives 0 for no points, and for an angle or an aspect that makes no picture.\n */\nexport function fitDistance(points: readonly Point3[], target: Point3, view: ViewAngles, fov: number, aspect: number): number {\n const tanUp = Math.tan((fov * Math.PI) / 360);\n const tanRight = tanUp * aspect;\n if (!(tanUp > 0) || !(tanRight > 0) || !Number.isFinite(tanRight)) return 0;\n const axes = viewAxes(view);\n let distance = 0;\n for (const point of points) {\n const depth = along(point, target, axes.back);\n const needed = Math.max(Math.abs(along(point, target, axes.right)) / tanRight, Math.abs(along(point, target, axes.up)) / tanUp);\n distance = Math.max(distance, depth + needed);\n }\n return distance;\n}\n\n/**\n * This function gives the smallest distance from the center of a ball at which a camera shows a cap of the ball.\n *\n * The camera looks at the center of the ball, and the center of the cap is on the line to the camera.\n * `radius` is the radius of the ball. `angle` is the angle of the cap at the center of the ball, in radians, from 0 to π / 2.\n * `fov` is the vertical angle of the picture in degrees, and `aspect` is the width of the picture divided by its height.\n * The function gives 0 for an angle or an aspect that makes no picture.\n */\nexport function capDistance(radius: number, angle: number, fov: number, aspect: number): number {\n const tanUp = Math.tan((fov * Math.PI) / 360);\n const tan = Math.min(tanUp, tanUp * aspect);\n if (!(tan > 0) || !Number.isFinite(tan) || !(radius > 0)) return 0;\n const cap = Math.min(Math.max(angle, 0), Math.PI / 2);\n const half = Math.atan(tan);\n // A cap this large has its edge behind the outline of the ball. Then the outline of the ball is the limit.\n if (cap >= Math.PI / 2 - half) return radius / Math.sin(half);\n // The edge of the cap is at the height r sin(a) from the line, and at the depth r cos(a) from the center.\n return radius * Math.cos(cap) + (radius * Math.sin(cap)) / tan;\n}\n\n/** This function gives the position of a camera at a distance from `target`, in the direction of `view`. */\nexport function cameraPosition(target: Point3, view: ViewAngles, distance: number): Point3 {\n const { back } = viewAxes(view);\n return { x: target.x + back.x * distance, y: target.y + back.y * distance, z: target.z + back.z * distance };\n}\n\n/** This function gives the angles of the view from `target` to a camera, and the distance between them. A camera at the target gives the angles 0. */\nexport function viewOf(camera: Point3, target: Point3): ViewAngles & { readonly distance: number } {\n const x = camera.x - target.x;\n const y = camera.y - target.y;\n const z = camera.z - target.z;\n const distance = Math.hypot(x, y, z);\n if (!(distance > 0)) return { polar: 0, azimuth: 0, distance: 0 };\n return { polar: Math.acos(Math.min(Math.max(y / distance, -1), 1)), azimuth: Math.atan2(x, z), distance };\n}\n\n/** This function gives the angle between two azimuths along the shortest way, from −π to π. */\nexport function turnBetween(from: number, to: number): number {\n const full = 2 * Math.PI;\n const turn = (((to - from) % full) + full) % full;\n return turn > Math.PI ? turn - full : turn;\n}\n\n/** This function gives a place in its limits. The target and the azimuth stay as they are. */\nexport function clampPlace(place: Place, limits: PlaceLimits): Place {\n return {\n target: place.target,\n azimuth: place.azimuth,\n polar: Math.min(Math.max(place.polar, limits.minPolar), limits.maxPolar),\n distance: Math.min(Math.max(place.distance, limits.minDistance), limits.maxDistance),\n };\n}\n\n/**\n * This function gives the height of a camera above the surface of a stage, as a part of its distance from the target.\n *\n * `surface` is the radius of the ball around the target that the camera stays out of. A stage with no ball has the value 0.\n * The result is the factor of the zoom speed of a camera: near the surface, a camera moves slowly.\n * The result is 0.02 at least, so a camera on the surface can move away.\n */\nexport function speedAt(distance: number, surface: number): number {\n if (!(distance > 0)) return 1;\n return Math.min(Math.max((distance - surface) / distance, 0.02), 1);\n}\n\n/** The default vertical angle of the picture of a stage, in degrees. */\nexport const FIELD_OF_VIEW = 32;\n\n/** The smallest result of `turnAcross`, in radians. A camera on a ball, or in it, can thus turn. */\nconst SMALLEST_TURN = 1e-6;\n\n/**\n * This function gives the turn of a camera around a ball that moves the surface by the height of the picture, in radians.\n *\n * `surface` is the radius of the ball around the target. `fieldOfView` is the vertical angle of the picture, in degrees.\n *\n * The result is exact for the surface at the middle of the picture. Thus that surface follows the pointer in a drag.\n * The ball is round, so a long drag moves that surface by a smaller distance than the pointer.\n * Thus the surface does not go before the pointer.\n *\n * The result is `Infinity` for a stage with no ball, because such a stage has no surface that follows the pointer.\n * A turn about the up axis moves a point between the equator and a pole of the ball by a smaller distance.\n */\nexport function turnAcross(distance: number, surface: number, fieldOfView: number): number {\n const half = (fieldOfView * Math.PI) / 360;\n if (!(surface > 0) || !(distance > 0) || !(half > 0 && half < Math.PI / 2)) return Number.POSITIVE_INFINITY;\n // The surface at the middle of the picture is at the distance `distance - surface` from the camera.\n // There, the height of the picture shows this length of the surface. The turn is that length as an angle of the ball.\n const shown = 2 * (distance - surface) * Math.tan(half);\n return Math.max(shown / surface, SMALLEST_TURN);\n}\n\n/**\n * This function gives the place at a part of the way between two places. `part` goes from 0 to 1.\n *\n * The azimuth goes along the shortest way. The height above the surface changes by an equal factor for each equal step,\n * so a zoom has one speed in the picture. `surface` is the radius of the ball around the target, or 0 for no ball.\n */\nexport function placeBetween(from: Place, to: Place, part: number, surface: number = 0): Place {\n const between = (a: number, b: number): number => a + (b - a) * part;\n const low = from.distance - surface;\n const high = to.distance - surface;\n const height = low > 0 && high > 0 ? low * (high / low) ** part : between(low, high);\n return {\n target: { x: between(from.target.x, to.target.x), y: between(from.target.y, to.target.y), z: between(from.target.z, to.target.z) },\n polar: between(from.polar, to.polar),\n azimuth: from.azimuth + turnBetween(from.azimuth, to.azimuth) * part,\n distance: surface + height,\n };\n}\n","import type { Point3 } from \"@mark1russell7/layout-contract\";\nimport { capDistance, fitDistance, viewOf, type Place, type PlaceLimits, type ViewAngles } from \"./view.ts\";\n\n/** The space that the content of a stage fills. A view and the limits of the camera come from it. */\nexport interface StageExtent {\n /** The points that a view of all the content shows, for example each corner of each solid. */\n readonly corners: readonly Point3[];\n /** The point that the camera looks at. */\n readonly center: Point3;\n /**\n * The radius of the ball around the center that the camera stays out of, for example the radius of a globe.\n * The default is 0: the content has no ball.\n */\n readonly surface?: number | undefined;\n /** The smallest distance of the camera from the center. The default comes from the views of the stage. */\n readonly minDistance?: number | undefined;\n /** The largest distance of the camera from the center. The default comes from the views of the stage. */\n readonly maxDistance?: number | undefined;\n}\n\n/** The picture that a view is for: the content, and the angle and the shape of the picture. */\nexport interface ViewFrame {\n readonly extent: StageExtent;\n /** The vertical angle of the picture, in degrees. */\n readonly fieldOfView: number;\n /** The width of the picture divided by its height. */\n readonly aspect: number;\n}\n\n/** A view of a stage: a function that gives the place of the camera for a picture. A new size of the picture gives a new place. */\nexport type StageView = (frame: ViewFrame) => Place;\n\n/** The limits of the camera of a stage: the limits of its place, and the nearest and the farthest depth that it draws. */\nexport interface StageLimits extends PlaceLimits {\n readonly near: number;\n readonly far: number;\n}\n\n/** The space around the content in a view that shows all of it, as a factor of the distance. */\nexport const FIT_MARGIN = 1.06;\n\n/** This function gives the radius of the ball around the center of an extent, or 0 for no ball. */\nexport function surfaceOf(extent: StageExtent): number {\n const surface = extent.surface ?? 0;\n return surface > 0 ? surface : 0;\n}\n\n/**\n * This function makes a view that shows each corner of the content from one direction.\n * `margin` is the space around the content, as a factor of the distance. An extent with no corners gives the distance 1.\n */\nexport function fitView(angles: ViewAngles, margin: number = FIT_MARGIN): StageView {\n return ({ extent, fieldOfView, aspect }) => {\n const distance = fitDistance(extent.corners, extent.center, angles, fieldOfView, aspect) * margin;\n return { target: extent.center, polar: angles.polar, azimuth: angles.azimuth, distance: distance > 0 ? distance : 1 };\n };\n}\n\n/**\n * This function makes a view of a part of the ball of the content: a cap around the point of the ball below the camera.\n *\n * `angles` is the direction from the center of the ball to the camera. `angle` is the angle of the cap at the center of the ball, in radians.\n * `margin` is the space around the cap, as a factor of the height above the ball. An extent with no ball gives the distance 1.\n */\nexport function capView(angles: ViewAngles, angle: number, margin: number = FIT_MARGIN): StageView {\n return ({ extent, fieldOfView, aspect }) => {\n const surface = surfaceOf(extent);\n const height = Math.max(capDistance(surface, angle, fieldOfView, aspect) - surface, 0);\n return { target: extent.center, polar: angles.polar, azimuth: angles.azimuth, distance: surface > 0 ? surface + height * margin : 1 };\n };\n}\n\n/**\n * This function makes a view of points on the ball of the content. The camera is above the middle of the points, and the picture shows each point.\n *\n * The middle is the center of the box of the points. The camera is at the smallest distance that shows each point in the width and in the height of the picture.\n * Thus wide points fill a wide picture. `margin` is the space around the points, as a factor of the height above the ball.\n * A list with no points gives a view of all of the ball from the front. Points with their middle at the center of the ball give the same view.\n */\nexport function ballView(points: readonly Point3[], margin: number = FIT_MARGIN): StageView {\n let found: { readonly center: Point3; readonly angles: ViewAngles | undefined } | undefined;\n return (frame) => {\n const { extent } = frame;\n const { center } = extent;\n // The middle is the same for each picture of one content. So the function calculates it one time for each center.\n if (found === undefined || found.center.x !== center.x || found.center.y !== center.y || found.center.z !== center.z) {\n found = { center, angles: middleOf(points, center) };\n }\n const { angles } = found;\n if (angles === undefined) return capView({ polar: Math.PI / 2, azimuth: 0 }, Math.PI / 2, margin)(frame);\n const surface = surfaceOf(extent);\n // A point of the ball needs no more distance than the outline of the ball. Thus the camera is not farther than a view of all of the ball.\n const height = Math.max(fitDistance(points, center, angles, frame.fieldOfView, frame.aspect) - surface, 0);\n return { target: center, polar: angles.polar, azimuth: angles.azimuth, distance: surface > 0 ? surface + height * margin : 1 };\n };\n}\n\n/** This function gives the direction from `center` to the middle of the box of the points. It gives `undefined` when the middle has no direction. */\nfunction middleOf(points: readonly Point3[], center: Point3): ViewAngles | undefined {\n const low = { x: Infinity, y: Infinity, z: Infinity };\n const high = { x: -Infinity, y: -Infinity, z: -Infinity };\n for (const point of points) {\n low.x = Math.min(low.x, point.x);\n low.y = Math.min(low.y, point.y);\n low.z = Math.min(low.z, point.z);\n high.x = Math.max(high.x, point.x);\n high.y = Math.max(high.y, point.y);\n high.z = Math.max(high.z, point.z);\n }\n const middle = { x: (low.x + high.x) / 2 - center.x, y: (low.y + high.y) / 2 - center.y, z: (low.z + high.z) / 2 - center.z };\n const length = Math.hypot(middle.x, middle.y, middle.z);\n if (!(length > 0) || !Number.isFinite(length)) return undefined;\n const { polar, azimuth } = viewOf(middle, { x: 0, y: 0, z: 0 });\n return { polar, azimuth };\n}\n\n/** This function gives the radius of the ball around the center of an extent that holds the ball of the extent and each corner. */\nexport function reachOf(extent: StageExtent): number {\n let reach = surfaceOf(extent);\n for (const corner of extent.corners) reach = Math.max(reach, Math.hypot(corner.x - extent.center.x, corner.y - extent.center.y, corner.z - extent.center.z));\n return reach;\n}\n\n/**\n * This function gives the nearest depth that a camera draws, from the distance of the camera to the center of the content.\n *\n * A camera far from the content gets a large value. The depths of the content then have more steps, so two surfaces that are near stay apart.\n * The result is not less than the nearest depth of the limits, and it is in front of all the content.\n */\nexport function nearDepth(limits: StageLimits, extent: StageExtent, distance: number): number {\n const free = (distance - reachOf(extent)) / 8;\n return free > limits.near ? Math.min(free, limits.far / 4) : limits.near;\n}\n\n/**\n * This function gives the limits of the camera of a stage for a picture.\n *\n * The largest distance of the views is the base. The camera goes out to 3 times this distance, and in to 3 % of the height of that view.\n * The extent can give each distance. The nearest depth is small against the height of the nearest camera, and the farthest depth is behind all the content.\n */\nexport function stageLimits(frame: ViewFrame, views: readonly StageView[], polar: { readonly min: number; readonly max: number }): StageLimits {\n const { extent } = frame;\n const surface = surfaceOf(extent);\n let widest = 0;\n for (const view of views) widest = Math.max(widest, view(frame).distance);\n if (!(widest > surface)) widest = surface + 1;\n const reach = reachOf(extent);\n const minDistance = extent.minDistance ?? surface + (widest - surface) * 0.03;\n const maxDistance = Math.max(extent.maxDistance ?? surface + (widest - surface) * 3, minDistance);\n const height = Math.max(minDistance - surface, 1e-6);\n return { minPolar: polar.min, maxPolar: polar.max, minDistance, maxDistance, near: height / 8, far: (maxDistance + reach) * 1.5 };\n}\n"],"mappings":"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"}
package/build/globe.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { i as StageContent } from "./stage-CtWLSoV-.js";
2
- import { S as ViewAngles, d as StageView, t as StageTheme } from "./theme-CKXd_emk.js";
1
+ import { r as StageContent } from "./stage-Bhu1f7Dw.js";
2
+ import { C as ViewAngles, d as StageView, t as StageTheme } from "./theme-3EGbXXoP.js";
3
3
  import { Raycaster } from "three";
4
4
  import { LatLon, Region } from "@mark1russell7/geo";
5
5
  import { Point3 } from "@mark1russell7/layout-contract";
@@ -179,6 +179,7 @@ export declare function globeAngles(place: LatLon): ViewAngles;
179
179
  export declare function globeView(place: LatLon, degrees?: number, margin?: number): StageView;
180
180
  /**
181
181
  * This function makes a view that shows each region of a list. The camera is above the middle of the regions.
182
+ * The regions fill the width or the height of the picture, so a wide region is large in a wide picture.
182
183
  * A list with no regions gives a view of a half of the Earth. `margin` is the space around the regions, as a factor of the height above the surface.
183
184
  */
184
185
  export declare function regionView(regions: readonly Region[], margin?: number): StageView;
@@ -1 +1 @@
1
- {"version":3,"file":"globe.d.ts","names":[],"sources":["../src/globe/content.ts","../src/globe/mesh.ts","../src/globe/space.ts"],"mappings":";;;;;;UA6BiB;;WAEN;;WAEA;;WAEA;;;UAIM,mBAAmB;;WAEzB;;WAEA;;WAEA;;WAEA,QAAQ,SAAS,eAAe;;WAEhC,OAAO;;WAEP;;WAEA;;;UAIM,UAAU;;WAEhB;;WAEA,QAAQ;;WAER;;WAEA,OAAO;;WAEP;;;UAIM,WAAW;;WAEjB;WACA,OAAO;;WAEP;;WAEA,OAAO;;WAEP;;WAEA;;;UAIM,aAAa;;WAEnB,iBAAiB,UAAU;;WAE3B,kBAAkB,WAAW;;WAE7B;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;;UAIM,aAAa,WAAW,aAAa,GAAG;;;;;EAKvD,KAAK,OAAO,MAAM,UAAU,KAAK,WAAW;;EAE5C,QAAQ,KAAK,YAAY;;;;;;wBAmBX,YAAY;;;;;;;wBA6IZ,YAAY,GAAG,UAAS,aAAa,KAAU,aAAa;;;;;UChR3D;;WAEN,SAAS;;WAET,WAAW;;;qBAIT;;;;;wBA0CG,WAAW;;;;;;;;;;;;;wBAyOX,cAAc,QAAQ,QAAQ,cAAc,sBAA2C;;;;;;;;wBA6GvF,YAAY,QAAQ,QAAQ,eAAe;;;;;;;wBA4E3C,UAAU,iBAAiB,eAAe;;;;;qBCld7C;WAAwB;WAAsB;;;;;;;;wBAU3C,WAAW,OAAO,QAAQ,kBAAqB;;;;;wBAS/C,WAAW,OAAO,SAAS;;wBAO3B,YAAY,OAAO,SAAS;;;;;;;wBAU5B,UAAU,OAAO,QAAQ,kBAAsB,kBAA8B;;;;;wBAQ7E,WAAW,kBAAkB,UAAU,kBAA8B;;;;;;wBAiBrE,QAAQ,QAAQ,QAAQ,WAAW,QAAQ,iBAAiB;;;;;wBAe5D,QAAQ,OAAO,QAAQ,KAAK,QAAQ"}
1
+ {"version":3,"file":"globe.d.ts","names":[],"sources":["../src/globe/content.ts","../src/globe/mesh.ts","../src/globe/space.ts"],"mappings":";;;;;;UA6BiB;;WAEN;;WAEA;;WAEA;;;UAIM,mBAAmB;;WAEzB;;WAEA;;WAEA;;WAEA,QAAQ,SAAS,eAAe;;WAEhC,OAAO;;WAEP;;WAEA;;;UAIM,UAAU;;WAEhB;;WAEA,QAAQ;;WAER;;WAEA,OAAO;;WAEP;;;UAIM,WAAW;;WAEjB;WACA,OAAO;;WAEP;;WAEA,OAAO;;WAEP;;WAEA;;;UAIM,aAAa;;WAEnB,iBAAiB,UAAU;;WAE3B,kBAAkB,WAAW;;WAE7B;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;;UAIM,aAAa,WAAW,aAAa,GAAG;;;;;EAKvD,KAAK,OAAO,MAAM,UAAU,KAAK,WAAW;;EAE5C,QAAQ,KAAK,YAAY;;;;;;wBAmBX,YAAY;;;;;;;wBA6IZ,YAAY,GAAG,UAAS,aAAa,KAAU,aAAa;;;;;UChR3D;;WAEN,SAAS;;WAET,WAAW;;;qBAIT;;;;;wBA0CG,WAAW;;;;;;;;;;;;;wBAyOX,cAAc,QAAQ,QAAQ,cAAc,sBAA2C;;;;;;;;wBA6GvF,YAAY,QAAQ,QAAQ,eAAe;;;;;;;wBA4E3C,UAAU,iBAAiB,eAAe;;;;;qBCld7C;WAAwB;WAAsB;;;;;;;;wBAU3C,WAAW,OAAO,QAAQ,kBAAqB;;;;;wBAS/C,WAAW,OAAO,SAAS;;wBAO3B,YAAY,OAAO,SAAS;;;;;;;wBAU5B,UAAU,OAAO,QAAQ,kBAAsB,kBAA8B;;;;;;wBAS7E,WAAW,kBAAkB,UAAU,kBAA8B;;;;;;wBAiBrE,QAAQ,QAAQ,QAAQ,WAAW,QAAQ,iBAAiB;;;;;wBAe5D,QAAQ,OAAO,QAAQ,KAAK,QAAQ"}
package/build/globe.js CHANGED
@@ -1,4 +1,4 @@
1
- import { n as ballView, r as capView, t as FIT_MARGIN } from "./extent-CALhBZU-.js";
1
+ import { n as ballView, r as capView, t as FIT_MARGIN } from "./extent-DC0qrxC5.js";
2
2
  import { BufferAttribute, BufferGeometry, Color, FrontSide, InstancedInterleavedBuffer, InterleavedBufferAttribute, Mesh, MeshBasicMaterial, Points, ShaderMaterial, ShapeUtils, Sphere, SphereGeometry, Vector2, Vector3 } from "three";
3
3
  import { densify, fromUnitVector, pointLocator, toUnitVector } from "@mark1russell7/geo";
4
4
  import { LineMaterial } from "three/addons/lines/LineMaterial.js";
@@ -513,6 +513,7 @@ function globeView(place, degrees = 90, margin = FIT_MARGIN) {
513
513
  }
514
514
  /**
515
515
  * This function makes a view that shows each region of a list. The camera is above the middle of the regions.
516
+ * The regions fill the width or the height of the picture, so a wide region is large in a wide picture.
516
517
  * A list with no regions gives a view of a half of the Earth. `margin` is the space around the regions, as a factor of the height above the surface.
517
518
  */
518
519
  function regionView(regions, margin = FIT_MARGIN) {