@mark1russell7/visuals 0.1.0 → 0.1.1

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
@@ -2,10 +2,11 @@
2
2
 
3
3
  3D stages for data. A stage is one canvas of three.js with a camera that a person moves. The content of the stage is your data.
4
4
 
5
- The package has two entries:
5
+ The package has three entries:
6
6
 
7
7
  - The entry `.` has the camera maths: views, places, moves, keys and marks. It needs no browser, and it does not need `three`.
8
8
  - The entry `/three` has the stage. It needs the package `three`, version 0.187.0 or later.
9
+ - The entry `/globe` has a content that shows the Earth as a globe, with areas and points on it. It also needs `three`.
9
10
 
10
11
  ## Install
11
12
 
@@ -110,6 +111,97 @@ all({ extent: globe, fieldOfView: 32, aspect: 1.5 }).distance; // => 3.79: the o
110
111
  region({ extent: globe, fieldOfView: 32, aspect: 1.5 }).distance; // => 1.18: a cap of 0.05 radians fills the height
111
112
  ```
112
113
 
114
+ ## A globe
115
+
116
+ The entry `/globe` has a content for a stage that shows the Earth. The picture goes from the whole Earth to one region.
117
+
118
+ ```ts
119
+ import { GLOBE_POLAR, createGlobe, globeView, regionView, type GlobeArea, type GlobeTheme } from "@mark1russell7/visuals/globe";
120
+ import { createStage } from "@mark1russell7/visuals/three";
121
+
122
+ const storm: GlobeArea<string> = {
123
+ record: "storm",
124
+ kind: "warning",
125
+ value: "A storm warning",
126
+ region: {
127
+ type: "Polygon",
128
+ coordinates: [
129
+ [
130
+ [-98, 30],
131
+ [-90, 30],
132
+ [-90, 36],
133
+ [-98, 36],
134
+ [-98, 30],
135
+ ],
136
+ ],
137
+ },
138
+ };
139
+
140
+ const theme: GlobeTheme = {
141
+ sky: "#ffffff",
142
+ ground: "#8a8f98",
143
+ ball: "#0d2236",
144
+ grid: "#24415c",
145
+ shade: "#02060a",
146
+ styles: {
147
+ warning: { fill: "#f0883e", opacity: 0.35, line: "#f0883e" },
148
+ city: { fill: "#ffffff", line: "#0d2236" },
149
+ },
150
+ other: { fill: "#6b7785", opacity: 0.5 },
151
+ hovered: "#ffd866",
152
+ selected: "#ffffff",
153
+ };
154
+
155
+ const globe = createGlobe({
156
+ areas: [storm],
157
+ points: [{ record: "city", kind: "city", value: "A city", place: { lat: 32.8, lon: -96.8 } }],
158
+ });
159
+
160
+ const stage = createStage(document.body, {
161
+ content: globe,
162
+ theme,
163
+ label: "The Earth with one storm warning",
164
+ views: { earth: globeView({ lat: 35, lon: -95 }), storm: regionView([storm.region]) },
165
+ home: "earth",
166
+ polar: GLOBE_POLAR,
167
+ pan: false,
168
+ onSelect: (value) => console.log(value), // => "A storm warning" after a click on the area
169
+ });
170
+ ```
171
+
172
+ - An area is a region of `@mark1russell7/geo`: a `Polygon` or a `MultiPolygon` of GeoJSON. A point is a place with a latitude and a longitude.
173
+ - The surface of an area follows the curve of the Earth. The option `step` sets the largest step of an edge, in degrees.
174
+ - A kind names the style of an area or a point in the theme. A new theme changes each color, and the geometry stays.
175
+ - The pointer finds a point first, then the last area of the list. The pointer ignores a part with `pick: false`.
176
+ - `show` hides each part that a test refuses, for example the records that are not active at a time.
177
+ - `placeAt` gives the place on the Earth under the pointer.
178
+ - The globe uses no map tiles and no service. Give the land to it as an area.
179
+
180
+ The views of a globe:
181
+
182
+ - `globeView(place, degrees)` shows the cap of the Earth around a place. The default shows a half of the Earth.
183
+ - `regionView(regions)` shows each region of a list, from above their middle.
184
+
185
+ The functions of the globe maths have no state. A test in Node.js uses them:
186
+
187
+ | Function | What it gives |
188
+ | --- | --- |
189
+ | `globePoint`, `globePlace` | The point of the globe for a place on the Earth, and the place for a point. |
190
+ | `regionSurface` | The triangles of the surface of a region. No edge is longer than 1.25 steps. |
191
+ | `regionEdges` | The lines of the outline of a region. A cut on the antimeridian or at a pole gives no line. |
192
+ | `gridLines` | The meridians and the parallels of a grid. |
193
+ | `rayBall`, `inSight` | The first point of a ball on a ray, and if a camera sees a point of the ball. |
194
+
195
+ ```ts
196
+ import { globePoint, regionSurface } from "@mark1russell7/visuals/globe";
197
+
198
+ globePoint({ lat: 0, lon: 0 }); // => { x: 0, y: 0, z: 1 }: the axis z goes to latitude 0 and longitude 0, and the axis y to the north pole
199
+
200
+ const surface = regionSurface(storm.region, 2);
201
+ surface.corners.length / 2; // => 43: the corners of the outline with a step of 2 degrees, and the corners in the surface
202
+ surface.triangles.length / 3; // => 70
203
+ ```
204
+
113
205
  ## The camera maths
114
206
 
115
207
  The entry `.` has pure functions. A page with no WebGL 2 and a test in Node.js use the same functions as the stage.
@@ -120,7 +212,9 @@ The entry `.` has pure functions. A page with no WebGL 2 and a test in Node.js u
120
212
  | `fitDistance`, `capDistance` | The distance at which the camera shows points, or a cap of a ball. |
121
213
  | `cameraPosition`, `viewOf` | The position of a camera from its place, and the place from its position. |
122
214
  | `placeBetween`, `moveAt`, `easeInOut` | A place on the way between two places, and the place at a time of a move. |
215
+ | `ballView` | A view that shows points on a ball, from above their middle. |
123
216
  | `clampPlace`, `stageLimits` | A place in the limits of a stage, and the limits from the content. |
217
+ | `reachOf`, `nearDepth` | The radius of the ball that holds the content, and the nearest depth that the camera draws. |
124
218
  | `keyAction` | The action of a key. |
125
219
  | `markOf`, `isClick` | The mark of a record, and the difference between a click and a drag. |
126
220
  | `approach` | One step of a value to its goal, for a part that changes with time. |
@@ -180,6 +180,89 @@ function capView(angles, angle, margin = FIT_MARGIN) {
180
180
  };
181
181
  }
182
182
  /**
183
+ * 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
+ *
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.
186
+ * 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
+ */
188
+ function ballView(points, margin = FIT_MARGIN) {
189
+ let found;
190
+ return (frame) => {
191
+ const { center } = frame.extent;
192
+ if (found === void 0 || found.center.x !== center.x || found.center.y !== center.y || found.center.z !== center.z) found = {
193
+ center,
194
+ view: capOf(points, center, margin)
195
+ };
196
+ return found.view(frame);
197
+ };
198
+ }
199
+ /** This function makes the view of the cap of a ball around `center` that holds each point. */
200
+ function capOf(points, center, margin) {
201
+ const low = {
202
+ x: 1e400,
203
+ y: 1e400,
204
+ z: 1e400
205
+ };
206
+ const high = {
207
+ x: -1e400,
208
+ y: -1e400,
209
+ z: -1e400
210
+ };
211
+ for (const point of points) {
212
+ low.x = Math.min(low.x, point.x);
213
+ low.y = Math.min(low.y, point.y);
214
+ low.z = Math.min(low.z, point.z);
215
+ high.x = Math.max(high.x, point.x);
216
+ high.y = Math.max(high.y, point.y);
217
+ high.z = Math.max(high.z, point.z);
218
+ }
219
+ const middle = {
220
+ x: (low.x + high.x) / 2 - center.x,
221
+ y: (low.y + high.y) / 2 - center.y,
222
+ z: (low.z + high.z) / 2 - center.z
223
+ };
224
+ 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
+ }
239
+ const { polar, azimuth } = viewOf(middle, {
240
+ x: 0,
241
+ y: 0,
242
+ z: 0
243
+ });
244
+ return capView({
245
+ polar,
246
+ azimuth
247
+ }, angle, margin);
248
+ }
249
+ /** 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
+ function reachOf(extent) {
251
+ let reach = surfaceOf(extent);
252
+ 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));
253
+ return reach;
254
+ }
255
+ /**
256
+ * This function gives the nearest depth that a camera draws, from the distance of the camera to the center of the content.
257
+ *
258
+ * 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.
259
+ * The result is not less than the nearest depth of the limits, and it is in front of all the content.
260
+ */
261
+ function nearDepth(limits, extent, distance) {
262
+ const free = (distance - reachOf(extent)) / 8;
263
+ return free > limits.near ? Math.min(free, limits.far / 4) : limits.near;
264
+ }
265
+ /**
183
266
  * This function gives the limits of the camera of a stage for a picture.
184
267
  *
185
268
  * 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.
@@ -191,8 +274,7 @@ function stageLimits(frame, views, polar) {
191
274
  let widest = 0;
192
275
  for (const view of views) widest = Math.max(widest, view(frame).distance);
193
276
  if (!(widest > surface)) widest = surface + 1;
194
- let reach = surface;
195
- 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));
277
+ const reach = reachOf(extent);
196
278
  const minDistance = extent.minDistance ?? surface + (widest - surface) * .03;
197
279
  const maxDistance = Math.max(extent.maxDistance ?? surface + (widest - surface) * 3, minDistance);
198
280
  const height = Math.max(minDistance - surface, 1e-6);
@@ -205,134 +287,6 @@ function stageLimits(frame, views, polar) {
205
287
  far: (maxDistance + reach) * 1.5
206
288
  };
207
289
  }
208
- // src/keys.ts
209
- /** The angle of one step of an arrow key, in radians, for a camera far from the surface. */
210
- const KEY_TURN = Math.PI / 24;
211
- /** The factor of the height of a camera above the surface for one step of the key `+`. */
212
- const KEY_ZOOM = .85;
213
- /**
214
- * This function gives the action of a key on a stage, or `undefined` for a key with no action.
215
- *
216
- * The arrow keys turn the camera around the target. The keys `+` and `-` change the height above the surface.
217
- * The keys `Home` and `0` show the home view. Near the surface, a step of an arrow key is smaller.
218
- * The result has no limits: the stage puts the place in its limits.
219
- */
220
- function keyAction(key, now, options) {
221
- const surface = options.surface ?? 0;
222
- const turn = KEY_TURN * speedAt(now.distance, surface);
223
- const zoom = (factor) => ({
224
- ...now,
225
- distance: surface + (now.distance - surface) * factor
226
- });
227
- switch (key) {
228
- case "ArrowLeft": return {
229
- type: "place",
230
- place: {
231
- ...now,
232
- azimuth: now.azimuth - turn
233
- }
234
- };
235
- case "ArrowRight": return {
236
- type: "place",
237
- place: {
238
- ...now,
239
- azimuth: now.azimuth + turn
240
- }
241
- };
242
- case "ArrowUp": return {
243
- type: "place",
244
- place: {
245
- ...now,
246
- polar: now.polar - turn
247
- }
248
- };
249
- case "ArrowDown": return {
250
- type: "place",
251
- place: {
252
- ...now,
253
- polar: now.polar + turn
254
- }
255
- };
256
- case "+":
257
- case "=": return {
258
- type: "place",
259
- place: zoom(KEY_ZOOM)
260
- };
261
- case "-":
262
- case "_": return {
263
- type: "place",
264
- place: zoom(1 / KEY_ZOOM)
265
- };
266
- case "Home":
267
- case "0": return {
268
- type: "view",
269
- view: options.home
270
- };
271
- default: {
272
- const view = key.length === 1 ? options.views?.[key.toLowerCase()] : void 0;
273
- return view === void 0 ? void 0 : {
274
- type: "view",
275
- view
276
- };
277
- }
278
- }
279
- }
280
- // src/marks.ts
281
- /** The marks of a stage with no pointer on it and no selected record. */
282
- const NO_MARKS = {
283
- hovered: void 0,
284
- selected: void 0,
285
- marked: /* @__PURE__ */ new Set()
286
- };
287
- /** This function gives the mark of a record. The selected record has the highest mark. */
288
- function markOf(marks, record) {
289
- if (record === marks.selected) return 2;
290
- return record === marks.hovered || marks.marked.has(record) ? 1 : 0;
291
- }
292
- /** A pointer that moves this distance or less between down and up makes a click, in CSS pixels. */
293
- const CLICK_DISTANCE = 4;
294
- /**
295
- * This function tells if a pointer that went down and up made a click. A pointer that moved more than `limit` made a drag.
296
- * The positions and the limit are in CSS pixels.
297
- */
298
- function isClick(down, up, limit = 4) {
299
- return Math.hypot(up.x - down.x, up.y - down.y) <= limit;
300
- }
301
- // src/motion.ts
302
- /**
303
- * This function gives a part of a move with a slow start and a slow end. `part` goes from 0 to 1.
304
- * The result goes from 0 to 1, and it is 0.5 at the middle.
305
- */
306
- function easeInOut(part) {
307
- const clamped = Math.min(Math.max(part, 0), 1);
308
- return clamped < .5 ? 4 * clamped * clamped * clamped : 1 - (-2 * clamped + 2) ** 3 / 2;
309
- }
310
- /**
311
- * This function gives the place of a camera at the time `now` of a move, in milliseconds.
312
- * A move with no duration is at its end immediately. `surface` is the radius of the ball around the target, or 0 for no ball.
313
- */
314
- function moveAt(move, now, surface = 0) {
315
- const part = move.duration > 0 ? Math.min(Math.max((now - move.start) / move.duration, 0), 1) : 1;
316
- if (part >= 1) return {
317
- place: move.to,
318
- done: true
319
- };
320
- return {
321
- place: placeBetween(move.from, move.to, easeInOut(part), surface),
322
- done: false
323
- };
324
- }
325
- /**
326
- * This function moves a value one step to its goal. Each step goes a constant part of the way that remains.
327
- *
328
- * `seconds` is the time of the step, and `time` is the time in which the value goes most of the way, in seconds.
329
- * A step with no time gives the goal. A value nearer to the goal than `snap` becomes the goal, so the steps have an end.
330
- */
331
- function approach(value, goal, seconds, time, snap = .01) {
332
- if (!(seconds > 0) || !(time > 0)) return goal;
333
- const next = value + (goal - value) * (1 - Math.exp(0 - seconds / time));
334
- return Math.abs(goal - next) < snap ? goal : next;
335
- }
336
- export { viewAxes as C, turnBetween as S, capDistance as _, NO_MARKS as a, placeBetween as b, KEY_TURN as c, FIT_MARGIN as d, capView as f, cameraPosition as g, surfaceOf as h, CLICK_DISTANCE as i, KEY_ZOOM as l, stageLimits as m, easeInOut as n, isClick as o, fitView as p, moveAt as r, markOf as s, approach as t, keyAction as u, clampPlace as v, viewOf as w, speedAt as x, fitDistance as y };
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 };
337
291
 
338
- //# sourceMappingURL=motion-Ba4IIfAV.js.map
292
+ //# sourceMappingURL=extent-CALhBZU-.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extent-CALhBZU-.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 turn speed and 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/**\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. `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 view: StageView } | undefined;\n return (frame) => {\n const { center } = frame.extent;\n // The middle and the cap are the same for each picture of one content. So the function calculates them 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, view: capOf(points, center, margin) };\n }\n return found.view(frame);\n };\n}\n\n/** This function makes the view of the cap of a ball around `center` that holds each point. */\nfunction capOf(points: readonly Point3[], center: Point3, margin: number): StageView {\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 capView({ polar: Math.PI / 2, azimuth: 0 }, Math.PI / 2, margin);\n let angle = 0;\n for (const point of points) {\n const x = point.x - center.x;\n const y = point.y - center.y;\n const z = point.z - center.z;\n const distance = Math.hypot(x, y, z);\n if (!(distance > 0)) continue;\n const cosine = (x * middle.x + y * middle.y + z * middle.z) / (distance * length);\n angle = Math.max(angle, Math.acos(Math.min(Math.max(cosine, -1), 1)));\n }\n const { polar, azimuth } = viewOf(middle, { x: 0, y: 0, z: 0 });\n return capView({ polar, azimuth }, angle, margin);\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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"}
@@ -0,0 +1,192 @@
1
+ import { i as StageContent } from "./stage-C9NHD-6Q.js";
2
+ import { S as ViewAngles, d as StageView, t as StageTheme } from "./theme-CJ2SAcHX.js";
3
+ import { Raycaster } from "three";
4
+ import { LatLon, Region } from "@mark1russell7/geo";
5
+ import { Point3 } from "@mark1russell7/layout-contract";
6
+ /** The look of the areas and the points of one kind. Each color is a CSS hex color. */
7
+ interface GlobeStyle {
8
+ /** The color of the surface of an area, or of a point. An area with no color has no surface, and a point with no color is not in the picture. */
9
+ readonly fill?: string | undefined;
10
+ /** The part of the light that the surface of an area stops, from 0 to 1. The default is 1. */
11
+ readonly opacity?: number | undefined;
12
+ /** The color of the edge of an area, or of the ring around a point. An area with no color has no edge. */
13
+ readonly line?: string | undefined;
14
+ }
15
+ /** The colors of a globe. Each color is a CSS hex color. */
16
+ interface GlobeTheme extends StageTheme {
17
+ /** The color of the Earth where it has no area, for example the sea. */
18
+ readonly ball: string;
19
+ /** The color of the meridians and the parallels. */
20
+ readonly grid: string;
21
+ /** The color of the shade at the rim of the Earth. */
22
+ readonly shade: string;
23
+ /** The style of each kind of area or point, by the name of the kind. */
24
+ readonly styles: Readonly<Record<string, GlobeStyle>>;
25
+ /** The style of a kind that `styles` does not have. */
26
+ readonly other: GlobeStyle;
27
+ /** The color of the edge of a record under the pointer, or in the marked list. */
28
+ readonly hovered: string;
29
+ /** The color of the edge of the selected record. */
30
+ readonly selected: string;
31
+ }
32
+ /** An area of a globe: a region of the Earth that belongs to a record. */
33
+ interface GlobeArea<P> {
34
+ /** The name of the record. Two parts with one name are one record: the stage marks them together. */
35
+ readonly record: string;
36
+ /** The region, with edges that are straight lines in longitude and latitude, as in `@mark1russell7/geo`. */
37
+ readonly region: Region;
38
+ /** The name of the style of the area in the theme. */
39
+ readonly kind: string;
40
+ /** The value that a pick of the area gives to the page. */
41
+ readonly value: P;
42
+ /** This value is false for an area that the pointer does not find. The default is true. */
43
+ readonly pick?: boolean | undefined;
44
+ }
45
+ /** A point of a globe: a place on the Earth that belongs to a record. The picture shows it as a dot of a constant size. */
46
+ interface GlobePoint<P> {
47
+ /** The name of the record. Two parts with one name are one record: the stage marks them together. */
48
+ readonly record: string;
49
+ readonly place: LatLon;
50
+ /** The name of the style of the point in the theme. */
51
+ readonly kind: string;
52
+ /** The value that a pick of the point gives to the page. */
53
+ readonly value: P;
54
+ /** The width of the dot, in CSS pixels. The default is the option `pointSize` of the globe. */
55
+ readonly size?: number | undefined;
56
+ /** This value is false for a point that the pointer does not find. The default is true. */
57
+ readonly pick?: boolean | undefined;
58
+ }
59
+ /** The options of a globe. Each width is in CSS pixels. */
60
+ interface GlobeOptions<P> {
61
+ /** The areas, in the sequence of the picture: a later area is above an earlier area, and the pointer finds it first. */
62
+ readonly areas?: readonly GlobeArea<P>[] | undefined;
63
+ /** The points. Each point is above each area. */
64
+ readonly points?: readonly GlobePoint<P>[] | undefined;
65
+ /** The radius of the globe, in the units of the stage. The default is 1. */
66
+ readonly radius?: number | undefined;
67
+ /** The largest step of an edge in longitude or latitude, in degrees. A smaller step follows the curve of the Earth better. The default is 1. */
68
+ readonly step?: number | undefined;
69
+ /** The angle between two lines of the grid, in degrees. The value 0 gives no grid. The default is 15. */
70
+ readonly grid?: number | undefined;
71
+ /** The smallest height of the camera above the surface, as a part of the radius. The default is 0.005. */
72
+ readonly nearest?: number | undefined;
73
+ /** The width of the edge of an area. The default is 1.25. */
74
+ readonly lineWidth?: number | undefined;
75
+ /** The width of the edge of a record with a mark. The default is 2.5. */
76
+ readonly markWidth?: number | undefined;
77
+ /** The width of a line of the grid. The default is 1. */
78
+ readonly gridWidth?: number | undefined;
79
+ /** The width of the dot of a point. The default is 9. */
80
+ readonly pointSize?: number | undefined;
81
+ /** The strength of the shade at the rim of the Earth, from 0 to 1. The default is 0.4. */
82
+ readonly shade?: number | undefined;
83
+ }
84
+ /** The content of a stage that shows the Earth as a globe, with areas and points on it. */
85
+ interface GlobeContent<P> extends StageContent<P, GlobeTheme> {
86
+ /**
87
+ * This function shows only the areas and the points that a test accepts. A part that the picture does not show gets no pick.
88
+ * Start `refresh` of the stage after it. A test that accepts each part shows all of them again.
89
+ */
90
+ show(test: (part: GlobeArea<P> | GlobePoint<P>) => boolean): void;
91
+ /** This function gives the place on the Earth that a ray from the camera finds. A ray that does not find the Earth gives `undefined`. */
92
+ placeAt(ray: Raycaster): LatLon | undefined;
93
+ }
94
+ /**
95
+ * This function makes the content of a stage that shows the Earth as a globe. The center of the globe is the origin of the stage.
96
+ *
97
+ * The materials use no light, so each color in the picture is the color of the theme. Use `GLOBE_POLAR` and no pan in the options of the stage.
98
+ * The function throws an `Error` with the name of the record for an area that is not correct. Its cause is the error of `@mark1russell7/geo`.
99
+ */
100
+ export declare function createGlobe<P>(options?: GlobeOptions<P>): GlobeContent<P>;
101
+ /**
102
+ * The surface of a region as triangles. The region and the triangles are in the plane of longitude and latitude,
103
+ * as the polygon tests of `@mark1russell7/geo` are. So a triangle does not go across the antimeridian.
104
+ */
105
+ interface RegionSurface {
106
+ /** The longitude and the latitude of each corner, in degrees: two numbers for each corner. */
107
+ readonly corners: Float64Array;
108
+ /** The three corners of each triangle, as indices of corners. Each triangle is counterclockwise in the plane, with east on the right and north up. */
109
+ readonly triangles: Uint32Array;
110
+ }
111
+ /** The largest count of corners of the surface of one region. A smaller step gives more corners. */
112
+ export declare const MAX_SURFACE_CORNERS = 2e6;
113
+ /**
114
+ * This function gives the height of the flat triangles of a surface below a ball of radius 1, at most.
115
+ * A layer at this height above a ball does not go into the ball. `step` is the step of the surface, in degrees.
116
+ */
117
+ export declare function surfaceSag(step: number): number;
118
+ /**
119
+ * This function divides the surface of a region into triangles that follow the curve of the Earth.
120
+ *
121
+ * `step` is the largest step of an edge of the outline in longitude or latitude, in degrees. The outline is the outline of `densify` with this step:
122
+ * each edge of the outline of the surface is an edge of that outline. So a line through the points of `densify` is exactly on the outline of the surface.
123
+ * An edge in the surface is not longer than 1.25 steps. A step of longitude is as long as it is on the Earth at that latitude, and a quarter of a step at least.
124
+ *
125
+ * A straight edge in the plane is a curve on the Earth. So a flat triangle on a globe is not exactly the triangle in the plane.
126
+ * The difference is small for a small step. It is largest near a pole.
127
+ *
128
+ * The function throws a `GeoError` for a region or a step that is not correct, and a `RangeError` for a surface with too many corners.
129
+ */
130
+ export declare function regionSurface(region: Region, step: number, maxCorners?: number): RegionSurface;
131
+ /**
132
+ * This function gives the edges of a region as lines, for the outline that a person sees. Each line is a list of longitudes and latitudes, in degrees:
133
+ * two numbers for each point.
134
+ *
135
+ * `step` is the largest step of a line in longitude or latitude, in degrees. The points are the points of `densify`, so they are corners of `regionSurface`.
136
+ * An edge that is only a cut gets no line. A cut is an edge along a pole, or an edge on the antimeridian with an edge of the region on its other side.
137
+ */
138
+ export declare function regionEdges(region: Region, step: number): Float64Array[];
139
+ /**
140
+ * This function gives the lines of a grid of meridians and parallels. Each line is a list of longitudes and latitudes, in degrees: two numbers for each point.
141
+ *
142
+ * `spacing` is the angle between two lines, in degrees, and `step` is the largest step of a line. A spacing of 0 or less gives no lines.
143
+ * The meridians at each 90 degrees go to the poles. The other meridians stop one spacing before each pole, so the poles stay clear.
144
+ */
145
+ export declare function gridLines(spacing: number, step: number): Float64Array[];
146
+ /**
147
+ * The polar limits of the camera of a globe: the camera goes above each pole.
148
+ * Give this value to the option `polar` of a stage. Set the option `pan` to false, so the camera turns around the center of the Earth.
149
+ */
150
+ export declare const GLOBE_POLAR: {
151
+ readonly min: number;
152
+ readonly max: number;
153
+ };
154
+ /**
155
+ * This function gives the point of a globe for a place on the Earth. The center of the globe is the origin of the stage.
156
+ *
157
+ * The axis `y` of the stage goes to the north pole. The axis `z` goes to latitude 0 and longitude 0, and the axis `x` goes to latitude 0 and longitude 90 east.
158
+ * `radius` is the distance of the point from the center. The default is 1.
159
+ */
160
+ export declare function globePoint(place: LatLon, radius?: number): Point3;
161
+ /**
162
+ * This function gives the place on the Earth in the direction of a point of the stage, as seen from the center of the globe.
163
+ * The center of the globe has no direction, so it gives `undefined`.
164
+ */
165
+ export declare function globePlace(point: Point3): LatLon | undefined;
166
+ /** This function gives the direction of a camera that is above a place on the Earth. */
167
+ export declare function globeAngles(place: LatLon): ViewAngles;
168
+ /**
169
+ * This function makes a view from above a place on the Earth. The picture shows the cap of the Earth around the place.
170
+ *
171
+ * `degrees` is the angle of the cap at the center of the Earth. It is the distance from the place to the edge of the cap, in degrees of a great circle.
172
+ * The default is 90: the picture shows a half of the Earth. `margin` is the space around the cap, as a factor of the height above the surface.
173
+ */
174
+ export declare function globeView(place: LatLon, degrees?: number, margin?: number): StageView;
175
+ /**
176
+ * This function makes a view that shows each region of a list. The camera is above the middle of the regions.
177
+ * 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.
178
+ */
179
+ export declare function regionView(regions: readonly Region[], margin?: number): StageView;
180
+ /**
181
+ * This function gives the first point of a ball that a ray finds. The center of the ball is the origin of the stage.
182
+ *
183
+ * `direction` has the length 1. A ray that does not find the ball gives `undefined`, and a ray that starts in the ball also gives `undefined`.
184
+ */
185
+ export declare function rayBall(origin: Point3, direction: Point3, radius: number): Point3 | undefined;
186
+ /**
187
+ * This function tells if a camera at `eye` sees a point of the surface of a ball. The center of the ball is the origin of the stage.
188
+ * A point on the far side of the ball gives false.
189
+ */
190
+ export declare function inSight(point: Point3, eye: Point3, radius: number): boolean;
191
+ export type { GlobeArea, GlobeContent, GlobeOptions, GlobePoint, GlobeStyle, GlobeTheme, RegionSurface };
192
+ //# sourceMappingURL=globe.d.ts.map
@@ -0,0 +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;;;;;;;;wBAwJX,YAAY,GAAG,UAAS,aAAa,KAAU,aAAa;;;;;UCxQ3D;;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"}