@docyrus/animaguru 0.22.0 → 0.24.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 +9 -3
- package/dist/animaguru.js +311 -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-caption-news/SKILL.md +34 -0
- package/skills/animaguru-caption-news/references/recipe.md +26 -0
- package/skills/animaguru-city-symphony/SKILL.md +34 -0
- package/skills/animaguru-city-symphony/references/recipe.md +26 -0
- package/skills/animaguru-countdown/SKILL.md +34 -0
- package/skills/animaguru-countdown/references/recipe.md +26 -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-kino-montage/SKILL.md +34 -0
- package/skills/animaguru-kino-montage/references/recipe.md +26 -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-news-package/SKILL.md +34 -0
- package/skills/animaguru-news-package/references/recipe.md +26 -0
- package/skills/animaguru-newsreel/SKILL.md +34 -0
- package/skills/animaguru-newsreel/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-telestrator/SKILL.md +34 -0
- package/skills/animaguru-telestrator/references/recipe.md +26 -0
- package/skills/animaguru-visual-investigation/SKILL.md +34 -0
- package/skills/animaguru-visual-investigation/references/recipe.md +26 -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 +137 -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 +379 -0
- package/templates/video/style-source-provenance.json +8 -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,13 @@ 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
|
+
|
|
46
|
+
CLI 0.24.0 adds eight documentary & broadcast styles, cut from real archive footage, documents and data: Caption News, 1920s Newsreel, Live Countdown Split-screen, Time-lapse Symphony, Visual Investigation, Constructivist Montage, Sports Telestrator and Broadcast News Package. Their skills carry the same real-evidence and sourcing discipline as the evidence styles, with licence-clean archive and footage sources per style. Each has a runnable study (`npm run example -- caption-news`).
|
|
47
|
+
|
|
44
48
|
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
49
|
|
|
46
|
-
CLI 0.5.2 includes a complete local PixiJS video workspace with
|
|
50
|
+
CLI 0.5.2 includes a complete local PixiJS video workspace, now with 48 visual styles:
|
|
47
51
|
|
|
48
52
|
```sh
|
|
49
53
|
animaguru templates
|
|
@@ -59,13 +63,15 @@ Open the generated folder in **Codex or Claude Code**, then describe the video y
|
|
|
59
63
|
- 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
64
|
- `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
65
|
|
|
62
|
-
New projects leave category and template unset in `animaguru.project.json`. `animaguru.templates.json` lists categories, styles and their installed skills. The
|
|
66
|
+
New projects leave category and template unset in `animaguru.project.json`. `animaguru.templates.json` lists categories, styles and their installed skills. The 48 visual styles cover cutout, type, vector, technical, evidence, documentary, 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.
|
|
67
|
+
|
|
68
|
+
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
69
|
|
|
64
70
|
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
71
|
|
|
66
72
|
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
73
|
|
|
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
|
|
74
|
+
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
75
|
|
|
70
76
|
## Install the project skill
|
|
71
77
|
|
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.24.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,278 @@ 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
|
|
46020
|
+
},
|
|
46021
|
+
"caption-news": {
|
|
46022
|
+
name: "Caption News",
|
|
46023
|
+
description: "Huge chunk-slammed captions carry a story that reads with the sound off, while footage, documents and data each arrive with the source tag that proves them.",
|
|
46024
|
+
materials: [
|
|
46025
|
+
"Chunk-slammed captions",
|
|
46026
|
+
"Source-tagged footage",
|
|
46027
|
+
"Document highlighter sweeps"
|
|
46028
|
+
],
|
|
46029
|
+
motion: [
|
|
46030
|
+
"Frame-4 rolling number hook",
|
|
46031
|
+
"Keyword wipes in yellow",
|
|
46032
|
+
"Highlighter sweep on the page"
|
|
46033
|
+
],
|
|
46034
|
+
previewCaption: "A hook number rolls in the opening frames, a chunk-slammed caption lands its yellow keyword, and a report page is highlighted before its figure is trusted. Procedural stand-ins for the footage and document, not real sources.",
|
|
46035
|
+
family: "documentary",
|
|
46036
|
+
example: true
|
|
46037
|
+
},
|
|
46038
|
+
newsreel: {
|
|
46039
|
+
name: "1920s Newsreel",
|
|
46040
|
+
description: "A searchlight-and-globe ident, a newspaper spinning into the lens, and a fast announcer carried by a hot band, all inside one silver-graded projector gate.",
|
|
46041
|
+
materials: [
|
|
46042
|
+
"Projected film gate",
|
|
46043
|
+
"Art Deco ident lettering",
|
|
46044
|
+
"Grease-pencil marks"
|
|
46045
|
+
],
|
|
46046
|
+
motion: [
|
|
46047
|
+
"Globe-and-searchlight ident",
|
|
46048
|
+
"Spinning newspaper slam",
|
|
46049
|
+
"Iris wipe to the next story"
|
|
46050
|
+
],
|
|
46051
|
+
previewCaption: "The ident's searchlights snap on, a globe turns under the title, and a headline spins into the lens before the iris closes on a place card. Code-drawn packaging only; no archive footage is shown.",
|
|
46052
|
+
family: "documentary",
|
|
46053
|
+
example: true
|
|
46054
|
+
},
|
|
46055
|
+
countdown: {
|
|
46056
|
+
name: "Live Countdown Split-screen",
|
|
46057
|
+
description: "Real-time footage of one event with a known zero, the screen splitting into more cells as the moment nears and merging into a single picture when the clock hits it.",
|
|
46058
|
+
materials: [
|
|
46059
|
+
"Synced camera cells",
|
|
46060
|
+
"Fixed-slot digit clock",
|
|
46061
|
+
"Sync badges"
|
|
46062
|
+
],
|
|
46063
|
+
motion: [
|
|
46064
|
+
"Cells multiplying toward zero",
|
|
46065
|
+
"Many-into-one merge at zero",
|
|
46066
|
+
"Clock inversion at T plus"
|
|
46067
|
+
],
|
|
46068
|
+
previewCaption: "Cells multiply as the clock counts down, merge into one frame at zero, and the clock flips from counting down to counting up. Illustrative camera feeds, not a real launch.",
|
|
46069
|
+
family: "documentary",
|
|
46070
|
+
example: true
|
|
46071
|
+
},
|
|
46072
|
+
"city-symphony": {
|
|
46073
|
+
name: "Time-lapse Symphony",
|
|
46074
|
+
description: "Time-lapse turns traffic and crowds into rivers of light, cut like a minimalist score that accelerates to a climax and stops dead on a downbeat.",
|
|
46075
|
+
materials: [
|
|
46076
|
+
"Frame-blended light trails",
|
|
46077
|
+
"35mm release-print grade",
|
|
46078
|
+
"Day-ring clock graphic"
|
|
46079
|
+
],
|
|
46080
|
+
motion: [
|
|
46081
|
+
"Traffic sped into light rivers",
|
|
46082
|
+
"Grid of streets multiplying",
|
|
46083
|
+
"Hard cut to black on the beat"
|
|
46084
|
+
],
|
|
46085
|
+
previewCaption: "Traffic blurs into rivers of light as a grid of streets multiplies on the beat, then the score stops dead and the film cuts to black. Procedural city, not a real skyline.",
|
|
46086
|
+
family: "documentary",
|
|
46087
|
+
example: true
|
|
46088
|
+
},
|
|
46089
|
+
"visual-investigation": {
|
|
46090
|
+
name: "Visual Investigation",
|
|
46091
|
+
description: "Footage, documents and sound from one real event laid out on a shared clock, so independent sources check each other and converge on the same second.",
|
|
46092
|
+
materials: [
|
|
46093
|
+
"Synced evidence panels",
|
|
46094
|
+
"Grey ground, one red accent",
|
|
46095
|
+
"Freeze-circle-magnify marks"
|
|
46096
|
+
],
|
|
46097
|
+
motion: [
|
|
46098
|
+
"Panels syncing to one stopwatch",
|
|
46099
|
+
"Freeze, circle and loupe",
|
|
46100
|
+
"Converging red links to a map"
|
|
46101
|
+
],
|
|
46102
|
+
previewCaption: "Three sources light up against one stopwatch, a frozen frame is circled and magnified, and every red link converges on the same point of a map. Illustrative evidence panels, not a real case.",
|
|
46103
|
+
family: "documentary",
|
|
46104
|
+
example: true
|
|
46105
|
+
},
|
|
46106
|
+
"kino-montage": {
|
|
46107
|
+
name: "Constructivist Montage",
|
|
46108
|
+
description: "Real footage and photographs printed as one red-and-ink poster and cut on a machine beat, with scissored figures stacked into the structure they built.",
|
|
46109
|
+
materials: [
|
|
46110
|
+
"Red, ink and paper print",
|
|
46111
|
+
"Diagonal type bands",
|
|
46112
|
+
"Photomontage cut-outs"
|
|
46113
|
+
],
|
|
46114
|
+
motion: [
|
|
46115
|
+
"Grid lighting cell by cell",
|
|
46116
|
+
"Figures stacking into a tower",
|
|
46117
|
+
"Red wipe on the downbeat"
|
|
46118
|
+
],
|
|
46119
|
+
previewCaption: "A grid lights cell by cell, cut-out figures climb and stack into a tower, and a red band wipes to the count on the downbeat. Illustrative silhouettes, not real archive photographs.",
|
|
46120
|
+
family: "documentary",
|
|
46121
|
+
example: true
|
|
46122
|
+
},
|
|
46123
|
+
telestrator: {
|
|
46124
|
+
name: "Sports Telestrator",
|
|
46125
|
+
description: "Play it, rewind it, freeze it: rings under the feet, a marker arrow on the ball, and the picture flattened into a top-down board, drawn over real match footage.",
|
|
46126
|
+
materials: [
|
|
46127
|
+
"Marker rings and arrows",
|
|
46128
|
+
"Frame-counting stopwatch",
|
|
46129
|
+
"Perspective-flattened pitch board"
|
|
46130
|
+
],
|
|
46131
|
+
motion: [
|
|
46132
|
+
"Rewind into a freeze",
|
|
46133
|
+
"Ring and arrow drawn on the play",
|
|
46134
|
+
"Perspective flatten to the board"
|
|
46135
|
+
],
|
|
46136
|
+
previewCaption: "A play rewinds into a freeze, a ring and an arrow mark the move, and the picture flattens into a top-down board with the shot plotted on it. Illustrative match, not a real game.",
|
|
46137
|
+
family: "documentary",
|
|
46138
|
+
example: true
|
|
46139
|
+
},
|
|
46140
|
+
"news-package": {
|
|
46141
|
+
name: "Broadcast News Package",
|
|
46142
|
+
description: "A newsroom bulletin built entirely in code: a sting that becomes the channel bug, a rundown ticked off story by story, and a strap that never leaves the frame.",
|
|
46143
|
+
materials: [
|
|
46144
|
+
"Brand plate sting and bug",
|
|
46145
|
+
"Split-flap price board",
|
|
46146
|
+
"Lower-third strap"
|
|
46147
|
+
],
|
|
46148
|
+
motion: [
|
|
46149
|
+
"Sting flying into the corner bug",
|
|
46150
|
+
"Rundown rows flipping and ticking",
|
|
46151
|
+
"Split-flap board changing value"
|
|
46152
|
+
],
|
|
46153
|
+
previewCaption: "The sting slams in and flies to the corner bug, a rundown's rows flip and tick off one by one, and a split-flap board turns an old value into the new. Illustrative bulletin, procedural graphics throughout.",
|
|
46154
|
+
family: "documentary",
|
|
46155
|
+
example: true
|
|
45867
46156
|
}
|
|
45868
46157
|
},
|
|
45869
46158
|
browseStyles: "Browse animation styles",
|
|
@@ -45877,7 +46166,9 @@ var animation_styles_default = {
|
|
|
45877
46166
|
paper: "Paper & cutout",
|
|
45878
46167
|
character: "Character & pixel",
|
|
45879
46168
|
material: "Materials & depth",
|
|
45880
|
-
cinematic: "Cinema & media"
|
|
46169
|
+
cinematic: "Cinema & media",
|
|
46170
|
+
evidence: "Evidence & data",
|
|
46171
|
+
documentary: "Documentary & broadcast"
|
|
45881
46172
|
},
|
|
45882
46173
|
searchLabel: "Search visual styles",
|
|
45883
46174
|
searchPlaceholder: "Try paper, product, typography\u2026",
|
|
@@ -45974,6 +46265,7 @@ var VIDEO_STYLE_IDS = [
|
|
|
45974
46265
|
"silkscreen-poster",
|
|
45975
46266
|
"art-deco-motion",
|
|
45976
46267
|
"blueprint-drafting",
|
|
46268
|
+
"machine-anatomy",
|
|
45977
46269
|
"holographic-scan",
|
|
45978
46270
|
"paper-popup",
|
|
45979
46271
|
"shadow-theatre",
|
|
@@ -45986,7 +46278,23 @@ var VIDEO_STYLE_IDS = [
|
|
|
45986
46278
|
"stop-motion-objects",
|
|
45987
46279
|
"miniature-diorama",
|
|
45988
46280
|
"sand-drawing",
|
|
45989
|
-
"generative-light-signal"
|
|
46281
|
+
"generative-light-signal",
|
|
46282
|
+
"satellite-briefing",
|
|
46283
|
+
"briefing-board",
|
|
46284
|
+
"lidar-survey",
|
|
46285
|
+
"white-model-projection",
|
|
46286
|
+
"data-physicalization",
|
|
46287
|
+
"exploded-teardown",
|
|
46288
|
+
"microscope-story",
|
|
46289
|
+
"archive-light-table",
|
|
46290
|
+
"caption-news",
|
|
46291
|
+
"newsreel",
|
|
46292
|
+
"countdown",
|
|
46293
|
+
"city-symphony",
|
|
46294
|
+
"visual-investigation",
|
|
46295
|
+
"kino-montage",
|
|
46296
|
+
"telestrator",
|
|
46297
|
+
"news-package"
|
|
45990
46298
|
];
|
|
45991
46299
|
var VIDEO_WORKFLOW_IDS = [
|
|
45992
46300
|
"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-caption-news
|
|
3
|
+
description: Build Caption News 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
|
+
# Caption News
|
|
8
|
+
|
|
9
|
+
Social-video news that reads with the sound off: huge chunk-slammed captions are the lead actor over real footage, photos and documents, and every number arrives with the source tag that proves it. It is a documentary & broadcast style: real footage, photos, documents or data 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#caption-news). Fold missing visual questions into the shared interview:
|
|
14
|
+
|
|
15
|
+
- Which footage, photos or documents do you have, and what is the one turn the hook sets up?
|
|
16
|
+
- Which keyword gets the yellow block, and what should the lower third carry (place, date or speaker)?
|
|
17
|
+
|
|
18
|
+
## Use real evidence
|
|
19
|
+
|
|
20
|
+
Ask the user for their own footage, photos, documents or data first; otherwise find licence-clean sources (see the [production recipe](references/recipe.md)). Never stand a generated image in for the evidence, and never show a number without its source tag in the same shot. 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, "no known restrictions" or unclear licences 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 or Filters skills. Read `animaguru` before generating assets: generation can supply music or narration, never the evidence itself. Discover current models and estimates, respect the user's budget, and reuse completed media. Essential captions, numbers and charts belong in authored canvas content, never baked into footage.
|
|
25
|
+
|
|
26
|
+
- The caption card is the shot: one Chinese line and one English line, chunk-slammed a piece at a time, one keyword per caption wiped into a honey-yellow block; never wrapped.
|
|
27
|
+
- Numbers roll in fixed-width digit cells with their source tag in the same shot; a document highlight sweeps the exact line before its figure is restated as a block.
|
|
28
|
+
- Cuts land on a half-beat grid; transitions are a small fixed set (hard cut, a short white flash, a card sliding in, a split, a lit grid, a mask growing out of a map shape) — never dissolves or page turns.
|
|
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 time on every caption and chart title, source-tag presence beside every number, footage credits in the corner, keyword-wipe timing, and every figure 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,26 @@
|
|
|
1
|
+
# Caption News production recipe
|
|
2
|
+
|
|
3
|
+
The workspace includes an executable original study in `src/studies/scenes.ts`, selected with `caption-news`. 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 -- caption-news`, 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 the licence on each file page: CC0, public domain or CC BY are fine; not CC BY-SA, "no known restrictions", unclear licences or YouTube re-uploads), U.S. federal agencies (USDA, USGS, NASA, NOAA, NARA — works of federal employees are public domain), Internet Archive (public domain or CC0/CC BY items only; U.S. works published before 1931 are public domain), Library of Congress (read each item's rights statement). Official documents and data (reports, statistics, filings) come from the agency's own site. Download into the film's `public/` or `production/` folders, log every request, and record each asset in `production/CREDITS.md` and each claim with its quoted wording in `production/FACTS.md`. Burn a readable footage credit into the frame where the medium calls for one.
|
|
10
|
+
|
|
11
|
+
## Adaptation decisions
|
|
12
|
+
|
|
13
|
+
- Build the caption card and the ledger (data-card) ground as `Text` and `Graphics` over a `Sprite` or video-texture footage layer; the keyword's yellow block is a masked rect wiped left to right behind the chunk.
|
|
14
|
+
- Roll numbers in fixed-width digit cells (a monospace `Text` or `BitmapText` per digit, updated on the ticker) so a counter never jitters; keep its source tag in the same shot.
|
|
15
|
+
- Sweep the document highlight as a `Graphics` rect in a multiply-like blend over the scanned page sprite, animated by an exact clip mask rather than opacity, so the sentence reads as marked, not merely tinted.
|
|
16
|
+
|
|
17
|
+
The study is silent, original procedural art with illustrative values, labelled as such; it demonstrates material, layout and motion, not evidence. Replace its stand-ins with the real footage, photos, documents or data described above, never with generated imagery. The gallery preview uses procedural placeholder footage and documents, labelled illustrative, to demonstrate the caption, keyword-wipe and highlight system without claiming any real source. 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/caption-news/STYLE.md](https://github.com/lemomo-ai/lemo-opuscar/blob/77ee8318df779b0736d7de0abe24387e51023735/styles/caption-news/STYLE.md)
|
|
26
|
+
- [styles/caption-news/demo/main.js](https://github.com/lemomo-ai/lemo-opuscar/blob/77ee8318df779b0736d7de0abe24387e51023735/styles/caption-news/demo/main.js)
|