Funciones

2.1. FUNCIONES ELEMENTALES DEL CSOUND

ALGUNAS SENTENCIAS QUE CONSIDERAMOS PRINCIPALES PARA EL ARCHIVO DE PARTITURA.

SENTENCIA f

Esta sentencia hace que una subrutina GEN almacene valores en una tabla de función, para usarla con los instrumentos de la orquesta.

f p1 p2 p3 p4…

p1: número de la tabla con el que será conocida la función almacenada, un número negativo indica que la tabla debe ser destruida.
p2: instante de comienzo de la generación (o destrucción) de la función en pulsos.
p3: Tamaño de la tabla de función (número de puntos). Debe ser una potencia de 2 o una potencia de 2 más 1 (el tamaño máximo de la tabla es de 16777216, 2²⁴, puntos).
p4: número de la rutina GEN a llamar.

Los demás parámetros vendrán determinados por la rutina GEN en particular.

Una sentencia f0 (p1 = 0, p2 = valor positivo) puede ser usada para crear una indicación de comienzo sin ninguna acción real asociada.

SENTENCIA i

Esta sentencia llama a un instrumento para hacerlo activo en un instante específico y durante un tiempo determinado. Los valores de los campos p se pasan a ese instrumento antes de su inicialización, y permanecen válidos durante toda su ejecución.

i p1 p2 p3 p4…

p1: número del instrumento (de 1 a 200), normalmente un entero no negativo. Una parte fraccionaria puede proporcionar un indicador adicional para especificar ligaduras entre notas determinadas. Un valor negativo (incluido el indicador) puede usarse para desactivar una nota tenida determinada.
p2: instante de comienzo en unidades arbitrarias llamadas pulsos.
p3: duración en pulsos (normalmente positiva). Valor negativo iniciará una nota tenida. Valor 0 invocará una pasada de inicialización sin ejecución.

Los demás parámetros vendrán determinados por la rutina GEN en particular.

Los pulsos son evaluados como segundos, a menos que haya una sentencia t en esa sección de la partitura o un indicador t en la línea de comando de Csound que cambie el criterio.

SENTENCIA t

Esta sentencia modifica el tempo de una sección de partitura según la sentencia t. La operación de tempo convierte p2 (y, para las sentencias i, p3) de su formato original a pulsos en segundos reales.

t p1 p2 p3 p4… (ilimitado)

p1: debe ser 0.
p2: tiempo inicial en pulsos por minuto.
p3, p5, p7, …: instante en los que se produce el cambio de tiempo, en pulsos y en orden creciente.
p4, p6, p8, …: tiempos aplicados en los instantes anteriores.

SENTENCIA s

Esta sentencia ignora todos los campos p.

s cualquier cosa

ALGUNAS SENTENCIAS QUE CONSIDERAMOS PRINCIPALES PARA EL ARCHIVO DE ORQUESTA.

SINTAXIS DE ORQUESTA

instr, endin

Estas sentencias delimitan el cuerpo de un instrumento. Siempre deben aparecer en parejas.

instr i, j, …
<Cuerpo del instrumento>
endin

follow

Este opcode es un “extractor” del envolvente de una señal de audio.

ar follow asig, idt

asig: señal de la cual se extrae el envolvente.
idt: periodo, en segundos, en el que se proporciona la amplitud media de la señal asig.

OPERACIONES MATEMÁTICAS

Operaciones Aritméticas y Lógicas

Los operadores aritméticos llevan a cabo operaciones de cambio de signo, preservación de signo, “Y” y “O” lógicos, suma, resta, multiplicación y división.

- a ;(sin restricción de frecuencia)
+ a ;(sin restricción de frecuencia)
a && b ;(Y lógico; no válido a frecuencia de audio)
a || b ;(O lógico; no válido a frecuencia de audio)
a + b ;(sin restricción de frecuencia)
a - b ;(sin restricción de frecuencia)
a * b ;(sin restricción de frecuencia)
a / b ;(sin restricción de frecuencia)
a ^ b ;(b no puede ser de tipo audio)
a % b ;(sin restricción de frecuencia)

Funciones Matemáticas

Las funciones matemáticas, donde los argumentos entre paréntesis pueden ser expresiones.

int(x) ;(solamente argumentos i- o k-): devuelve la parte entera de x.
frac(x) ;(solamente argumentos i- o k-): devuelve la parte fraccionaria de x.
i(x) ;(solamente argumentos k-): devuelve el equivalente en tipo i- de un valor k-.
abs(x) ;(sin restricción de tipo): devuelve el valor absoluto de x.
exp(x) ;(sin restricción de tipo): devuelve el valor de e elevado a x.
log(x) ;(sin restricción de tipo): devuelve el logaritmo natural de x.
log10(x) ;(sin restricción de tipo): devuelve el logaritmo en base 10 de x.
sqrt(x) ;(sin restricción de tipo): devuelve la raíz cuadrada de x.

Funciones Trigonométricas

sin(x) ;(sin restricción de tipo): devuelve el seno de x (en radianes).
cos(x) ;(sin restricción de tipo): devuelve el coseno de x (en radianes).
tan(x) ;(sin restricción de tipo): devuelve la tangente de x.
sininv(x) ;(sin restricción de tipo): devuelve el arcoseno de x.
cosinv(x) ;(sin restricción de tipo): devuelve el arcocoseno de x.
taninv(x) ;(sin restricción de tipo): devuelve la arcotangente de x.
sinh(x) ;(sin restricción de tipo): devuelve el seno hiperbólico de x.
cosh(x) ;(sin restricción de tipo): devuelve el coseno hiperbólico de x.
tanh(x) ;(sin restricción de tipo): devuelve la tangente hiperbólica de x.