Referencia API

Referencia API Completa

También disponible en forma corta dentro del mismo Editor:

Constructores de Activos

Los constructores crean los principales tipos de activos utilizados por el editor. Cuando asignas uno a una variable, el editor lo reconoce y te permite abrir el editor de activos correspondiente con Ctrl+Click.

Métodos de Lista

Crea listas con [] o [valor1, valor2, ...]. Lee y sobrescribe entradas con list[index], e itera con for (var i = 0; i < list.length(); i = i + 1).

Operadores

Los operadores son pequeños símbolos que realizan cálculos comunes. El operador módulo es especialmente útil para envolver temporizadores, índices, pasos de animación o patrones repetitivos.

Propiedades de Objeto

Los objetos son las cosas que tu script normalmente mueve y cambia durante el juego. Estas funciones leen o actualizan la posición, sprite, comportamiento de colisión, capa y tinte visual de un objeto.

Funciones de Sprite

Las funciones de sprite permiten al código inspeccionar o modificar los datos de píxeles del sprite y la velocidad de animación. La mayoría de los juegos dibujan sprites en el editor, pero estas funciones son útiles para efectos procedimentales, depuración o cambios simples en tiempo de ejecución.

Funciones de Animación

Las funciones de animación trabajan en objetos que usan sprites con múltiples fotogramas. Úsalas cuando quieras que el código inspeccione o fuerce el fotograma de animación actual.

Funciones de Transformación (Flip/Rotación)

Las funciones de transformación cambian cómo se dibuja el sprite de un objeto sin editar el sprite mismo. Son buenas para reutilizar un sprite en múltiples direcciones.

El desplazamiento del centro predeterminado es [0.5, 0.5], que rota alrededor del medio del sprite. [0, 0] rota alrededor de la ubicación superior izquierda del objeto, y [1, 1] rota alrededor de location + (width, height).

Advertencia para proyectos más antiguos: A partir de Tiniest2D 1.8, getRotation() y setRotation() utilizan ángulos en grados en lugar de valores de un cuarto de vuelta. Los colliders de objetos rotados ahora afectan la física y las consultas de escena.

Tipos de Colisión

Los tipos de colisión deciden cómo un objeto participa en las verificaciones de colisión. Elige el tipo basado en el rol del objeto: las paredes son generalmente estáticas, los jugadores son generalmente dinámicos, y los pickups a menudo son disparadores.

Funciones de Escena

Las funciones de escena controlan qué escena está activa, qué objetos están dentro de ella y ajustes generales de la escena como el color de fondo y la gravedad. También proporcionan ayudantes de búsqueda para encontrar objetos en posiciones o por nombre.

Reproducción de Audio

Las funciones de reproducción de audio inician y detienen activos de audio desde el script. playAudio() retorna un identificador de manejo para que puedas detener o verificar más tarde esa instancia de reproducción específica.

Funciones de Pantalla

Las funciones de pantalla ayudan cuando necesitas conocer el tamaño de la ventana o convertir entre píxeles de pantalla y posiciones del mundo. Esto es útil para apuntar con el mouse, detección de clics y UI consciente de la cámara.

Modo de Ventana

Controla el modo de ventana para los juegos exportados. Estas funciones no tienen efecto al jugar en el editor (el editor tiene mayor autoridad sobre el estado de la ventana).

Ejemplo:

func start() {
    // Establecer modo de ventana (WINDOW_MAXIMIZED es el predeterminado para juegos exportados)
    setWindowMode(WINDOW_MAXIMIZED())
}

Nota: Si setWindowMode() nunca se llama en un juego exportado, el predeterminado es WINDOW_MAXIMIZED.

Funciones de UI

La UI utiliza una resolución de espacio de pantalla virtual. El espacio de UI predeterminado es 100 x 100. El tamaño de fuente se puede aumentar para los siguientes widgets de texto con uiPushFontSize(size) y restaurarse con uiPopFontSize(). Los colores de las fuentes se pueden apilar con uiPushFontColor(r, g, b[, a]), y los rellenos de elementos de UI se pueden apilar con uiPushElementColor(r, g, b[, a]). Al igual que el resto de la UI en modo inmediato, estas configuraciones se aplican mientras se construye la UI del marco actual. Si el tamaño empujado es 0 o menos, el motor utiliza el tamaño automático.

Constantes de Estado de UI

Las funciones de UI devuelven constantes de estado para que tu script pueda saber si un widget está inactivo, sobrevolado, sostenido o clicado. Por lo general, UI_CLICKED() es el valor que compruebas para acciones de botón.

Funciones de Cámara

La posición de la cámara representa el centro de la vista. El zoom mantiene una vista del mundo vertical consistente sin importar el tamaño de la pantalla.

Comportamiento del zoom: El zoom mantiene una vista del mundo vertical consistente sin importar el tamaño de la ventana o la relación de aspecto. Las pantallas más anchas muestran más horizontalmente, pero la misma cantidad verticalmente.

Funciones de Entrada

Las funciones de entrada permiten que el juego reaccione al estado del teclado y del mouse. Usa Pressed para acciones de un solo fotograma, Held para movimiento continuo, y Released para acciones que ocurren cuando se suelta un botón.

Constantes de Botón del Mouse

Las constantes de botón del mouse se pasan a las funciones de entrada del mouse. Hacen que el código sea más fácil de leer que los números en bruto.

Constantes de Tecla

Las constantes de tecla se pasan a las funciones de entrada del teclado. El motor expone letras, números, teclas de función, flechas, y un pequeño conjunto de teclas especiales comunes.

Letras: KEY_A() a KEY_Z()

Números: KEY_0() a KEY_9()

Teclas de función: KEY_F1() a KEY_F12()

Teclas especiales: | Constante | Tecla | |----------|-----| | KEY_SPACE() | Barra espaciadora | | KEY_ENTER() | Enter/Return | | KEY_ESCAPE() | Escape | | KEY_TAB() | Tab | | KEY_BACKSPACE() | Retroceso | | KEY_DELETE() | Suprimir | | KEY_SHIFT() | Shift | | KEY_CTRL() | Control | | KEY_ALT() | Alt | | KEY_LEFT() | Flecha izquierda | | KEY_RIGHT() | Flecha derecha | | KEY_UP() | Flecha hacia arriba | | KEY_DOWN() | Flecha hacia abajo | | KEY_HOME() | Inicio | | KEY_END() | Fin |

Funciones Matemáticas

Los ayudantes matemáticos cubren cálculos comunes utilizados en movimiento, animación, aleatoriedad y límites de valores. Mantienen los scripts más cortos y fáciles de leer.

Funciones de Utilidad

Las funciones de utilidad son ayudas generales que no pertenecen a un tipo de activo específico. print() es especialmente útil mientras aprendes porque muestra lo que tu script está haciendo.

Funciones de Cadena

Las funciones de cadena trabajan con valores de texto. Por ahora, esta sección es intencionalmente pequeña.

Funciones de Almacenamiento

Guarda y carga datos del juego en archivos. Soporta números, cadenas, booleanos y listas (incluyendo listas anidadas). NO soporta valores de Sprite, Escena, Objeto o Audio.

Ejemplo: Guardando y Cargando el Progreso del Jugador

// Guardar datos del jugador
var playerData = [100, "Jugador1", true, [1, 2, 3]]
var savePath = getAppDataPath() + "/MiJuego/save.dat"
if (save(savePath, playerData)) {
    print("¡Juego guardado!")
}

// Cargar datos del jugador
if (fileExists(savePath)) {
    var loaded = load(savePath)
    if (loaded != null) {
        var health = loaded[0]
        var name = loaded[1]
        var hasKey = loaded[2]
        var inventory = loaded[3]
    }
}

// Guardado cifrado (para ocultar datos de inspección casual)
var secretData = ["secreto", 12345]
save(getAppDataPath() + "/MiJuego/config.dat", secretData, "binary", "miClaveSecreta")
var decrypted = load(getAppDataPath() + "/MiJuego/config.dat", "miClaveSecreta")

// Formato de texto (legible por humanos, útil para depuración)
save(getAppDataPath() + "/MiJuego/debug.txt", playerData, "text")

Notas:

• El formato binario (predeterminado) es compacto y más rápido
• El formato de texto es legible por humanos, útil para depuración
• La clave de cifrado incorrecta devuelve null (los datos serán basura)
• Los directorios se crean automáticamente al guardar