這份入門教學是為有 JavaScript 與網頁開發基礎、同時對 Processing 有初步認識的讀者寫的。如果你完全沒聽過 Processing,建議先看過它的官方教學再回來。
如果你急著看到成果,先掌握這幾件事:
1. Processing.js 的作用是把 Processing 程式碼轉譯成能在瀏覽器執行的 JavaScript,底層是透過 <canvas> 元素來繪圖。
2. 到官網下載 processing.js(下文以 1.3.6 版為例)。
3. 建立副檔名為 .pde 的 Processing 檔案,它本質上就是純文字檔,例如 hello-web.pde。
4. 建立一個 HTML 頁面,引入 processing.js,再放一個 <canvas>,並用 data-processing-sources 屬性指向你的 sketch 檔(多個檔案以空白分隔):
<script src="processing-1.3.6.min.js"></script> <canvas data-processing-sources="hello-web.pde"></canvas>
載入頁面後,processing.js 會自動解析並翻譯 sketch 檔,讓它直接跑在瀏覽器裡。
Processing 語言最初由 MIT 開發,源自多媒體實驗室與「美學與運算」研究群體。它的目標是拉近軟體工程師、藝術家與資料視覺化工作者之間的距離,讓寫程式的人和完全不寫程式的人都能相對容易地做出視覺作品。它本身是 Java 的簡化版,並附上一套為繪圖而設計的簡化 API。
Processing 有龐大且活躍的社群,擅長產生 2D/3D 圖形、資料視覺化、音訊與影片處理。而在 HTML5 帶來 canvas、audio、video 這些原本得靠 Flash 或 Java 外掛才能取得的元件之後,加上 JavaScript 引擎效能的大幅提升,把 Processing 移植到瀏覽器就成為顺理成章的事。
這個移植是雙贏的:對 Processing 社群而言,程式碼不再只能跑在桌面;對 Web 社群而言,則多了一個成熟且高階的圖形程式語言。原生 canvas API 對多數開發者來說層級偏低,而 Processing.js 正好可以當作一個更高階的 2D/3D 繪圖封裝來使用。
Processing 語言小而完整,學習曲線平緩。坊間的 Processing 教科書、規範與範例絕大多數都能直接映射到 Processing.js(下面列出的少數例外除外)。你也可以跳過 Processing 慣用的 Java 語法,改用純 JavaScript 搭配 Processing 的繪圖 API。
這是官方最推薦的方式。步驟是:下載 processing.js;建立一個或多個 .pde 檔;建立 HTML 頁面,在 <canvas> 上用 data-processing-sources 屬性列出 sketch 檔名。
<!DOCTYPE html> <html> <head> <title>Hello Web - Processing.js Test</title> <script src="processing-1.3.6.min.js"></script> </head> <body> <h1>Processing.js Test</h1> <p>This is my first Processing.js web-based sketch:</p> <canvas data-processing-sources="hello-web.pde"></canvas> </body> </html>
頁面載入完成後,processing.js 會掃描 DOM 找出帶有該屬性的 canvas,用 XMLHttpRequest 下載檔案,送進翻譯器轉成 JavaScript,最後以 eval 執行。
用 Processing.compile() 就能取得翻譯後的原始碼,也可以搭配相關的建置工具在離線階段完成:
// hard-coded Processing code, text from an HTML widget, downloaded text, etc. var processingCode = "..."; var jsCode = Processing.compile(processingCode).sourceCode;
例如這段 Processing 程式碼:
// Processing code
void setup() {
size(200, 200);
background(100);
stroke(255);
ellipse(50, 50, 25, 25);
println("hello web!");
}
會被編譯成類似下面的形式:
// "Compiled" JavaScript code
// this code was autogenerated from PJS
(function(processing, $constants) {
function setup() {
processing.size(200, 200);
processing.background(100);
processing.stroke(255);
processing.ellipse(50, 50, 25, 25);
processing.println("hello web!");
}
processing.setup = setup;
})
既然解析器最終產出的是「接收一個 processing 實例的函式」,那麼你完全可以跳過 Processing 語法,直接寫這個函式。以下是一個時鐘的範例:
function sketchProc(processing) {
// 覆寫 draw 函式,預設每秒被呼叫 60 次
processing.draw = function() {
var centerX = processing.width / 2,
centerY = processing.height / 2;
var maxArmLength = Math.min(centerX, centerY);
function drawArm(position, lengthScale, weight) {
processing.strokeWeight(weight);
processing.line(
centerX, centerY,
centerX + Math.sin(position * 2 * Math.PI) * lengthScale * maxArmLength,
centerY - Math.cos(position * 2 * Math.PI) * lengthScale * maxArmLength
);
}
processing.background(224);
var now = new Date();
// 時針:依分鐘微幅移動
var hoursPosition = (now.getHours() % 12 + now.getMinutes() / 60) / 12;
drawArm(hoursPosition, 0.5, 5);
// 分針:依秒數微幅移動
var minutesPosition = (now.getMinutes() + now.getSeconds() / 60) / 60;
drawArm(minutesPosition, 0.80, 3);
// 秒針:逐秒跳動
var secondsPosition = now.getSeconds() / 60;
drawArm(secondsPosition, 0.90, 1);
};
}
var canvas = document.getElementById("canvas1");
// 把 sketchProc 掛到 canvas 上(注意要帶 new)
var processingInstance = new Processing(canvas, sketchProc);
這個函式的參數就是 Processing 建構子產生的 runtime 物件,所有 Processing 的方法與常數都作為它的屬性存取。
Processing.js 在轉譯時會把 Processing 程式碼包進函式閉包,因此你宣告的變數與函式並不會掛在 window 上,但仍然可以互相存取。
從 Processing 存取 JavaScript 物件:由於轉譯後的程式碼等同一般函式,能存取全域物件,所以只要在同一頁面的 script 區塊宣告變數或函式,Processing 端就能直接用。首先是 mixed.pde:
String processingString = "Hello from Processing!";
void setup() {
printMessage(jsString + " " + processingString);
}
接著是網頁:
<!DOCTYPE html>
<html>
<head>
<title>Hello Web - Accessing JavaScript from Processing</title>
<script src="processing-1.3.6.min.js"></script>
</head>
<body>
<div id="msg"></div>
<canvas data-processing-sources="mixing.pde"></canvas>
<script type="application/javascript">
var jsString = "Hello from JavaScript!";
var printMessage = function(msg) {
document.getElementById('msg').innerHTML = "Message: " + msg;
};
</script>
</body>
</html>
直接在同一個檔案裡混寫:解析器會保留 Processing 程式碼中夾雜的 JavaScript 原樣不動,因此也可以這樣寫:
var jsString = "Hello from JavaScript!";
var printMessage = function(msg) {
document.getElementById('msg').innerHTML = "Message: " + msg;
};
String processingString = "Hello from Processing!";
void setup() {
printMessage(jsString + " " + processingString);
}
不過有些 JavaScript 語法混寫起來會出問題(例如正則字面值),遇到這種情況,把純 JS 抽到 <script> 區塊裡反而乾淨。
從 JavaScript 控制 Processing:反方向就沒那麼直觀了,因為解析器產生的程式碼不直接暴露在全域,必須透過 Processing.instances 存取。建構子會持續監控實例的建立,並提供 getInstanceById() 方法。預設情況下,帶有 data-processing-sources 屬性的 canvas,其 id 就是該實例的識別碼;若沒有 id,則可用 Processing.instance[0]。
<!DOCTYPE html>
<html>
<head>
<title>Hello Web - Controlling Processing from JavaScript</title>
<script src="processing-1.3.6.min.js"></script>
</head>
<body>
<canvas id="sketch" data-processing-sources="controlling.pde"></canvas>
<button onclick="startSketch();"> Start</button>
<button onclick="stopSketch();"> Stop</button>
<script type="application/javascript">
var processingInstance;
function startSketch() { switchSketchState(true); }
function stopSketch() { switchSketchState(false); }
function switchSketchState(on) {
if (!processingInstance) {
processingInstance = Processing.getInstanceById('sketch');
}
if (on) {
processingInstance.loop(); // 恢復動畫迴圈
} else {
processingInstance.noLoop(); // 暫停動畫
}
}
</script>
</body>
</html>
兩個按鈕分別呼叫 Processing 的 loop() 與 noLoop(),即可控制 sketch 的播放與暫停。
Processing.js 雖力求與 Processing 相容,仍有若干需要留意的落差。
externals 屬性:每個 Processing 實例都有 externals 屬性,內含指向 DOM 與 JavaScript 物件的參照,例如 canvas(sketch 綁定的畫布)、context(畫布的執行環境),以及 onblur、onfocus 等事件處理器。
整數除法:Processing 是強型別語言,整數除以整數會得到整數;JavaScript 一律回傳浮點數。因此當你期望整數結果時,需要顯式轉型:
// before int g = mouseX / i; // after int g = (int)(mouseX / i);
同步 I/O 的模擬:Processing 使用同步 I/O 模型,像 loadImage() 這種耗時方法執行期間程式會停下等待,因此可以立刻把回傳值用在下一行。瀏覽器則是異步模型,外部資源不會等到載入完成才繼續。Processing.js 的解法是用註解形式的「directive」提示預先載入:
PImage img;
void setup() {
img = loadImage("picture.jpg");
image(img, 0, 0);
}
上面這段在瀏覽器中會失敗,因為圖片還沒下載完就已經被繪製。加上預載指示後即可正常運作:
/* @pjs preload="picture.jpg"; */
PImage img;
void setup() {
img = loadImage("picture.jpg");
image(img, 0, 0);
}
這個放在檔案最上方的註解行是給 Processing.js 看的,等於是在程式開始執行前先跑完的額外步驟。多個檔案用逗號分隔:
/* @pjs preload="picture.jpg,picture2.jpg,picture3.png"; */
命名要更小心:JavaScript 是動態弱型別語言,不像 Java 有方法重載。因此不要替變數取與內建函式或 Processing 名稱相同的名字——例如叫 line 的變數會與內建的 line() 衝突。
覆寫重載方法時需要「假覆寫」:如果你的子類覆寫了父類中某個重載方法,為了避免 Processing.js 搞錯方法鏈,即使你不想改動其他簽名,也得把它們補上並轉呼叫 super:
class X {
void doSomething() { ... }
void doSomething(float x, float y) { ... }
}
class Y extends X {
void doSomething() {
// 與父類不同的實作
}
// 即使不打算覆寫,簽名仍必須補上,
// 否則 PJS 會搞錯方法鏈
void doSomething(float x, float y) {
super.doSomething(x, y);
}
}
行內寫法:除了用 data-processing-sourcestype="application/processing" 讓瀏覽器略過它,並用 data-processing-target 與 canvas 的 id 配對:
<script src="processing-1.3.6.min.js"></script>
<script type="application/processing" data-processing-target="pjs">
void setup() {
size(200, 200);
background(100);
stroke(255);
ellipse(50, 50, 25, 25);
println('hello web!');
}
</script>
<canvas id="pjs"></canvas>
這種寫法較囉嗦,因為你得自行處理 script 與 canvas 的配對關係(同一頁可以有多組),也少了外部快取的好處。一般仍建議用外部檔案的方式。
需要補充的是,Processing.js 這個專案早已停止維護,最後版本停留在 1.4.x,對應的是 Processing 1.5 時期的語法。若你今天要開新專案,比較合理的選擇是直接使用 p5.js——它是 Processing 基金會官方推出的 JavaScript 原生重寫版,API 設計相近但更貼近 JS 生態,支援 ES6 模組、 async/await,並持續維護中。本教程的觀念(sketch 結構、setup/draw 生命週期、canvas 繪圖模型)在 p5.js 中幾乎都能直接沿用,只是引入方式從 data-processing-sources 改成 new p5() 或全域模式。
希望這份整理能幫你快速掌握 Processing.js 的核心概念與那些容易踩到的相容性陷阱。