Was macht Stick-Szene?
Ein Strichmännchen in Kamrans Tinten-und-Butter-Stil erledigt eine Aufgabe, die zeigt, was ein Produkt tut. Die Szene verharrt im Leerlauf (atmet, blickt umher, kratzt sich am Kinn) und spielt bei Auslösung eine 5–8 Sekunden dauernde Aktion ab, um dann wieder in den Ruhezustand zurückzukehren. Es handelt sich um ein einzelnes <canvas>-Element innerhalb eines <stick-scene>-Elements, ohne Abhängigkeiten.
Alles hier ist auf ~90 Szenen auf kamranahmed.info/story erprobt. Folge diesen Mustern; erfinde keinen neuen Zeichenstil.
Dateien
runtime/stick.js: die gesamte Laufzeit. Das Rig (Figur, Posen, Easing, Stift), eine Sammlung von Requisiten, die Bühne und das<stick-scene>-Element. Kopiere es unverändert in den statischen Ordner des Projekts.templates/scene.js: der Ausgangspunkt für eine neue Szene.templates/preview.html+scripts/frames.mjs: rendert eine Szene, die an ausgewählten Zeitpunkten eingefroren ist, in einen Kontaktabzug und meldet Fehler.scripts/motion.mjs: führt eine Szene mit 60 fps aus und meldet Probleme, die ein Standbild verbergen kann: Gelenke, die rucken, ein Arm durchs Gesicht, ein Requisit, das über einen Kopf gezeichnet wird, ein Ellenbogen, der falsch herum absteht oder nach hinten ragt, eine gequetschte Drehung, schlurfende Füße, eine Hand, die zu kurz kommt, und ein Sprung zu Beginn oder Ende der Aktion.references/craft.md: API-Spickzettel, Posen-Kochbuch, Timing-Rezept, Requisiten-Rezepte, Metaphernkatalog und die bereits gemachten Fehler. Lies es, bevor du eine Szene schreibst.examples/: echte Szenen.diffity-review.js(Kommentar → Agent repariert → bestätigen, zwei Figuren, ein Whiteboard und ein Schreibtisch) ist das sauberste vollständige Beispiel.scenes-p3.jsundscenes-p4.jsenthalten ~30 weitere; der Metaphernkatalog in craft.md gibt an, welche Szene welche ist.
Arbeitsablauf
- Verstehe das Produkt. Jeweils ein Satz: Was der Benutzer tut, was er bekommt. Lies die Landingpage oder README, falls vorhanden.
- Schlage 2–3 Metaphern vor und lass den Benutzer wählen, es sei denn, er hat dich gebeten, einfach loszulegen. Ein Satz pro Idee: das Requisit, die Aktion, der Nutzen. Eine gute Metapher ist physisch (Hebel, Stempel, Förderband, Pinnwand, Bilderschiene, Kistenstapel), auf einen Blick ohne Bildunterschrift verständlich und endet mit einem sichtbaren Ergebnis (ein Häkchen, ein Stempel, etwas, das aufsteigt oder aufleuchtet). Siehe den Katalog in craft.md.
- Schreibe die Szene ausgehend von
templates/scene.js. Platziere zuerst Requisiten in festen Weltkoordinaten, dann den Leerlauf, dann die Aktion als Zeitlinie überTSekunden. Giblabeleinen einfachen Satz für Screenreader. - Überprüfe sie mit dem Kontaktabzug. Sieh dir jeden Abzug an, bevor du die Szene für fertig erklärst:
# einmalig, in einem Scratch-Verzeichnis: npm i [email protected] NODE_PATH=<scratch>/node_modules node <skill-dir>/scripts/frames.mjs \ --scene <id> --src pfad/zu/scene.js \ --frames "idle:0,idle:2.5,s:0.8,s:1.6,s:2.4,s:3.2,s:4.0,s:5.0" --fw 400 --out /tmp/<id>.png<skill-dir>ist der Ordner, in dem sich diese SKILL.md befindet. Lies dann das PNG.idle:<sek>friert die Leerlaufschleife ein,s:<sek>einen Moment in der Aktion,u:<0..1>einen Bruchteil davon. Füge@<n>hinzu, um die n-te Wiedergabe zu rendern (s:2.4@1), damit Szenen, die mitS.nvariieren, in jeder Variante überprüft werden. Korrigiere und rendere neu, bis: nichts an den Rändern abgeschnitten ist, kein Requisit ein Gesicht oder das zu erklärende Objekt verdeckt, jede Bewegung für sich allein lesbar ist, Text innerhalb seiner Box mit Platz oben und unten sitzt, Hände vor dem sind, was sie halten, gehaltene Objekte den Körper dort treffen, wo ein echtes Objekt es tun würde (ein Mikrofon am Mund, ein Griff in der Handfläche), Pfeile handgezeichnete Winkel sind, keine gefüllten Dreiecke, und das letzte Bild mit dem Leerlauf übereinstimmt (kein Sprung beim Zurückschleifen). Zwei oder drei Runden sind normal. Überprüfe dann die Bewegung, die der Abzug nicht zeigen kann:Behebe jedenNODE_PATH=<scratch>/node_modules node <skill-dir>/scripts/motion.mjs --scene <id> --src pfad/zu/scene.jsSprung(verwende eine Überblendung der Pose anstatt eines Wechsels),Arm-durch-Gesicht,Kopf-bedeckt(ein Requisit, eine Notiz oder eine Sprechblase über einem Gesicht),Ellenbogen-rückwärts,Ellenbogen-hinten(ein Arm wie ein gebrochener Flügel, länger als einen Moment gehalten),Quetschung,Start-SprungundEnd-Sprung, bis "Bewegung ist sauber" ausgegeben wird. Ein kurzesSchlurfenganz am Anfang oder Ende eines Gangs ist in Ordnung. - Binde sie ein. Kopiere
runtime/stick.jsund die Szenendatei in den statischen Ordner der Website und füge hinzu:In Astro verwende<stick-scene scene="<id>" play="view" style="height:230px; max-width:560px"></stick-scene> <script src="/scenes/stick.js" defer></script> <script src="/scenes/<id>.js" defer></script><script is:inline ... defer>.stick.jsmuss in der Dokumentreihenfolge vor jedem Szenenskript stehen (deferierte Skripte werden in der Reihenfolge ausgeführt und Szenen lesenwindow.RIGbeim Laden). Auf einer Landingpage mit mehreren Szenen platziere jede in einem Rahmen, damit sie nicht auf einer bloßen Grundlinie schwebt: eine abgerundete Karte mit 1px Rahmen, weißem Hintergrund, einem schwachen Punktgitter (radial-gradient(#e6e6e6 1px, transparent 1.2px)bei 14px) und der Bodenband bleibt aktiviert (keinno-floor); die Grundlinie verläuft dann von Kante zu Kante wie eine kleine Bühne. Gib jeder Szene auf der Seite denselben Rahmen und die volle Inhaltsbreite. Lade dann die echte Seite in einem kopflosen Browser, scrolle das Element in den sichtbaren Bereich, warte ~3 s und mache einen Screenshot in Desktop- und Telefonbreite.
Das Element
scene: die ID, die alsSCENES['<id>']registriert ist.play:view(spielt einmal ab, wenn es zur Hälfte sichtbar ist, dann bei Klick; beste Voreinstellung für Landingpages),click,hover(schleift, solange die Maus darüber ist, Klick auf Touch),loop(läuft immer, sparsam verwenden),idle(spielt nie ab).no-floor: entfernt das hellgraue Band unter der Grundlinie. Verwende es auf weißen Seiten.no-ground: entfernt auch die Linie.zoom: skaliert die Zeichnung innerhalb der Box nach oben oder unten (Standard 1).labeloderaria-label: was die Szene zeigt. Standard ist daslabelder Szene.no-font: lädt Balsamiq Sans nicht von Google Fonts (wenn die Website es bereits selbst hostet oder Google nicht aufrufen darf).- Größe mit CSS anpassen. Die Zeichnung passt sich der Höhe an (230px ist die native Größe) und der
widthder Szene in Welteinheiten, zentriert. - Reduzierte Bewegung zeigt ein einzelnes Standbild und spielt nie ab. Szenen außerhalb des Bildschirms werden nicht gezeichnet.
STICK.theme({ butter: '#…', greenInk: '#…' })tauscht die Palettenfarben für die gesamte Seite aus. Bevorzuge lokale Farbkonstanten in der Szene (wie die GitHub-Hinzufügen/Löschen-Grüntöne indiffity-review.js), wenn nur eine Szene sie benötigt.
Stilregeln
- Tinte
#141414, weiße Papierfüllungen, eine Butter- oder Akzent-Hervorhebung, viel leerer Raum. Balsamiq Sans bei 8.5–11px für Wörter, und nur wenige Wörter. - Die Figur ist der Held: Verstecke niemals ihren Kopf oder die aktive Hand hinter einem Requisit. Zeichne zuerst Requisiten, dann Figuren, dann gehaltene oder fliegende Objekte.
- Eine Idee pro Szene. Wenn du eine Bildunterschrift zur Erklärung benötigst, ist die Metapher falsch.
- Zeige das Ergebnis, nicht die Arbeit: Ende mit etwas, das seinen Zustand geändert hat und für einen Moment so bleibt.
- Physische Objekte vor gezeichneten Tieren oder detaillierten Charakteren. Eine zweite Figur (ein Helfer) erhält eine einzelne Farbe über
ink/far. Ein KI-Agent ist ein Roboter:fig(..., { ink: '#d97757', far: '#e8b7a3', bot: { col: '#d97757', dark: '#a8553a', glow, blink, happy } })zeichnet einen abgerundeten Kopf mit einem dunklen Visier und leuchtenden Augen, Ohrbolzen, einer Antennenbirne und einem Brustlicht. Ein zweiter Agent wird in Türkis gehalten (#3d7a8c, dunkel#2a5866, far#a9c9d1). Ein schwarzer Agent funktioniert auch: eine dunklecolerhält automatisch ein weißes Visier und Tintenaugen. Lichtglow, während er arbeitet,happy, wenn er fertig ist, und platziere ein kleines Label (du,agent,claude) unter jeder Figur beiy = 16. - Agenten sollten nicht sofort reagieren. Halte einen Moment inne, nachdem eine Anfrage eintrifft (eine
denke...-Linie, einehmm...-Blase, eine Hand am Kinn, ein langsames Antennenblinzeln), bevor die Arbeit beginnt. - Verwende keine Logos anderer Unternehmen. Produktnamen als Klartext auf einem Requisit sind in Ordnung.