API de bajo nivel de rayos

El Low Level API (Engine.*) está diseñado para la creación versátil de juegos 2D.

Cada función API toma un parámetro. El parámetro debe ser un diccionario y los argumentos deben almacenarse como pares clave-valor.

esqueleto

// Do not define variables outside functions because it's a syntax error.

// Called when the window is created.
func setup() {
    // Return the window configuration.
    return {
        width: 1280,
        height: 720,
        title: "My First Game"
    };
}

// Called once when the game starts.
func start() {
    // Global variables should be defined here.
    posX = 0;
    posY = 0;

    // Create a white 100x100 texture.
    tex = Engine.createColorTexture({
        width: 100,
        height: 100,
        r: 255, g: 255, b: 255, a: 255
    });
}

// Called every frame before rendering.
func update() {
    posX = Engine.mousePosX;
    posY = Engine.mousePosY;
}

// Called every frame to render graphics.
func render() {
    Engine.draw({ texture: tex, x: posX, y: posY });
}

Depurar

print()

Esta API imprime una cadena o vuelca un objeto. Sólo se necesita un argumento que no esté en el diccionario.

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

Tiempo

Tiempo absoluto

func update() {
    // Get the seconds since the last call.
    var curTime = Engine.millisec;
    var dt = (curTime - lastTime) * 0.001;
    lastTime = curTime;

    updateCharacters(dt);
}

Engine.getDate()

Devuelve un diccionario de fechas.

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

Aporte

Estas son variables, no funciones.

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

Representación

Engine.createColorTexture()

Esta API crea una textura con el color especificado y devuelve una textura.

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

Engine.loadTexture()

Esta API carga una textura a partir de activos y devuelve una textura.

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

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

Engine.destroyTexture()

Esta API destruye una textura.

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

Engine.renderTexture()

Esta API representa una textura en la pantalla.

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()

Esta API representa una textura en la pantalla (una versión más simple de Engine.renderTexture()).

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

Engine.renderTexture3D()

Esta API representa una textura en la pantalla.

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.loadFont()

Esta API carga un archivo de fuente de recurso en una ranura de fuente especificada.

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

Engine.createTextTexture()

Esta API crea una textura y dibuja un texto sobre ella.

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

Sonido

Engine.playSound()

Esta API comienza a reproducir un archivo de recursos de sonido en una pista de sonido específica.

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

Engine.playSoundLoop()

Esta API comienza a reproducir un archivo de recursos de sonido en una pista de sonido específica.

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

Engine.stopSound()

Esta API detiene la reproducción de sonido en una pista de sonido específica.

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

Engine.setSoundVolume()

Esta API establece un volumen de sonido en una pista de sonido específica.

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

Guardar datos

Engine.writeSaveData()

Esta API escribe un valor de datos guardados que corresponde a una cadena de clave. Si el valor de los datos guardados es demasiado grande, esta API fallará.

Engine.readSaveData()

Esta API lee el valor de los datos guardados que corresponde a una cadena de clave. El valor de retorno será un objeto que representa un valor de datos guardados. Esta API fallará cuando la clave especificada no esté disponible.

Engine.checkSaveData()

Esta API comprueba si los datos guardados existen para una cadena de clave o no. El valor de retorno es booleano.