Ray 低階 API 參考

Low Level API (Engine.*) 是為多樣化的 2D 遊戲製作而設計的。

每個 API 函式都只接受一個引數。 該引數必須是字典，而引數必須以鍵值對方式存放。

骨架

// 請勿在函式外定義變數，這會造成語法錯誤。

// 視窗建立時呼叫。
func setup() {
    // 回傳視窗設定。
    return {
        width: 1280,
        height: 720,
        title: "My First Game"
    };
}

// 遊戲開始時只呼叫一次。
func start() {
    // 全域變數應該在這裡定義。
    posX = 0;
    posY = 0;

    // 建立一張白色的 100x100 紋理。
    tex = Engine.createColorTexture({
        width: 100,
        height: 100,
        r: 255, g: 255, b: 255, a: 255
    });
}

// 每一幀在渲染前呼叫。
func update() {
    posX = Engine.mousePosX;
    posY = Engine.mousePosY;
}

// 每一幀用來繪製圖形。
func render() {
    Engine.draw({ texture: tex, x: posX, y: posY });
}

除錯

print()

這個 API 會列印字串或轉儲物件。 只接受非字典引數。

func dumpEnemies() {
    if (Engine.isGamepadXPressed) {
        print("[Current emenies]");
        print(enemies);
    }
}

時間

絕對時間

func update() {
    // 取得距離上次呼叫經過的秒數。
    var curTime = Engine.millisec;
    var dt = (curTime - lastTime) * 0.001;
    lastTime = curTime;

    updateCharacters(dt);
}

Engine.getDate()

回傳日期字典。

func frame() {
    var date = Engine.getDate({});

    var year  = date.year;
    var month = date.month;
    var day   = date.day;
    var hour  = date.hour;
    var min   = date.minute;
    var sec   = date.second;
}

輸入

以下是變數，不是函式。

func update() { if (Engine.isMouseLeftPressed) { player.x = player.x + 100; } }

Rendering

Engine.createColorTexture()

此 API 會以指定顏色建立一個材質貼圖並回傳。

func createBlockTexture() { blockTex = Engine.createColorTexture({ width: 16, height: 16, r: 255, g: 255, b: 255, a: 255 }); }

Engine.loadTexture()

此 API 會從資產載入貼圖並回傳。

` func loadPlayerTexture() { playerTex = Engine.loadTexture({ file: "player.png" });

var width = playerTex.width; var height = playerTex.height; } `

Engine.destroyTexture()

此 API 會銷毀貼圖。

func destroyPlayerTexture() { Engine.loadTexture({ texture: playerTex }); }

Engine.renderTexture()

此 API 會將貼圖渲染到畫面上。

func renderPlayer() { Engine.renderTexture({ dstLeft: playerPos.x, dstTop: playerPos.y, dstWidth: playerTex.width, dstHeight: playerTex.height, texture: playerTex, srcLeft: 0, srcTop: 0, srcWidth: playerTex.width, srcHeight: playerTex.height, alpha: 255 }); }

Engine.draw()

此 API 會將貼圖渲染到畫面上（比 Engine.renderTexture() 更簡單的版本）。

func renderPlayer() { Engine.draw({ texture: playerTex, x: playerPos.x, y: playerPos.y }); }

Engine.renderTexture3D()

此 API 會將貼圖渲染到畫面上。

func renderPlayer3D() { Engine.renderTexture3D({ x1: playerPos.x, y1: playerPos.y, x2: playerPos.x + playerTex.width, y2: playerPos.y, x3: playerPos.x + playerTex.width, y3: playerPos.y + playerTex.height, x4: playerPos.x, y4: playerPos.y + playerTex.height, texture: playerTex, srcLeft: 0, srcTop: 0, srcWidth: playerTex.width, srcHeight: playerTex.height, alpha: 255 }); }

Engine.loadFont()

此 API 會將資產字型檔載入到指定字型槽。

func loadNotoSansFont() { Engine.loadFont({ slot: 0, file: "NotoSans.ttf" }); }

Engine.createTextTexture()

此 API 會建立貼圖並在其上繪製文字。

func createScoreTexture() { scoreTex = Engine.createTextTexture({ slot: 0, text: "Score: " + score, size: 32, r: 255, g: 255, b: 255, a: 255 }); }

Sound

Engine.playSound()

此 API 會開始播放指定音效資產檔。

func playJumpSound() { Engine.playSound({ stream: 0, file: "jump.ogg" }); }

Engine.playSoundLoop()

此 API 會開始播放指定音效資產檔。

func playBGM() { Engine.playSoundLoop({ stream: 0, file: "jump.ogg" }); }

Engine.stopSound()

此 API 會停止指定音軌上的音效播放。

func playJumpSound() { Engine.stopSound({ stream: 0 }); }

Engine.setSoundVolume()

此 API 會設定指定音軌的音量。

func playJumpSound() { Engine.setSoundVolume({ stream: 0, volume: 1.0 }); }

Save Data

Engine.writeSaveData()

此 API 會寫入與 key 字串對應的存檔資料值。 如果存檔資料值太大，這個 API 會失敗。

Engine.readSaveData()

此 API 會讀取與 key 字串對應的存檔資料值。 回傳值會是一個代表存檔資料值的物件。 當指定的 key 不可用時，此 API 會失敗。

Engine.checkSaveData()

此 API 會檢查指定 key 字串是否存在存檔資料。 回傳值為布林值。