Stick scene
Un personnage en bâtonnets dans le style encre-et-beurre de Kamran effectue une tâche unique qui illustre le fonctionnement d'un produit. La scène reste en veille (respire, regarde autour, se gratte le menton) et joue une action de 5 à 8 secondes lorsqu'elle est déclenchée, puis revient à son état de repos. Il s'agit d'un seul <canvas> à l'intérieur d'un élément <stick-scene>, sans dépendances.
Tout ici est éprouvé sur environ 90 scènes sur kamranahmed.info/story. Partez de ces modèles ; n'inventez pas un nouveau style de dessin.
Fichiers
runtime/stick.js: l'intégralité du runtime. Le rig (personnage, poses, easing, stylo), un kit d'accessoires, la scène et l'élément<stick-scene>. Copiez-le tel quel dans le dossier statique du projet.templates/scene.js: le point de départ pour une nouvelle scène.templates/preview.html+scripts/frames.mjs: génère une planche-contact d'une scène figée à des moments choisis, et signale les erreurs.scripts/motion.mjs: parcourt une scène à 60 ips et signale les problèmes qu'une image fixe peut cacher : articulations qui sautent, bras traversant le visage, accessoire dessiné par-dessus la tête, coude plié dans le mauvais sens ou qui dépasse derrière, mouvement écrasé, pieds qui glissent, main qui tombe trop court, et un saut au début ou à la fin de l'action.references/craft.md: aide-mémoire de l'API, recettes de poses, recette de timing, recettes d'accessoires, catalogue de métaphores et les erreurs déjà commises. Lisez-le avant d'écrire une scène.examples/: scènes réelles.diffity-review.js(commentaire → agent corrige → approuve, deux personnages, un tableau et un bureau) est l'exemple complet le plus propre.scenes-p3.jsetscenes-p4.jscontiennent environ 30 autres scènes ; le catalogue de métaphores dans craft.md indique quelle scène est laquelle.
Flux de travail
- Comprendre le produit. Une ligne chacune : ce que l'utilisateur fait, ce qu'il obtient. Lisez la page d'accueil ou le README s'il existe.
- Proposer 2–3 métaphores et laissez l'utilisateur choisir, sauf s'il vous a demandé de commencer directement. Une idée par ligne : l'accessoire, l'action, le résultat. Une bonne métaphore est physique (levier, tampon, convoyeur, tableau d'affichage, rail d'images, pile de caisses), se lit en un coup d'œil sans la légende, et se termine par un résultat visible (une coche, un tampon, quelque chose qui monte ou s'allume). Consultez le catalogue dans craft.md.
- Écrire la scène à partir de
templates/scene.js. Disposez d'abord les accessoires en coordonnées mondiales fixes, puis la veille, puis l'action sous forme de chronologie surTsecondes. Donnez àlabelune phrase simple pour les lecteurs d'écran. - Vérifier avec la planche-contact. Regardez chaque planche avant de considérer le travail comme terminé :
# une fois, dans un répertoire temporaire : npm i [email protected] NODE_PATH=<scratch>/node_modules node <skill-dir>/scripts/frames.mjs \ --scene <id> --src path/to/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>est le dossier contenant ce SKILL.md. Lisez ensuite le PNG.idle:<sec>fige la boucle de repos,s:<sec>un moment de l'action,u:<0..1>une fraction de celle-ci. Ajoutez@<n>pour afficher la n-ième exécution (s:2.4@1), afin que les scènes qui varient avecS.naient chaque variante vérifiée. Corrigez et regénérez jusqu'à ce que : rien ne soit rogné sur les bords, aucun accessoire ne couvre un visage ou l'objet expliqué, chaque temps fort soit lisible en soi, le texte soit à l'intérieur de son cadre avec de l'espace au-dessus et en dessous, les mains soient devant ce qu'elles tiennent, les objets tenus rencontrent le corps là où un vrai le ferait (un micro à la bouche, une poignée dans la paume), les flèches soient des chevrons dessinés à la main, pas des triangles pleins, et la dernière image corresponde à la veille (pas de saut lors du retour en boucle). Deux ou trois cycles est normal. Vérifiez ensuite le mouvement, que la planche ne peut pas montrer :Corrigez chaqueNODE_PATH=<scratch>/node_modules node <skill-dir>/scripts/motion.mjs --scene <id> --src path/to/scene.jsjump(mélangez la pose au lieu de la changer brusquement),arm-through-face,head-covered(un accessoire, une note ou une bulle dessiné par-dessus un visage),bent-back-elbow,elbow-out-back(un bras en aile brisée tenu plus d'un instant),squash,start-popetend-popjusqu'à ce que le script affiche "motion is clean". Un courtskateau tout début ou à la fin d'une marche est acceptable. - Intégrer. Copiez
runtime/stick.jset le fichier de la scène dans le dossier statique du site et ajoutez :Dans Astro, utilisez<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.jsdoit venir avant chaque script de scène dans l'ordre du document (les scripts différés s'exécutent dans l'ordre et les scènes lisentwindow.RIGau chargement). Sur une page d'accueil avec plusieurs scènes, placez chacune dans un cadre pour qu'elle ne flotte pas sur une ligne de fond nue : une carte arrondie avec une bordure de 1px, fond blanc, un léger quadrillage de points (radial-gradient(#e6e6e6 1px, transparent 1.2px)à 14px) et la bande de sol conservée (pas deno-floor) ; la ligne de sol court alors d'un bord à l'autre comme une petite scène. Donnez à chaque scène de la page le même cadre et la même largeur de contenu complet. Chargez ensuite la page réelle dans un navigateur sans tête, faites défiler l'élément dans la vue, attendez environ 3 secondes et prenez une capture d'écran aux largeurs de bureau et de téléphone.
L'élément
scene: l'identifiant enregistré sousSCENES['<id>'].play:view(joue une fois lorsque la moitié est visible, puis au clic ; meilleur défaut pour les pages d'accueil),click,hover(boucle tant que la souris est dessus, clic sur tactile),loop(toujours en cours, à utiliser avec parcimonie),idle(ne joue jamais).no-floor: supprime la bande gris clair sous la ligne de sol. À utiliser sur des pages blanches unies.no-ground: supprime aussi la ligne.zoom: agrandit ou réduit le dessin à l'intérieur du cadre (défaut 1).labelouaria-label: ce que montre la scène. Par défaut, lelabelde la scène.no-font: ne charge pas Balsamiq Sans depuis Google Fonts (lorsque le site l'héberge déjà lui-même ou ne doit pas appeler Google).- Dimensionnez-le avec CSS. Le dessin s'adapte à la hauteur (230px est la taille native) et à la
widthde la scène en unités monde, centré. - Le mouvement réduit (prefers-reduced-motion) affiche une seule image fixe et ne joue jamais. Les scènes hors écran ne se dessinent pas.
STICK.theme({ butter: '#…', greenInk: '#…' })échange les couleurs de la palette pour toute la page. Préférez les constantes de couleur locales dans la scène (comme les verts d'ajout/suppression GitHub dansdiffity-review.js) lorsqu'une seule scène en a besoin.
Règles de style
- Encre
#141414, remplissages de papier blanc, un seul accent beurre ou couleur vive, beaucoup d'espace vide. Balsamiq Sans en 8,5–11px pour tout texte, et seulement quelques mots. - Le personnage est le héros : ne cachez jamais sa tête ou la main active derrière un accessoire. Dessinez d'abord les accessoires, puis les personnages, puis les objets tenus ou volants.
- Une idée par scène. Si vous avez besoin d'une légende pour l'expliquer, la métaphore est erronée.
- Montrez le résultat, pas le travail : terminez sur quelque chose qui a changé d'état et qui reste un instant.
- Objets physiques plutôt qu'animaux dessinés ou personnages détaillés. Un deuxième personnage (un assistant) reçoit une seule couleur via
ink/far. Un agent IA est un robot :fig(..., { ink: '#d97757', far: '#e8b7a3', bot: { col: '#d97757', dark: '#a8553a', glow, blink, happy } })dessine une tête arrondie avec une visière sombre et des yeux lumineux, des boulons d'oreille, une ampoule d'antenne et une lumière de poitrine. Un deuxième agent devient turquoise (#3d7a8c, dark#2a5866, far#a9c9d1). Un agent noir fonctionne aussi : uncolsombre obtient automatiquement une visière blanche et des yeux à l'encre. Allumezglowlorsqu'il travaille,happylorsqu'il a terminé, et placez une petite étiquette (vous,agent,claude) sous chaque personnage ày = 16. - Les agents ne doivent pas réagir instantanément. Marquez une pause après qu'une demande est reçue (une ligne
thinking…, une bullehmm…, une main au menton, un lent clignement d'antenne) avant que le travail ne commence. - N'utilisez pas les logos d'autres entreprises. Les noms de produits en texte brut sur un accessoire sont acceptables.