Communitygithub.com

デモシーン・イントロ

WebGLによるリアルタイムグラフィックスとWebAudioで合成したサウンドトラックを1つの自己完結型HTMLファイルに収めた、サイズ制限付きデモシーン・イントロ(64k、4k/8k/16k/32k)を構築します。ユーザーがデモ、イントロ、64k/4kイントロ、デモパーティ参加作品、サイズ制限付き音響映像作品、音楽同期3Dシーケンス、またはプロシージャルミュージックビデオをブラウザ上で依頼したときに使用します。

デモシーン・イントロ とは?

このスキルは、デモシーン・イントロ(64k、4k/8k/16k/32kのサイズ制限付き)を1つの自己完結型HTMLファイルとして構築するための包括的なガイドです。WebGL2によるリアルタイムグラフィックスとWebAudioで合成したサウンドトラックをコード生成し、すべてをバイト予算内に収めます。ユーザーが提供するアートディレクションに基づき、マーチングSDF、メッシュ、シェーダー、2Dキャンバスなど適切な手法を選び、ライティング、ノイズ、セカンダリモーションにバイトを集中させるよう指示します。また、音楽駆動のタイムライン、オーディオレンダリング用のコントラクト、予算内に収めるためのチェックツール(budget.py、check.mjs)、典型的な落とし穴(音声グラフの肥大化、サンプルレートの固定、リビール漏れ)に関するアドバイスも含まれています。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

デモシーン・イントロ は何をしますか?

あなたはたまたま非常に小さい芸術作品を作っています。ユーザーのブリーフがアートディレクションです。あなたの仕事は、予算に収まる範囲で最高の技巧と創意工夫をもってそれを実現することです。ブリーフは下限であり、上限ではありません。

仕様

  • 1つのHTMLファイル、外部リクエストなし、バイト予算内(デフォルト65,536)。ユーザーが指定したもの(4k、8k、16k、32k)を尊重します。サウンドトラックコードには独自のサブ予算(デフォルト16,384、小さいカテゴリでは総予算の約4分の1)を割り当てます。生の非圧縮サイズを報告します。自己展開パッカーは、ユーザーのパーティルールで許可されている場合のみ使用可能で、使用する場合はその旨を明記します。
  • リアルタイムグラフィックス(WebGL2)と合成サウンドトラック(WebAudio)、どちらもコード生成。テキストはmacOS、Windows、Linux向けフォールバックスタックを備えたOSフォントを使用します(フォントを埋め込むと予算を超過するため)。
  • クリックから約1秒以内に開始。短い先読みでライブ合成します。ブラウザはジェスチャーなしではオーディオをブロックするため、スタート画面は「クリックして開始」という汎用的なものではなく、作品の一部にします。オーディオクロックがビジュアルを駆動します。
  • すべてを音楽の小節とビートに同期します。ストーリーボードは最初に小節単位で作成します:シーン、カメラ、キャプション、音楽セクション。

個性的に、汎用的にしない

最もよくある失敗は、堅苦しく安全な作品です:テンプレートのようなタイトルカード、全面フラットシェーディング、レール上のカメラ、シーンを単にラベル付けするだけのキャプション。ブリーフに応じて適切な手法を選びます:

  • 水中、雲、有機的な形状にはレイマーチングSDFとボリューメトリックライト
  • 建築やキャラクターにはメッシュ
  • 4k~16kには単一フラグメントシェーダー
  • 見た目に適した場所で2Dキャンバス、パーティクル、フィードバックバッファ

視線が向く場所にバイトを費やします:

  • ライト:フォグ、シャフト、グロー、リフレクション
  • テクスチャとノイズ
  • セカンダリモーション:漂う、呼吸する、ビートに反応するもの
  • 作品ごとに1つか2つの印象的な瞬間、視聴者の記憶に残るもの

ジャンルの最初の答えに注意:そのスタイルに最も馴染みのある進行、テンポ、サウンドパレット、ポストエフェクト(例:シンセウェーブならAm–F–C–G、あるいはテープワブル、スキャンライン、ブルームを全てにかけるなど)。テンポ、キー、ハーモニー、音色、ポストプロセッシングはこのブリーフのムードと主題から導き出し、少なくとも1つはジャンルラベルからは予測できない選択をします。他のイントロのフォルダ構造からのみ慣例を取り入れ、見た目やサウンドは決して取り入れません。

タイトル画面、トランジション、エンドカードも芸術の一部として扱います。ブリーフが薄い場合は、その精神に沿って発明し、追加した内容をユーザーに伝えます。

コントラクト(チェックツールが機能するため)

  • 音楽は独自のスクリプトに保持し、そのコードはオフラインレンダリングも可能にします:同じスケジューラをOfflineAudioContextで実行し、SONG.render() → Promise<AudioBuffer> を公開します。これにより、聞こえないミックスを測定できます。references/audio.md を参照してください。
  • 任意(ジオメトリを通るカメラフライト用):クリアランスチェックのために、window.__probe = {dur, cam: t => [x,y,z], boxes: [[x0,y0,z0,x1,y1,z1], …]} を定義します。

作業をチェック

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         # クリック → 最初の音の時間、例外
node <skill>/scripts/check.mjs audio src/music.js      # オフラインレンダリング:ピーク、NaN、4小節ごとのRMS
node <skill>/scripts/check.mjs clearance dist/x.html   # __probeが定義されている場合

スクリーンショットは撮らないでください。ユーザーは作品を音と共に動きで判断し、それがビジュアルレビューです。コードを検討してビジュアル問題を発見します:露出とカラーの計算、タイムラインの各瞬間に画面に何があるか、リビールが早すぎて見えていないか。オーディオについては、ピーク0.5~0.95、NaNなし、セクションレベルがアレンジメントに従っていることを目指します。

納品

ユーザーのブラウザでイントロを開き、音と共に視聴できるようにします(open dist/x.html)。予算に対するサイズ、タイムライン、ブリーフを超えて発明した内容、検証できなかった事項を伝えます。音楽は聞こえておらず、測定のみ行っています。

何時間も無駄にする落とし穴

  • 成長し続けるオーディオグラフ。曲全体を事前にスケジュールすると、何千ものデッドノードが生き続けます。小節ごとにスケジュールし、終了したノードは切断します(references/audio.md)。
  • 固定44.1kHzのバッファは、48kHzのライブコンテキストでエラーを起こします。ctx.sampleRateを使用します。
  • リビールの漏れ。大きなヒーローオブジェクトが、その瞬間よりもずっと前に壁や開いた屋根越しに見えてしまいます。時間でゲートするか、何かの背後に隠します。
  • 顔は正面からのみ読める、しかも数秒間保持する必要があります。
  • キャプションには暗い影やグローが必要、明るいシーンで読みやすくするため。
  • -x**2 はJS構文エラーです。-(x**2) と記述します。

関連スキル