Funciones del módulo PdsPlayback.

Estructuras de datos
struct	PdsPlayback
	La estructura tipo PdsPlayback . Esta estructura genera una metodo para reproducir audio por la salida de audio por defecto del sistema. Para usar incluir pds/pdsplayback.h. Más...

'defines'
#define	TRUE   1
#define	FALSE   0

Funciones
PdsPlayback *	pds_playback_new (PdsDaNatural *freq, PdsDaNatural *bits)
	Crea una estructura para la reproducción de audio digital. Más...
int	pds_playback_set_samples_buffer (PdsPlayback *A, PdsDaNatural samples)
	Establece la cantidad de muestras en el buffer de salida. Más...
int	pds_playback_write (PdsPlayback *A, PdsVector *X)
	Escribe los datos de X en el buffer de salida. Los datos estarán comprendidos entre [-1.0,1.0>. Más...
void	pds_playback_free (PdsPlayback *A)
	Libera la estructura para la reproducción de audio digital. Más...
void	pds_playback_destroy (PdsPlayback **A)
	Libera la estructura para la reproducción de audio digital, y carga con NULL la estructura. Más...

Descripción detallada

Documentación de los 'defines'

#define TRUE   1

Define la palabra TRUE equivalente con 1.

Definición en la línea 52 del archivo pdsplayback.h.

#define FALSE   0

Define la palabra FALSE equivalente con 0.

Ejemplos:

testprograma1.c y testprograma2.c.

Definición en la línea 60 del archivo pdsplayback.h.

Documentación de las funciones

PdsPlayback * pds_playback_new	(	PdsDaNatural *	freq,
		PdsDaNatural *	bits
	)

Crea una estructura para la reproducción de audio digital.

Parámetros

[in,out]	freq	Frecuencia de muestreo,si no es posible es cargada en freq la frecuencia mas próxima.
[in,out]	bits	La cantidad de bits en el muestreo, si no es posible es cargada la cantidad de bits posible próxima o inmediata superior. Los valores posibles son:8, 16,24 o32 bits.

Devuelve

Un puntero a la estructura para la reproducción de audio digital. o NULL en caso de error.

Ejemplos:

testprograma2.c.

int pds_playback_set_samples_buffer	(	PdsPlayback *	A,
		PdsDaNatural	samples
	)

Establece la cantidad de muestras en el buffer de salida.

Parámetros

[in,out]	A	estructura para la reproducción de audio digital.
[in]	samples	La cantidad de muestras en el buffer.

Devuelve

TRUE si todo fue bien o FALSE si no. (ejem A==NULL o samples==0).

Ejemplos:

testprograma2.c.

int pds_playback_write	(	PdsPlayback *	A,
		PdsVector *	X
	)

Escribe los datos de X en el buffer de salida. Los datos estarán comprendidos entre [-1.0,1.0>.

Parámetros

[in,out]	A	Estructura para la reproducción de audio digital.
[in]	X	Vector real de donde se leerán los datos del buffer.

Devuelve

TRUE si todo fue bien o FALSE si no. (ejem A==NULL, X==NULL o el número de elementos de X es distinto a la cantidad de samples en el buffer.).

Ejemplos:

testprograma2.c.

void pds_playback_free

(

PdsPlayback *

A

)

Libera la estructura para la reproducción de audio digital.

Parámetros

[in,out]

A

Estructura para la reproducción de audio digital.

Ejemplos:

testprograma2.c.

void pds_playback_destroy

(

PdsPlayback **

A

)

Libera la estructura para la reproducción de audio digital, y carga con NULL la estructura.

Parámetros

[in,out]

A

Estructura para la reproducción de audio digital.