lk3d 0.1.0 → 0.2.0
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/CHANGELOG.md +35 -0
- package/README.md +19 -6
- package/bin/lk3d.mjs +24 -13
- package/dist/lk3d-export.min.js +1 -1
- package/dist/lk3d.min.js +55 -23
- package/dist/lk3d.mjs +55 -23
- package/docs/api.md +105 -24
- package/docs/design.md +10 -7
- package/docs/performance.md +41 -10
- package/docs/scene-format.md +30 -29
- package/index.d.ts +49 -2
- package/package.json +1 -3
- package/scene.d.ts +96 -1
- package/schema/scene.schema.json +165 -1
- package/skill/lk3d/SKILL.md +11 -1
- package/src/ao.js +58 -0
- package/src/controls.js +21 -2
- package/src/element.js +111 -0
- package/src/figure/api.js +12 -2
- package/src/figure/camera.js +49 -9
- package/src/figure/context.d.ts +23 -1
- package/src/figure/idle.js +57 -19
- package/src/figure/input.js +81 -7
- package/src/figure/labels.js +12 -9
- package/src/figure/loop.js +6 -2
- package/src/figure/pick.js +19 -5
- package/src/figure/steps.js +143 -0
- package/src/flow.js +33 -2
- package/src/index.js +13 -2
- package/src/locales/en.js +6 -0
- package/src/locales/vi.js +6 -0
- package/src/renderer-gl.js +85 -15
- package/src/shaders.js +39 -1
- package/src/stylesheet.js +10 -2
- package/src/validate.js +50 -0
- package/docs/flow.png +0 -0
- package/docs/generator.png +0 -0
- package/docs/pen-blueprint.png +0 -0
- package/docs/pen-dark.png +0 -0
- package/docs/pen-ortho.png +0 -0
- package/docs/shapes/blade.png +0 -0
- package/docs/shapes/blob.png +0 -0
- package/docs/shapes/box.png +0 -0
- package/docs/shapes/capsule.png +0 -0
- package/docs/shapes/cylinder.png +0 -0
- package/docs/shapes/dna.png +0 -0
- package/docs/shapes/ellipsoid.png +0 -0
- package/docs/shapes/extrude.png +0 -0
- package/docs/shapes/helix.png +0 -0
- package/docs/shapes/lathe.png +0 -0
- package/docs/shapes/loop.png +0 -0
- package/docs/shapes/molecule.png +0 -0
- package/docs/shapes/orbit.png +0 -0
- package/docs/shapes/ring.png +0 -0
- package/docs/shapes/scatter.png +0 -0
- package/docs/shapes/shell.png +0 -0
- package/docs/shapes/sphere.png +0 -0
- package/docs/shapes/terrain.png +0 -0
- package/docs/shapes/torus.png +0 -0
- package/docs/shapes/tree.png +0 -0
- package/docs/shapes/tube.png +0 -0
package/docs/api.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# API
|
|
2
2
|
|
|
3
3
|
```js
|
|
4
|
-
// a page: one script tag, the global LK3D (https://unpkg.com/lk3d@0.
|
|
5
|
-
<script src="https://unpkg.com/lk3d@0.
|
|
4
|
+
// a page: one script tag, the global LK3D (https://unpkg.com/lk3d@0.2.0/dist/lk3d.min.js, or a copy of dist/lk3d.min.js)
|
|
5
|
+
<script src="https://unpkg.com/lk3d@0.2.0/dist/lk3d.min.js"></script>;
|
|
6
6
|
// or a module
|
|
7
7
|
import LK3D, { mount, build, defaults, locales } from 'lk3d';
|
|
8
8
|
```
|
|
@@ -16,25 +16,29 @@ the part's name and note, not what the pointer passes over), and every named par
|
|
|
16
16
|
list after the figure (not drawn on the page). Every handle is also a range input for the keyboard and screen
|
|
17
17
|
readers.
|
|
18
18
|
|
|
19
|
-
| Option
|
|
20
|
-
|
|
|
21
|
-
| `info`, `infoIdle`
|
|
22
|
-
| `controls`
|
|
23
|
-
| `
|
|
24
|
-
| `
|
|
25
|
-
| `
|
|
26
|
-
| `
|
|
27
|
-
| `
|
|
28
|
-
| `
|
|
29
|
-
| `
|
|
30
|
-
| `
|
|
31
|
-
| `
|
|
32
|
-
| `
|
|
33
|
-
| `
|
|
34
|
-
| `
|
|
35
|
-
| `
|
|
36
|
-
| `
|
|
37
|
-
| `
|
|
19
|
+
| Option | Default | Meaning |
|
|
20
|
+
| ----------------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
21
|
+
| `info`, `infoIdle` | | an element that shows the name and note of the part pointed at (only `b i em strong sub sup br` kept as HTML; the rest as text); what it says when none is |
|
|
22
|
+
| `controls` | `true` | `false`: no built-in buttons (build your own with the figure's methods) |
|
|
23
|
+
| `steps` | `controls` | `false`: no panel for the scene's [guided steps](#guided-steps) under the figure (the page goes through them with `step()`) |
|
|
24
|
+
| `step` | `0` | the step the figure starts at, by its place (from 0) or id; `-1`: before the first, the figure at its own start |
|
|
25
|
+
| `onSection({normal, offset})` | | the cut moved by the reader, by dragging its face or by its slider (not by the page's own `set()`) |
|
|
26
|
+
| `onStep(index, step)` | | the reader went to another step with the panel's Back or Next (not the page's own `step()`) |
|
|
27
|
+
| `style` | scene's, else `'pen'` | the first look: `'pen'`, `'studio'` or `'ink'` |
|
|
28
|
+
| `theme` | scene's, else none | the colours: `'light'`, `'dark'`, `'blueprint'`, `'sepia'`, `'auto'`, or a name added to `LK3D.themes` |
|
|
29
|
+
| `labels` | `'auto'` | `'auto'` (on hover and when taken apart), `'all'`, `'none'`, or `[ids or groups]`: exactly those parts' labels |
|
|
30
|
+
| `transparent` | `false` | `true`: nothing painted behind the model, in any look and theme (the canvas is clear; the theme's lines, solids and words still apply) |
|
|
31
|
+
| `onPick(part)` | | a part chosen by the reader (a tap, a click, a handle reached by Tab), or `null` when they let it go; a part is `{ id, name, note, group, min, max, center, triangleCount }` (its box's corners and middle in the scene) |
|
|
32
|
+
| `onHover(part)` | | the part under the pointer as it moves onto one, or `null` as it moves off |
|
|
33
|
+
| `onHandle(id, value)` | | a handle moved by the reader (not by the page's own `handle(id).set`) |
|
|
34
|
+
| `handleText(id, value)` | | what a screen reader says for a handle's value, e.g. `` `d = ${v} cm` `` |
|
|
35
|
+
| `locale`, `strings` | `'en'` | the language of the built-in words (`'en'`, `'vi'`, or any key of `LK3D.locales`); single words changed |
|
|
36
|
+
| `buttonClass` | lk3d's own | the page's class for the built-in buttons |
|
|
37
|
+
| `quality` | 1 (0.6 on small screens) | shape detail |
|
|
38
|
+
| `maxTriangles` | 1 million or 10 million | the most triangles the scene may have here: 1 million where memory is small (a screen under 700 px a side, or `navigator.deviceMemory` under 4 GB), else 10 million (2 million a part); over it, the scene is built coarser, down to a quarter of `quality`, else refused |
|
|
39
|
+
| `validate` | the engine's guard | the full rules to check the scene by before it is built: `validate` from `lk3d/validate`; its first problem is thrown |
|
|
40
|
+
| `maxDpr`, `adaptive`, `ao` | 3, `true`, `true` | the highest pixel density; lowering resolution while frames run late; crease shading |
|
|
41
|
+
| `force2d`, `webgl1` | | for testing: the Canvas 2D fallback, or WebGL 1 |
|
|
38
42
|
|
|
39
43
|
`LK3D.defaults` (`locale`, `strings`, `buttonClass`) sets these for every figure on a page.
|
|
40
44
|
|
|
@@ -64,9 +68,11 @@ try {
|
|
|
64
68
|
| `view(name or [yaw, pitch] or {yaw, pitch, dist, zoom, target}, {ms})` | glide the camera: `'front'`, `'side'`, `'top'`, `'iso'`, `'home'`; `zoom`: how close (2: twice as close as the whole model); `ms`: how long the glide takes (600; 0: at once) |
|
|
65
69
|
| `zoom(factor, x, y)`, `zoomLevel` | zoom by a factor towards a point of the stage (what is under it stays under it), as the wheel and a pinch do; how close the view is (the scene's `view.minZoom`, 0.02 by default, is the limit: 50 times closer) |
|
|
66
70
|
| `focus([ids or groups], {yaw, pitch, ms})` | frame those parts |
|
|
71
|
+
| `step(index or id, {ms})`, `currentStep`, `steps` | go to one of the scene's [guided steps](#guided-steps), gliding there (`ms: 0`: at once), without calling `onStep`; the step shown (from 0; `-1` for none); the scene's steps |
|
|
67
72
|
| `explode(0 or 1)` | take apart or put together, animated |
|
|
68
73
|
| `camera()` | `{yaw, pitch, dist, target}` (degrees, scene units) |
|
|
69
74
|
| `select(id or null)`, `selected` | choose a part (lit, its note shown) without calling `onPick`; the part chosen |
|
|
75
|
+
| `section` | the cut's plane now, `{normal, offset}`: the scene's, a step's, the page's, or where the reader moved it |
|
|
70
76
|
| `labels`, `style`, `theme`, `timeScale`, `renderer`, `hifi`, `parts` | the labels, look, theme and time scale in use; `'webgl2'`, `'webgl1'` or `'2d'`; the studio look's full lighting; the parts as built |
|
|
71
77
|
| `handle(id)` | `{ value, set(v) }` for a part with a handle ([handles](handles-and-lines.md)) |
|
|
72
78
|
| `motion(id)` | `{ value, playing, set(v), play(), stop() }` for a motion of the scene; `set({ motion: { id: value } })` sets several ([motions](handles-and-lines.md#motions-parts-that-move-together)) |
|
|
@@ -89,6 +95,77 @@ try {
|
|
|
89
95
|
The figure draws only when something changes and pauses while it is off screen. A page's own simulation is better on
|
|
90
96
|
its own `requestAnimationFrame`, telling the figure the new state with `set` and `redraw`.
|
|
91
97
|
|
|
98
|
+
## The element: `<lk3d-figure>`
|
|
99
|
+
|
|
100
|
+
The same script defines an HTML element for a page that writes no script of its own (Markdown, a content system, a
|
|
101
|
+
framework's template): a figure where the element is, with its controls, and a line under it with the name and note
|
|
102
|
+
of the part pointed at.
|
|
103
|
+
|
|
104
|
+
```html
|
|
105
|
+
<lk3d-figure src="generator.json" look="studio" locale="vi" step="rotor"></lk3d-figure>
|
|
106
|
+
|
|
107
|
+
<lk3d-figure labels="all">
|
|
108
|
+
<script type="application/json">
|
|
109
|
+
{ "title": "A bolt and a nut", "parts": [ … ] }
|
|
110
|
+
</script>
|
|
111
|
+
</lk3d-figure>
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
| Attribute | Meaning |
|
|
115
|
+
| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
116
|
+
| `src` | the scene's address (JSON); without it, a `<script type="application/json">` inside the element |
|
|
117
|
+
| `look`, `theme`, `labels`, `step` | the look, the theme, which labels show, the guided step (its place from 0, or its id): set as they change |
|
|
118
|
+
| `locale`, `controls="false"`, `steps="false"`, `info="false"`, `transparent` | the words; no buttons; no steps' panel; no line for the part's name and note; nothing painted behind (the figure is mounted again as they change) |
|
|
119
|
+
|
|
120
|
+
`element.figure` is the figure's API ([above](#the-figure); a new one each time the element mounts it again) and
|
|
121
|
+
`element.ready` resolves with the first, once complete. The reader's moves come as events that bubble:
|
|
122
|
+
`lk3d-pick` (`{ id }`), `lk3d-handle` (`{ id, value }`), `lk3d-step` (`{ index, step }`), `lk3d-section`
|
|
123
|
+
(`{ normal, offset }`). A scene that cannot be fetched, read or drawn shows its problem in the element and sends
|
|
124
|
+
`lk3d-error` (`{ message }`). Taken out of the page, the element destroys its figure; put back, it draws it again.
|
|
125
|
+
|
|
126
|
+
## Guided steps
|
|
127
|
+
|
|
128
|
+
A scene's `steps` ([format](scene-format.md)) explain the figure in order. Each has its words (a `title`, `text`, or
|
|
129
|
+
both) and the state of the figure while it is shown: where the camera goes (`view`, `focus`), how far apart
|
|
130
|
+
(`explode`), the cut (`cut`, `section`), see-through (`xray`), which `labels` show, parts hidden (`hide`), a part
|
|
131
|
+
chosen (`select`), the motions' values (`motion`) and which play (`play`).
|
|
132
|
+
|
|
133
|
+
```json
|
|
134
|
+
"steps": [
|
|
135
|
+
{ "id": "whole", "title": "An AC generator", "text": "Turn the rotor and a current lights the lamp.", "view": "home" },
|
|
136
|
+
{ "id": "rotor", "title": "The rotor", "text": "Cut open: magnets turn inside the coils.", "cut": true,
|
|
137
|
+
"labels": ["magnet-n", "magnet-s"], "view": { "yaw": -20, "pitch": 16 } },
|
|
138
|
+
{ "id": "circuit", "title": "The circuit", "text": "Each half-turn turns the current round.",
|
|
139
|
+
"focus": ["circuit"], "select": "filament" }
|
|
140
|
+
]
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
The figure starts at the first step (or `opts.step`), and a panel under it shows the step's words with Back and Next;
|
|
144
|
+
its words are said aloud as the reader comes to each. Going to a step sets everything it describes, and what it leaves
|
|
145
|
+
out goes back to the figure's start: put together, not cut, see-through off, labels as `opts.labels` says, nothing
|
|
146
|
+
hidden or chosen, every motion at its start and stopped. So a step is the same picture however the reader came to it,
|
|
147
|
+
by Next, by Back or straight from the page. The camera is the exception: it moves only when the step gives a `view`
|
|
148
|
+
or parts to `focus` on, so a step that only changes what is shown leaves the reader's view alone. `focus` frames the
|
|
149
|
+
parts as they will be once the step has taken them apart, from the view's angles if it gives them. The explode, the
|
|
150
|
+
cut and the camera glide there together (at once when the reader asked for reduced motion). In between, the reader
|
|
151
|
+
explores as usual; the next step sets its own state again.
|
|
152
|
+
|
|
153
|
+
A page can go through the steps itself instead, say as the reader scrolls through its own text, with the panel left
|
|
154
|
+
out:
|
|
155
|
+
|
|
156
|
+
```js
|
|
157
|
+
const fig = LK3D.mount(el, scene, { steps: false });
|
|
158
|
+
for (const section of document.querySelectorAll('[data-step]'))
|
|
159
|
+
new IntersectionObserver(([entry]) => entry.isIntersecting && fig.step(section.dataset.step), {
|
|
160
|
+
threshold: 0.6,
|
|
161
|
+
}).observe(section);
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
`lk3d check` checks that what each step names exists (parts and groups, motions within their range), that a labelled
|
|
165
|
+
part has a label and is not hidden by the same step, and that a step cuts only where the scene offers a cut; `lk3d
|
|
166
|
+
render` draws each step as a picture of its own (`--poses steps`, with the others by default when the scene has
|
|
167
|
+
steps).
|
|
168
|
+
|
|
92
169
|
## Driving a figure from a timeline
|
|
93
170
|
|
|
94
171
|
A page whose every frame is a function of its own time `t` (a video renderer that seeks to any time and takes a
|
|
@@ -154,11 +231,13 @@ and the exporter apart: `lk3d/export` (lk3d with `fig.exportGLB()` working, and
|
|
|
154
231
|
| presses `+` or `=`, `-` | zooms in, out |
|
|
155
232
|
| presses Page Down, Page Up (canvas focused) | chooses the next, the previous named part on show (as a click: `onPick`, lit, its note shown and said); Escape lets it go |
|
|
156
233
|
| Tabs to a handle | reaches its range input: arrow keys, Page Up and Page Down move it |
|
|
234
|
+
| drags the cut face (the model cut open) | moves the cut along its normal, held within the parts it cuts (seen face on, up and down move it); the view stays; a tap chooses the part (`onSection`; not when the scene's `section` is `fixed`) |
|
|
157
235
|
|
|
158
236
|
Zoom stops at `view.minZoom` of the distance that fits the whole model (0.02: 50 times closer) and at three times that
|
|
159
237
|
distance going out. The built-in controls under the figure (each where the scene has a use for it) take it apart (a
|
|
160
|
-
slider and a button), cut it open,
|
|
161
|
-
|
|
238
|
+
slider and a button), cut it open (and, while it is, move the cut: a slider, the keys' way to do what dragging the
|
|
239
|
+
cut face does), see through, show all labels, go round the looks, glide to the views (front, side, top, home), and
|
|
240
|
+
give each named motion a slider and a play button. Labels whose place the cut has passed are not shown.
|
|
162
241
|
|
|
163
242
|
## The command line
|
|
164
243
|
|
|
@@ -186,4 +265,6 @@ runs. Flags go anywhere on the line.
|
|
|
186
265
|
Without a [theme](looks-and-materials.md#themes) (which sets them on the stage itself), the figure's colours and
|
|
187
266
|
lettering come from CSS variables a page sets on `:root` or any element around the figure:
|
|
188
267
|
`--lk3d-ink`, `--lk3d-paper`, `--lk3d-muted`, `--lk3d-accent` (focus), `--lk3d-warn` (the scale note),
|
|
189
|
-
`--lk3d-highlight` (pressed buttons)
|
|
268
|
+
`--lk3d-highlight` (pressed buttons) and `--lk3d-highlight-ink` (their words: dark by default, for the light
|
|
269
|
+
highlight; a page whose highlight is dark sets it light), `--lk3d-font` (labels in the drawn look). Printed, the
|
|
270
|
+
figure keeps its picture and a step's words, without the buttons and the hint.
|
package/docs/design.md
CHANGED
|
@@ -19,17 +19,19 @@ lk3d is about 8 000 lines of plain JavaScript (ES modules, no dependencies). Thi
|
|
|
19
19
|
| `src/figure/labels.js` | labels and leader lines (measured once, moved with transforms), the scale bar |
|
|
20
20
|
| `src/figure/pick.js` | picking: a ray through the stage against each part's bounding-volume trees |
|
|
21
21
|
| `src/figure/idle.js` | the work done in idle slices after the first picture (the trees, crease shading, edges) and `ready` |
|
|
22
|
-
| `src/figure/input.js` | the pointer, wheel and keys; handles grabbed and dragged, and each as a range input
|
|
22
|
+
| `src/figure/input.js` | the pointer, wheel and keys; handles grabbed and dragged, and each as a range input; the cut face dragged |
|
|
23
23
|
| `src/figure/additions.js`, `src/figure/api.js` | what a page adds (particles, flows, streams, lines); the figure's API |
|
|
24
|
+
| `src/figure/steps.js` | guided steps: going to one (everything it describes set, the rest back at the start; the cut swept in, the camera framing what it focuses on), and the panel of words with Back and Next |
|
|
24
25
|
| `src/geometry.js` | `Mesh` (positions, normals, indices, optional vertex colours and texture coordinates), the shapes for machines (lathe, cylinder, box, sphere, torus, tube, helix, loop), placement and repeats, `buildScene` (parts → batches), materials |
|
|
25
26
|
| `src/science.js` | the shapes for the sciences: ellipsoid, capsule, blob, shell, tree, molecule, dna, extrude, terrain, ring, orbit, blade, and a seeded random generator |
|
|
26
27
|
| `src/gltf.js` | reading `.glb` models (synchronously, from base64): nodes, quantized attributes, colours, texture coordinates and maps |
|
|
27
28
|
| `src/gltf-write.js` | writing a figure out as `.glb`: a node, mesh and material for each part, posed as shown, and each motion as an animation when asked |
|
|
28
29
|
| `src/export.js`, `src/export-script.js` | the exporter apart from the engine: `lk3d/export` (the module, with lk3d) and `dist/lk3d-export.min.js` (the script) |
|
|
29
|
-
| `src/flow.js` | streaks along paths: their geometry each frame (seeded, so pictures repeat)
|
|
30
|
+
| `src/flow.js` | streaks along paths: placed on the GPU on WebGL 2 from their paths and fixed numbers (gpuData), elsewhere their geometry each frame (seeded, so pictures repeat); the colour ramps, and the path measure particles share |
|
|
30
31
|
| `src/renderer-gl.js`, `src/shaders.js` | the WebGL 2 and WebGL 1 renderer and its shaders (written once, compiled as GLSL ES 1.00 or 3.00) |
|
|
31
32
|
| `src/renderer-2d.js` | the Canvas 2D fallback |
|
|
32
33
|
| `src/bvh.js` | bounding-volume trees: picking and ambient occlusion by rays on the CPU |
|
|
34
|
+
| `src/ao.js` | the crease shading worked out in a Web Worker made of lk3d's own script (the page's one worker; the same script, marked, answers its jobs), or nowhere, where none can be made |
|
|
33
35
|
| `src/math.js` | small vector and 4×4 matrix helpers (column-major, as WebGL wants them), colours |
|
|
34
36
|
| `src/changed.js` | whether what something was made from has changed since (values compared without garbage): a part's matrix, groups of parts alike, the shadow map, the liquids' bodies |
|
|
35
37
|
| `src/handles.js` | the handle maths: a pointer ray to an angle, a distance or a place along a path (pure, tested in Node) |
|
|
@@ -88,7 +90,7 @@ renderer = { kind: 'webgl2' | 'webgl1' | '2d', hifi, shadows, parallel,
|
|
|
88
90
|
A frame (WebGL 2, studio look): the shadow map (drawn again only when something that casts a shadow moves, the cut
|
|
89
91
|
changes or lines move, not when the camera turns); the outline; the solid parts; the ground's shadow; solid
|
|
90
92
|
particles; see-through parts far to near (glass that refracts samples a copy of the picture made just before); the
|
|
91
|
-
pen look's edges; path particles; flow streaks (ribbons widened on screen in the vertex shader, inked over a light page
|
|
93
|
+
pen look's edges; path particles; flow streaks (ribbons placed and widened on screen in the vertex shader, inked over a light page
|
|
92
94
|
or added to a dark one); streams (the solid parts' depth, drawn again only when they or the camera move; each stream,
|
|
93
95
|
far to near, marched once per pixel from its hull's farthest face into a half-size picture, put over the page); the
|
|
94
96
|
glow (emission at half resolution, blurred at a quarter, added). Every look has one sun, fixed in the scene: it shades the
|
|
@@ -137,7 +139,7 @@ Liquids and gases are shaped again only when a volume or a height changed.
|
|
|
137
139
|
Labels are HTML, measured once (canvas text metrics, cached, measured again when web fonts arrive) and moved with
|
|
138
140
|
transforms, so a frame never forces the page to lay itself out. Picking casts a ray on the CPU against each batch's
|
|
139
141
|
bounding-volume tree (built in idle slices just after the first picture) instead of reading a pixel back from the GPU.
|
|
140
|
-
Ambient occlusion is computed the same way, a
|
|
142
|
+
Ambient occlusion is computed the same way, by rays against each shape's tree, in a Web Worker (ao.js; on the page in idle slices where there is none), then uploaded.
|
|
141
143
|
|
|
142
144
|
## Handles
|
|
143
145
|
|
|
@@ -160,7 +162,7 @@ environments the engine draws.
|
|
|
160
162
|
instancing, picking against brute force), glTF reading and writing, handle maths, motions and joints, liquids and gases,
|
|
161
163
|
the validator and the geometry check against planted mistakes, the command line, the skill, the locales. `npm run
|
|
162
164
|
typecheck`: the sources (as JavaScript, against the types), the types, and every reference and example scene against
|
|
163
|
-
them. `npm run size`: the
|
|
165
|
+
them. `npm run size`: the 67 KB budget. `npm run test:visual`: 18 reference scenes in their looks
|
|
164
166
|
(some also in the 2D fallback, a theme or the orthographic camera) and the page API, compared with stored pictures
|
|
165
167
|
(`test/visual/`). Pictures are stored per browser and platform: Chromium and Firefox on macOS, and Chromium, Firefox
|
|
166
168
|
and WebKit on Linux (the CI workflow's). WebKit is skipped on macOS 14 and older (Playwright cannot drive it there).
|
|
@@ -179,8 +181,9 @@ schema makes.
|
|
|
179
181
|
a slider and a play button under the figure; liquids pouring and gases settling by their laws) or driven by the page
|
|
180
182
|
(spin, glow, particles, moved parts, a motion's value). There is no general physics engine; a page that simulates
|
|
181
183
|
writes its own model.
|
|
182
|
-
- The cut is one plane at a time: the scene's (`section`), which
|
|
183
|
-
(`set({ section, cut })`); the reader
|
|
184
|
+
- The cut is one plane at a time: the scene's (`section`), which the reader moves along its normal (dragging the cut
|
|
185
|
+
face, or its slider) and a page can move, turn or sweep through the model (`set({ section, cut })`); the reader
|
|
186
|
+
cannot turn it, nor cut along a second plane.
|
|
184
187
|
- Ambient occlusion is computed per part (a part's own creases and hollows), not between parts.
|
|
185
188
|
- The 2D fallback has no section view (its button is not offered) and no shadows, and draws balls without sorting them
|
|
186
189
|
by depth; WebGL 1 has no cast shadows, no glow halo, no surface detail, refraction or textures.
|
package/docs/performance.md
CHANGED
|
@@ -7,18 +7,18 @@ it, keep the tab in front, press Run).
|
|
|
7
7
|
|
|
8
8
|
## Size
|
|
9
9
|
|
|
10
|
-
The global script `dist/lk3d.min.js`, built by `npm run build`. The budget is
|
|
10
|
+
The global script `dist/lk3d.min.js`, built by `npm run build`. The budget is 67 KB gzipped (57 KB until November 2026; 60 when the engine began checking scenes and models itself; 65 for room to grow; 67 for guided steps, the cut the reader moves, the element, and streaks and crease shading off the main thread): `npm run size` fails past
|
|
11
11
|
it, and the CI workflow runs it. The glTF exporter is a script of its own, `dist/lk3d-export.min.js` (3.8 KB, 2.0 KB
|
|
12
12
|
gzipped), outside the budget: a page loads it only to export.
|
|
13
13
|
|
|
14
14
|
| | Minified | Gzipped |
|
|
15
15
|
| --------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- |
|
|
16
|
+
| lk3d 0.2.0 | 166.0 KB | 64.9 KB |
|
|
16
17
|
| lk3d 0.1.0 | 148.0 KB | 59.2 KB |
|
|
17
18
|
| three.js r187, the smallest page (renderer, camera, box, basic material) | 522 KB | 131 KB |
|
|
18
19
|
| three.js r187 with what lk3d does (PBR and glass, shadows, environment, orbit controls, picking, glTF, labels, bloom, shape generators) | 708 KB | 181 KB |
|
|
19
20
|
|
|
20
|
-
Measured with esbuild (minify, ES2020) and gzip level 9 (lk3d by `npm run size`,
|
|
21
|
-
under the budget; three.js, 2 November 2026).
|
|
21
|
+
Measured with esbuild (minify, ES2020) and gzip level 9 (lk3d by `npm run size`, 11 November 2026: 66 455 bytes, 2 153 under the budget; three.js, 2 November 2026).
|
|
22
22
|
|
|
23
23
|
## Frames
|
|
24
24
|
|
|
@@ -40,9 +40,9 @@ Apple M3 Pro laptop, Chrome, 120 Hz screen (8.3 ms per frame), 2 November 2026.
|
|
|
40
40
|
|
|
41
41
|
Every scene kept the screen's rate. The pen look's edges cost no script: they are found once, in idle time after the
|
|
42
42
|
first picture, and drawn by the GPU. The jet engine's rows were measured again after it was rebuilt on its test stand
|
|
43
|
-
(twice the triangles: the stand, flanges and bolts, casings in halves). Flow streaks
|
|
44
|
-
|
|
45
|
-
|
|
43
|
+
(twice the triangles: the stand, flanges and bolts, casings in halves). Flow streaks were the one thing whose script
|
|
44
|
+
grew with what is drawn, each placed on the CPU every frame it moved (about 0.6 ms for 2000 here); on WebGL 2 the GPU
|
|
45
|
+
places them now (below). On this machine the GPU's cost hides under the 120 Hz frame, so the numbers that
|
|
46
46
|
matter most come from phones.
|
|
47
47
|
|
|
48
48
|
## On a phone-like device
|
|
@@ -64,13 +64,44 @@ percentile, on a 60 Hz screen.
|
|
|
64
64
|
| Solar System | 11 332 | 6× | 132 | 154 | 340 | 887 | 16.7 / 16.7 |
|
|
65
65
|
| Molecules | 26 856 | 6× | 224 | 245 | 562 | 6 836 | 16.7 / 16.7 |
|
|
66
66
|
|
|
67
|
-
The first picture comes within a third of a second even at 6×. The crease shading
|
|
68
|
-
CPU on the molecules at 6×),
|
|
69
|
-
|
|
70
|
-
|
|
67
|
+
The first picture comes within a third of a second even at 6×. The crease shading was the slow part (up to 7 s of
|
|
68
|
+
CPU on the molecules at 6×), done on the page in idle slices of a few milliseconds that wait while the reader turns
|
|
69
|
+
the figure. Since 11 November 2026 it is worked out in a Web Worker made of lk3d's own script (the file a `<script src>`
|
|
70
|
+
loaded, or an inline script's text: nothing more to ship), off the page's main thread, and without the slices' pauses
|
|
71
|
+
it finishes sooner: at 1× (the CPU slowdown does not reach a worker, so only 1× compares fairly), shading done
|
|
72
|
+
in ms from mounting, `node test/bench/phone.mjs` with the engine before and after:
|
|
73
|
+
|
|
74
|
+
| Scene | On the page, in idle slices | In the worker |
|
|
75
|
+
| ----------- | --------------------------- | ------------- |
|
|
76
|
+
| Animal cell | 970 | 353 |
|
|
77
|
+
| Jet engine | 536 | 245 |
|
|
78
|
+
| Molecules | 2 170 | 572 |
|
|
79
|
+
|
|
80
|
+
Where no worker can be made (lk3d imported as a module, a page whose policy forbids workers) the figure shades on the
|
|
81
|
+
page in idle slices, as before; `fig.stats().aoWorker` says which. What this cannot show is a phone's GPU: frames held the
|
|
71
82
|
screen's rate here because the laptop's GPU did the drawing. A real low-end phone (and its browser) is still the
|
|
72
83
|
measurement that matters.
|
|
73
84
|
|
|
85
|
+
## Flow streaks
|
|
86
|
+
|
|
87
|
+
`node test/bench/flow.mjs`: the ducted fan of the image tests with n streaks between its two flows, moving, each frame
|
|
88
|
+
drawn with `drawNow()` and timed (lk3d's own work, median / 95th percentile in ms; the GPU's work is not in it).
|
|
89
|
+
Headless Chromium on the same laptop (Metal), 11 November 2026.
|
|
90
|
+
|
|
91
|
+
| Streaks | CPU | Placed on the CPU (before) | Placed on the GPU (WebGL 2) |
|
|
92
|
+
| ------- | --- | -------------------------- | --------------------------- |
|
|
93
|
+
| 2 000 | 1× | 0.5 / 0.7 | 0.0 / 0.1 |
|
|
94
|
+
| 8 000 | 1× | 2.0 / 2.3 | 0.0 / 0.2 |
|
|
95
|
+
| 2 000 | 6× | 3.6 / 4.9 | 0.1 / 1.3 |
|
|
96
|
+
| 8 000 | 6× | 13.7 / 16.6 | 0.1 / 1.3 |
|
|
97
|
+
|
|
98
|
+
Each streak used to be placed on the CPU every frame it moved, and its geometry sent to the GPU again (over 2 MB a
|
|
99
|
+
frame at 8 000). On WebGL 2 each flow's paths go to the GPU once, as a float texture (a row a path: each point and its
|
|
100
|
+
distance along), and its streaks' fixed numbers as instance attributes; the vertex shader places each corner from the
|
|
101
|
+
time travelled, finding its place along the path by halving, so a frame sends one number a flow. WebGL 1 and the 2D
|
|
102
|
+
fallback still place them on the CPU. What this moves to the GPU (three lookups of up to 16 steps a corner) is still to
|
|
103
|
+
be measured on a phone's GPU.
|
|
104
|
+
|
|
74
105
|
## Many parts
|
|
75
106
|
|
|
76
107
|
How far lk3d scales with the number of parts, measured with `node lessonkit/js/bench.cjs`: n small assemblies on a
|
package/docs/scene-format.md
CHANGED
|
@@ -11,35 +11,36 @@ A shape, a motion, a joint, a vessel, a liquid and a gas take only the fields li
|
|
|
11
11
|
|
|
12
12
|
A 3D figure as data: parts made of shapes, each with a name and a note, that the reader turns, takes apart, cuts open and moves. Every field is one of the format's, so a misspelt one is caught; a page's own data goes under extras.
|
|
13
13
|
|
|
14
|
-
| Field | Type | Meaning
|
|
15
|
-
| ------------------ | --------------------------------------------------------------- |
|
|
16
|
-
| `lk3d` | `1` | The version of this format the scene is written in (1). Optional; a later engine that changes the format reads older versions.
|
|
17
|
-
| `w` | number > 0 | The stage's width in proportion to h (16 by default).
|
|
18
|
-
| `h` | number > 0 | The stage's height in proportion to w (10 by default).
|
|
19
|
-
| `narrow` | string | The stage's proportions on a narrow screen, e.g. "1 / 0.9".
|
|
20
|
-
| `title` | string | What the figure shows; also the canvas's label when alt is not given.
|
|
21
|
-
| `author` | string | Who made the figure: credited under it (© author), and written into an exported .glb.
|
|
22
|
-
| `license` | string | The terms the figure is under ("CC BY-NC-ND 4.0", "all rights reserved"): credited under it, after its author, and written into an exported .glb.
|
|
23
|
-
| `url` | string | Where the figure comes from: a web address (http or https), which the author's name in the credit links to.
|
|
24
|
-
| `alt` | string | A description of the model for screen readers.
|
|
25
|
-
| `style` | `"ink"` \| `"studio"` \| `"pen"` | The first look: pen (near-white, thin lines; the default), studio (realistic) or ink (drawn).
|
|
26
|
-
| `theme` | `"light"` \| `"dark"` \| `"blueprint"` \| `"sepia"` \| `"auto"` | The colours of the page behind the model, its lines and words (auto: light or dark, as the reader's system is set). None: each look's own.
|
|
27
|
-
| `env` | `"studio"` \| `"warm"` \| `"night"` | The studio look's environment.
|
|
28
|
-
| `view` | object | The first camera.
|
|
29
|
-
| `edges` | boolean | Lines where a part's faces meet at an angle: drawn in the pen look unless false; true draws them in every look.
|
|
30
|
-
| `check` | object | What the geometry check (lk3d check, lk3d/lint) is to excuse, by name: what the scene means on purpose.
|
|
31
|
-
| `ground` | boolean | A shadow under the model (true by default).
|
|
32
|
-
| `section` | `false` or object | The cut: a plane, or false to offer none. What lies on the side its normal points to, beyond offset along it, is cut away; a page may move it (set({ section }))
|
|
33
|
-
| `motions` | list of object | Parts that move together as one value goes along a range: a piston's stroke as the crank turns, a sleeve sliding back, a valve opening. Set or played by the page (fig.motion(id)) and, when named, by the reader (a slider and a play button); run through its range by the geometry check.
|
|
34
|
-
| `joints` | list of object | Parts posed by how they are joined, not by keys for each: a crank driven by a motion, a piston held by its rod, a rod aimed at the crank pin, a cam that follows at half speed. A joint's value comes from a motion, another joint, a rod, an aim, or the page (set({ joints })).
|
|
35
|
-
| `scale` | object | Honest scale: a bar that keeps its true length as the view zooms, and/or a note saying what is not to scale.
|
|
36
|
-
| `models` | map of name → object | glTF 2.0 models (.glb) by name, for {model: name} shapes.
|
|
37
|
-
| `unit` | `"mm"` \| `"cm"` \| `"dm"` \| `"m"` \| `"km"` | What one scene unit is (m): the laws of liquids and gases (g, R) are worked out in it.
|
|
38
|
-
| `vessels` | list of object | Parts that hold liquids or a gas: the radius of their inside at each height, and an outlet they pour through.
|
|
39
|
-
| `liquids` | list of object | Liquids in vessels, drawn by lk3d as bodies that fill their vessel to the level their volume gives; liquids in one vessel stack by density; an open outlet pours by Torricelli's law into the liquid below.
|
|
40
|
-
| `gases` | list of object | Gases under a piston: the piston rests where pV = nRT puts it (n moles at T kelvin under p pascals and the piston's weight).
|
|
41
|
-
| `extras` | object | The page's own data about the figure (as glTF's extras): lk3d keeps it and does not read it.
|
|
42
|
-
| `parts` (required) | list of object | The parts of the model, each a list of shapes with a name and a note.
|
|
14
|
+
| Field | Type | Meaning |
|
|
15
|
+
| ------------------ | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
16
|
+
| `lk3d` | `1` | The version of this format the scene is written in (1). Optional; a later engine that changes the format reads older versions. |
|
|
17
|
+
| `w` | number > 0 | The stage's width in proportion to h (16 by default). |
|
|
18
|
+
| `h` | number > 0 | The stage's height in proportion to w (10 by default). |
|
|
19
|
+
| `narrow` | string | The stage's proportions on a narrow screen, e.g. "1 / 0.9". |
|
|
20
|
+
| `title` | string | What the figure shows; also the canvas's label when alt is not given. |
|
|
21
|
+
| `author` | string | Who made the figure: credited under it (© author), and written into an exported .glb. |
|
|
22
|
+
| `license` | string | The terms the figure is under ("CC BY-NC-ND 4.0", "all rights reserved"): credited under it, after its author, and written into an exported .glb. |
|
|
23
|
+
| `url` | string | Where the figure comes from: a web address (http or https), which the author's name in the credit links to. |
|
|
24
|
+
| `alt` | string | A description of the model for screen readers. |
|
|
25
|
+
| `style` | `"ink"` \| `"studio"` \| `"pen"` | The first look: pen (near-white, thin lines; the default), studio (realistic) or ink (drawn). |
|
|
26
|
+
| `theme` | `"light"` \| `"dark"` \| `"blueprint"` \| `"sepia"` \| `"auto"` | The colours of the page behind the model, its lines and words (auto: light or dark, as the reader's system is set). None: each look's own. |
|
|
27
|
+
| `env` | `"studio"` \| `"warm"` \| `"night"` | The studio look's environment. |
|
|
28
|
+
| `view` | object | The first camera. |
|
|
29
|
+
| `edges` | boolean | Lines where a part's faces meet at an angle: drawn in the pen look unless false; true draws them in every look. |
|
|
30
|
+
| `check` | object | What the geometry check (lk3d check, lk3d/lint) is to excuse, by name: what the scene means on purpose. |
|
|
31
|
+
| `ground` | boolean | A shadow under the model (true by default). |
|
|
32
|
+
| `section` | `false` or object | The cut: a plane, or false to offer none. What lies on the side its normal points to, beyond offset along it, is cut away; while the model is cut open the reader moves the plane along its normal (dragging the cut face, or the slider) unless it is fixed, and a page may move it (set({ section })) |
|
|
33
|
+
| `motions` | list of object | Parts that move together as one value goes along a range: a piston's stroke as the crank turns, a sleeve sliding back, a valve opening. Set or played by the page (fig.motion(id)) and, when named, by the reader (a slider and a play button); run through its range by the geometry check. |
|
|
34
|
+
| `joints` | list of object | Parts posed by how they are joined, not by keys for each: a crank driven by a motion, a piston held by its rod, a rod aimed at the crank pin, a cam that follows at half speed. A joint's value comes from a motion, another joint, a rod, an aim, or the page (set({ joints })). |
|
|
35
|
+
| `scale` | object | Honest scale: a bar that keeps its true length as the view zooms, and/or a note saying what is not to scale. |
|
|
36
|
+
| `models` | map of name → object | glTF 2.0 models (.glb) by name, for {model: name} shapes. |
|
|
37
|
+
| `unit` | `"mm"` \| `"cm"` \| `"dm"` \| `"m"` \| `"km"` | What one scene unit is (m): the laws of liquids and gases (g, R) are worked out in it. |
|
|
38
|
+
| `vessels` | list of object | Parts that hold liquids or a gas: the radius of their inside at each height, and an outlet they pour through. |
|
|
39
|
+
| `liquids` | list of object | Liquids in vessels, drawn by lk3d as bodies that fill their vessel to the level their volume gives; liquids in one vessel stack by density; an open outlet pours by Torricelli's law into the liquid below. |
|
|
40
|
+
| `gases` | list of object | Gases under a piston: the piston rests where pV = nRT puts it (n moles at T kelvin under p pascals and the piston's weight). |
|
|
41
|
+
| `extras` | object | The page's own data about the figure (as glTF's extras): lk3d keeps it and does not read it. |
|
|
42
|
+
| `parts` (required) | list of object | The parts of the model, each a list of shapes with a name and a note. |
|
|
43
|
+
| `steps` | list of object | Guided steps: the figure explained in order, each with its words and a state of the figure (where the camera looks, taken apart, cut open, labels, a part chosen, motions). The figure starts at the first; the reader goes through them with Back and Next under it, the page with fig.step(). |
|
|
43
44
|
|
|
44
45
|
## Part
|
|
45
46
|
|
package/index.d.ts
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
// (Scene, Part, Shape, Handle, Motion, Joint, …) are generated from schema/scene.schema.json into scene.d.ts and
|
|
3
3
|
// re-exported from here.
|
|
4
4
|
|
|
5
|
-
import type { Scene, Look, SceneTheme, Vec3, Color, JointFields } from './scene.js';
|
|
5
|
+
import type { Scene, Look, SceneTheme, Vec3, Color, JointFields, Step } from './scene.js';
|
|
6
6
|
export * from './scene.js';
|
|
7
7
|
|
|
8
8
|
/** the themes lk3d has by name (a scene may also say 'auto') */
|
|
@@ -68,6 +68,14 @@ export interface Strings {
|
|
|
68
68
|
home: string;
|
|
69
69
|
play: string;
|
|
70
70
|
pause: string;
|
|
71
|
+
/** the slider that moves the cut, while it is on, and what a screen reader calls it */
|
|
72
|
+
cutAt: string;
|
|
73
|
+
cutAtLabel: string;
|
|
74
|
+
/** the guided steps' panel, its buttons, and where the reader is ("{n}" and "{count}" are filled in) */
|
|
75
|
+
steps: string;
|
|
76
|
+
back: string;
|
|
77
|
+
next: string;
|
|
78
|
+
stepOf: string;
|
|
71
79
|
/** the decimal mark in numbers read out (handles) */
|
|
72
80
|
decimal: string;
|
|
73
81
|
}
|
|
@@ -76,8 +84,15 @@ export interface MountOptions {
|
|
|
76
84
|
/** an element for the name and note of the part pointed at, and what it says when none is */
|
|
77
85
|
info?: HTMLElement;
|
|
78
86
|
infoIdle?: string;
|
|
79
|
-
/** false: no built-in buttons */
|
|
87
|
+
/** false: no built-in buttons (nor the steps' panel, unless `steps` says otherwise) */
|
|
80
88
|
controls?: boolean;
|
|
89
|
+
/** false: no panel for the scene's steps under the figure (the page goes through them with fig.step) */
|
|
90
|
+
steps?: boolean;
|
|
91
|
+
/** the step the figure starts at, by its place (from 0) or id (the first); -1: before the first, the figure at its
|
|
92
|
+
* own start (Next goes to the first) */
|
|
93
|
+
step?: number | string;
|
|
94
|
+
/** the reader went to another step with the panel's Back or Next (not the page's own fig.step) */
|
|
95
|
+
onStep?: (index: number, step: Step) => void;
|
|
81
96
|
style?: Look;
|
|
82
97
|
theme?: string;
|
|
83
98
|
labels?: Labels;
|
|
@@ -89,6 +104,8 @@ export interface MountOptions {
|
|
|
89
104
|
onHover?: (part: BuiltPart | null) => void;
|
|
90
105
|
/** a handle moved by the reader (not by the page's own set()) */
|
|
91
106
|
onHandle?: (id: string, value: number) => void;
|
|
107
|
+
/** the cut moved by the reader, by its face or its slider (not by the page's own set()) */
|
|
108
|
+
onSection?: (section: { normal: Vec3; offset: number }) => void;
|
|
92
109
|
/** what a screen reader says for a handle's value */
|
|
93
110
|
handleText?: (id: string, value: number) => string | undefined;
|
|
94
111
|
/** 'en' (default), 'vi', or any key of LK3D.locales */
|
|
@@ -297,11 +314,19 @@ export interface Figure {
|
|
|
297
314
|
readonly zoomLevel: number;
|
|
298
315
|
explode(v: number): void;
|
|
299
316
|
focus(ids: string[], o?: { yaw?: number; pitch?: number; ms?: number }): void;
|
|
317
|
+
/** the scene's guided steps */
|
|
318
|
+
readonly steps: Step[];
|
|
319
|
+
/** go to a step by its place (from 0) or id: its state glided to (ms: 0, at once); onStep is not called */
|
|
320
|
+
step(which: number | string, o?: { ms?: number }): void;
|
|
321
|
+
/** the step shown, from 0 (-1: the scene has none) */
|
|
322
|
+
readonly currentStep: number;
|
|
300
323
|
camera(): { yaw: number; pitch: number; dist: number; target: Vec3 };
|
|
301
324
|
readonly selected: string | null;
|
|
302
325
|
/** choose a part (or null) without calling onPick */
|
|
303
326
|
select(id: string | null): void;
|
|
304
327
|
readonly labels: Labels;
|
|
328
|
+
/** the cut's plane now: the scene's, a step's, the page's or where the reader moved it */
|
|
329
|
+
readonly section: { normal: Vec3; offset: number };
|
|
305
330
|
readonly style: Look;
|
|
306
331
|
readonly theme: string | null;
|
|
307
332
|
readonly timeScale: number;
|
|
@@ -381,3 +406,25 @@ declare const LK3D: {
|
|
|
381
406
|
toGLB?: (scene: unknown, o?: object) => Uint8Array;
|
|
382
407
|
};
|
|
383
408
|
export default LK3D;
|
|
409
|
+
|
|
410
|
+
/** <lk3d-figure>: a figure as an HTML element (src="scene.json", or a JSON script inside; attributes look, theme,
|
|
411
|
+
* labels, step, locale, controls="false", steps="false", info="false", transparent), defined when lk3d loads */
|
|
412
|
+
export interface Lk3dFigureElement extends HTMLElement {
|
|
413
|
+
/** the figure's API, once mounted (a new one each time the element mounts it again) */
|
|
414
|
+
readonly figure: Figure | null;
|
|
415
|
+
/** resolves with the first figure, once complete */
|
|
416
|
+
readonly ready: Promise<Figure>;
|
|
417
|
+
}
|
|
418
|
+
/** what the element's events carry (they bubble) */
|
|
419
|
+
export interface Lk3dFigureEvents {
|
|
420
|
+
'lk3d-pick': CustomEvent<{ id: string | null }>;
|
|
421
|
+
'lk3d-handle': CustomEvent<{ id: string; value: number }>;
|
|
422
|
+
'lk3d-step': CustomEvent<{ index: number; step: Step }>;
|
|
423
|
+
'lk3d-section': CustomEvent<{ normal: Vec3; offset: number }>;
|
|
424
|
+
'lk3d-error': CustomEvent<{ message: string }>;
|
|
425
|
+
}
|
|
426
|
+
declare global {
|
|
427
|
+
interface HTMLElementTagNameMap {
|
|
428
|
+
'lk3d-figure': Lk3dFigureElement;
|
|
429
|
+
}
|
|
430
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lk3d",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "A small engine for explorable, accessible 3D diagrams built from data: take apart, cut open, label, move parts by hand",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"3d",
|
|
@@ -64,8 +64,6 @@
|
|
|
64
64
|
"export.d.ts",
|
|
65
65
|
"validate.d.ts",
|
|
66
66
|
"docs/*.md",
|
|
67
|
-
"docs/*.png",
|
|
68
|
-
"docs/shapes/*.png",
|
|
69
67
|
"README.md",
|
|
70
68
|
"LICENSE",
|
|
71
69
|
"CHANGELOG.md",
|