Android 開發教學筆記 - 研究 Renderscript 以 HelloWorld 為例

此例是一個很簡單的 Renderscript 的 HelloWorld，程式跑起來後，螢幕上只會顯示一個 "Hello World!" 字串，並且隨著你點擊螢幕的位置，該字串就會在那個位置上顯示。

使用方式：

[File]->[Project]->[Android]->[Android Sample Project]->[Android 4.0]->[RenderScript > HelloWorld]

接著簡述架構，共有 4 個檔案需留意：

HelloWorld.java

HelloWorld.java 就像一般 Android app 中的角色，為一個 Activity，裡頭新增一個 HelloWorldView 後，再把它加到自身的 View 身上。除此之外，則是對 Android app 的程式流程資訊(onResume、onPause)傳給 HelloWorldView 處理。

HelloWorldView.java

HelloWorldView.java 是一個繼承於 RSSurfaceView 的物件，用來負責初始化 Renderscript 所需的環境資源，以及接收 View 上頭的事件資訊進行處理，例如 onTouchEvent 等，而此例則是接收 TouchEvent 的位置後，把資訊傳遞給 Renderscript 以決定畫字串的位置。

初始化 Renderscript 運行的環境：

RenderScriptGL.SurfaceConfig sc = new RenderScriptGL.SurfaceConfig();
RenderScriptGL mRS = createRenderScriptGL(sc);
// Create an instance of the script that does the rendering
HelloWorldRS mRender = new HelloWorldRS();
HelloWorldRS mRender.init(mRS, getResources());

更新字串位置：

if (ev.getAction() == MotionEvent.ACTION_DOWN) {
        mRender.onActionDown((int)ev.getX(), (int)ev.getY());
        return true;
}

HelloWorldRS.java

void init(RenderScriptGL rs, Resources res)

負責將 HelloWorldView 初始化 Renderscript 所需的執行環境資源接收起來，用全域變數紀錄。接著執行自身函數 void initRS()。

void initRS()

初始化 mScript 變數，將 Java 與 Renderscript 接起來。其中 mScript = ScriptC_helloworld 代表要使用 helloworld.rs 程式。初始化完後，再 bind 到 Renderscript 執行環境。

void onActionDown(int x, int y)

把座標資訊傳遞給 mScript(helloworld.rs) 使用。

HelloWorld.rs

HelloWorld.rs 的工作主要就只是依據指定的 (gTouchX, gTouchY) 座標把 "Hello World!" 字串印出。負責印出的函式是 int root(void)，回傳的整數代表更新螢幕的時間(ms)，如回傳 20ms 代表每 20ms 作一次 root 內容函式。

From: http://developer.android.com/guide/topics/renderscript/graphics.html
A root() function. This is the main worker function for your Renderscript and calls Renderscript graphics functions to render scenes. This function is called every time a frame refresh occurs, which is specified as its return value. A 0 (zero) specified for the return value says to only render the frame when a property of the scene that you are rendering changes. A non-zero positive integer specifies the refresh rate of the frame in milliseconds.

因此，想要體會 20ms 執行 root 內容函式的話，那更新一下 helloworld.rs 片段程式碼，將 rsgFontColor(1.0f, 1.0f, 1.0f, 1.0f); 更新為 rsgFontColor(rsRand(1.0f), rsRand(1.0f), rsRand(1.0f), 1.0f); 如此一來，就可以看到字串顏色不斷得變化囉。(該程式碼只是字型顏色改成亂數產生而已)

最後一提，不曉得這是不是一個很傷硬體的範例？程式執行沒多久後，我那塊 PandaBoard 就會掛掉 :P 或許 root 裡頭改成回傳 200(ms) 也適合，因為 0.2 秒的反應速度對人來說還 ok 囉。