MSRingPlayer

Name

MSRingPlayer -- A nice source filter to play rings.

Synopsis


#include <msringplayer.h>


            MSRingPlayer;
MSFilter*   ms_ring_player_new              (char *name,
                                             gint seconds);
void        ms_ring_player_destroy          (MSRingPlayer *obj);

Description

This filter plays a repeatly a sound followed by a period of silence. The sound is given as the path to a 16 bit raw audio file, and the interval is specified in number of seconds.

Details

MSRingPlayer

typedef struct {
	/* the MSRingPlayer derivates from MSFilter, so the MSFilter object MUST be the first of the MSRingPlayer object
	in order to the object mechanism to work*/
	MSFilter filter;
	MSFifo *foutputs[MS_RING_PLAYER_MAX_OUTPUTS];
	MSQueue *qoutputs[MS_RING_PLAYER_MAX_OUTPUTS];\
	MSSync *sync;
	gint gran;
	gint freq;
	gint rate;
	gint channel;	/* number of interleaved channels */
	gint silence;	/* silence time between each ring, in seconds */
	gint state;
	gint fd;  /* the file descriptor of the file being read*/
	gint silence_bytes; /*silence in number of bytes between each ring */
	gint current_pos;
	gint need_swap;
} MSRingPlayer;


ms_ring_player_new ()

MSFilter*   ms_ring_player_new              (char *name,
                                             gint seconds);

Allocates a new MSRingPlayer object.

name :

The path to the 16-bit 8khz raw file to be played as a ring.

seconds :

The number of seconds that separates two rings.

Returns :

a pointer the the object, NULL if name could not be open.


ms_ring_player_destroy ()

void        ms_ring_player_destroy          (MSRingPlayer *obj);

Destroy a MSRingPlayer object.

obj :

A valid MSRingPlayer object.