paudio/paudio.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 *
 * Produced by:
 *      Mark Elendt
 *      Side Effects Software Inc.
 *      20 Maud St.
 *      Toronto, Ontario,  M5V 2M5
 *      Canada
 *      416-366-4607
 *
 * NAME:        Prisms Audio Library
 *
 * COMMENTS:    Header file for structures for PRISMS audio
 *
 */

#ifndef __PAUDIO_H__
#define __PAUDIO_H__

#include "paudio_API.h"

#ifdef __cplusplus
extern "C" {
#endif

#include <audio.h>

#define AUDP_IN_MIC     0x01    /* Record from microphone */
#define AUDP_IN_LINE    0x02    /* Record from line */
#define AUDP_IN_DIGITAL 0x04    /* Record from digital in */

#define AUDP_READ       0x00    /* Read port */
#define AUDP_WRITE      0x01    /* Write port */
#define AUDP_NOBLOCKS   0x02    /* Play audio in real-time */

#define ALLOCAUDIO()    (PR_AUDIO *)calloc(sizeof(PR_AUDIO), 1)
#define FREEAUDIO(pap)  { if (pap->data) free(pap->data); free(pap); }

#define PR_LEFT_CHANNEL         1
#define PR_RIGHT_CHANNEL        2
#define PR_AVERAGE_CHANNEL      3

typedef struct {
        long    rate;
        short   bits;
        short   nchannels;
} PR_APARMS;

typedef struct {
        PR_APARMS       parms;
        int             data_bytes;             /* Number of bytes of data */
        char            *data;                  /* The actual sound samples */
        int             midi_bytes;             /* Unused */
        char            *midi;                  /* Unused */
        char            *sparePointer;          /* User information */

        int             bytes_per_samp;         /* Bytes per sample of sound */
        int             currpos;                /* Current play position */
        float           scrubLength;            /* scrub length in sec */
} PR_AUDIO;                                     /* Prisms audio buffer */

typedef struct {
        int             mode;           /* Flags for port */
        ALport          alport;         /* Audio port */
        PR_APARMS       parms;
} PR_APORT;

#ifdef NO_PROTOTYPES

paudio_API extern PR_APORT      *PR_OpenPort();
paudio_API extern PR_AUDIO      *PR_ReadFile();
paudio_API extern PR_AUDIO      *PR_Record();
paudio_API extern PR_AUDIO      *PR_ClipAudio();
paudio_API extern PR_AUDIO      *PR_RevAudio();
paudio_API extern PR_AUDIO      *PR_VolumeAudio();
paudio_API extern PR_AUDIO      *PR_AppendAudio();
paudio_API extern PR_AUDIO      *PR_CombineAudio();
paudio_API extern PR_AUDIO      *PR_StripAudio();
paudio_API extern PR_AUDIO      *PR_ShiftAudio();
paudio_API extern void           PR_GetData();
paudio_API extern void           PR_PutData();
paudio_API extern int            PR_GetSampleSize();

#else

/* Determine if audio is available */
paudio_API extern int            PR_IsAudio(void);

paudio_API extern PR_AUDIO      *PR_ReadFile(const char *filename);
paudio_API extern int            PR_WriteFile(const char *filename,
                                        PR_AUDIO *pap);

paudio_API extern PR_APORT      *PR_OpenPort(PR_APARMS *pparms, int mode);
paudio_API extern int            PR_ClosePort(PR_APORT *pport);

paudio_API extern PR_AUDIO      *PR_Record(PR_APORT *pport, int inp,
                                        int (*notify)(float), int len);
paudio_API extern void           PR_StartPlay(PR_APORT *pport, PR_AUDIO *pap,
                                        int start);
paudio_API extern void           PR_Play(PR_APORT *pport, PR_AUDIO *pap,
                                        int (*notify)(float));
paudio_API extern long           PR_AvailableBuffSamps(PR_APORT *pport);
paudio_API extern void           PR_WaitForEnd(PR_APORT *pport);
paudio_API extern void           PR_StopPlay(PR_APORT *pport);
paudio_API extern void           PR_RefreshPlay(PR_APORT *pport,
                                        PR_AUDIO *pap, int start);

paudio_API extern int            PR_SampleTime(PR_AUDIO *pap, float second);
paudio_API extern int            PR_ValidSample(PR_AUDIO *pap, int sample);
paudio_API extern PR_AUDIO      *PR_ClipAudio(PR_AUDIO *pap, int start,
                                        int end);
paudio_API extern PR_AUDIO      *PR_ReverseAudio(PR_AUDIO *pap);
paudio_API extern PR_AUDIO      *PR_ShiftAudio(PR_AUDIO *pap, int rate,
                                        int bits);
paudio_API extern PR_AUDIO      *PR_StripAudio(PR_AUDIO *pap, int which);
paudio_API extern PR_AUDIO      *PR_CombineAudio(PR_AUDIO *pap);
paudio_API extern PR_AUDIO      *PR_AppendAudio(PR_AUDIO *pap1, PR_AUDIO *pap2);
paudio_API extern PR_AUDIO      *PR_VolumeAudio(PR_AUDIO *pap1, float factor);
paudio_API extern void           PR_GetData(PR_AUDIO *pap, int pos,
                                        long *sample);
paudio_API extern void           PR_PutData(PR_AUDIO *pap, int pos,
                                        long *sample);
paudio_API extern int            PR_GetSampleSize(float min_value,
                                        float max_value);

#endif

#ifdef __cplusplus
}
#endif

#endif

---