Funciones del módulo PdsWave.

Estructuras de datos
struct	PdsWave
	La estructura tipo PdsWave . Más...

Funciones
PdsWave *	pds_wave_new (PdsDsNatural Nel)
	Crea una estructura de tipo PdsWave de Nel elementos. Más...
PdsWave *	pds_wave_new_vector (const PdsVector *VecSrc)
	Crea una estructura de tipo PdsWave usando como fuente el vector VecSrc. Más...
int	pds_wave_set_data (PdsWave *Wave, PdsDsNatural x, PdsDsReal m)
	Escribe el valor m en la posición (x) del generador Wave. (x) inicia con (0). Más...
int	pds_wave_get_value (PdsWave *WAVE, PdsDsReal *y)
	Obtiene un valor en la salida e itera el generador de ondas. Más...
int	pds_wave_get_last_value (PdsWave *WAVE, PdsDsReal *y)
	Obtiene el último valor a la salida del generador de onda. Más...
int	pds_wave_get_vector (PdsWave *WAVE, PdsVector *Vector)
	Carga un vector con valores obtenidos en la salida del generador de onda. Realiza una iteración para cada elemento del vector. Más...
void	pds_wave_free (PdsWave *WAVE)
	Libera una estructura de tipo puntero PdsWave. Más...
void	pds_wave_destroy (PdsWave **WAVE)
	Libera una estructura de tipo puntero PdsWave, y lo carga con NULL. Más...

Descripción detallada

Se genera una onda a partir de un arreglo de datos, y se repite cíclicamente.

Señal de salida y[n].

Documentación de las funciones

PdsWave * pds_wave_new

(

PdsDsNatural

Nel

)

Crea una estructura de tipo PdsWave de Nel elementos.

Todos los elementos son rellenados con ceros.

Parámetros

[in]

Nel

Es el número de elementos por ciclo.

Devuelve

Un puntero a una estructura de tipo PdsWave.

PdsWave * pds_wave_new_vector

(

const PdsVector *

VecSrc

)

Crea una estructura de tipo PdsWave usando como fuente el vector VecSrc.

Parámetros

[in]

VecSrc

Es el vector que se usará como fuente.

Devuelve

Un puntero a la onda de tipo PdsWave.

Ejemplos:

testprog3.c.

int pds_wave_set_data	(	PdsWave *	Wave,
		PdsDsNatural	x,
		PdsDsReal	m
	)

Escribe el valor m en la posición (x) del generador Wave. (x) inicia con (0).

Parámetros

[in,out]	Wave	El generador a escribir.
[in]	x	Posición x, el primer valor de x es cero.
[in]	m	El valor en la posición (x), en caso de error por fuera de rango (x) entonces no hace nada y no se considera como error.

Devuelve

TRUE si todo fue bien o FALSE si no (ej: Vector==NULL).

int pds_wave_get_value	(	PdsWave *	WAVE,
		PdsDsReal *	y
	)

Obtiene un valor en la salida e itera el generador de ondas.

Parámetros

[in,out]	WAVE	La estructura de PdsWave a consultar.
[out]	y	En esta variable se carga el nuevo valor a la salida de generador.

Devuelve

TRUE si todo fue bien o FALSE si no. Ejemplo WAVE==NULL.

int pds_wave_get_last_value	(	PdsWave *	WAVE,
		PdsDsReal *	y
	)

Obtiene el último valor a la salida del generador de onda.

Parámetros

[in,out]	WAVE	La estructura de PdsWave a consultar.
[out]	y	En esta variable se carga el último valor a la salida de generador.

Devuelve

TRUE si todo fue bien o FALSE si no. Ejemplo WAVE==NULL.

int pds_wave_get_vector	(	PdsWave *	WAVE,
		PdsVector *	Vector
	)

Carga un vector con valores obtenidos en la salida del generador de onda. Realiza una iteración para cada elemento del vector.

Parámetros

[in,out]	WAVE	La estructura de PdsWave a consultar.
[out]	Vector	En este vector se cargará los valores a la salida de generador.

Devuelve

TRUE si todo fue bien o FALSE si no. Ejemplo WAVE==NULL, Vector==NULL.

Ejemplos:

testprog3.c.

void pds_wave_free

(

PdsWave *

WAVE

)

Libera una estructura de tipo puntero PdsWave.

Parámetros

[in,out]

WAVE

La estructura de PdsWave a liberar.

Devuelve

No retorna valor.

Ejemplos:

testprog3.c.

void pds_wave_destroy

(

PdsWave **

WAVE

)

Libera una estructura de tipo puntero PdsWave, y lo carga con NULL.

Parámetros

[in,out]

WAVE

La estructura de PdsWave a liberar.

Devuelve

No retorna valor.