Alexandre Lision | 7c6f4a6 | 2013-09-05 13:27:01 -0400 | [diff] [blame] | 1 | /* |
| 2 | ** Copyright (C) 2005-2011 Erik de Castro Lopo <erikd@mega-nerd.com> |
| 3 | ** |
| 4 | ** All rights reserved. |
| 5 | ** |
| 6 | ** Redistribution and use in source and binary forms, with or without |
| 7 | ** modification, are permitted provided that the following conditions are |
| 8 | ** met: |
| 9 | ** |
| 10 | ** * Redistributions of source code must retain the above copyright |
| 11 | ** notice, this list of conditions and the following disclaimer. |
| 12 | ** * Redistributions in binary form must reproduce the above copyright |
| 13 | ** notice, this list of conditions and the following disclaimer in |
| 14 | ** the documentation and/or other materials provided with the |
| 15 | ** distribution. |
| 16 | ** * Neither the author nor the names of any contributors may be used |
| 17 | ** to endorse or promote products derived from this software without |
| 18 | ** specific prior written permission. |
| 19 | ** |
| 20 | ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| 21 | ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED |
| 22 | ** TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
| 23 | ** PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR |
| 24 | ** CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, |
| 25 | ** EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, |
| 26 | ** PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; |
| 27 | ** OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, |
| 28 | ** WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR |
| 29 | ** OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF |
| 30 | ** ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| 31 | */ |
| 32 | |
| 33 | /* |
| 34 | ** The above modified BSD style license (GPL and LGPL compatible) applies to |
| 35 | ** this file. It does not apply to libsndfile itself which is released under |
| 36 | ** the GNU LGPL or the libsndfile test suite which is released under the GNU |
| 37 | ** GPL. |
| 38 | ** This means that this header file can be used under this modified BSD style |
| 39 | ** license, but the LGPL still holds for the libsndfile library itself. |
| 40 | */ |
| 41 | |
| 42 | /* |
| 43 | ** sndfile.hh -- A lightweight C++ wrapper for the libsndfile API. |
| 44 | ** |
| 45 | ** All the methods are inlines and all functionality is contained in this |
| 46 | ** file. There is no separate implementation file. |
| 47 | ** |
| 48 | ** API documentation is in the doc/ directory of the source code tarball |
| 49 | ** and at http://www.mega-nerd.com/libsndfile/api.html. |
| 50 | */ |
| 51 | |
| 52 | #ifndef SNDFILE_HH |
| 53 | #define SNDFILE_HH |
| 54 | |
| 55 | #include <sndfile.h> |
| 56 | |
| 57 | #include <string> |
| 58 | #include <new> // for std::nothrow |
| 59 | |
| 60 | class SndfileHandle |
| 61 | { private : |
| 62 | struct SNDFILE_ref |
| 63 | { SNDFILE_ref (void) ; |
| 64 | ~SNDFILE_ref (void) ; |
| 65 | |
| 66 | SNDFILE *sf ; |
| 67 | SF_INFO sfinfo ; |
| 68 | int ref ; |
| 69 | } ; |
| 70 | |
| 71 | SNDFILE_ref *p ; |
| 72 | |
| 73 | public : |
| 74 | /* Default constructor */ |
| 75 | SndfileHandle (void) : p (NULL) {} ; |
| 76 | SndfileHandle (const char *path, int mode = SFM_READ, |
| 77 | int format = 0, int channels = 0, int samplerate = 0) ; |
| 78 | SndfileHandle (std::string const & path, int mode = SFM_READ, |
| 79 | int format = 0, int channels = 0, int samplerate = 0) ; |
| 80 | SndfileHandle (int fd, bool close_desc, int mode = SFM_READ, |
| 81 | int format = 0, int channels = 0, int samplerate = 0) ; |
| 82 | |
| 83 | #ifdef ENABLE_SNDFILE_WINDOWS_PROTOTYPES |
| 84 | SndfileHandle (LPCWSTR wpath, int mode = SFM_READ, |
| 85 | int format = 0, int channels = 0, int samplerate = 0) ; |
| 86 | #endif |
| 87 | |
| 88 | ~SndfileHandle (void) ; |
| 89 | |
| 90 | SndfileHandle (const SndfileHandle &orig) ; |
| 91 | SndfileHandle & operator = (const SndfileHandle &rhs) ; |
| 92 | |
| 93 | /* Mainly for debugging/testing. */ |
| 94 | int refCount (void) const { return (p == NULL) ? 0 : p->ref ; } |
| 95 | |
| 96 | operator bool () const { return (p != NULL) ; } |
| 97 | |
| 98 | bool operator == (const SndfileHandle &rhs) const { return (p == rhs.p) ; } |
| 99 | |
| 100 | sf_count_t frames (void) const { return p ? p->sfinfo.frames : 0 ; } |
| 101 | int format (void) const { return p ? p->sfinfo.format : 0 ; } |
| 102 | int channels (void) const { return p ? p->sfinfo.channels : 0 ; } |
| 103 | int samplerate (void) const { return p ? p->sfinfo.samplerate : 0 ; } |
| 104 | |
| 105 | int error (void) const ; |
| 106 | const char * strError (void) const ; |
| 107 | |
| 108 | int command (int cmd, void *data, int datasize) ; |
| 109 | |
| 110 | sf_count_t seek (sf_count_t frames, int whence) ; |
| 111 | |
| 112 | void writeSync (void) ; |
| 113 | |
| 114 | int setString (int str_type, const char* str) ; |
| 115 | |
| 116 | const char* getString (int str_type) const ; |
| 117 | |
| 118 | static int formatCheck (int format, int channels, int samplerate) ; |
| 119 | |
| 120 | sf_count_t read (short *ptr, sf_count_t items) ; |
| 121 | sf_count_t read (int *ptr, sf_count_t items) ; |
| 122 | sf_count_t read (float *ptr, sf_count_t items) ; |
| 123 | sf_count_t read (double *ptr, sf_count_t items) ; |
| 124 | |
| 125 | sf_count_t write (const short *ptr, sf_count_t items) ; |
| 126 | sf_count_t write (const int *ptr, sf_count_t items) ; |
| 127 | sf_count_t write (const float *ptr, sf_count_t items) ; |
| 128 | sf_count_t write (const double *ptr, sf_count_t items) ; |
| 129 | |
| 130 | sf_count_t readf (short *ptr, sf_count_t frames) ; |
| 131 | sf_count_t readf (int *ptr, sf_count_t frames) ; |
| 132 | sf_count_t readf (float *ptr, sf_count_t frames) ; |
| 133 | sf_count_t readf (double *ptr, sf_count_t frames) ; |
| 134 | |
| 135 | sf_count_t writef (const short *ptr, sf_count_t frames) ; |
| 136 | sf_count_t writef (const int *ptr, sf_count_t frames) ; |
| 137 | sf_count_t writef (const float *ptr, sf_count_t frames) ; |
| 138 | sf_count_t writef (const double *ptr, sf_count_t frames) ; |
| 139 | |
| 140 | sf_count_t readRaw (void *ptr, sf_count_t bytes) ; |
| 141 | sf_count_t writeRaw (const void *ptr, sf_count_t bytes) ; |
| 142 | |
| 143 | /**< Raw access to the handle. SndfileHandle keeps ownership. */ |
| 144 | SNDFILE * rawHandle (void) ; |
| 145 | |
| 146 | /**< Take ownership of handle, iff reference count is 1. */ |
| 147 | SNDFILE * takeOwnership (void) ; |
| 148 | } ; |
| 149 | |
| 150 | /*============================================================================== |
| 151 | ** Nothing but implementation below. |
| 152 | */ |
| 153 | |
| 154 | inline |
| 155 | SndfileHandle::SNDFILE_ref::SNDFILE_ref (void) |
| 156 | : ref (1) |
| 157 | {} |
| 158 | |
| 159 | inline |
| 160 | SndfileHandle::SNDFILE_ref::~SNDFILE_ref (void) |
| 161 | { if (sf != NULL) sf_close (sf) ; } |
| 162 | |
| 163 | inline |
| 164 | SndfileHandle::SndfileHandle (const char *path, int mode, int fmt, int chans, int srate) |
| 165 | : p (NULL) |
| 166 | { |
| 167 | p = new (std::nothrow) SNDFILE_ref () ; |
| 168 | |
| 169 | if (p != NULL) |
| 170 | { p->ref = 1 ; |
| 171 | |
| 172 | p->sfinfo.frames = 0 ; |
| 173 | p->sfinfo.channels = chans ; |
| 174 | p->sfinfo.format = fmt ; |
| 175 | p->sfinfo.samplerate = srate ; |
| 176 | p->sfinfo.sections = 0 ; |
| 177 | p->sfinfo.seekable = 0 ; |
Alexandre Lision | 2b23792 | 2013-09-09 16:23:02 -0400 | [diff] [blame] | 178 | |
Alexandre Lision | 7c6f4a6 | 2013-09-05 13:27:01 -0400 | [diff] [blame] | 179 | p->sf = sf_open (path, mode, &p->sfinfo) ; |
Alexandre Lision | 2b23792 | 2013-09-09 16:23:02 -0400 | [diff] [blame] | 180 | |
| 181 | //sf_format_check(&p->sfinfo); |
Alexandre Lision | 7c6f4a6 | 2013-09-05 13:27:01 -0400 | [diff] [blame] | 182 | } ; |
| 183 | |
| 184 | return ; |
| 185 | } /* SndfileHandle const char * constructor */ |
| 186 | |
| 187 | inline |
| 188 | SndfileHandle::SndfileHandle (std::string const & path, int mode, int fmt, int chans, int srate) |
| 189 | : p (NULL) |
| 190 | { |
| 191 | p = new (std::nothrow) SNDFILE_ref () ; |
| 192 | |
| 193 | if (p != NULL) |
| 194 | { p->ref = 1 ; |
| 195 | |
| 196 | p->sfinfo.frames = 0 ; |
| 197 | p->sfinfo.channels = chans ; |
| 198 | p->sfinfo.format = fmt ; |
| 199 | p->sfinfo.samplerate = srate ; |
| 200 | p->sfinfo.sections = 0 ; |
| 201 | p->sfinfo.seekable = 0 ; |
| 202 | |
| 203 | p->sf = sf_open (path.c_str (), mode, &p->sfinfo) ; |
| 204 | } ; |
| 205 | |
| 206 | return ; |
| 207 | } /* SndfileHandle std::string constructor */ |
| 208 | |
| 209 | inline |
| 210 | SndfileHandle::SndfileHandle (int fd, bool close_desc, int mode, int fmt, int chans, int srate) |
| 211 | : p (NULL) |
| 212 | { |
| 213 | if (fd < 0) |
| 214 | return ; |
| 215 | |
| 216 | p = new (std::nothrow) SNDFILE_ref () ; |
| 217 | |
| 218 | if (p != NULL) |
| 219 | { p->ref = 1 ; |
| 220 | |
| 221 | p->sfinfo.frames = 0 ; |
| 222 | p->sfinfo.channels = chans ; |
| 223 | p->sfinfo.format = fmt ; |
| 224 | p->sfinfo.samplerate = srate ; |
| 225 | p->sfinfo.sections = 0 ; |
| 226 | p->sfinfo.seekable = 0 ; |
| 227 | |
| 228 | p->sf = sf_open_fd (fd, mode, &p->sfinfo, close_desc) ; |
| 229 | } ; |
| 230 | |
| 231 | return ; |
| 232 | } /* SndfileHandle fd constructor */ |
| 233 | |
| 234 | inline |
| 235 | SndfileHandle::~SndfileHandle (void) |
| 236 | { if (p != NULL && --p->ref == 0) |
| 237 | delete p ; |
| 238 | } /* SndfileHandle destructor */ |
| 239 | |
| 240 | |
| 241 | inline |
| 242 | SndfileHandle::SndfileHandle (const SndfileHandle &orig) |
| 243 | : p (orig.p) |
| 244 | { if (p != NULL) |
| 245 | ++p->ref ; |
| 246 | } /* SndfileHandle copy constructor */ |
| 247 | |
| 248 | inline SndfileHandle & |
| 249 | SndfileHandle::operator = (const SndfileHandle &rhs) |
| 250 | { |
| 251 | if (&rhs == this) |
| 252 | return *this ; |
| 253 | if (p != NULL && --p->ref == 0) |
| 254 | delete p ; |
| 255 | |
| 256 | p = rhs.p ; |
| 257 | if (p != NULL) |
| 258 | ++p->ref ; |
| 259 | |
| 260 | return *this ; |
| 261 | } /* SndfileHandle assignment operator */ |
| 262 | |
| 263 | inline int |
| 264 | SndfileHandle::error (void) const |
| 265 | { return sf_error (p->sf) ; } |
| 266 | |
| 267 | inline const char * |
| 268 | SndfileHandle::strError (void) const |
| 269 | { return sf_strerror (p->sf) ; } |
| 270 | |
| 271 | inline int |
| 272 | SndfileHandle::command (int cmd, void *data, int datasize) |
| 273 | { return sf_command (p->sf, cmd, data, datasize) ; } |
| 274 | |
| 275 | inline sf_count_t |
| 276 | SndfileHandle::seek (sf_count_t frame_count, int whence) |
| 277 | { return sf_seek (p->sf, frame_count, whence) ; } |
| 278 | |
| 279 | inline void |
| 280 | SndfileHandle::writeSync (void) |
| 281 | { sf_write_sync (p->sf) ; } |
| 282 | |
| 283 | inline int |
| 284 | SndfileHandle::setString (int str_type, const char* str) |
| 285 | { return sf_set_string (p->sf, str_type, str) ; } |
| 286 | |
| 287 | inline const char* |
| 288 | SndfileHandle::getString (int str_type) const |
| 289 | { return sf_get_string (p->sf, str_type) ; } |
| 290 | |
| 291 | inline int |
| 292 | SndfileHandle::formatCheck (int fmt, int chans, int srate) |
| 293 | { |
| 294 | SF_INFO sfinfo ; |
| 295 | |
| 296 | sfinfo.frames = 0 ; |
| 297 | sfinfo.channels = chans ; |
| 298 | sfinfo.format = fmt ; |
| 299 | sfinfo.samplerate = srate ; |
| 300 | sfinfo.sections = 0 ; |
| 301 | sfinfo.seekable = 0 ; |
| 302 | |
| 303 | return sf_format_check (&sfinfo) ; |
| 304 | } |
| 305 | |
| 306 | /*---------------------------------------------------------------------*/ |
| 307 | |
| 308 | inline sf_count_t |
| 309 | SndfileHandle::read (short *ptr, sf_count_t items) |
| 310 | { return sf_read_short (p->sf, ptr, items) ; } |
| 311 | |
| 312 | inline sf_count_t |
| 313 | SndfileHandle::read (int *ptr, sf_count_t items) |
| 314 | { return sf_read_int (p->sf, ptr, items) ; } |
| 315 | |
| 316 | inline sf_count_t |
| 317 | SndfileHandle::read (float *ptr, sf_count_t items) |
| 318 | { return sf_read_float (p->sf, ptr, items) ; } |
| 319 | |
| 320 | inline sf_count_t |
| 321 | SndfileHandle::read (double *ptr, sf_count_t items) |
| 322 | { return sf_read_double (p->sf, ptr, items) ; } |
| 323 | |
| 324 | inline sf_count_t |
| 325 | SndfileHandle::write (const short *ptr, sf_count_t items) |
| 326 | { return sf_write_short (p->sf, ptr, items) ; } |
| 327 | |
| 328 | inline sf_count_t |
| 329 | SndfileHandle::write (const int *ptr, sf_count_t items) |
| 330 | { return sf_write_int (p->sf, ptr, items) ; } |
| 331 | |
| 332 | inline sf_count_t |
| 333 | SndfileHandle::write (const float *ptr, sf_count_t items) |
| 334 | { return sf_write_float (p->sf, ptr, items) ; } |
| 335 | |
| 336 | inline sf_count_t |
| 337 | SndfileHandle::write (const double *ptr, sf_count_t items) |
| 338 | { return sf_write_double (p->sf, ptr, items) ; } |
| 339 | |
| 340 | inline sf_count_t |
| 341 | SndfileHandle::readf (short *ptr, sf_count_t frame_count) |
| 342 | { return sf_readf_short (p->sf, ptr, frame_count) ; } |
| 343 | |
| 344 | inline sf_count_t |
| 345 | SndfileHandle::readf (int *ptr, sf_count_t frame_count) |
| 346 | { return sf_readf_int (p->sf, ptr, frame_count) ; } |
| 347 | |
| 348 | inline sf_count_t |
| 349 | SndfileHandle::readf (float *ptr, sf_count_t frame_count) |
| 350 | { return sf_readf_float (p->sf, ptr, frame_count) ; } |
| 351 | |
| 352 | inline sf_count_t |
| 353 | SndfileHandle::readf (double *ptr, sf_count_t frame_count) |
| 354 | { return sf_readf_double (p->sf, ptr, frame_count) ; } |
| 355 | |
| 356 | inline sf_count_t |
| 357 | SndfileHandle::writef (const short *ptr, sf_count_t frame_count) |
| 358 | { return sf_writef_short (p->sf, ptr, frame_count) ; } |
| 359 | |
| 360 | inline sf_count_t |
| 361 | SndfileHandle::writef (const int *ptr, sf_count_t frame_count) |
| 362 | { return sf_writef_int (p->sf, ptr, frame_count) ; } |
| 363 | |
| 364 | inline sf_count_t |
| 365 | SndfileHandle::writef (const float *ptr, sf_count_t frame_count) |
| 366 | { return sf_writef_float (p->sf, ptr, frame_count) ; } |
| 367 | |
| 368 | inline sf_count_t |
| 369 | SndfileHandle::writef (const double *ptr, sf_count_t frame_count) |
| 370 | { return sf_writef_double (p->sf, ptr, frame_count) ; } |
| 371 | |
| 372 | inline sf_count_t |
| 373 | SndfileHandle::readRaw (void *ptr, sf_count_t bytes) |
| 374 | { return sf_read_raw (p->sf, ptr, bytes) ; } |
| 375 | |
| 376 | inline sf_count_t |
| 377 | SndfileHandle::writeRaw (const void *ptr, sf_count_t bytes) |
| 378 | { return sf_write_raw (p->sf, ptr, bytes) ; } |
| 379 | |
| 380 | inline SNDFILE * |
| 381 | SndfileHandle::rawHandle (void) |
| 382 | { return (p ? p->sf : NULL) ; } |
| 383 | |
| 384 | inline SNDFILE * |
| 385 | SndfileHandle::takeOwnership (void) |
| 386 | { |
| 387 | if (p == NULL || (p->ref != 1)) |
| 388 | return NULL ; |
| 389 | |
| 390 | SNDFILE * sf = p->sf ; |
| 391 | p->sf = NULL ; |
| 392 | delete p ; |
| 393 | p = NULL ; |
| 394 | return sf ; |
| 395 | } |
| 396 | |
| 397 | #ifdef ENABLE_SNDFILE_WINDOWS_PROTOTYPES |
| 398 | |
| 399 | inline |
| 400 | SndfileHandle::SndfileHandle (LPCWSTR wpath, int mode, int fmt, int chans, int srate) |
| 401 | : p (NULL) |
| 402 | { |
| 403 | p = new (std::nothrow) SNDFILE_ref () ; |
| 404 | |
| 405 | if (p != NULL) |
| 406 | { p->ref = 1 ; |
| 407 | |
| 408 | p->sfinfo.frames = 0 ; |
| 409 | p->sfinfo.channels = chans ; |
| 410 | p->sfinfo.format = fmt ; |
| 411 | p->sfinfo.samplerate = srate ; |
| 412 | p->sfinfo.sections = 0 ; |
| 413 | p->sfinfo.seekable = 0 ; |
| 414 | |
| 415 | p->sf = sf_wchar_open (wpath, mode, &p->sfinfo) ; |
| 416 | } ; |
| 417 | |
| 418 | return ; |
| 419 | } /* SndfileHandle const wchar_t * constructor */ |
| 420 | |
| 421 | #endif |
| 422 | |
| 423 | #endif /* SNDFILE_HH */ |
| 424 | |