DIV CSS 佈局教程網

給 JavaScript 開發者的 Processing.js 入門指南
編輯:關於JavaScript     

這份入門教學是為有 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 是什麼?

Processing 語言最初由 MIT 開發,源自多媒體實驗室與「美學與運算」研究群體。它的目標是拉近軟體工程師、藝術家與資料視覺化工作者之間的距離,讓寫程式的人和完全不寫程式的人都能相對容易地做出視覺作品。它本身是 Java 的簡化版,並附上一套為繪圖而設計的簡化 API。

它能在 Web 上做什麼?

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 程式碼

這是官方最推薦的方式。步驟是:下載 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 編譯成 JavaScript

用 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;
})

方式三:只寫 JavaScript

既然解析器最終產出的是「接收一個 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 與 JavaScript 混寫

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 的核心概念與那些容易踩到的相容性陷阱。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved