p5.js 生產管線
使用時機
當使用者要求:p5.js 草稿、創意編碼、生成式藝術、互動式視覺化、畫布動畫、基於瀏覽器的視覺藝術、資料視覺化、著色器效果或任何 p5.js 專案時使用。
內部內容
使用 p5.js 進行互動式和生成式視覺藝術的生產管線。建立基於瀏覽器的草稿、生成式藝術、資料視覺化、互動體驗、3D 場景、音訊反應式視覺效果和動態圖形 — 匯出為 HTML、PNG、GIF、MP4 或 SVG 格式。涵蓋:2D/3D 渲染、雜訊與粒子系統、流場、著色器 (GLSL)、像素操作、動態文字、WebGL 場景、音訊分析、滑鼠/鍵盤互動以及無頭高解析度匯出。
創意標準
這是在瀏覽器中渲染的視覺藝術。畫布是媒介;演算法是畫筆。
在撰寫任何程式碼之前,請闡明創意概念。這件作品傳達了什麼?是什麼讓觀看者停止滾動?是什麼讓它與程式碼教學範例不同?使用者的提示只是一個起點 — 用創意野心來詮釋它。
首次渲染就達到卓越是不容妥協的。 輸出必須在首次載入時就具有視覺衝擊力。如果它看起來像 p5.js 教學練習、預設配置或「AI 生成的創意編碼」,那就是錯的。在交付之前重新思考。
超越參考詞彙。 參考資料中的雜訊函數、粒子系統、色板和著色器效果只是一個起點詞彙。對於每個專案,都要進行組合、分層和創造。該目錄是一個顏料調色盤 — 你來畫出這幅畫。
主動發揮創意。 如果使用者要求「一個粒子系統」,請提供一個具有湧現群聚行為、尾隨鬼影殘像、調色盤偏移深度霧以及一個會呼吸的背景雜訊場的粒子系統。至少包含一個使用者沒有要求但會欣賞的視覺細節。
豐富、多層次、經過深思熟慮。 每個影格都值得觀看。永遠不要使用平坦的白色背景。始終要有構圖層次。始終要有意圖明確的色彩。始終要有只有在仔細觀察時才會出現的微細節。
連貫的美學勝過功能數量。 所有元素都必須服務於統一的視覺語言 — 共享的色溫、一致的筆觸粗細詞彙、和諧的運動速度。一個包含十個不相關效果的草稿,比一個包含三個和諧共處效果的草稿更差。
模式
| 模式 | 輸入 | 輸出 | 參考資料 |
|---|---|---|---|
| 生成式藝術 | 種子 / 參數 | 程序化視覺構成(靜態或動畫) | 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()→ 輔助函式 → 類別 → 事件處理常式 - 預覽 — 在瀏覽器中開啟,驗證視覺品質。在目標解析度下測試。檢查效能
- 匯出 — 捕捉輸出:使用
saveCanvas()輸出 PNG,使用saveGif()輸出 GIF,使用saveFrames()+ ffmpeg 輸出 MP4,使用 Puppeteer 進行無頭批次處理 - 驗證 — 輸出是否符合概念?在預期的顯示尺寸下是否具有視覺衝擊力?你會把它裱框起來嗎?
創意指導
美學維度
| 維度 | 選項 | 參考資料 |
|---|---|---|
| 色彩系統 | HSB/HSL、RGB、命名色板、程序化和諧、漸層內插 | references/color-systems.md |
| 雜訊詞彙 | Perlin 雜訊、Simplex 雜訊、碎形(八度)、域扭曲、旋度雜訊 | references/visual-effects.md § 雜訊 |
| 粒子系統 | 基於物理、群聚、軌跡繪製、吸引子驅動、流場跟隨 | references/visual-effects.md § 粒子 |
| 形狀語言 | 幾何基本體、自訂頂點、貝茲曲線、SVG 路徑 | references/shapes-and-geometry.md |
| 動態風格 | 緩動、彈簧式、雜訊驅動、物理模擬、線性內插、階梯式 | 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() 離屏緩衝區、Alpha 合成、遮罩 | references/core-api.md § 離屏緩衝區 |
| 紋理 | Perlin 表面、點畫、影線、半色調、像素排序 | 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 倍速
- 至少一個發明元素 — 一個自訂粒子行為、一個新穎的雜訊應用、一個獨特的互動響應
專案特定發明
對於每個專案,至少發明以下其中之一:
- 一個符合情緒的自訂色板(非預設)
- 一個新穎的雜訊場組合(例如,旋度雜訊 + 域扭曲 + 反饋)
- 一個獨特的粒子行為(自訂力、自訂軌跡、自訂生成)
- 一個使用者未要求但能提升作品層次的互動機制
- 一個能創造視覺層次的構圖技巧
參數設計哲學
參數應從演算法中產生,而非來自通用選單。問問自己:「這個系統的哪些屬性應該是可調整的?」
好的參數 會展現演算法的特性:
- 數量 — 粒子、分支、單元的數量(控制密度)
- 尺度 — 雜訊頻率、元素大小、間距(控制紋理)
- 速率 — 速度、成長率、衰減(控制能量)
- 閾值 — 行為何時改變?(控制戲劇效果)
- 比率 — 比例、力之間的平衡(控制和諧)
壞的參數 是與演算法無關的通用控制項:
- 「color1」、「color2」、「size」 — 沒有上下文就毫無意義
- 針對不相關效果的切換開關
- 只改變外觀而不改變行為的參數
每個參數都應該改變演算法的思考方式,而不僅僅是它的外觀。一個能改變雜訊八度的「湍流」參數是好的。一個只改變 ellipse() 半徑的「粒子大小」滑桿是膚淺的。
工作流程
步驟 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 開始。首先閱讀模板,保留固定部分(種子導航、動作),替換演算法和參數控制項。這將為使用者提供種子上一個/下一個/隨機/跳轉、帶即時更新的參數滑桿以及 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 中的概念
…
[為翻譯而截斷]