libsndfile source files.
[Faustine.git] / interpretor / libsndfile-1.0.25 / src / chanmap.c
1 /*
2 ** Copyright (C) 2009-2011 Erik de Castro Lopo <erikd@mega-nerd.com>
3 **
4 ** This program is free software; you can redistribute it and/or modify
5 ** it under the terms of the GNU Lesser General Public License as published by
6 ** the Free Software Foundation; either version 2.1 of the License, or
7 ** (at your option) any later version.
8 **
9 ** This program is distributed in the hope that it will be useful,
10 ** but WITHOUT ANY WARRANTY; without even the implied warranty of
11 ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 ** GNU Lesser General Public License for more details.
13 **
14 ** You should have received a copy of the GNU Lesser General Public License
15 ** along with this program; if not, write to the Free Software
16 ** Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
17 */
18
19 /*
20 ** Mostly from "Apple Core Audio Format Specification 1.0":
21 **
22 ** http://developer.apple.com/documentation/MusicAudio/Reference/CAFSpec/CAFSpec.pdf
23 */
24
25 #include "sfconfig.h"
26
27 #include <stdio.h>
28 #include <stdlib.h>
29 #include <string.h>
30
31 #include "sndfile.h"
32 #include "common.h"
33 #include "chanmap.h"
34
35
36 static const AIFF_CAF_CHANNEL_MAP zero_chan [] =
37 { { (0 << 16) | 0, NULL, "Use channel descriptions." },
38 { (1 << 16) | 0, NULL, "Use channel bitmap." }
39 } ; /* zero_chan */
40
41
42 static const int one_chan_mono [1] = { SF_CHANNEL_MAP_MONO } ;
43
44 static const AIFF_CAF_CHANNEL_MAP one_chan [] =
45 { { (100 << 16) | 1, one_chan_mono, "mono" }
46 } ; /* one_chan */
47
48
49 static const int two_channel_stereo [2] = { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT } ;
50
51 static const AIFF_CAF_CHANNEL_MAP two_chan [] =
52 { { (101 << 16) | 2, two_channel_stereo, "stereo (L, R)" },
53 { (102 << 16) | 2, two_channel_stereo, "stereo headphones (L, R)" },
54 #if 0
55 { (103 << 16) | 2, NULL, "matrix stereo (Lt, Rt)" },
56 { (104 << 16) | 2, NULL, "2 channels (mid, side)" },
57 { (105 << 16) | 2, NULL, "coincident mic pair" },
58 { (106 << 16) | 2, NULL, "binaural stereo (L, R)"
59 }
60 #endif
61 } ; /* two_chan */
62
63
64 static const int three_channel_mpeg_30a [3] =
65 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_CENTER } ;
66 static const int three_channel_mpeg_30b [3] =
67 { SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT } ;
68 static const int three_channel_itu_21 [3] =
69 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_CENTER } ;
70 static const int three_channel_dvd_4 [3] =
71 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_LFE } ;
72
73 static const AIFF_CAF_CHANNEL_MAP three_chan [] =
74 { { (113 << 16) | 3, three_channel_mpeg_30a, "MPEG 3 0 A (L, R, C)" },
75 { (114 << 16) | 3, three_channel_mpeg_30b, "MPEG 3 0 B (C, L, R)" },
76 { (131 << 16) | 3, three_channel_itu_21, "ITU 2.1 (L, R, Cs)" },
77 { (133 << 16) | 3, three_channel_dvd_4, "DVD 4 (L, R, LFE)" }
78 } ; /* three_chan */
79
80
81 static const int four_channel_ambisonc_b [4] =
82 { SF_CHANNEL_MAP_AMBISONIC_B_W, SF_CHANNEL_MAP_AMBISONIC_B_X, SF_CHANNEL_MAP_AMBISONIC_B_Y, SF_CHANNEL_MAP_AMBISONIC_B_Z } ;
83 static const int four_channel_quad [4] =
84 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT } ;
85 static const int four_channel_mpeg_40a [4] =
86 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_REAR_CENTER } ;
87 static const int four_channel_mpeg_40b [4] =
88 { SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_CENTER } ;
89 static const int four_channel_itu_23 [4] =
90 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT } ;
91 static const int four_channel_dvd_5 [4] =
92 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_LFE, SF_CHANNEL_MAP_REAR_CENTER } ;
93 static const int four_channel_dvd_10 [4] =
94 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_LFE } ;
95
96 static const AIFF_CAF_CHANNEL_MAP four_chan [] =
97 { { (107 << 16) | 4, four_channel_ambisonc_b, "ambisonic B (W, X, Y, Z)" },
98 { (108 << 16) | 4, four_channel_quad, "quad (Lfront, Rfront, Lrear, Rrear)" },
99 { (115 << 16) | 4, four_channel_mpeg_40a, "MPEG 4.0 A (L, R, C, Cs)" },
100 { (116 << 16) | 4, four_channel_mpeg_40b, "MPEG 4.0 B (C, L, R, Cs)" },
101 { (132 << 16) | 4, four_channel_itu_23, "ITU 2.3 (L, R, Ls, Rs)" },
102 { (134 << 16) | 4, four_channel_dvd_5, "DVD 5 (L, R, LFE, Cs)" },
103 { (136 << 16) | 4, four_channel_dvd_10, "DVD 10 (L, R, C, LFE)" }
104 } ; /* four_chan */
105
106
107 static const int five_channel_pentagonal [5] =
108 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT, SF_CHANNEL_MAP_CENTER } ;
109 static const int five_channel_mpeg_50_a [5] =
110 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT } ;
111 static const int five_channel_mpeg_50_b [5] =
112 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT, SF_CHANNEL_MAP_CENTER } ;
113 static const int five_channel_mpeg_50_c [5] =
114 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT } ;
115 static const int five_channel_mpeg_50_d [5] =
116 { SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT } ;
117 static const int five_channel_dvd_6 [5] =
118 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_LFE, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT } ;
119 static const int five_channel_dvd_11 [5] =
120 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_LFE, SF_CHANNEL_MAP_REAR_CENTER } ;
121 static const int five_channel_dvd_18 [5] =
122 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT, SF_CHANNEL_MAP_LFE } ;
123
124 static const AIFF_CAF_CHANNEL_MAP five_chan [] =
125 { { (109 << 16) | 5, five_channel_pentagonal, "pentagonal (L, R, Lrear, Rrear, C)" },
126 { (117 << 16) | 5, five_channel_mpeg_50_a, "MPEG 5.0 A (L, R, C, Ls, Rs)" },
127 { (118 << 16) | 5, five_channel_mpeg_50_b, "MPEG 5.0 B (L, R, Ls, Rs, C)" },
128 { (119 << 16) | 5, five_channel_mpeg_50_c, "MPEG 5.0 C (L, C, R, Ls, Rs,)" },
129 { (120 << 16) | 5, five_channel_mpeg_50_d, "MPEG 5.0 D (C, L, R, Ls, Rs)" },
130 { (135 << 16) | 5, five_channel_dvd_6, "DVD 6 (L, R, LFE, Ls, Rs)" },
131 { (137 << 16) | 5, five_channel_dvd_11, "DVD 11 (L, R, C, LFE, Cs)" },
132 { (138 << 16) | 5, five_channel_dvd_18, "DVD 18 (L, R, Ls, Rs, LFE)" }
133 } ; /* five_chan */
134
135
136 static const int six_channel_mpeg_51_a [6] =
137 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_LFE, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT } ;
138 static const int six_channel_mpeg_51_b [6] =
139 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT, SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_LFE } ;
140 static const int six_channel_mpeg_51_c [6] =
141 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT, SF_CHANNEL_MAP_LFE } ;
142 static const int six_channel_mpeg_51_d [6] =
143 { SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT, SF_CHANNEL_MAP_LFE } ;
144 static const int six_channel_audio_unit_60 [6] =
145 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT, SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_REAR_CENTER } ;
146 static const int six_channel_aac_60 [6] =
147 { SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT, SF_CHANNEL_MAP_REAR_CENTER } ;
148
149 static const AIFF_CAF_CHANNEL_MAP six_chan [] =
150 { { (110 << 16) | 6, NULL, "hexagonal (L, R, Lr, Rr, C, Rear)" },
151 { (121 << 16) | 6, six_channel_mpeg_51_a, "MPEG 5.1 A (L, R, C, LFE, Ls, Rs)" },
152 { (122 << 16) | 6, six_channel_mpeg_51_b, "MPEG 5.1 B (L, R, Ls, Rs, C, LFE)" },
153 { (123 << 16) | 6, six_channel_mpeg_51_c, "MPEG 5.1 C (L, C, R, Ls, Rs, LFE)" },
154 { (124 << 16) | 6, six_channel_mpeg_51_d, "MPEG 5.1 D (C, L, R, Ls, Rs, LFE)" },
155 { (139 << 16) | 6, six_channel_audio_unit_60, "AudioUnit 6.0 (L, R, Ls, Rs, C, Cs)" },
156 { (141 << 16) | 6, six_channel_aac_60, "AAC 6.0 (C, L, R, Ls, Rs, Cs)" }
157 } ; /* six_chan */
158
159
160 static const int six_channel_mpeg_61a [7] =
161 { SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_LFE, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT, SF_CHANNEL_MAP_REAR_CENTER } ;
162 static const int six_channel_aac_61 [7] =
163 { SF_CHANNEL_MAP_CENTER, SF_CHANNEL_MAP_LEFT, SF_CHANNEL_MAP_RIGHT, SF_CHANNEL_MAP_REAR_LEFT, SF_CHANNEL_MAP_REAR_RIGHT, SF_CHANNEL_MAP_REAR_CENTER, SF_CHANNEL_MAP_LFE } ;
164
165 static const AIFF_CAF_CHANNEL_MAP seven_chan [] =
166 { { (125 << 16) | 7, six_channel_mpeg_61a, "MPEG 6.1 A (L, R, C, LFE, Ls, Rs, Cs)" },
167 { (140 << 16) | 7, NULL, "AudioUnit 7.0 (L, R, Ls, Rs, C, Rls, Rrs)" },
168 { (142 << 16) | 7, six_channel_aac_61, "AAC 6.1 (C, L, R, Ls, Rs, Cs, Lfe)" },
169 { (143 << 16) | 7, NULL, "AAC 7.0 (C, L, R, Ls, Rs, Rls, Rrs,)" }
170 } ; /* seven_chan */
171
172
173 static const AIFF_CAF_CHANNEL_MAP eight_chan [] =
174 { { (111 << 16) | 8, NULL,
175 // front left, front right, rear left, rear right,
176 // front center, rear center, side left, side right
177 "octagonal (Lf, Rf, Lr, Rr, Cf, Cr, Ls, Rs)"
178 },
179 { (112 << 16) | 8, NULL,
180 // left, right, rear left, rear right
181 // top left, top right, top rear left, top rear right
182 "cube (L, R, Lrear, Rrear, Ltop, Rtop, Ltoprear, Rtoprear)"
183 },
184 { (126 << 16) | 8, NULL, "MPEG 7.1 A (L, R, C, LFE, Ls, Rs, Lc, Rc)" },
185 { (127 << 16) | 8, NULL, "MPEG 7.1 B (C, Lc, Rc, L, R, Ls, Rs, LFE)" },
186 { (128 << 16) | 8, NULL, "MPEG 7.1 C (L, R, C, LFE, Ls, R, Rls, Rrs)" },
187 { (129 << 16) | 8, NULL, "Emagic Default 7.1 (L, R, Ls, Rs, C, LFE, Lc, Rc)" },
188 { (130 << 16) | 8, NULL,
189 // (ITU_5_1 plus a matrix encoded stereo mix)
190 "SMPTE DTV (L, R, C, LFE, Ls, Rs, Lt, Rt)"
191 },
192 { (144 << 16) | 8, NULL, "AAC octagonal (C, L, R, Ls, Rs, Rls, Rrs, Cs)" }
193 } ; /* eight_chan */
194
195
196
197 #if 0
198
199 TMH_10_2_std = (145 << 16) | 16,
200 // L R C Vhc Lsd Rsd Ls Rs Vhl Vhr Lw Rw Csd Cs LFE1 LFE2
201
202 TMH_10_2_full = (146 << 16) | 21,
203 // TMH_10_2_std plus: Lc Rc HI VI Haptic
204
205 #endif
206
207
208 typedef struct
209 { const AIFF_CAF_CHANNEL_MAP * map ;
210 int len ;
211 } MAP_MAP ;
212
213 static const MAP_MAP map [] =
214 { { zero_chan, ARRAY_LEN (zero_chan) },
215 { one_chan, ARRAY_LEN (one_chan) },
216 { two_chan, ARRAY_LEN (two_chan) },
217 { three_chan, ARRAY_LEN (three_chan) },
218 { four_chan, ARRAY_LEN (four_chan) },
219 { five_chan, ARRAY_LEN (five_chan) },
220 { six_chan, ARRAY_LEN (six_chan) },
221 { seven_chan, ARRAY_LEN (seven_chan) },
222 { eight_chan, ARRAY_LEN (eight_chan) }
223 } ; /* map */
224
225
226 int
227 aiff_caf_find_channel_layout_tag (const int *chan_map, int channels)
228 { const AIFF_CAF_CHANNEL_MAP * curr_map ;
229 unsigned k, len ;
230
231 if (channels < 1 || channels > ARRAY_LEN (map))
232 return 0 ;
233
234 curr_map = map [channels].map ;
235 len = map [channels].len ;
236
237 for (k = 0 ; k < len ; k++)
238 if (curr_map [k].channel_map != NULL)
239 if (memcmp (chan_map, curr_map [k].channel_map, channels * sizeof (chan_map [0])) == 0)
240 return curr_map [k].channel_layout_tag ;
241
242 return 0 ;
243 } /* aiff_caf_find_channel_layout_tag */
244
245 const AIFF_CAF_CHANNEL_MAP *
246 aiff_caf_of_channel_layout_tag (int tag)
247 { const AIFF_CAF_CHANNEL_MAP * curr_map ;
248 unsigned k, len ;
249 int channels = tag & 0xffff ;
250
251 if (channels < 0 || channels > ARRAY_LEN (map))
252 return NULL ;
253
254 curr_map = map [channels].map ;
255 len = map [channels].len ;
256
257 for (k = 0 ; k < len ; k++)
258 if (curr_map [k].channel_layout_tag == tag)
259 return curr_map + k ;
260
261 return NULL ;
262 } /* aiff_caf_of_channel_layout_tag */