Communitygithub.com

V4TIME/V4SKILL

p5.js 生成藝術、著色器、互動式與 3D 創作草稿。

V4SKILL 是什麼?

這個技能提供了一個完整的生產管線,用於使用 p5.js 建立互動式和生成式視覺藝術。它涵蓋多種模式,包括生成藝術、資料視覺化、互動體驗、動畫、3D 場景、影像處理和音訊反應式視覺效果。該管線遵循一個六階段流程(概念→設計→編碼→預覽→匯出→驗證),並強調創意卓越,確保每個作品都具有視覺衝擊力、獨特性,並包含設計良好的參數,這些參數會影響演算法的行為,而不僅僅是外觀。此技能支援跨平台使用,包括 Claude Code、Cursor 和 Codex,並包含用於色板、雜訊、粒子系統、形狀語言和動畫風格的詳細參考資料,幫助開發者將創意願景轉化為精緻的瀏覽器內體驗。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/V4TIME/V4SKILL/tree/HEAD/creative/p5js

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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)畫布渲染、數學、變換、事件處理
3Dp5.js WebGL 模式3D 幾何、攝影機、光照、GLSL 著色器
音訊p5.sound.js (CDN)FFT 分析、振幅、麥克風輸入、振盪器
匯出內建 saveCanvas() / saveGif() / saveFrames()PNG、GIF、影格序列輸出
捕捉CCapture.js(可選)確定性幀率影片捕捉(WebM、GIF)
無頭Puppeteer + Node.js(可選)自動化高解析度渲染,透過 ffmpeg 輸出 MP4
SVGp5.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 階段路徑:

概念 → 設計 → 編碼 → 預覽 → 匯出 → 驗證
  1. 概念 — 闡明創意願景:情緒、色彩世界、動作詞彙、獨特之處
  2. 設計 — 選擇模式、畫布尺寸、互動模型、色彩系統、匯出格式。將概念映射到技術決策
  3. 編碼 — 編寫包含內聯 p5.js 的單一 HTML 檔案。結構:全域變數 → preload() → setup() → draw() → 輔助函式 → 類別 → 事件處理常式
  4. 預覽 — 在瀏覽器中開啟,驗證視覺品質。在目標解析度下測試。檢查效能
  5. 匯出 — 捕捉輸出:使用 saveCanvas() 輸出 PNG,使用 saveGif() 輸出 GIF,使用 saveFrames() + ffmpeg 輸出 MP4,使用 Puppeteer 進行無頭批次處理
  6. 驗證 — 輸出是否符合概念?在預期的顯示尺寸下是否具有視覺衝擊力?你會把它裱框起來嗎?

創意指導

美學維度

維度選項參考資料
色彩系統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、OVERLAYreferences/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 中的概念

…

[為翻譯而截斷]

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

相關技能