296 lines
9.3 KiB
C
296 lines
9.3 KiB
C
#pragma once
|
|
|
|
#ifndef __TSOUND_H__
|
|
#define __TSOUND_H__
|
|
|
|
#include "tmacro.h"
|
|
|
|
#undef TNZAPI
|
|
#ifdef TNZ_IS_AUDIOLIB
|
|
#define TNZAPI TNZ_EXPORT_API
|
|
#else
|
|
#define TNZAPI TNZ_IMPORT_API
|
|
#endif
|
|
|
|
/*----------------------------------------------------------------------- */
|
|
|
|
#ifndef TSAPI
|
|
#define TSAPI extern
|
|
#endif
|
|
|
|
typedef int TS_RESULT;
|
|
|
|
enum {
|
|
TS_NOERROR = 0,
|
|
TS_BADFILE,
|
|
TS_BADFORMAT,
|
|
TS_ENV,
|
|
TS_NOT_ALLOCATED,
|
|
TS_BADDEVICE,
|
|
TS_DEVICEBUSY,
|
|
TS_NODRIVER,
|
|
TS_PLAYERROR,
|
|
TS_RECERROR,
|
|
TS_NODATA,
|
|
TS_OK_PLAYSTOPPED,
|
|
TS_OK_RECSTOPPED
|
|
|
|
};
|
|
|
|
typedef unsigned long DWORD;
|
|
/*
|
|
typedef unsigned char BYTE;
|
|
typedef int BOOL;
|
|
*/
|
|
typedef unsigned char *PBYTE;
|
|
|
|
typedef const char *TS_STRING;
|
|
|
|
/*-----------------------------------------------------------------------------
|
|
*/
|
|
/* Sound data type */
|
|
/* MEGACAMBIO!!!! AUDIOFRAME intero */
|
|
|
|
typedef int AUDIOFRAME; /* -inf , +inf */
|
|
typedef float TIME; /* -inf , +inf */
|
|
typedef DWORD SAMPLE; /* 0 , +inf */
|
|
typedef DWORD TS_SIZE;
|
|
typedef float HERTZ; /* 0 , +inf */
|
|
typedef float PRESSURE; /* -1.0 , +1.0 */
|
|
typedef float AMPLIFICATION;
|
|
typedef unsigned int VOLUME; /* 0 , 255 */
|
|
|
|
/* conversione: tempo -> frame */
|
|
#define TS_CINEMA_FRAMEDURATION ((double)1 / 24)
|
|
#define TS_PAL_FRAMEDURATION ((double)1 / 25)
|
|
#define TS_NTSC_FRAMEDURATION ((double)1 / 30)
|
|
|
|
/*------------------- DIGITAL AUDIO --------------------*/
|
|
|
|
/* channels number */
|
|
typedef enum { TS_MONO = 1, TS_STEREO = 2 } TS_DIGITAL_CHANNELS;
|
|
|
|
/*
|
|
audio quality (sampling rate)
|
|
mu: HERTZ
|
|
*/
|
|
|
|
typedef enum {
|
|
TS_RATE_8000 = 8000,
|
|
TS_RATE_11025 = 11025,
|
|
TS_RATE_16000 = 16000,
|
|
TS_RATE_22050 = 22050,
|
|
TS_RATE_32000 = 32000,
|
|
TS_RATE_44100 = 44100,
|
|
TS_RATE_48000 = 48000
|
|
} TS_DIGITAL_QUALITY;
|
|
|
|
#define TS_VOICE_QUALITY TS_RATE_8000
|
|
#define TS_PHONE_QUALITY TS_RATE_11025
|
|
#define TS_RADIO_QUALITY TS_RATE_22050
|
|
#define TS_CD_QUALITY TS_RATE_44100
|
|
|
|
/*
|
|
sample dimension
|
|
mu: BIT
|
|
*/
|
|
|
|
typedef enum {
|
|
TS_8BIT_SAMPLES = 8,
|
|
TS_16BIT_SAMPLES = 16,
|
|
#ifndef WIN32
|
|
TS_24BIT_SAMPLES = 24
|
|
#else
|
|
TS_24BIT_SAMPLES = 24
|
|
#endif
|
|
} TS_DIGITAL_SAMPLES;
|
|
|
|
/*
|
|
bit masks for dwMask
|
|
*/
|
|
enum {
|
|
TS_MASK_DEFAULT = 0, /* per usare param. di default */
|
|
TS_MASK_ORIGIN = (1 << 0),
|
|
TS_MASK_DURATION = (1 << 1),
|
|
TS_MASK_QUALITY = (1 << 2),
|
|
TS_MASK_CHANNEL = (1 << 3),
|
|
TS_MASK_SAMPLE = (1 << 4),
|
|
TS_MASK_FILENAME = (1 << 5),
|
|
TS_MASK_ALL = TS_MASK_ORIGIN | TS_MASK_DURATION | TS_MASK_QUALITY |
|
|
TS_MASK_CHANNEL | TS_MASK_SAMPLE | TS_MASK_FILENAME,
|
|
TS_MASK_CREATE = TS_MASK_QUALITY | TS_MASK_CHANNEL | TS_MASK_SAMPLE
|
|
};
|
|
|
|
/*
|
|
internal time unit = SAMPLE
|
|
*/
|
|
typedef struct _TS_STRACK_INFO {
|
|
TIME tmOrigin;
|
|
TIME tmDuration;
|
|
char *tmFilename;
|
|
/* DIGITAL audio dependent part - low level*/
|
|
TS_DIGITAL_CHANNELS dChannels;
|
|
TS_DIGITAL_QUALITY dSamplingRate;
|
|
TS_DIGITAL_SAMPLES dBitsPerSample;
|
|
/* --- */
|
|
DWORD dwMask;
|
|
} * TS_STRACK_INFO;
|
|
|
|
typedef struct _TS_STRACK *TS_STRACK;
|
|
|
|
/*
|
|
I/O devices
|
|
*/
|
|
|
|
typedef enum {
|
|
TS_INPUT_LINE,
|
|
TS_INPUT_MIC,
|
|
TS_INPUT_DIGITAL,
|
|
TS_INPUT_DUMMY /* per aprire in output */
|
|
} TS_DEVTYPE;
|
|
|
|
typedef enum { TS_UNIQUE = 0, TS_RIGHT, TS_LEFT } TS_CHAN;
|
|
|
|
/*
|
|
typedef struct _TS_DEVICE_INFO {
|
|
TS_DEVTYPE input_source;
|
|
VOLUME input_volume;
|
|
VOLUME output_volume;
|
|
}*TS_DEVICE_INFO;
|
|
*/
|
|
|
|
typedef struct _TS_DEVICE *TS_DEVICE;
|
|
|
|
/* ------------------------ FUNCTIONS ------------------------------*/
|
|
/* N.B. Tutte le funzioni con from, to (src_from, src_to)
|
|
* prendono TUTTA la track se from==TS_BEGIN && to==TS_END
|
|
*/
|
|
|
|
#define ALL -1 /* PROVVISORIO!!!!!*/
|
|
#define TS_BEGIN MININT
|
|
#define TS_END MAXINT
|
|
|
|
/*---------------------- Creation/Destruction ----------------------------*/
|
|
|
|
/* usa i campi di info dichiarati in dwFlagsi, per gli altri usa default */
|
|
TNZAPI TSAPI TS_STRACK tsCreateStrack(TS_STRACK_INFO info);
|
|
TNZAPI TSAPI TS_RESULT tsDestroyStrack(TS_STRACK strack);
|
|
|
|
/*---------------------- Conversion Functions -----------------------------*/
|
|
/*
|
|
secs * tsFrameRate() => num.frames
|
|
N.B.:Nessun controllo sui parametri passati (conv.indiscriminata)
|
|
*/
|
|
|
|
TNZAPI TSAPI AUDIOFRAME tsTimeToFrame(TIME time);
|
|
TNZAPI TSAPI TIME tsFrameToTime(AUDIOFRAME frames);
|
|
TNZAPI TSAPI TIME tsFracFrameToTime(float frac_frames);
|
|
TNZAPI TSAPI SAMPLE tsFrameToSample(AUDIOFRAME frames, TS_STRACK strack);
|
|
TNZAPI TSAPI AUDIOFRAME tsSampleToFrame(SAMPLE samples, TS_STRACK strack);
|
|
TNZAPI TSAPI AUDIOFRAME tsByteToFrame(TS_SIZE bytes, TS_STRACK strack);
|
|
TNZAPI TSAPI TS_SIZE tsFrameToByte(AUDIOFRAME frames, TS_STRACK strack);
|
|
TNZAPI TSAPI SAMPLE tsTimeToSample(TIME time, TS_STRACK strack);
|
|
TNZAPI TSAPI TIME tsSampleToTime(SAMPLE samples, TS_STRACK strack);
|
|
|
|
TNZAPI TSAPI void tsAreyousure_to_quit(void);
|
|
|
|
/*--------------------------- File Functions ----------------------------*/
|
|
|
|
/* riempie tutti i campi della info */
|
|
TNZAPI TSAPI TS_RESULT tsFileInfo(TS_STRING szFileName, TS_STRACK_INFO info);
|
|
|
|
TNZAPI TSAPI TS_STRACK tsLoad(TS_STRING szFileName, AUDIOFRAME from,
|
|
AUDIOFRAME to);
|
|
|
|
TNZAPI TSAPI TS_STRACK tsLoadSubsampled(TS_STRING szFileName,
|
|
TS_STRACK_INFO desired_info,
|
|
AUDIOFRAME from, AUDIOFRAME to);
|
|
/* if from==ALL && to==ALL the whole track is loaded */
|
|
/*
|
|
TNZAPI TSAPI TS_RESULT tsSave ( TS_STRACK strack, TS_STRING szFileName,
|
|
AUDIOFRAME from, AUDIOFRAME to );
|
|
*/
|
|
TNZAPI TSAPI TS_RESULT tsSave(TS_STRACK strack, TS_STRING szFileName);
|
|
|
|
/*------------------------- Edit Functions --------------------------------*/
|
|
|
|
TNZAPI TSAPI void tsDelete(TS_STRACK strack, AUDIOFRAME from, AUDIOFRAME to);
|
|
/* cuts a piece of DATA */
|
|
TNZAPI TSAPI void tsClear(TS_STRACK strack, AUDIOFRAME from, AUDIOFRAME to);
|
|
/* zeroes a piece of DATA */
|
|
TNZAPI TSAPI void tsBlank(TS_STRACK strack, AUDIOFRAME point, AUDIOFRAME range);
|
|
/* insert zeros into a track */
|
|
|
|
TNZAPI TSAPI TS_RESULT tsCopy(TS_STRACK src_strack, AUDIOFRAME src_from,
|
|
AUDIOFRAME src_to, TS_STRACK dest_strack,
|
|
AUDIOFRAME dest_from);
|
|
TNZAPI TSAPI TS_RESULT tsInsert(TS_STRACK src_strack, AUDIOFRAME src_from,
|
|
AUDIOFRAME src_to, TS_STRACK dest_strack,
|
|
AUDIOFRAME dest_from);
|
|
/* Insertion of data in an empty track : dest_strack->buffer = NULL */
|
|
|
|
/* ------------------------Manipolator Functions -------------------------*/
|
|
|
|
TNZAPI TSAPI TS_RESULT tsConvert(TS_STRACK src_strack,
|
|
TS_STRACK_INFO dest_info);
|
|
TNZAPI TSAPI TS_RESULT tsAmplify(TS_STRACK strack, AMPLIFICATION amp);
|
|
|
|
/*----------------------- Miscellanea Functions ---------------------------*/
|
|
|
|
TNZAPI TSAPI AUDIOFRAME tsGetFrames(TS_STRACK strack);
|
|
TNZAPI TSAPI PBYTE tsBuffer(TS_STRACK strack);
|
|
/* riempie i campi di info richiesti in dwFlags */
|
|
TNZAPI TSAPI TS_RESULT tsInfo(TS_STRACK strack, TS_STRACK_INFO info);
|
|
TNZAPI TSAPI PRESSURE tsGetPressure(TS_STRACK strack, TIME time, TS_CHAN chan);
|
|
TNZAPI TSAPI PRESSURE tsGetMaxPressure(TS_STRACK strack, TS_CHAN chan);
|
|
TNZAPI TSAPI TS_STRING tsAudioFileExtension(void);
|
|
|
|
#ifndef WIN32
|
|
TNZAPI TSAPI int tsSupportDigitalIn(void);
|
|
#endif
|
|
|
|
/* only for tsNewPlay etc. */
|
|
TNZAPI TSAPI TBOOL tsNeedsRefill(void);
|
|
TNZAPI TSAPI TBOOL
|
|
tsRefill(void); /* call at least 4 times per sec while playing, */
|
|
/* TRUE means needs to be called again */
|
|
|
|
/*------------------------ Play/Rec Functions -----------------------------*/
|
|
/* default asynch */
|
|
TNZAPI TSAPI TS_RESULT tsPlay(TS_STRACK strack, TS_DEVICE dev, AUDIOFRAME from,
|
|
AUDIOFRAME to);
|
|
TNZAPI TSAPI TS_RESULT tsNewPlay(TS_STRACK strack, TS_DEVICE dev,
|
|
AUDIOFRAME from, AUDIOFRAME to);
|
|
TNZAPI TSAPI TS_RESULT tsPlayLoop(TS_STRACK strack, TS_DEVICE dev,
|
|
AUDIOFRAME from, AUDIOFRAME to);
|
|
TNZAPI TSAPI TBOOL tsIsPlaying(TS_STRACK strack, TS_DEVICE dev);
|
|
TNZAPI TSAPI TBOOL tsIsNewPlaying(TS_STRACK strack, TS_DEVICE dev);
|
|
TNZAPI TSAPI TS_RESULT tsSyncPlay(TS_STRACK strack, TS_DEVICE dev,
|
|
AUDIOFRAME from, AUDIOFRAME to);
|
|
TNZAPI TSAPI TS_RESULT tsStopPlaying(TS_STRACK strack, TS_DEVICE dev);
|
|
TNZAPI TSAPI TS_RESULT tsStopNewPlaying(TS_STRACK strack, TS_DEVICE dev);
|
|
|
|
TNZAPI TSAPI TS_RESULT tsRecord(TS_STRACK strack, TS_DEVICE dev,
|
|
AUDIOFRAME from, AUDIOFRAME to);
|
|
TNZAPI TSAPI TBOOL tsIsRecording(TS_STRACK strack, TS_DEVICE dev);
|
|
TNZAPI TSAPI TS_RESULT tsSyncRecord(TS_STRACK strack, TS_DEVICE dev,
|
|
AUDIOFRAME from, AUDIOFRAME to);
|
|
TNZAPI TSAPI TS_RESULT tsStopRecording(TS_STRACK strack, TS_DEVICE dev);
|
|
/* TSAPI void tsSetEndPlayCb (void(*end_play_cb)(void));*/
|
|
|
|
/*------------------------- Device Functions ------------------------------*/
|
|
|
|
/* dinfo==NIL => usato vol. di default e microfono per input */
|
|
/* mode = "w" per Play; "r" per Record */
|
|
|
|
TNZAPI TSAPI TS_DEVICE tsInitDevice(TS_DEVTYPE type, TS_STRACK_INFO info,
|
|
char *mode);
|
|
TNZAPI TSAPI TS_RESULT tsCloseDevice(TS_DEVICE dev);
|
|
TNZAPI TSAPI TBOOL tsCheckOutput(void);
|
|
TNZAPI TSAPI void tsSetVolume(TS_DEVICE dev, VOLUME vol);
|
|
TNZAPI TSAPI void tsSetInVolume(TS_DEVICE dev, VOLUME vol);
|
|
TNZAPI TSAPI VOLUME tsGetVolume(TS_DEVICE dev);
|
|
|
|
/*------------------------------------------------------------------------ */
|
|
|
|
#endif
|