1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
/* GSL - Generic Sound Layer
* Copyright (C) 2001-2002 Tim Janik and Stefan Westerfeld
*
* This library is free software; you can redistribute it and/or modify
* it under the terms of the GNU Library General Public License as
* published by the Free Software Foundation; either version 2 of the
* License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA 02111-1307, USA.
*/
#ifndef __GSL_LOADER_H__
#define __GSL_LOADER_H__
#include <gsl/gsldefs.h>
#include <gsl/gslcommon.h>
#include <gsl/gslwavechunk.h>
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
typedef struct _GslWaveFileInfo GslWaveFileInfo;
typedef struct _GslWaveDsc GslWaveDsc;
typedef struct _GslWaveChunkDsc GslWaveChunkDsc;
/* --- structures --- */
struct _GslWaveFileInfo
{
guint n_waves;
struct {
gchar *name;
} *waves;
/*< private >*/
gchar *file_name;
GslLoader *loader;
guint ref_count;
};
struct _GslWaveDsc
{
gchar *name;
guint n_chunks;
GslWaveChunkDsc *chunks;
guint n_channels;
/*< private >*/
GslWaveFileInfo *file_info;
};
struct _GslWaveChunkDsc
{
gfloat osc_freq;
gfloat mix_freq;
GslWaveLoopType loop_type;
GslLong loop_start; /* sample offset */
GslLong loop_end; /* sample offset */
guint loop_count;
/* loader-specific */
GslLong loader_offset;
GslLong loader_length;
gpointer loader_data1; /* generic pointers for more data */
gpointer loader_data2;
};
/* --- functions --- */
GslWaveFileInfo* gsl_wave_file_info_load (const gchar *file_name,
GslErrorType *error);
GslWaveFileInfo* gsl_wave_file_info_ref (GslWaveFileInfo *wave_file_info);
void gsl_wave_file_info_unref (GslWaveFileInfo *wave_file_info);
GslWaveDsc* gsl_wave_dsc_load (GslWaveFileInfo *wave_file_info,
guint nth_wave,
GslErrorType *error);
void gsl_wave_dsc_free (GslWaveDsc *wave_dsc);
GslDataHandle* gsl_wave_handle_create (GslWaveDsc *wave_dsc,
guint nth_chunk,
GslErrorType *error);
GslWaveChunk* gsl_wave_chunk_create (GslWaveDsc *wave_dsc,
guint nth_chunk,
GslErrorType *error);
/* --- loader impl --- */
struct _GslLoader
{
const gchar *name; /* format/loader name, e.g. "GslWave" or "WAVE audio, RIFF (little-endian)" */
/* at least one of the
* following three must
* be non-NULL
*/
const gchar **extensions; /* e.g.: "mp3", "ogg" or "gslwave" */
const gchar **mime_types; /* e.g.: "audio/x-mpg3" or "audio/x-wav" */
const gchar **magic_specs; /* e.g.: "0 string RIFF\n8 string WAVE\n" or "0 string #GslWave\n" */
gint priority; /* -100=high, +100=low, 0=default */
/*< private >*/
gpointer data;
GslWaveFileInfo* (*load_file_info) (gpointer data,
const gchar *file_name,
GslErrorType *error);
void (*free_file_info) (gpointer data,
GslWaveFileInfo *file_info);
GslWaveDsc* (*load_wave_dsc) (gpointer data,
GslWaveFileInfo *file_info,
guint nth_wave,
GslErrorType *error);
void (*free_wave_dsc) (gpointer data,
GslWaveDsc *wave_dsc);
GslDataHandle* (*create_chunk_handle) (gpointer data,
GslWaveDsc *wave_dsc,
guint nth_chunk,
GslErrorType *error);
GslLoader *next; /* must be NULL */
};
void gsl_loader_register (GslLoader *loader);
GslLoader* gsl_loader_match (const gchar *file_name);
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* __GSL_LOADER_H__ */
|
