Communitygithub.com

demoscene-intro

Créez une intro demoscene en code de taille réduite (64k, ou budgets 4k/8k/16k/32k) sous forme d'un fichier HTML autonome avec des graphismes WebGL temps réel, une bande-son WebAudio synthétisée dans son propre budget, une caméra chorégraphiée et des sous-titres.

Qu'est-ce que demoscene-intro ?

Cette compétence vous permet de construire une production demoscene complète — une œuvre audiovisuelle temps réel — dans un seul fichier HTML respectant des limites de taille strictes (64k par défaut, mais adaptable aux formats 4k, 8k, 16k ou 32k). Le graphisme utilise WebGL2 pour des effets avancés (raymarching, SDF, shaders uniques) et la bande-son est générée via WebAudio avec un sous-budget dédié (typiquement 16 384 octets). Tout est synchronisé sur la musique en mesures et temps, avec une chorégraphie de caméra et des sous-titres intégrés. La compétence inclut des scripts de vérification pour valider la taille, le timing de démarrage, les pics audio et la géométrie, et met en garde contre les pièges courants comme les graphes audio qui s'accumulent ou les révélations qui fuient. Le résultat est une expérience interactive qui commence en une seconde après le clic, avec un écran de démarrage artistique plutôt qu'un générique standard.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LukaszDygon/demoscene/tree/HEAD/skill/demoscene-intro

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Intro Demoscene

Vous créez une œuvre d'art qui se trouve être minuscule. Le brief de l'utilisateur est la direction artistique. Votre travail est de la réaliser avec autant de savoir-faire et d'invention que le budget le permet : le brief est le plancher, pas le plafond.

Le cahier des charges

  • Un seul fichier HTML, aucune requête externe, dans les limites du budget (par défaut 65 536 octets). Respectez ce que l'utilisateur demande : 4k, 8k, 16k, 32k. Le code de la bande-son a son propre sous-budget (par défaut 16 384, soit environ un quart du total pour les petites catégories). Signalez la taille brute, non compressée. Un compresseur auto-extractible n'est acceptable que si les règles de la demoparty le permettent, et si vous en utilisez un, mentionnez-le.
  • Graphismes temps réel (WebGL2) et bande-son synthétisée (WebAudio), tous deux générés par du code. Le texte utilise les polices système avec une pile de secours pour macOS, Windows et Linux, car inclure une police dépasse le budget.
  • Commence environ une seconde après le clic. Synthétisez en direct avec un lookahead court. Les navigateurs bloquent l'audio sans interaction, donc faites de l'écran de démarrage une partie de l'œuvre plutôt qu'un générique « cliquez pour commencer ». L'horloge audio pilote les visuels.
  • Synchronisez tout sur la musique en mesures et temps. Écrivez le storyboard en mesures d'abord : scène, caméra, sous-titres, section musicale.

Faites-le vôtre, pas générique

L'échec le plus courant est une pièce rigide et sécurisée : un carton titre qui ressemble à un modèle, un éclairage plat partout, une caméra sur rails, des sous-titres qui ne font que décrire la scène. Choisissez la technique selon le brief :

  • raymarching de SDF et lumière volumétrique pour l'eau, les nuages, les formes organiques
  • maillages pour l'architecture et les personnages
  • un seul fragment shader pour 4k–16k
  • astuces canvas 2D, particules et buffers de rétroaction si cela sert le rendu

Dépensez les octets là où l'œil se pose :

  • lumière : brouillard, faisceaux, lueur, reflets
  • texture et bruit
  • mouvement secondaire : choses qui dérivent, respirent, réagissent au rythme
  • un ou deux moments signature par pièce que le spectateur retiendra

Méfiez-vous de la première réponse du genre : la progression, le tempo, la palette sonore ou l'effet post-traitement les plus familiers pour le style, comme Am–F–C–G pour la synthwave, ou le wobble magnétique, les lignes de balayage et le bloom partout. Dérivez le tempo, la tonalité, l'harmonie, les timbres et le post-traitement de l'ambiance et du sujet de ce brief, et faites au moins un choix qu'un auditeur ne pourrait pas prédire à partir de l'étiquette du genre. Ne reprenez que la structure de dossiers des autres intros, jamais leur apparence ou leur son.

Traitez l'écran titre, les transitions et le carton de fin comme faisant partie de l'œuvre. Si le brief est mince, inventez dans son esprit et dites à l'utilisateur ce que vous avez ajouté.

Contrats (pour que les outils de vérification fonctionnent)

  • Gardez la musique dans son propre script dont le code peut aussi être rendu hors ligne : exposez SONG.render() → Promise<AudioBuffer> en exécutant le même planificateur sur un OfflineAudioContext. C'est ainsi que vous mesurez un mix que vous ne pouvez pas entendre. Voir references/audio.md.
  • Optionnel, pour les vols de caméra à travers la géométrie : définissez window.__probe = {dur, cam: t => [x,y,z], boxes: [[x0,y0,z0,x1,y1,z1], …]} pour la vérification des dégagements.

Vérifiez votre travail

python3 <skill>/scripts/budget.py dist/x.html --total 65536 --music src/music.js --music-max 16384
node <skill>/scripts/check.mjs e2e dist/x.html         # clic → temps du premier son, exceptions
node <skill>/scripts/check.mjs audio src/music.js      # rendu hors ligne : pic, NaN, RMS par 4 mesures
node <skill>/scripts/check.mjs clearance dist/x.html   # si __probe est défini

Ne prenez pas de captures d'écran : l'utilisateur juge la pièce en la regardant en mouvement avec le son, et c'est la revue visuelle. Repérez les problèmes visuels en raisonnant sur le code : l'exposition et les maths de couleurs, ce qui est à l'écran à chaque instant de la timeline, et si une révélation est visible trop tôt. Pour l'audio, visez un pic de 0,5–0,95, pas de NaN, et des niveaux de section qui suivent l'arrangement.

Livrez

Ouvrez l'intro dans le navigateur de l'utilisateur pour qu'il puisse la regarder avec le son (open dist/x.html). Dites-lui la taille par rapport au budget, la timeline, ce que vous avez inventé au-delà du brief, et ce que vous n'avez pas pu vérifier. Vous n'avez pas entendu la musique ; vous l'avez seulement mesurée.

Pièges qui coûtent des heures auparavant

  • Des graphes audio qui ne font que croître. Planifier toute une chanson d'avance garde des milliers de nœuds morts en vie. Planifiez mesure par mesure et déconnectez les nœuds terminés (references/audio.md).
  • Les buffers à 44,1 kHz fixes échouent sur des contextes live à 48 kHz. Utilisez ctx.sampleRate.
  • Les révélations fuient. Les gros objets héros apparaissent par-dessus les murs et à travers les toits ouverts bien avant leur moment. Filtrez-les dans le temps ou cachez-les derrière quelque chose.
  • Les visages ne se lisent que de face, tenus pendant quelques secondes.
  • Les sous-titres ont besoin d'une ombre sombre ou d'une lueur pour rester lisibles sur des scènes lumineuses.
  • -x**2 est une erreur de syntaxe JS ; écrivez -(x**2).

Skills associés