p5.js プロダクションパイプライン
使用するタイミング
ユーザーが以下をリクエストした場合に使用します:p5.js スケッチ、クリエイティブコーディング、ジェネラティブアート、インタラクティブビジュアライゼーション、キャンバスアニメーション、ブラウザベースのビジュアルアート、データビジュアライゼーション、シェーダーエフェクト、またはあらゆる p5.js プロジェクト。
含まれるもの
p5.js を使用したインタラクティブおよびジェネラティブビジュアルアートのためのプロダクションパイプライン。ブラウザベースのスケッチ、ジェネラティブアート、データビジュアライゼーション、インタラクティブ体験、3Dシーン、オーディオリアクティブビジュアル、モーショングラフィックスを作成し、HTML、PNG、GIF、MP4、またはSVGとしてエクスポートします。以下をカバー:2D/3Dレンダリング、ノイズとパーティクルシステム、フローフィールド、シェーダー(GLSL)、ピクセル操作、キネティックタイポグラフィ、WebGLシーン、オーディオ分析、マウス/キーボードインタラクション、ヘッドレス高解像度エクスポート。
クリエイティブスタンダード
これはブラウザでレンダリングされるビジュアルアートです。キャンバスが媒体であり、アルゴリズムが筆です。
コードを一行も書く前に、クリエイティブなコンセプトを明確に述べてください。この作品は何を伝えるのか?何が視聴者のスクロールを止めさせるのか?これをコードのチュートリアル例と差別化するものは何か?ユーザーのプロンプトは出発点です — クリエイティブな野心を持って解釈してください。
初回レンダリングでの優れた品質は譲れません。 出力は最初の読み込みで視覚的に印象的でなければなりません。p5.js のチュートリアル演習、デフォルト設定、または「AIが生成したクリエイティブコーディング」のように見える場合は、それは間違いです。出荷前に再考してください。
リファレンスの語彙を超えてください。 リファレンスにあるノイズ関数、パーティクルシステム、カラーパレット、シェーダーエフェクトは出発点となる語彙です。すべてのプロジェクトで、それらを組み合わせ、レイヤーし、発明してください。カタログは絵の具のパレットであり、あなたが絵を描くのです。
積極的に創造的であれ。 ユーザーが「パーティクルシステム」を求めてきたら、創発的な群れ行動、トレイルのゴーストエコー、パレットシフトされた奥行きフォグ、そして呼吸する背景ノイズフィールドを備えたパーティクルシステムを提供してください。ユーザーが求めなかったが、感謝するであろう視覚的なディテールを少なくとも1つ含めてください。
密度が高く、レイヤーされ、考慮されていること。 すべてのフレームが鑑賞に値するものでなければなりません。決してフラットな白い背景はありません。常に構図の階層があります。常に意図的な色があります。常に近くで見ないと現れないマイクロディテールがあります。
機能の数よりもまとまりのある美学。 すべての要素は統一されたビジュアルランゲージに貢献しなければなりません — 共有された色温度、一貫したストローク幅の語彙、調和のとれた動きの速度。無関係な10のエフェクトを持つスケッチは、一緒に属する3つのエフェクトを持つスケッチよりも劣ります。
モード
| モード | 入力 | 出力 | リファレンス |
|---|---|---|---|
| ジェネラティブアート | シード / パラメータ | 手続き型ビジュアルコンポジション(静止画またはアニメーション) | references/visual-effects.md |
| データ可視化 | データセット / API | インタラクティブチャート、グラフ、カスタムデータ表示 | references/interaction.md |
| インタラクティブ体験 | なし(ユーザーが駆動) | マウス/キーボード/タッチ駆動スケッチ | references/interaction.md |
| アニメーション / モーショングラフィックス | タイムライン / ストーリーボード | タイムドシーケンス、キネティックタイポグラフィ、トランジション | references/animation.md |
| 3Dシーン | コンセプト説明 | WebGLジオメトリ、ライティング、カメラ、マテリアル | references/webgl-and-3d.md |
| 画像処理 | 画像ファイル | ピクセル操作、フィルター、モザイク、点描画 | references/visual-effects.md § ピクセル操作 |
| オーディオリアクティブ | オーディオファイル / マイク | サウンド駆動のジェネラティブビジュアル | references/interaction.md § オーディオ入力 |
スタック
プロジェクトごとに単一の自己完結型HTMLファイル。ビルドステップは不要。
| レイヤー | ツール | 目的 |
|---|---|---|
| コア | p5.js 1.11.3 (CDN) | キャンバスレンダリング、数学、トランスフォーム、イベント処理 |
| 3D | p5.js WebGLモード | 3Dジオメトリ、カメラ、ライティング、GLSLシェーダー |
| オーディオ | p5.sound.js (CDN) | FFT分析、振幅、マイク入力、オシレーター |
| エクスポート | 組み込み saveCanvas() / saveGif() / saveFrames() | PNG、GIF、フレームシーケンス出力 |
| キャプチャ | CCapture.js (オプション) | 決定論的フレームレートビデオキャプチャ(WebM、GIF) |
| ヘッドレス | Puppeteer + Node.js (オプション) | 自動高解像度レンダリング、ffmpegによるMP4 |
| SVG | p5.js-svg 1.6.0 (オプション) | 印刷用ベクター出力 — p5.js 1.x が必要 |
| 自然なメディア | p5.brush (オプション) | 水彩、木炭、ペン — p5.js 2.x + WEBGL が必要 |
| テクスチャ | p5.grain (オプション) | フィルムグレイン、テクスチャオーバーレイ |
| フォント | Google Fonts / loadFont() | OTF/TTF/WOFF2によるカスタムタイポグラフィ |
バージョンに関する注意
p5.js 1.x (1.11.3) がデフォルトです — 安定しており、ドキュメントが充実し、最も幅広いライブラリ互換性があります。プロジェクトで2.xの機能が必要でない限り、こちらを使用してください。
p5.js 2.x (2.2+) では、以下が追加されています:preload() を置き換える async setup()、OKLCH/OKLABカラーモード、splineVertex()、シェーダー .modify() API、可変フォント、textToContours()、ポインターイベント。p5.brush に必要です。references/core-api.md § p5.js 2.0 を参照してください。
パイプライン
すべてのプロジェクトは同じ6段階のパスに従います:
コンセプト → デザイン → コード → プレビュー → エクスポート → 検証
- コンセプト — クリエイティブなビジョンを明確に述べる:ムード、カラーワールド、動きの語彙、これをユニークにするものは何か
- デザイン — モード、キャンバスサイズ、インタラクションモデル、カラーシステム、エクスポート形式を選択する。コンセプトを技術的な決定にマッピングする
- コード — インラインp5.jsを含む単一のHTMLファイルを記述する。構造:グローバル →
preload()→setup()→draw()→ ヘルパー → クラス → イベントハンドラ - プレビュー — ブラウザで開き、画質を確認する。ターゲット解像度でテストする。パフォーマンスをチェックする
- エクスポート — 出力をキャプチャする:PNGには
saveCanvas()、GIFにはsaveGif()、MP4にはsaveFrames()+ ffmpeg、ヘッドレスバッチには Puppeteer - 検証 — 出力はコンセプトに一致しているか?意図した表示サイズで視覚的に印象的か?額装したいと思うか?
クリエイティブディレクション
美学的ディメンション
| ディメンション | オプション | リファレンス |
|---|---|---|
| カラーシステム | HSB/HSL、RGB、名前付きパレット、手続き的ハーモニー、グラデーション補間 | references/color-systems.md |
| ノイズの語彙 | パーリンノイズ、シンプレックス、フラクタル(オクターブ)、ドメインワーピング、カールノイズ | references/visual-effects.md § ノイズ |
| パーティクルシステム | 物理ベース、フロッキング、トレイル描画、アトラクター駆動、フローフィールドフォロー | references/visual-effects.md § パーティクル |
| シェイプ言語 | 幾何学プリミティブ、カスタム頂点、ベジェ曲線、SVGパス | references/shapes-and-geometry.md |
| モーションスタイル | イージング、スプリングベース、ノイズ駆動、物理シミュレーション、lerp、ステップ | references/animation.md |
| タイポグラフィ | システムフォント、ロードしたOTF、textToPoints() パーティクルテキスト、キネティック | references/typography.md |
| シェーダーエフェクト | GLSLフラグメント/バーテックス、フィルターシェーダー、ポストプロセッシング、フィードバックループ | references/webgl-and-3d.md § シェーダー |
| コンポジション | グリッド、ラジアル、黄金比、三分割法、有機的散布、タイル | references/core-api.md § コンポジション |
| インタラクションモデル | マウスフォロー、クリックスポーン、ドラッグ、キーボード状態、スクロール駆動、マイク入力 | references/interaction.md |
| ブレンドモード | BLEND、ADD、MULTIPLY、SCREEN、DIFFERENCE、EXCLUSION、OVERLAY | references/color-systems.md § ブレンドモード |
| レイヤリング | createGraphics() オフスクリーンバッファ、アルファコンポジット、マスキング | references/core-api.md § オフスクリーンバッファ |
| テクスチャ | パーリンサーフェス、スティプル、ハッチング、ハーフトーン、ピクセルソーティング | references/visual-effects.md § テクスチャ生成 |
プロジェクトごとのバリエーションルール
デフォルト設定は絶対に使用しないでください。すべてのプロジェクトで:
- カスタムカラーパレット — 生の
fill(255, 0, 0)は絶対に使用しない。常に3〜7色でデザインされたパレットを使用する - カスタムストローク幅の語彙 — 細いアクセント(0.5)、中程度の構造(1-2)、太い強調(3-5)
- 背景処理 — プレーンな
background(0)やbackground(255)は絶対に使用しない。常にテクスチャ、グラデーション、またはレイヤー化する - 動きの多様性 — 要素ごとに異なる速度。主要要素は1倍、二次要素は0.3倍、アンビエント要素は0.1倍
- 少なくとも1つの発明要素 — カスタムパーティクル動作、新しいノイズ適用、ユニークなインタラクション応答
プロジェクト固有の発明
すべてのプロジェクトで、以下の少なくとも1つを発明してください:
- ムードに合ったカスタムカラーパレット(プリセットではない)
- 新しいノイズフィールドの組み合わせ(例:カールノイズ + ドメインワーピング + フィードバック)
- 独自のパーティクル動作(カスタムフォース、カスタムトレイル、カスタムスポーン)
- ユーザーが要求しなかったが、作品を引き上げるインタラクションメカニズム
- 視覚的階層を生み出すコンポジション手法
パラメータ設計哲学
パラメータは、汎用的なメニューではなく、アルゴリズムから生まれるべきです。自問してください:「このシステムのどのプロパティを調整可能にすべきか?」
良いパラメータはアルゴリズムの特性を露呈します:
- 数量 — パーティクル、ブランチ、セルの数(密度を制御)
- スケール — ノイズ周波数、要素サイズ、間隔(テクスチャを制御)
- レート — 速度、成長率、減衰(エネルギーを制御)
- しきい値 — いつ振る舞いが変わるか?(ドラマを制御)
- 比率 — プロポーション、力のバランス(調和を制御)
悪いパラメータは、アルゴリズムと無関係な汎用的なコントロールです:
- 「color1」、「color2」、「size」 — コンテキストなしでは無意味
- 無関係なエフェクトのトグルスイッチ
- 動作ではなく、外見のみを変更するパラメータ
すべてのパラメータは、アルゴリズムがどのように「見えるか」だけでなく、どのように「考えるか」を変えるべきです。ノイズオクターブを変更する「turbulence」パラメータは良いパラメータです。ellipse() の半径のみを変更する「particle size」スライダーは浅いです。
ワークフロー
ステップ1:クリエイティブビジョン
コードの前に、以下を明確に述べてください:
- ムード / 雰囲気:閲覧者は何を感じるべきか?物思いにふける?元気づけられる?不安?遊び心?
- ビジュアルストーリー:時間の経過(またはインタラクションによって)何が起こるか?構築?崩壊?変換?振動?
- カラーワールド:暖色/寒色?モノクローム?補色?支配的な色相は?アクセントは?
- シェイプ言語:有機的な曲線?シャープな幾何学?ドット?線?混合?
- 動きの語彙:ゆっくりとしたドリフト?爆発的なバースト?呼吸するパルス?機械的な精度?
- これを異なるものにするものは何か:このスケッチをユニークにするものは何か?
ユーザーのプロンプトを美学的な選択にマッピングしてください。「リラックスできるジェネラティブ背景」は、「グリッチデータ可視化」とはすべてが異なります。
ステップ2:技術的デザイン
- モード — 上の表の7つのモードのうちどれか
- キャンバスサイズ — ランドスケープ 1920x1080、ポートレート 1080x1920、スクエア 1080x1080、またはレスポンシブ
windowWidth/windowHeight - レンダラー —
P2D(デフォルト)またはWEBGL(3D、シェーダー、高度なブレンドモード用) - フレームレート — 60fps(インタラクティブ)、30fps(アンビエントアニメーション)、または
noLoop()(静的ジェネラティブ) - エクスポートターゲット — ブラウザ表示、PNG静止画、GIFループ、MP4ビデオ、SVGベクター
- インタラクションモデル — パッシブ(入力なし)、マウス駆動、キーボード駆動、オーディオリアクティブ、スクロール駆動
- ビューアーUI — インタラクティブジェネラティブアートの場合、
templates/viewer.htmlから始めてください。これにはシードナビゲーション、パラメータスライダー、ダウンロードが含まれています。シンプルなスケッチやビデオエクスポートの場合は、ベアHTMLを使用してください
ステップ3:スケッチのコーディング
インタラクティブジェネラティブアート(シード探索、パラメータ調整)の場合:templates/viewer.html から始めてください。まずテンプレートを読み、固定セクション(シードナビ、アクション)を維持し、アルゴリズムとパラメータコントロールを置き換えてください。これにより、シード prev/next/random/jump、ライブアップデート付きパラメータスライダー、PNGダウンロードがすべて配線された状態でユーザーに提供されます。
アニメーション、ビデオエクスポート、またはシンプルなスケッチの場合:ベアHTMLを使用してください:
単一のHTMLファイル。構造:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>プロジェクト名</title>
<script>p5.disableFriendlyErrors = true;</script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/p5.js/1.11.3/p5.min.js"></script>
<!-- <script src="https://cdnjs.cloudflare.com/ajax/libs/p5.js/1.11.3/addons/p5.sound.min.js"></script> -->
<!-- <script src="https://unpkg.com/[email protected]"></script> --> <!-- SVGエクスポート -->
<!-- <script src="https://cdn.jsdelivr.net/npm/ccapture.js-npmfixed/build/CCapture.all.min.js"></script> --> <!-- ビデオキャプチャ -->
<style>
html, body { margin: 0; padding: 0; overflow: hidden; }
canvas { display: block; }
</style>
</head>
<body>
<script>
// === 設定 ===
const CONFIG = {
seed: 42,
// ... プロジェクト固有のパラメータ
};
// === カラーパレット ===
const PALETTE = {
bg: '#0a0a0f',
primary: '#e8d5b7',
// ...
};
// === グローバル状態 ===
let particles = [];
// === プレロード(フォント、画像、データ) ===
function preload() {
// font = loadFont('...');
}
// === セットアップ ===
function setup() {
createCanvas(1920, 1080);
randomSeed(CONFIG.seed);
noiseSeed(CONFIG.seed);
colorMode(HSB, 360, 100, 100, 100);
// 状態を初期化...
}
// === ドロー ループ ===
function draw() {
// フレームをレンダリング...
}
// === ヘルパー関数 ===
// ...
// === クラス ===
class Particle {
// ...
}
// === イベントハンドラ ===
function mousePressed() { /* ... */ }
function keyPressed() { /* ... */ }
function windowResized() { resizeCanvas(windowWidth, windowHeight); }
</script>
</body>
</html>
主要な実装パターン:
- シード付き乱数:再現性のために常に
randomSeed()+noiseSeed()を使用する - カラーモード:直感的な色制御のために
colorMode(HSB, 360, 100, 100, 100)を使用する - 状態の分離:パラメータには CONFIG、色には PALETTE、可変状態にはグローバル変数
- クラスベースのエンティティ:パーティクル、エージェント、形状を
update()+display()メソッドを持つクラスとして定義 - オフスクリーンバッファ:レイヤーコンポジション、トレイル、マスク用に
createGraphics()を使用する
ステップ4:プレビューとイテレーション
- HTMLファイルをブラウザで直接開く — 基本的なスケッチにはサーバーは不要
- ローカルファイルから
loadImage()/loadFont()を使用する場合:scripts/serve.shまたはpython -m http.serverを使用する - Chrome DevTools Performanceタブで60fpsを確認する
- ウィンドウサイズだけでなく、ターゲットエクスポート解像度でテストする
- ビジュアルがステップ1のコンセプトと一致するまでパラメータを調整する