@docyrus/animaguru 0.22.0 → 0.23.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/NOTICE.md +25 -1
- package/README.md +7 -3
- package/dist/animaguru.js +166 -3
- package/package.json +1 -1
- package/skills/animaguru-archive-light-table/SKILL.md +34 -0
- package/skills/animaguru-archive-light-table/references/recipe.md +26 -0
- package/skills/animaguru-briefing-board/SKILL.md +34 -0
- package/skills/animaguru-briefing-board/references/recipe.md +27 -0
- package/skills/animaguru-data-physicalization/SKILL.md +34 -0
- package/skills/animaguru-data-physicalization/references/recipe.md +27 -0
- package/skills/animaguru-exploded-teardown/SKILL.md +34 -0
- package/skills/animaguru-exploded-teardown/references/recipe.md +27 -0
- package/skills/animaguru-lidar-survey/SKILL.md +34 -0
- package/skills/animaguru-lidar-survey/references/recipe.md +26 -0
- package/skills/animaguru-machine-anatomy/LICENSE +21 -0
- package/skills/animaguru-machine-anatomy/SKILL.md +42 -0
- package/skills/animaguru-machine-anatomy/references/craft.md +97 -0
- package/skills/animaguru-machine-anatomy/references/recipe.md +52 -0
- package/skills/animaguru-microscope-story/SKILL.md +34 -0
- package/skills/animaguru-microscope-story/references/recipe.md +26 -0
- package/skills/animaguru-satellite-briefing/SKILL.md +34 -0
- package/skills/animaguru-satellite-briefing/references/recipe.md +27 -0
- package/skills/animaguru-white-model-projection/SKILL.md +34 -0
- package/skills/animaguru-white-model-projection/references/recipe.md +27 -0
- package/templates/video/README.md +1 -1
- package/templates/video/VIDEO-STYLE-NOTICES.txt +25 -1
- package/templates/video/shared/locales/en/style-studies.json +73 -0
- package/templates/video/src/kit/anatomy/LICENSE +21 -0
- package/templates/video/src/kit/anatomy/iso-kit.ts +842 -0
- package/templates/video/src/kit/anatomy/palette.ts +41 -0
- package/templates/video/src/kit/anatomy/pixi.ts +43 -0
- package/templates/video/src/studies/anatomy-plotter.ts +179 -0
- package/templates/video/src/studies/scenes.ts +171 -0
- package/templates/video/style-source-provenance.json +7 -2
package/NOTICE.md
CHANGED
|
@@ -1473,7 +1473,7 @@ SOFTWARE.
|
|
|
1473
1473
|
|
|
1474
1474
|
Video style sources and notices
|
|
1475
1475
|
|
|
1476
|
-
The executable studies and preview art are original AnimaGuru procedural 2D/2.5D work. Material/motion guidance was adapted from the pinned repositories below. No external creator video, sample music or demo font is bundled. Third-party demo assets retain their own licenses.
|
|
1476
|
+
The executable studies and preview art are original AnimaGuru procedural 2D/2.5D work. Material/motion guidance was adapted from the pinned repositories below. The Machine Anatomy geometry kit (src/kit/anatomy/iso-kit.ts) is a verbatim copy from anatomy; its MIT notice is also in src/kit/anatomy/LICENSE. No external creator video, sample music or demo font is bundled. Third-party demo assets retain their own licenses.
|
|
1477
1477
|
|
|
1478
1478
|
lemo-opuscar
|
|
1479
1479
|
MIT License
|
|
@@ -1527,6 +1527,30 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
|
1527
1527
|
SOFTWARE.
|
|
1528
1528
|
|
|
1529
1529
|
|
|
1530
|
+
anatomy
|
|
1531
|
+
MIT License
|
|
1532
|
+
|
|
1533
|
+
Copyright (c) 2026 Ryan
|
|
1534
|
+
|
|
1535
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
1536
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
1537
|
+
in the Software without restriction, including without limitation the rights
|
|
1538
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
1539
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
1540
|
+
furnished to do so, subject to the following conditions:
|
|
1541
|
+
|
|
1542
|
+
The above copyright notice and this permission notice shall be included in all
|
|
1543
|
+
copies or substantial portions of the Software.
|
|
1544
|
+
|
|
1545
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
1546
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
1547
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
1548
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
1549
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
1550
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
1551
|
+
SOFTWARE.
|
|
1552
|
+
|
|
1553
|
+
|
|
1530
1554
|
## Art Motion references
|
|
1531
1555
|
|
|
1532
1556
|
English adaptations of Huashu Art Motion (https://github.com/alchaincyf/huashu-art-motion). Source revision and coverage are in skills/animaguru-art-motion/references/coverage.json.
|
package/README.md
CHANGED
|
@@ -41,9 +41,11 @@ CLI versions before 0.16.2 need one manual update to gain enforcement. Publish t
|
|
|
41
41
|
|
|
42
42
|
## Create an animation video project
|
|
43
43
|
|
|
44
|
+
CLI 0.23.0 adds eight evidence styles, in which real data, imagery or scans carry the film: Satellite Briefing, Engineering Briefing Board, LiDAR Survey, White Model Projection, Data Physicalization, Exploded Teardown, Microscope Story and Archive Light Table. Their skills ask for the user's own data first, list licence-clean sources, keep `production/FACTS.md` and `production/CREDITS.md`, and never let a generated image stand in for evidence. Each has a runnable study (`npm run example -- satellite-briefing`).
|
|
45
|
+
|
|
44
46
|
CLI 0.16.2 also installs `animaguru-art-motion` for Codex and Claude Code: one skill with 36 English art-treatment references and nine explainer motion grammars, plus AnimaGuru generation, timing, camera and review guidance. Request it explicitly for a custom film treatment; its references are separate from the gallery presets. Source coverage and the upstream MIT notice are included in the skill.
|
|
45
47
|
|
|
46
|
-
CLI 0.5.2 includes a complete local PixiJS video workspace with
|
|
48
|
+
CLI 0.5.2 includes a complete local PixiJS video workspace, now with 40 visual styles:
|
|
47
49
|
|
|
48
50
|
```sh
|
|
49
51
|
animaguru templates
|
|
@@ -59,13 +61,15 @@ Open the generated folder in **Codex or Claude Code**, then describe the video y
|
|
|
59
61
|
- Agent instructions that first ask **Explainer, Advertisement or General Video**, then offer the available visual styles and [the preview gallery](https://animaguru.com/animation-styles), then gather a short creative brief. Each choice is saved before continuing.
|
|
60
62
|
- `film.config.json`, editable TypeScript scenes, localized copy, local asset/production folders, portable HTML5 ZIP export for iframe embedding, and `npm run export:mp4` with exact frame capture and output verification.
|
|
61
63
|
|
|
62
|
-
New projects leave category and template unset in `animaguru.project.json`. `animaguru.templates.json` lists categories, styles and their installed skills. The
|
|
64
|
+
New projects leave category and template unset in `animaguru.project.json`. `animaguru.templates.json` lists categories, styles and their installed skills. The 40 visual styles cover cutout, type, vector, technical, evidence, character, print, paper, material and cinematic treatments. Every style skill ships with the project, including its relevant visual interview and review criteria. Categories describe purpose and templates describe appearance and motion. The brief establishes audience, tone, message, story, duration and any CTA.
|
|
65
|
+
|
|
66
|
+
CLI 0.23.0 also adds **Machine Anatomy** (`machine-anatomy`): an idea explained as a working isometric machine of many small shaded parts in a framed figure card with a live readout. Adapted from the MIT-licensed [Anatomy](https://github.com/wheresryan22/anatomy) skill, it bundles that skill's geometry kit in `src/kit/anatomy/` with a PixiJS adapter, and `npm run example -- machine-anatomy` installs its original study.
|
|
63
67
|
|
|
64
68
|
Scaffolding requires no AnimaGuru sign-in and spends no generation credits; dependency installation requires npm access. `npm run dev` previews the project, and `npm run build` checks and bundles it. To export, run `npm run export:mp4`, open its local URL and wait for the verified MP4, or use HTML5 export for embedding. The starter demo is silent; the agent creates narration and music when in scope.
|
|
65
69
|
|
|
66
70
|
The official PixiJS skills are vendored with their MIT license and a hashed provenance manifest. Skills and template files ship in both the npm package and macOS installer; `create` does not fetch agent instructions from a remote repository at runtime.
|
|
67
71
|
|
|
68
|
-
CLI 0.16.1 also installs **AnimaGuru Cutcraft** in both agent skill folders. Ask your agent to use `$animaguru-cutcraft` for tactile paper-collage explainers with exact editorial lettering, one narrator and purposeful cutout motion. Its generation adapter checks the server's enabled models, tracks asynchronous jobs and supports controlled animation of generated transparent artwork when precise placement is needed or video providers are unavailable. Cutcraft is an additional skill
|
|
72
|
+
CLI 0.16.1 also installs **AnimaGuru Cutcraft** in both agent skill folders. Ask your agent to use `$animaguru-cutcraft` for tactile paper-collage explainers with exact editorial lettering, one narrator and purposeful cutout motion. Its generation adapter checks the server's enabled models, tracks asynchronous jobs and supports controlled animation of generated transparent artwork when precise placement is needed or video providers are unavailable. Cutcraft is an additional skill, not a gallery style.
|
|
69
73
|
|
|
70
74
|
## Install the project skill
|
|
71
75
|
|
package/dist/animaguru.js
CHANGED
|
@@ -19761,7 +19761,7 @@ var require_ignore2 = __commonJS({
|
|
|
19761
19761
|
// cli/package.json
|
|
19762
19762
|
var package_default = {
|
|
19763
19763
|
name: "@docyrus/animaguru",
|
|
19764
|
-
version: "0.
|
|
19764
|
+
version: "0.23.0",
|
|
19765
19765
|
description: "Agent-friendly AnimaGuru CLI built with CrustJS",
|
|
19766
19766
|
type: "module",
|
|
19767
19767
|
bin: {
|
|
@@ -45644,6 +45644,23 @@ var animation_styles_default = {
|
|
|
45644
45644
|
previewCaption: "A drafting point traces an AnimaGuru-generated cyanotype line by line, then dimensions, callouts and a title block are drawn in.",
|
|
45645
45645
|
example: true
|
|
45646
45646
|
},
|
|
45647
|
+
"machine-anatomy": {
|
|
45648
|
+
name: "Machine Anatomy",
|
|
45649
|
+
description: "Ideas built as working isometric machines: dozens of small shaded parts in a framed figure, with a live readout driven by the mechanism.",
|
|
45650
|
+
materials: [
|
|
45651
|
+
"Four-tone isometric solids",
|
|
45652
|
+
"Small, precise parts",
|
|
45653
|
+
"Figure card and live readout"
|
|
45654
|
+
],
|
|
45655
|
+
motion: [
|
|
45656
|
+
"Mechanism-driven movement",
|
|
45657
|
+
"Eased travel and springs",
|
|
45658
|
+
"Exploded assemblies"
|
|
45659
|
+
],
|
|
45660
|
+
family: "technical",
|
|
45661
|
+
previewCaption: "One dispensing head on a gantry fills a sixteen-well tray in a serpentine pass while the readout counts wells and milliliters. Drawn in code with the bundled Anatomy kit.",
|
|
45662
|
+
example: true
|
|
45663
|
+
},
|
|
45647
45664
|
"holographic-scan": {
|
|
45648
45665
|
name: "Holographic Scan",
|
|
45649
45666
|
description: "Luminous projected geometry, traveling scans and accurate part callouts with restrained depth and local explosions.",
|
|
@@ -45864,6 +45881,142 @@ var animation_styles_default = {
|
|
|
45864
45881
|
family: "graphic",
|
|
45865
45882
|
previewCaption: "Seeded light particles stream along braided ribbons, flaring as timed pulses pass. A seamless loop rendered in code.",
|
|
45866
45883
|
example: true
|
|
45884
|
+
},
|
|
45885
|
+
"satellite-briefing": {
|
|
45886
|
+
name: "Satellite Briefing",
|
|
45887
|
+
description: "Satellite imagery graded to an analyst's grey, with thin measured hairlines, dated passes and one reading per screen in one continuous zoom.",
|
|
45888
|
+
materials: [
|
|
45889
|
+
"Georeferenced imagery plates",
|
|
45890
|
+
"Analyst grey grade",
|
|
45891
|
+
"Hairline measurements"
|
|
45892
|
+
],
|
|
45893
|
+
motion: [
|
|
45894
|
+
"Orbit-to-ground dive",
|
|
45895
|
+
"Dated scan passes",
|
|
45896
|
+
"Range lines that count up"
|
|
45897
|
+
],
|
|
45898
|
+
previewCaption: "From orbit down to a drying lake: four satellite passes print their shorelines and a range line measures the retreat. Procedural terrain drawn in code, not a real place.",
|
|
45899
|
+
family: "evidence",
|
|
45900
|
+
example: true
|
|
45901
|
+
},
|
|
45902
|
+
"briefing-board": {
|
|
45903
|
+
name: "Engineering Briefing Board",
|
|
45904
|
+
description: "A filmed whiteboard wall where printed cards land with weight and marker ink in fixed colours measures every option against one limit.",
|
|
45905
|
+
materials: [
|
|
45906
|
+
"Enamel board with ghosts",
|
|
45907
|
+
"Three-colour marker ink",
|
|
45908
|
+
"Printed cards & magnets"
|
|
45909
|
+
],
|
|
45910
|
+
motion: [
|
|
45911
|
+
"Riding dimension lines",
|
|
45912
|
+
"Weighted landings",
|
|
45913
|
+
"Whole-wall reveal"
|
|
45914
|
+
],
|
|
45915
|
+
previewCaption: "Three drones are measured against one reserve line, a stamp picks the winner and the camera pulls back to the whole wall. Drawn in code with illustrative values.",
|
|
45916
|
+
family: "evidence",
|
|
45917
|
+
example: true
|
|
45918
|
+
},
|
|
45919
|
+
"lidar-survey": {
|
|
45920
|
+
name: "LiDAR Survey",
|
|
45921
|
+
description: "Measured point clouds flown through in the dark, peeled by a cutting plane and condensed into a raking-lit surface with traced features.",
|
|
45922
|
+
materials: [
|
|
45923
|
+
"Point clouds coloured by height",
|
|
45924
|
+
"Raking-lit relief",
|
|
45925
|
+
"Amber traced features"
|
|
45926
|
+
],
|
|
45927
|
+
motion: [
|
|
45928
|
+
"Scan fronts",
|
|
45929
|
+
"Canopy peel",
|
|
45930
|
+
"Points condensing to ground"
|
|
45931
|
+
],
|
|
45932
|
+
previewCaption: "A scan front paints a forest in points, a cutting plane peels the canopy and the ground condenses to reveal old field walls. A procedural cloud drawn in code, not a real survey.",
|
|
45933
|
+
family: "evidence",
|
|
45934
|
+
example: true
|
|
45935
|
+
},
|
|
45936
|
+
"white-model-projection": {
|
|
45937
|
+
name: "White Model Projection",
|
|
45938
|
+
description: "A white massing model in a dark room, where projected light paints data onto the buildings one layer at a time.",
|
|
45939
|
+
materials: [
|
|
45940
|
+
"Matte white massing",
|
|
45941
|
+
"Projected data light",
|
|
45942
|
+
"Pins & single readouts"
|
|
45943
|
+
],
|
|
45944
|
+
motion: [
|
|
45945
|
+
"Lights out, lamp on",
|
|
45946
|
+
"Decade-by-decade switch-ons",
|
|
45947
|
+
"A rising level of light"
|
|
45948
|
+
],
|
|
45949
|
+
previewCaption: "The house lights cut, each decade lights the buildings it left, a level of light climbs every facade and the tallest tower is picked out. Rendered in code; an illustrative district.",
|
|
45950
|
+
family: "evidence",
|
|
45951
|
+
example: true
|
|
45952
|
+
},
|
|
45953
|
+
"data-physicalization": {
|
|
45954
|
+
name: "Data Physicalization",
|
|
45955
|
+
description: "Statistics built as countable objects on a crafted base, lit like a studio product shot and read at the edge of one unit.",
|
|
45956
|
+
materials: [
|
|
45957
|
+
"Countable unit plates",
|
|
45958
|
+
"Metal, acrylic & walnut",
|
|
45959
|
+
"Pinned paper readings"
|
|
45960
|
+
],
|
|
45961
|
+
motion: [
|
|
45962
|
+
"Pieces placed with weight",
|
|
45963
|
+
"Tracked growth",
|
|
45964
|
+
"Pull-back to the installation"
|
|
45965
|
+
],
|
|
45966
|
+
previewCaption: "Ten years of two series become aluminium and acrylic plates on a walnut slab; the stacks cross in 2020 and the camera pulls back to the whole installation. Rendered in code with illustrative values.",
|
|
45967
|
+
family: "evidence",
|
|
45968
|
+
example: true
|
|
45969
|
+
},
|
|
45970
|
+
"exploded-teardown": {
|
|
45971
|
+
name: "Exploded Teardown",
|
|
45972
|
+
description: "A product taken apart on one axis under studio light, every part named with the numbers in its own files, then closed and dimensioned.",
|
|
45973
|
+
materials: [
|
|
45974
|
+
"Studio-lit product parts",
|
|
45975
|
+
"Painted circuit boards",
|
|
45976
|
+
"Leader labels & dimensions"
|
|
45977
|
+
],
|
|
45978
|
+
motion: [
|
|
45979
|
+
"Layer-by-layer separation",
|
|
45980
|
+
"Lights on inside",
|
|
45981
|
+
"Closing and measuring"
|
|
45982
|
+
],
|
|
45983
|
+
previewCaption: "An original pad controller lifts apart in one orbit, its LEDs light the diffuser, labels land in a column and it closes to be dimensioned. Rendered in code from its own model.",
|
|
45984
|
+
family: "evidence",
|
|
45985
|
+
example: true
|
|
45986
|
+
},
|
|
45987
|
+
"microscope-story": {
|
|
45988
|
+
name: "Microscope Story",
|
|
45989
|
+
description: "One continuous dive from a slide on the bench to a single cell, with focus breaths, true scale bars and readings counted from the image.",
|
|
45990
|
+
materials: [
|
|
45991
|
+
"Stained specimen plates",
|
|
45992
|
+
"Frosted instrument panels",
|
|
45993
|
+
"Measured rings & counts"
|
|
45994
|
+
],
|
|
45995
|
+
motion: [
|
|
45996
|
+
"Log-zoom dive",
|
|
45997
|
+
"Focus breaths & sweeps",
|
|
45998
|
+
"Counting the colour"
|
|
45999
|
+
],
|
|
46000
|
+
previewCaption: "A slide on the bench dives to 10\xD7, the blue inside one circle is counted pixel by pixel, then the camera goes on to a single nucleus. A procedural specimen drawn in code, not a real slide.",
|
|
46001
|
+
family: "evidence",
|
|
46002
|
+
example: true
|
|
46003
|
+
},
|
|
46004
|
+
"archive-light-table": {
|
|
46005
|
+
name: "Archive Light Table",
|
|
46006
|
+
description: "Archive photographs and documents on a backlit table, where a loupe turns a negative positive and catalogue records sit beside the objects.",
|
|
46007
|
+
materials: [
|
|
46008
|
+
"Backlit archive objects",
|
|
46009
|
+
"Loupe optics",
|
|
46010
|
+
"Catalogue tags & index"
|
|
46011
|
+
],
|
|
46012
|
+
motion: [
|
|
46013
|
+
"Table glides",
|
|
46014
|
+
"Loupe landings & develop fronts",
|
|
46015
|
+
"Into the photograph"
|
|
46016
|
+
],
|
|
46017
|
+
previewCaption: "Three NASA Ames photographs of one airfield on a light table; under the loupe a 1933 negative turns positive and opens into the picture. Public-domain NASA scans; the negatives are simulated.",
|
|
46018
|
+
family: "evidence",
|
|
46019
|
+
example: true
|
|
45867
46020
|
}
|
|
45868
46021
|
},
|
|
45869
46022
|
browseStyles: "Browse animation styles",
|
|
@@ -45877,7 +46030,8 @@ var animation_styles_default = {
|
|
|
45877
46030
|
paper: "Paper & cutout",
|
|
45878
46031
|
character: "Character & pixel",
|
|
45879
46032
|
material: "Materials & depth",
|
|
45880
|
-
cinematic: "Cinema & media"
|
|
46033
|
+
cinematic: "Cinema & media",
|
|
46034
|
+
evidence: "Evidence & data"
|
|
45881
46035
|
},
|
|
45882
46036
|
searchLabel: "Search visual styles",
|
|
45883
46037
|
searchPlaceholder: "Try paper, product, typography\u2026",
|
|
@@ -45974,6 +46128,7 @@ var VIDEO_STYLE_IDS = [
|
|
|
45974
46128
|
"silkscreen-poster",
|
|
45975
46129
|
"art-deco-motion",
|
|
45976
46130
|
"blueprint-drafting",
|
|
46131
|
+
"machine-anatomy",
|
|
45977
46132
|
"holographic-scan",
|
|
45978
46133
|
"paper-popup",
|
|
45979
46134
|
"shadow-theatre",
|
|
@@ -45986,7 +46141,15 @@ var VIDEO_STYLE_IDS = [
|
|
|
45986
46141
|
"stop-motion-objects",
|
|
45987
46142
|
"miniature-diorama",
|
|
45988
46143
|
"sand-drawing",
|
|
45989
|
-
"generative-light-signal"
|
|
46144
|
+
"generative-light-signal",
|
|
46145
|
+
"satellite-briefing",
|
|
46146
|
+
"briefing-board",
|
|
46147
|
+
"lidar-survey",
|
|
46148
|
+
"white-model-projection",
|
|
46149
|
+
"data-physicalization",
|
|
46150
|
+
"exploded-teardown",
|
|
46151
|
+
"microscope-story",
|
|
46152
|
+
"archive-light-table"
|
|
45990
46153
|
];
|
|
45991
46154
|
var VIDEO_WORKFLOW_IDS = [
|
|
45992
46155
|
"product-proof",
|
package/package.json
CHANGED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: animaguru-archive-light-table
|
|
3
|
+
description: Build Archive Light Table visuals and motion in an AnimaGuru PixiJS video workspace. Use when this visual style is chosen for an explainer, advertisement or general video.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Archive Light Table
|
|
8
|
+
|
|
9
|
+
Archive photographs and documents on a backlit table, where a loupe turns a negative positive and catalogue records sit beside the objects. It is an evidence style: real data, imagery or scans carry the film. Subject, audience, emotional tone and story come from the user's brief. This style supports Explainer, Advertisement and General Video.
|
|
10
|
+
|
|
11
|
+
## Establish direction
|
|
12
|
+
|
|
13
|
+
Follow sibling `animaguru-video` for purpose → style → compact interview before new production. Reuse explicit choices and completed briefs; honor a requested interview skip. Share [the style gallery](https://animaguru.com/animation-styles#archive-light-table). Fold missing visual questions into the shared interview:
|
|
14
|
+
|
|
15
|
+
- Which archive objects, with catalogue numbers, and do you have rights to the brand's own archive?
|
|
16
|
+
- Which object gets the loupe, and what should change inside the lens?
|
|
17
|
+
|
|
18
|
+
## Use real evidence
|
|
19
|
+
|
|
20
|
+
Ask the user for their own data, scans, files or rights first; otherwise find licence-clean sources (see the [production recipe](references/recipe.md)). Never stand a generated image in for the evidence, and never invent a number. Keep `production/FACTS.md` (each on-screen or spoken claim, its source URL and quoted wording, or the measurement method) and `production/CREDITS.md` (every asset's source, author and licence), and deliver both with the film. CC BY-SA, ODbL, "no known restrictions" or non-commercial terms are not CC0: name them to the user and ask before using them.
|
|
21
|
+
|
|
22
|
+
## Build the look and movement
|
|
23
|
+
|
|
24
|
+
Read `pixijs` and the relevant Graphics, Text, Container, Assets, Mesh or Filters skills. Read `animaguru` before generating assets: generation can supply music, narration or a title background, never the evidence itself. Discover current models and estimates, respect the user's budget, and reuse completed media. Essential text and exact numerical geometry belong in authored canvas content.
|
|
25
|
+
|
|
26
|
+
- The objects are real scans at their true proportions with their real damage; every identifier, date and title comes from the holder's record, quoted when you can.
|
|
27
|
+
- Light comes from below: film and glass transmit it and paper glows warm at its edges. The loupe is the camera's door, where a negative develops, a line lights up or a photograph opens into depth.
|
|
28
|
+
- Use no vintage filter: the age is in the objects, not the grade. One signal colour marks anchors, readings and the verdict.
|
|
29
|
+
|
|
30
|
+
Use the [production recipe](references/recipe.md) for sources, the bundled original study and port-specific decisions. It is a technique example, not a prescribed film. Keep motions a function of absolute seconds; separate drawing cadence from camera/light cadence when the material calls for it. Prepare assets locally, preserve async seeking and register actual resource/cue times. Keep essential type editable and localized.
|
|
31
|
+
|
|
32
|
+
## Review and delivery
|
|
33
|
+
|
|
34
|
+
Inspect the lens interior (under about 1.5 screen pixels per scan pixel), reading holds for labels on a moving table, shear in the photograph space and every identifier against its record. Check representative full-resolution frames, moving playback, desktop/mobile fit and cold seeks. Follow `animaguru-video` for production records, audio mixing and HTML5 delivery; export MP4 when requested. Describe the actual 2D/2.5D rendering method accurately. Physically rendered 3D remains deferred.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Archive Light Table production recipe
|
|
2
|
+
|
|
3
|
+
The workspace includes an executable original study in `src/studies/scenes.ts`, selected with `archive-light-table`. Its drawing commands are consumed by `src/studies/pixi-renderer.ts`; geometry and time sampling are shared with the gallery renderer. All copy lives in `shared/locales/en/style-studies.json`.
|
|
4
|
+
|
|
5
|
+
In an untouched starter, run `npm run example -- archive-light-table`, then `npm run dev`. The command refuses to replace an authored film, retains starter backups in `production/example-backup/`, and writes an 8-second study with its own resource tracks. `npm run export:html` and `npm run export:mp4` use this installed film normally. To use the recipe inside an existing film, import `studyFrame()` and `StudyRenderer`, then compose the selected scene into the project's timeline instead of running the installer.
|
|
6
|
+
|
|
7
|
+
## Evidence and sources
|
|
8
|
+
|
|
9
|
+
The Library of Congress (check each item's rights statement), Smithsonian Open Access and the Rijksmuseum (CC0), NARA, the NASA Image and Video Library (generally not copyrighted) and Europeana (rights per item). "No known restrictions" and CC BY-SA are not CC0: name the terms and ask first. For brand history, ask for the user's scans, archive numbers and right to use them. Download into the film's `public/` or `production/` folders, log every request, and record each asset in `production/CREDITS.md` and each claim in `production/FACTS.md`. Burn a readable credit into the frame where the medium calls for one.
|
|
10
|
+
|
|
11
|
+
## Adaptation decisions
|
|
12
|
+
|
|
13
|
+
- Lay the objects as sprites at true size on one table `Container` over a near-white emissive backdrop; a negative is its positive scan through a transmission curve in a small filter.
|
|
14
|
+
- The loupe renders a magnified copy of the table inside a circular mask, with a `DisplacementFilter` for the pincushion and slight per-channel offsets for fringes. The develop front is a growing radial mask between the negative and positive copies.
|
|
15
|
+
- Into the photograph: grow the lens mask past the frame while the view inside widens to the whole picture, then give it depth with two or three cut layers and a small dolly, small enough that fills stay hidden.
|
|
16
|
+
|
|
17
|
+
The study is silent, original procedural art with illustrative values, labelled as such; it demonstrates material, light, layout and motion, not evidence. Replace its stand-ins with the real data, imagery or scans described above, never with generated imagery. The gallery preview is three public-domain NASA Ames scans; their negatives are simulated from the positive scans, as the frame says. Configure the subject, palette, scene sequence, duration and soundtrack from the brief.
|
|
18
|
+
|
|
19
|
+
Use `src/studies/timing.ts` for deterministic easing, seeded variation, measured stroke truncation and cue helpers. `window.animaguru.texts` exposes visible study text bounds for `npm run review`; text declarations alone do not count as visual proof. Inspect the actual frames as well.
|
|
20
|
+
|
|
21
|
+
## Sources and attribution
|
|
22
|
+
|
|
23
|
+
Inspired by the following pinned references; source-specific 3D/media dependencies are not bundled. New study art and scene geometry are original. The workspace's `VIDEO-STYLE-NOTICES.txt` preserves the repository notices and clarifies third-party asset scope.
|
|
24
|
+
|
|
25
|
+
- [styles/archive-lighttable/STYLE.md](https://github.com/lemomo-ai/lemo-opuscar/blob/b5e8ef93930b6d828f352055a689320f138237b1/styles/archive-lighttable/STYLE.md)
|
|
26
|
+
- [styles/archive-lighttable/demo/film.js](https://github.com/lemomo-ai/lemo-opuscar/blob/b5e8ef93930b6d828f352055a689320f138237b1/styles/archive-lighttable/demo/film.js)
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: animaguru-briefing-board
|
|
3
|
+
description: Build Engineering Briefing Board visuals and motion in an AnimaGuru PixiJS video workspace. Use when this visual style is chosen for an explainer, advertisement or general video.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Engineering Briefing Board
|
|
8
|
+
|
|
9
|
+
A filmed whiteboard wall where printed cards land with weight and marker ink in fixed colours measures every option against one limit. It is an evidence style: real data, imagery or scans carry the film. Subject, audience, emotional tone and story come from the user's brief. This style supports Explainer, Advertisement and General Video.
|
|
10
|
+
|
|
11
|
+
## Establish direction
|
|
12
|
+
|
|
13
|
+
Follow sibling `animaguru-video` for purpose → style → compact interview before new production. Reuse explicit choices and completed briefs; honor a requested interview skip. Share [the style gallery](https://animaguru.com/animation-styles#briefing-board). Fold missing visual questions into the shared interview:
|
|
14
|
+
|
|
15
|
+
- Which decision, options and limit should the wall test, and in what real units?
|
|
16
|
+
- Do you have licensable photos of the real objects, or should they be marker sketches and printed cards?
|
|
17
|
+
|
|
18
|
+
## Use real evidence
|
|
19
|
+
|
|
20
|
+
Ask the user for their own data, scans, files or rights first; otherwise find licence-clean sources (see the [production recipe](references/recipe.md)). Never stand a generated image in for the evidence, and never invent a number. Keep `production/FACTS.md` (each on-screen or spoken claim, its source URL and quoted wording, or the measurement method) and `production/CREDITS.md` (every asset's source, author and licence), and deliver both with the film. CC BY-SA, ODbL, "no known restrictions" or non-commercial terms are not CC0: name them to the user and ask before using them.
|
|
21
|
+
|
|
22
|
+
## Build the look and movement
|
|
23
|
+
|
|
24
|
+
Read `pixijs` and the relevant Graphics, Text, Container, Assets, Mesh or Filters skills. Read `animaguru` before generating assets: generation can supply music, narration or a title background, never the evidence itself. Discover current models and estimates, respect the user's budget, and reuse completed media. Essential text and exact numerical geometry belong in authored canvas content.
|
|
25
|
+
|
|
26
|
+
- Design the final wall as a poster first, then plan every shot as a crop of it; keep one zone (the verdict or a secondary layer) unseen until the long pull-back.
|
|
27
|
+
- Ink means one thing per colour: graphite for names and rules, blue for measurement, red only for the decision. Draw at hand speed, letter glyph by glyph and erase rejected ideas to faint ghosts.
|
|
28
|
+
- Real things land as cut-out photographs, licensed or the user's own, under one light vector and one grade. With no licensable photo, draw the object as a marker sketch instead of generating one.
|
|
29
|
+
|
|
30
|
+
Use the [production recipe](references/recipe.md) for sources, the bundled original study and port-specific decisions. It is a technique example, not a prescribed film. Keep motions a function of absolute seconds; separate drawing cadence from camera/light cadence when the material calls for it. Prepare assets locally, preserve async seeking and register actual resource/cue times. Keep essential type editable and localized.
|
|
31
|
+
|
|
32
|
+
## Review and delivery
|
|
33
|
+
|
|
34
|
+
Inspect reading holds for every word the camera passes, judgement frames that show item, limit and verdict together, photo upsampling and the share of the wall visible before the reveal. Check representative full-resolution frames, moving playback, desktop/mobile fit and cold seeks. Follow `animaguru-video` for production records, audio mixing and HTML5 delivery; export MP4 when requested. Describe the actual 2D/2.5D rendering method accurately. Physically rendered 3D remains deferred.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Engineering Briefing Board production recipe
|
|
2
|
+
|
|
3
|
+
The workspace includes an executable original study in `src/studies/scenes.ts`, selected with `briefing-board`. Its drawing commands are consumed by `src/studies/pixi-renderer.ts`; geometry and time sampling are shared with the gallery renderer. All copy lives in `shared/locales/en/style-studies.json`.
|
|
4
|
+
|
|
5
|
+
In an untouched starter, run `npm run example -- briefing-board`, then `npm run dev`. The command refuses to replace an authored film, retains starter backups in `production/example-backup/`, and writes an 8-second study with its own resource tracks. `npm run export:html` and `npm run export:mp4` use this installed film normally. To use the recipe inside an existing film, import `studyFrame()` and `StudyRenderer`, then compose the selected scene into the project's timeline instead of running the installer.
|
|
6
|
+
|
|
7
|
+
## Evidence and sources
|
|
8
|
+
|
|
9
|
+
Wikimedia Commons (read each file page's licence and author), national libraries and archives (check each item's rights statement), agency media pages and Flickr Commons; for the user's own product, site or people, ask for their photos. Every number comes from a cited spec, a measurement or the user's documents. Download into the film's `public/` or `production/` folders, log every request, and record each asset in `production/CREDITS.md` and each claim in `production/FACTS.md`. Burn a readable credit into the frame where the medium calls for one.
|
|
10
|
+
|
|
11
|
+
## Adaptation decisions
|
|
12
|
+
|
|
13
|
+
- Build the wall as one large `Container` in board pixels with layers by height (board, prints, props, tray). A camera container moves, scales and rolls it; raised layers get a slightly larger scale, which gives parallax.
|
|
14
|
+
- Bake the enamel, erased ghosts and frame into one texture. Draw ink with `Graphics` strokes revealed by measured length (`strokePoints`), lettering by slicing glyphs, and a slow reflection band as a blurred sprite.
|
|
15
|
+
- Prints are sprites with a blurred shadow offset along one light vector; they land with an ease-out and one small bounce while the shadow tightens. Magnets pop, tags swing on damped springs, and the stamp scales down with a camera jolt.
|
|
16
|
+
|
|
17
|
+
The study is silent, original procedural art with illustrative values, labelled as such; it demonstrates material, light, layout and motion, not evidence. Replace its stand-ins with the real data, imagery or scans described above, never with generated imagery. The gallery preview is drawn in code with marker sketches and illustrative values. Configure the subject, palette, scene sequence, duration and soundtrack from the brief.
|
|
18
|
+
|
|
19
|
+
Use `src/studies/timing.ts` for deterministic easing, seeded variation, measured stroke truncation and cue helpers. `window.animaguru.texts` exposes visible study text bounds for `npm run review`; text declarations alone do not count as visual proof. Inspect the actual frames as well.
|
|
20
|
+
|
|
21
|
+
## Sources and attribution
|
|
22
|
+
|
|
23
|
+
Inspired by the following pinned references; source-specific 3D/media dependencies are not bundled. New study art and scene geometry are original. The workspace's `VIDEO-STYLE-NOTICES.txt` preserves the repository notices and clarifies third-party asset scope.
|
|
24
|
+
|
|
25
|
+
- [styles/briefing-board/STYLE.md](https://github.com/lemomo-ai/lemo-opuscar/blob/b5e8ef93930b6d828f352055a689320f138237b1/styles/briefing-board/STYLE.md)
|
|
26
|
+
- [styles/briefing-board/demo/kit/board.js](https://github.com/lemomo-ai/lemo-opuscar/blob/b5e8ef93930b6d828f352055a689320f138237b1/styles/briefing-board/demo/kit/board.js)
|
|
27
|
+
- [styles/briefing-board/demo/kit/README.md](https://github.com/lemomo-ai/lemo-opuscar/blob/b5e8ef93930b6d828f352055a689320f138237b1/styles/briefing-board/demo/kit/README.md)
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: animaguru-data-physicalization
|
|
3
|
+
description: Build Data Physicalization visuals and motion in an AnimaGuru PixiJS video workspace. Use when this visual style is chosen for an explainer, advertisement or general video.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Data Physicalization
|
|
8
|
+
|
|
9
|
+
Statistics built as countable objects on a crafted base, lit like a studio product shot and read at the edge of one unit. It is an evidence style: real data, imagery or scans carry the film. Subject, audience, emotional tone and story come from the user's brief. This style supports Explainer, Advertisement and General Video.
|
|
10
|
+
|
|
11
|
+
## Establish direction
|
|
12
|
+
|
|
13
|
+
Follow sibling `animaguru-video` for purpose → style → compact interview before new production. Reuse explicit choices and completed briefs; honor a requested interview skip. Share [the style gallery](https://animaguru.com/animation-styles#data-physicalization). Fold missing visual questions into the shared interview:
|
|
14
|
+
|
|
15
|
+
- Which real series and unit (one piece equals how much), and which comparison or crossover should land?
|
|
16
|
+
- Which materials and base suit the brand: metal, acrylic, wood, stone or coins?
|
|
17
|
+
|
|
18
|
+
## Use real evidence
|
|
19
|
+
|
|
20
|
+
Ask the user for their own data, scans, files or rights first; otherwise find licence-clean sources (see the [production recipe](references/recipe.md)). Never stand a generated image in for the evidence, and never invent a number. Keep `production/FACTS.md` (each on-screen or spoken claim, its source URL and quoted wording, or the measurement method) and `production/CREDITS.md` (every asset's source, author and licence), and deliver both with the film. CC BY-SA, ODbL, "no known restrictions" or non-commercial terms are not CC0: name them to the user and ask before using them.
|
|
21
|
+
|
|
22
|
+
## Build the look and movement
|
|
23
|
+
|
|
24
|
+
Read `pixijs` and the relevant Graphics, Text, Container, Assets, Mesh or Filters skills. Read `animaguru` before generating assets: generation can supply music, narration or a title background, never the evidence itself. Discover current models and estimates, respect the user's budget, and reuse completed media. Essential text and exact numerical geometry belong in authored canvas content.
|
|
25
|
+
|
|
26
|
+
- The unit is an object: one plate, block or coin equals one stated quantity, said once on screen, and every tenth piece is a heavier ruler material. Heights are exact counts, rounded by one unit at most.
|
|
27
|
+
- Growth is assembly: pieces land one by one with weight, an ease-out and an unwinding yaw, and counters roll with the landed pieces, never with time. Reveal the chart once as a made installation.
|
|
28
|
+
- Use studio light and real matter: a warm low key, a cool rim and long soft shadows. Material, not paint, separates series, and one accent marks the reading or verdict that matters.
|
|
29
|
+
|
|
30
|
+
Use the [production recipe](references/recipe.md) for sources, the bundled original study and port-specific decisions. It is a technique example, not a prescribed film. Keep motions a function of absolute seconds; separate drawing cadence from camera/light cadence when the material calls for it. Prepare assets locally, preserve async seeking and register actual resource/cue times. Keep essential type editable and localized.
|
|
31
|
+
|
|
32
|
+
## Review and delivery
|
|
33
|
+
|
|
34
|
+
Inspect counts against the data file, series separation at thumbnail size, readings kept inside the frame, a verdict that waits until its readings have been still, and the source line in frame. Check representative full-resolution frames, moving playback, desktop/mobile fit and cold seeks. Follow `animaguru-video` for production records, audio mixing and HTML5 delivery; export MP4 when requested. Describe the actual 2D/2.5D rendering method accurately. Physically rendered 3D remains deferred.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Data Physicalization production recipe
|
|
2
|
+
|
|
3
|
+
The workspace includes an executable original study in `src/studies/scenes.ts`, selected with `data-physicalization`. Its drawing commands are consumed by `src/studies/pixi-renderer.ts`; geometry and time sampling are shared with the gallery renderer. All copy lives in `shared/locales/en/style-studies.json`.
|
|
4
|
+
|
|
5
|
+
In an untouched starter, run `npm run example -- data-physicalization`, then `npm run dev`. The command refuses to replace an authored film, retains starter backups in `production/example-backup/`, and writes an 8-second study with its own resource tracks. `npm run export:html` and `npm run export:mp4` use this installed film normally. To use the recipe inside an existing film, import `studyFrame()` and `StudyRenderer`, then compose the selected scene into the project's timeline instead of running the installer.
|
|
6
|
+
|
|
7
|
+
## Evidence and sources
|
|
8
|
+
|
|
9
|
+
Our World in Data (credit OWID and the original source), World Bank Open Data and Eurostat (CC BY 4.0), US Census, BLS and EIA (public domain), national statistics offices, or the user's own reports with the document they come from. Textures and HDRIs from Poly Haven or ambientCG (CC0). Download into the film's `public/` or `production/` folders, log every request, and record each asset in `production/CREDITS.md` and each claim in `production/FACTS.md`. Burn a readable credit into the frame where the medium calls for one.
|
|
10
|
+
|
|
11
|
+
## Adaptation decisions
|
|
12
|
+
|
|
13
|
+
- Lay out the stacks from one table of values and the unit. Draw each piece as a small shaded box (`Graphics` faces in painter's order, or one shaded piece sprite per material reused with per-piece tint and offset), back to front.
|
|
14
|
+
- Bake the base (for example a walnut slab with inlaid ticks and labels) into a texture, cast shadows as blurred sprites along one light vector, and soften far layers with a `BlurFilter` for depth of field.
|
|
15
|
+
- Pin readings to projected piece corners with a leader, a material swatch and a paper plate, and keep them inside a safe box while the camera tracks.
|
|
16
|
+
|
|
17
|
+
The study is silent, original procedural art with illustrative values, labelled as such; it demonstrates material, light, layout and motion, not evidence. Replace its stand-ins with the real data, imagery or scans described above, never with generated imagery. The gallery preview is rendered in code with illustrative values. Configure the subject, palette, scene sequence, duration and soundtrack from the brief.
|
|
18
|
+
|
|
19
|
+
Use `src/studies/timing.ts` for deterministic easing, seeded variation, measured stroke truncation and cue helpers. `window.animaguru.texts` exposes visible study text bounds for `npm run review`; text declarations alone do not count as visual proof. Inspect the actual frames as well.
|
|
20
|
+
|
|
21
|
+
## Sources and attribution
|
|
22
|
+
|
|
23
|
+
Inspired by the following pinned references; source-specific 3D/media dependencies are not bundled. New study art and scene geometry are original. The workspace's `VIDEO-STYLE-NOTICES.txt` preserves the repository notices and clarifies third-party asset scope.
|
|
24
|
+
|
|
25
|
+
- [styles/data-physical/STYLE.md](https://github.com/lemomo-ai/lemo-opuscar/blob/b5e8ef93930b6d828f352055a689320f138237b1/styles/data-physical/STYLE.md)
|
|
26
|
+
- [styles/data-physical/demo/set.js](https://github.com/lemomo-ai/lemo-opuscar/blob/b5e8ef93930b6d828f352055a689320f138237b1/styles/data-physical/demo/set.js)
|
|
27
|
+
- [styles/data-physical/demo/film.js](https://github.com/lemomo-ai/lemo-opuscar/blob/b5e8ef93930b6d828f352055a689320f138237b1/styles/data-physical/demo/film.js)
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: animaguru-exploded-teardown
|
|
3
|
+
description: Build Exploded Teardown visuals and motion in an AnimaGuru PixiJS video workspace. Use when this visual style is chosen for an explainer, advertisement or general video.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Exploded Teardown
|
|
8
|
+
|
|
9
|
+
A product taken apart on one axis under studio light, every part named with the numbers in its own files, then closed and dimensioned. It is an evidence style: real data, imagery or scans carry the film. Subject, audience, emotional tone and story come from the user's brief. This style supports Explainer, Advertisement and General Video.
|
|
10
|
+
|
|
11
|
+
## Establish direction
|
|
12
|
+
|
|
13
|
+
Follow sibling `animaguru-video` for purpose → style → compact interview before new production. Reuse explicit choices and completed briefs; honor a requested interview skip. Share [the style gallery](https://animaguru.com/animation-styles#exploded-teardown). Fold missing visual questions into the shared interview:
|
|
14
|
+
|
|
15
|
+
- Which product and revision, and do you have its CAD, PCB layout, bill of materials and spec sheet?
|
|
16
|
+
- Which parts deserve a stop, and which real motion or light should it perform?
|
|
17
|
+
|
|
18
|
+
## Use real evidence
|
|
19
|
+
|
|
20
|
+
Ask the user for their own data, scans, files or rights first; otherwise find licence-clean sources (see the [production recipe](references/recipe.md)). Never stand a generated image in for the evidence, and never invent a number. Keep `production/FACTS.md` (each on-screen or spoken claim, its source URL and quoted wording, or the measurement method) and `production/CREDITS.md` (every asset's source, author and licence), and deliver both with the film. CC BY-SA, ODbL, "no known restrictions" or non-commercial terms are not CC0: name them to the user and ask before using them.
|
|
21
|
+
|
|
22
|
+
## Build the look and movement
|
|
23
|
+
|
|
24
|
+
Read `pixijs` and the relevant Graphics, Text, Container, Assets, Mesh or Filters skills. Read `animaguru` before generating assets: generation can supply music, narration or a title background, never the evidence itself. Discover current models and estimates, respect the user's budget, and reuse completed media. Essential text and exact numerical geometry belong in authored canvas content.
|
|
25
|
+
|
|
26
|
+
- Geometry, positions and counts come from the product's own files. Without files, build only from published dimensions, say that it is a model, and show no number you could not source.
|
|
27
|
+
- Separate layers on one axis, top first, with even gaps and a long settle; repeated parts lift in a wave. Labels sit in a fixed column (index, name, one spec line); close bottom first and draw dimensions in the object's own perspective.
|
|
28
|
+
- Keep the frame dark and neutral so the product is the brightest thing, use one accent for measured lines and indices, and show plain package tops instead of brand marks.
|
|
29
|
+
|
|
30
|
+
Use the [production recipe](references/recipe.md) for sources, the bundled original study and port-specific decisions. It is a technique example, not a prescribed film. Keep motions a function of absolute seconds; separate drawing cadence from camera/light cadence when the material calls for it. Prepare assets locally, preserve async seeking and register actual resource/cue times. Keep essential type editable and localized.
|
|
31
|
+
|
|
32
|
+
## Review and delivery
|
|
33
|
+
|
|
34
|
+
Inspect label reading time at each stop, leader anchors through the orbit, revision consistency between files, dark plastics against the ground and every number against `FACTS.md`. Check representative full-resolution frames, moving playback, desktop/mobile fit and cold seeks. Follow `animaguru-video` for production records, audio mixing and HTML5 delivery; export MP4 when requested. Describe the actual 2D/2.5D rendering method accurately. Physically rendered 3D remains deferred.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Exploded Teardown production recipe
|
|
2
|
+
|
|
3
|
+
The workspace includes an executable original study in `src/studies/scenes.ts`, selected with `exploded-teardown`. Its drawing commands are consumed by `src/studies/pixi-renderer.ts`; geometry and time sampling are shared with the gallery renderer. All copy lives in `shared/locales/en/style-studies.json`.
|
|
4
|
+
|
|
5
|
+
In an untouched starter, run `npm run example -- exploded-teardown`, then `npm run dev`. The command refuses to replace an authored film, retains starter backups in `production/example-backup/`, and writes an 8-second study with its own resource tracks. `npm run export:html` and `npm run export:mp4` use this installed film normally. To use the recipe inside an existing film, import `studyFrame()` and `StudyRenderer`, then compose the selected scene into the project's timeline instead of running the installer.
|
|
6
|
+
|
|
7
|
+
## Evidence and sources
|
|
8
|
+
|
|
9
|
+
The user's own CAD, layout files and BOM first. For a public product, open hardware (GitHub, the OSHWA list, Hackaday.io) with its original CAD, and component datasheets from the maker. CC0, public domain, CC BY and MIT are fine with credit; CERN-OHL, CC BY-SA and GPL hardware: name the terms and ask first. Download into the film's `public/` or `production/` folders, log every request, and record each asset in `production/CREDITS.md` and each claim in `production/FACTS.md`. Burn a readable credit into the frame where the medium calls for one.
|
|
10
|
+
|
|
11
|
+
## Adaptation decisions
|
|
12
|
+
|
|
13
|
+
- Convert the CAD offline to simple extruded outlines per layer (outline, holes, heights). Draw each layer's faces with `Graphics` from one camera, layer by layer along the lift axis, and map the board artwork onto the board's top face with a `PerspectiveMesh`.
|
|
14
|
+
- Paint the board texture once from the layout (copper, pads, silkscreen). Emitters are additive sprites that switch on while the layers are apart.
|
|
15
|
+
- Project labels and dimension lines with `Graphics` and `Text` every frame, and interpolate camera keys monotonically so a macro hold really holds.
|
|
16
|
+
|
|
17
|
+
The study is silent, original procedural art with illustrative values, labelled as such; it demonstrates material, light, layout and motion, not evidence. Replace its stand-ins with the real data, imagery or scans described above, never with generated imagery. The gallery preview is rendered in code from an original model whose dimensions it labels. Configure the subject, palette, scene sequence, duration and soundtrack from the brief.
|
|
18
|
+
|
|
19
|
+
Use `src/studies/timing.ts` for deterministic easing, seeded variation, measured stroke truncation and cue helpers. `window.animaguru.texts` exposes visible study text bounds for `npm run review`; text declarations alone do not count as visual proof. Inspect the actual frames as well.
|
|
20
|
+
|
|
21
|
+
## Sources and attribution
|
|
22
|
+
|
|
23
|
+
Inspired by the following pinned references; source-specific 3D/media dependencies are not bundled. New study art and scene geometry are original. The workspace's `VIDEO-STYLE-NOTICES.txt` preserves the repository notices and clarifies third-party asset scope.
|
|
24
|
+
|
|
25
|
+
- [styles/teardown/STYLE.md](https://github.com/lemomo-ai/lemo-opuscar/blob/b5e8ef93930b6d828f352055a689320f138237b1/styles/teardown/STYLE.md)
|
|
26
|
+
- [styles/teardown/demo/src/main.js](https://github.com/lemomo-ai/lemo-opuscar/blob/b5e8ef93930b6d828f352055a689320f138237b1/styles/teardown/demo/src/main.js)
|
|
27
|
+
- [styles/teardown/demo/src/overlay.js](https://github.com/lemomo-ai/lemo-opuscar/blob/b5e8ef93930b6d828f352055a689320f138237b1/styles/teardown/demo/src/overlay.js)
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: animaguru-lidar-survey
|
|
3
|
+
description: Build LiDAR Survey visuals and motion in an AnimaGuru PixiJS video workspace. Use when this visual style is chosen for an explainer, advertisement or general video.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# LiDAR Survey
|
|
8
|
+
|
|
9
|
+
Measured point clouds flown through in the dark, peeled by a cutting plane and condensed into a raking-lit surface with traced features. It is an evidence style: real data, imagery or scans carry the film. Subject, audience, emotional tone and story come from the user's brief. This style supports Explainer, Advertisement and General Video.
|
|
10
|
+
|
|
11
|
+
## Establish direction
|
|
12
|
+
|
|
13
|
+
Follow sibling `animaguru-video` for purpose → style → compact interview before new production. Reuse explicit choices and completed briefs; honor a requested interview skip. Share [the style gallery](https://animaguru.com/animation-styles#lidar-survey). Fold missing visual questions into the shared interview:
|
|
14
|
+
|
|
15
|
+
- Which place and dataset (or the user's own scan), and which feature should the survey reveal?
|
|
16
|
+
- Which classes should be peeled or kept, and which one reading should land?
|
|
17
|
+
|
|
18
|
+
## Use real evidence
|
|
19
|
+
|
|
20
|
+
Ask the user for their own data, scans, files or rights first; otherwise find licence-clean sources (see the [production recipe](references/recipe.md)). Never stand a generated image in for the evidence, and never invent a number. Keep `production/FACTS.md` (each on-screen or spoken claim, its source URL and quoted wording, or the measurement method) and `production/CREDITS.md` (every asset's source, author and licence), and deliver both with the film. CC BY-SA, ODbL, "no known restrictions" or non-commercial terms are not CC0: name them to the user and ask before using them.
|
|
21
|
+
|
|
22
|
+
## Build the look and movement
|
|
23
|
+
|
|
24
|
+
Read `pixijs` and the relevant Graphics, Text, Container, Assets, Mesh or Filters skills. Read `animaguru` before generating assets: generation can supply music, narration or a title background, never the evidence itself. Discover current models and estimates, respect the user's budget, and reuse completed media. Essential text and exact numerical geometry belong in authored canvas content.
|
|
25
|
+
|
|
26
|
+
- Every point is a real return at its measured position: colour by height above ground or by class, value by intensity, never moved into a shape. Points appear behind a front or by height, never by a random fade.
|
|
27
|
+
- Peel with a cutting plane by height above ground, then condense the remaining ground into a raking-lit surface. Exaggerate micro relief only with an on-screen note, and measure on undistorted data.
|
|
28
|
+
- Keep the background near black, fronts a cool near-white and one amber accent for traced features and the reading. Traced features are interpretation: say "traced".
|
|
29
|
+
|
|
30
|
+
Use the [production recipe](references/recipe.md) for sources, the bundled original study and port-specific decisions. It is a technique example, not a prescribed film. Keep motions a function of absolute seconds; separate drawing cadence from camera/light cadence when the material calls for it. Prepare assets locally, preserve async seeking and register actual resource/cue times. Keep essential type editable and localized.
|
|
31
|
+
|
|
32
|
+
## Review and delivery
|
|
33
|
+
|
|
34
|
+
Inspect point sizes and fog at distance, registration between points and surface at the front, the exaggeration note, privacy cropping and the reading against `FACTS.md`. Check representative full-resolution frames, moving playback, desktop/mobile fit and cold seeks. Follow `animaguru-video` for production records, audio mixing and HTML5 delivery; export MP4 when requested. Describe the actual 2D/2.5D rendering method accurately. Physically rendered 3D remains deferred.
|