ONDA BASIC 1

01 / STUDIO

Tu mesa de trabajo

Studio abre el código a todo el ancho. Los menús agrupan las herramientas y las ventanas de configuración conservan el proyecto mientras editas.

Ctrl + O abre un proyecto; Ctrl + S lo descarga como JSON; Ctrl + Enter compila y prueba. En Mac puedes usar Cmd. Guardar descarga un archivo: no sobrescribe automáticamente el que abriste.

El editor comprueba el programa mientras escribes. Pulsa un error para ir a su línea. Tab inserta dos espacios y Enter conserva la sangría. Las ayudas se insertan en la posición del cursor: colócalas dentro de init o frame.

Puedes guardar un borrador con errores. Para probarlo o exportarlo debe compilar correctamente. Al abrir un JSON se requiere el campo source con código en inglés y una carátula de 64 × 48; no hay conversión de proyectos. El JSON conserva código, comentarios, carátula y paleta; el WAV transporta el programa compilado y los datos del juego.

02 / PRIMER JUEGO

Tu primer juego

Abre Archivo → Nuevo juego en Studio. Este ejemplo dibuja un cuadrado que puedes mover con la cruceta. La pantalla mide 320 × 240: x crece hacia la derecha, y hacia abajo.

# Los comentarios empiezan por #.
init
  x = 150
  y_pos = 100
end

frame
  clear 0
  if key("right") then
    x = min(308, x + 100 * dt)
  end
  if key("left") then
    x = max(0, x - 100 * dt)
  end
  rect x, y_pos, 12, 12, 6
  text "MI PRIMER JUEGO", 70, 40, 7, 12
end

init se ejecuta una vez al arrancar. frame se ejecuta continuamente mientras juegas. Cada bloque acaba con end. El bloque init es opcional; frame es obligatorio. Solo puedes tener uno de cada.

dt es el tiempo del fotograma en segundos. Multiplicar una velocidad por dt evita que el movimiento dependa del número de fotogramas. Es una variable de solo lectura; se limita a 0,04 s.

03 / BLOQUES Y BUCLES

Condiciones y repeticiones

if vidas <= 0 then
  finish "GAME OVER"
else
  text vidas, 20, 20, 7, 10
end

repeat i, 10
  rect i * 30, 50, 25, 8, 6
end

else es opcional, igual que la palabra then. El índice de repeat comienza en 0: repeat 10 veces produce los índices 0 a 9. Puedes anidar bloques; cada uno necesita su propio end. La indentación ayuda a leer, pero no cambia el comportamiento.

04 / INSTRUCCIONES

Instrucciones

Una instrucción por línea. Separa los argumentos con comas. Usa comillas dobles para los textos.

Los colores son índices de 0 a 15, en el orden de la paleta del estudio. En la paleta ONDA original, 0 es el fondo oscuro, 6 es verde lima y 7 es blanco cálido. Los píxeles de la carátula también viajan en el cartucho.

05 / VALORES Y CONTROLES

Valores, operadores y funciones

Números: 3, -90, 0.1. Los decimales llevan punto. Textos: "Hola"; puedes escribir \" para incluir comillas. Un # dentro de comillas es texto; fuera de ellas inicia un comentario. Los textos que empiezan por $ están reservados por el formato interno.

Los nombres distinguen mayúsculas y minúsculas. Escribe instrucciones en minúscula y variables con letras a–z, números y guion bajo, empezando por una letra, máximo 21 caracteres. Evita nombres de instrucciones o funciones.

Precedencia, de mayor a menor: paréntesis; signo negativo y not; multiplicación/división/resto; suma/resta; comparaciones de orden; igualdad/desigualdad; and; or. Los operadores numéricos no concatenan texto. Dividir por cero devuelve 0. Las condiciones producen 1 o 0.

En el ordenador: flechas para la cruceta, X o espacio para A, Z para B, Enter para Start y Shift para Select. Mientras escribes en el editor, estas teclas escriben texto: pulsa Probar juego o Ctrl + Enter. La ventana de previsualización recibe el foco para jugar. Escape la cierra y suspende la prueba.

06 / PALETAS Y CARÁTULA

Paletas y animación de colores

Cada juego tiene 16 índices de color. Abre Cinta → Nombre, carátula y paleta. Elige ONDA, una selección de Amstrad CPC o escala de grises, o edita cada índice con el selector de color. Para el CPC, selecciona primero un índice del juego y después uno de sus 27 colores. La representación RGB utiliza intensidades 0, 128 y 255 como aproximación digital del monitor original.

La carátula usa la paleta del juego. Ambos se guardan en el proyecto y viajan por audio. Cambiar de paleta reasigna colores a los índices existentes; no modifica los píxeles. La importación de imágenes busca los colores más próximos de la paleta seleccionada.

# Cambia todos los píxeles dibujados con el índice 8.
ink 8, "#0066CC"

# Rota los colores 8 a 11 una posición hacia índices mayores.
cycle 8, 11, 1

# En sentido contrario.
cycle 8, 11, -1

ink indice, "#RRGGBB" requiere un índice entero entre 0 y 15 y un color hexadecimal de seis cifras. cycle primero, ultimo, pasos incluye los dos extremos; los argumentos son enteros, el rango debe estar entre 0 y 15 y primero no puede superar ultimo. Los pasos negativos invierten el sentido; cero no cambia nada.

Los cambios se aplican a toda la pantalla, incluidos los píxeles dibujados en init. Dos índices con el mismo RGB siguen siendo independientes. Afectan a rectángulos, textos y sprites que usen esos índices. Al reiniciar se recupera la paleta original; la carátula y la copia guardada no se alteran.

Abre Ejemplos → Marea Cromática: la escena se dibuja una vez y las olas avanzan rotando cuatro colores cada 0,15 segundos. A (X) oscurece el cielo; B (Z) pausa las olas. Reserva rangos exclusivos para efectos si no quieres cambiar también al personaje.

07 / TEXTO BITMAP

Texto y fuentes bitmap

La instrucción text usa fuentes bitmap incluidas en el motor. Los tamaños de 6 a 11 usan m5x7 a escala nativa. De 12 a 15 usan Press Start 2P a escala 1; de 16 a 23, a escala 2; y 24, a escala 3. Las coordenadas se redondean a píxeles enteros. El tamaño se ajusta a estas escalas para evitar trazos irregulares. Revisa la anchura al cambiar de tamaño: las fuentes tienen métricas diferentes.

Los caracteres no disponibles se representan con ?. Las fuentes funcionan sin conexión y no aumentan el tamaño de los cartuchos. El menú conserva Space Mono.

08 / AUDIO Y VIBRACIÓN

Sonido, música y vibración

Canales 0 y 1: pulsos; 2: bajo triangular; 3: ruido. Partituras MIDI:tiempos, con 0 para silencio. Se repiten con el reloj del juego y se pausan con él.

init
  music 0, "72:.5 76:.5 79:1 0:1", 120, .3
  music 2, "48:1 55:1", 120, .4
end
frame
  # En un evento del juego:
  # note 1, 84, .12, .5
  # vibrate 40, .5
end

music, note, silence y vibrate comparten un máximo de ocho llamadas por fotograma. Todos los cartuchos usan VM 3.

Para sonidos de acciones, detecta la pulsación nueva. Si reproduces una nota en cada fotograma mientras se mantiene un botón, la reiniciarás continuamente:

init
  last_a = 0
end
frame
  if key("a") and not last_a then
    note 0, 76, .12, .3
    vibrate 25, .3
  end
  last_a = key("a")
end

Para una melodía puntual, programa sus notas con un contador y dt, o detén la partitura con silence al terminar. music se repite hasta que la detienes.

09 / LÍMITES Y EXPORTACIÓN

Tamaño y límites

La barra inferior de Studio muestra el tamaño real de la cinta, el programa descomprimido y una estimación de duración del audio en modo Original. Son medidas diferentes: el texto que escribes se compila y el programa resultante se comprime.

No hay funciones propias, importaciones, acceso a red o archivos, ni ejecución de JavaScript desde el juego. Si agotas el presupuesto de ejecución, el motor detiene el cartucho.

La sintaxis válida no garantiza que el juego esté equilibrado: prueba giros, colisiones, pausas, derrota y victoria. Las cintas ya exportadas conservan sus reglas; exporta otro WAV para compartir una versión nueva.

Consultar el formato interno y la referencia del motor ↗