audio

Reproduce y controla sonidos: reproducir, pausar, reanudar, detener y ajustar el volumen.

importar
usar std/pincel/audio

Tipos

audio.Onda

La forma de onda de audio.tono, que decide su timbre: .Cuadrada (consola antigua), .Triangular (suave), .Sierra (áspera) o .Seno (pura).

Valores:

.Cuadrada.Seno.Sierra.Triangular

audio.Reproduccion

Una reproducción de sonido en curso, devuelta por audio.reproducir; permite pausarla, reanudarla o detenerla.

audio.Sonido

Un sonido cargado con recursos.sonido o creado con audio.tono o audio.ruido, listo para reproducirse con audio.reproducir.

Funciones

audio.reproducir(sonido audio.Sonido, volumen decimal = 1, bucle bool = falso, tono decimal = 1) audio.Reproduccion

Empieza a reproducir `sonido` con el volumen y modo de bucle dados, y devuelve la Reproduccion para controlarla luego. `tono` cambia la altura y la velocidad a la vez: 2 suena una octava más aguda y dura la mitad, 0.5 una octava más grave (se limita a entre 0.25 y 4).

audio.tono(frecuencia decimal, duracion decimal, onda audio.Onda = .Cuadrada, hasta decimal = 0, volumen decimal = 1) audio.Sonido

Crea un sonido en memoria, sin archivos: un tono de `frecuencia` hercios (440 es un la) que dura `duracion` segundos (hasta 30). `onda` cambia el timbre (.Cuadrada suena a consola antigua); con `hasta` mayor que 0 la frecuencia se desliza hasta ese valor (un salto sube, un láser baja). Guárdalo en una variable global y reprodúcelo con audio.reproducir.

audio.ruido(duracion decimal, volumen decimal = 1) audio.Sonido

Crea un sonido de ruido blanco de `duracion` segundos (hasta 30), sin archivos: sirve para explosiones, pasos o golpes. Siempre genera el mismo ruido.

audio.pausar(reproduccion audio.Reproduccion)

Pausa una reproducción en curso; puede reanudarse después con audio.reanudar.

audio.reanudar(reproduccion audio.Reproduccion)

Continúa una reproducción previamente pausada.

audio.detener(reproduccion audio.Reproduccion)

Detiene la reproducción por completo (a diferencia de pausar, no puede reanudarse desde donde iba).

audio.volumen(reproduccion audio.Reproduccion, valor decimal)

Cambia el volumen de una reproducción ya iniciada (0 = silencio, 1 = volumen original).