开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 多媒体 > Audio > 查看源码
common.h
资源名称：libsndfile-1.0.21.tar.gz　[点击查看]
上传用户：shw771010
上传日期：2022-01-05
资源大小：991k
文件大小：24k
源码类别：

Audio

开发平台：

Unix_Linux

common.h：源码内容
  1. /*
  2. ** Copyright (C) 1999-2009 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. */
  19. #ifndef SNDFILE_COMMON_H
  20. #define SNDFILE_COMMON_H
  22. #include "sfconfig.h"
  24. #include <stdlib.h>
  26. #if HAVE_STDINT_H
  27. #include <stdint.h>
  28. #elif HAVE_INTTYPES_H
  29. #include <inttypes.h>
  30. #endif
  32. #ifndef SNDFILE_H
  33. #include "sndfile.h"
  34. #endif
  36. #ifdef __cplusplus
  37. #error "This code is not designed to be compiled with a C++ compiler."
  38. #endif
  40. #if (SIZEOF_LONG == 8)
  41. # define SF_PLATFORM_S64(x) x##l
  42. #elif (SIZEOF_LONG_LONG == 8)
  43. # define SF_PLATFORM_S64(x) x##ll
  44. #elif COMPILER_IS_GCC
  45. # define SF_PLATFORM_S64(x) x##ll
  46. #elif OS_IS_WIN32
  47. # define SF_PLATFORM_S64(x) x##I64
  48. #else
  49. # error "Don't know how to define a 64 bit integer constant."
  50. #endif
  54. /*
  55. ** Inspiration : http://sourcefrog.net/weblog/software/languages/C/unused.html
  56. */
  57. #ifdef UNUSED
  58. #elif defined (__GNUC__)
  59. # define UNUSED(x) UNUSED_ ## x __attribute__ ((unused))
  60. #elif defined (__LCLINT__)
  61. # define UNUSED(x) /*@unused@*/ x
  62. #else
  63. # define UNUSED(x) x
  64. #endif
  66. #ifdef __GNUC__
  67. # define WARN_UNUSED __attribute__ ((warn_unused_result))
  68. #else
  69. # define WARN_UNUSED
  70. #endif
  72. #define SF_BUFFER_LEN (8192*2)
  73. #define SF_FILENAME_LEN (512)
  74. #define SF_SYSERR_LEN (256)
  75. #define SF_MAX_STRINGS (32)
  76. #define SF_STR_BUFFER_LEN (8192)
  77. #define SF_HEADER_LEN (4100 + SF_STR_BUFFER_LEN)
  79. #define PSF_SEEK_ERROR ((sf_count_t) -1)
  82. #define BITWIDTH2BYTES(x) (((x) + 7) / 8)
  84. /* For some reason sizeof returns an unsigned  value which causes
  85. ** a warning when that value is added or subtracted from a signed
  86. ** value. Use SIGNED_SIZEOF instead.
  87. */
  88. #define SIGNED_SIZEOF(x) ((int) sizeof (x))
  90. #define ARRAY_LEN(x) ((int) (sizeof (x) / sizeof ((x) [0])))
  92. #if (COMPILER_IS_GCC == 1)
  93. #define SF_MAX(x,y) ({ 
  94. typeof (x) sf_max_x1 = (x) ; 
  95. typeof (y) sf_max_y1 = (y) ; 
  96. (void) (&sf_max_x1 == &sf_max_y1) ; 
  97. sf_max_x1 > sf_max_y1 ? sf_max_x1 : sf_max_y1 ; })
  99. #define SF_MIN(x,y) ({ 
  100. typeof (x) sf_min_x2 = (x) ; 
  101. typeof (y) sf_min_y2 = (y) ; 
  102. (void) (&sf_min_x2 == &sf_min_y2) ; 
  103. sf_min_x2 < sf_min_y2 ? sf_min_x2 : sf_min_y2 ; })
  104. #else
  105. #define SF_MAX(a,b) ((a) > (b) ? (a) : (b))
  106. #define SF_MIN(a,b) ((a) < (b) ? (a) : (b))
  107. #endif
  110. #define SF_MAX_CHANNELS 256
  112. /*
  113. * Macros for spliting the format file of SF_INFI into contrainer type,
  114. ** codec type and endian-ness.
  115. */
  116. #define SF_CONTAINER(x) ((x) & SF_FORMAT_TYPEMASK)
  117. #define SF_CODEC(x) ((x) & SF_FORMAT_SUBMASK)
  118. #define SF_ENDIAN(x) ((x) & SF_FORMAT_ENDMASK)
  121. enum
  122. { /* PEAK chunk location. */
  123. SF_PEAK_START = 42,
  124. SF_PEAK_END = 43,
  126. /* PEAK chunk location. */
  127. SF_SCALE_MAX = 52,
  128. SF_SCALE_MIN = 53,
  130. /* str_flags values. */
  131. SF_STR_ALLOW_START = 0x0100,
  132. SF_STR_ALLOW_END = 0x0200,
  134. /* Location of strings. */
  135. SF_STR_LOCATE_START = 0x0400,
  136. SF_STR_LOCATE_END = 0x0800,
  138. SFD_TYPEMASK = 0x0FFFFFFF
  139. } ;
  141. #define SFM_MASK  (SFM_READ | SFM_WRITE | SFM_RDWR)
  142. #define SFM_UNMASK  (~SFM_MASK)
  144. /*---------------------------------------------------------------------------------------
  145. ** Formats that may be supported at some time in the future.
  146. ** When support is finalised, these values move to src/sndfile.h.
  147. */
  149. enum
  150. { /* Work in progress. */
  152. /* Formats supported read only. */
  153. SF_FORMAT_TXW = 0x4030000, /* Yamaha TX16 sampler file */
  154. SF_FORMAT_DWD = 0x4040000, /* DiamondWare Digirized */
  156. /* Following are detected but not supported. */
  157. SF_FORMAT_REX = 0x40A0000, /* Propellorheads Rex/Rcy */
  158. SF_FORMAT_REX2 = 0x40D0000, /* Propellorheads Rex2 */
  159. SF_FORMAT_KRZ = 0x40E0000, /* Kurzweil sampler file */
  160. SF_FORMAT_WMA = 0x4100000, /* Windows Media Audio. */
  161. SF_FORMAT_SHN = 0x4110000, /* Shorten. */
  163. /* Unsupported encodings. */
  164. SF_FORMAT_SVX_FIB = 0x1020,  /* SVX Fibonacci Delta encoding. */
  165. SF_FORMAT_SVX_EXP = 0x1021,  /* SVX Exponential Delta encoding. */
  167. SF_FORMAT_PCM_N = 0x1030
  168. } ;
  170. /*---------------------------------------------------------------------------------------
  171. ** PEAK_CHUNK - This chunk type is common to both AIFF and WAVE files although their
  172. ** endian encodings are different.
  173. */
  175. typedef struct
  176. { double value ; /* signed value of peak */
  177. sf_count_t position ; /* the sample frame for the peak */
  178. } PEAK_POS ;
  180. typedef struct
  181. { /* libsndfile internal : write a PEAK chunk at the start or end of the file? */
  182. int peak_loc ;
  184. /* WAV/AIFF */
  185. unsigned int version ; /* version of the PEAK chunk */
  186. unsigned int timestamp ; /* secs since 1/1/1970  */
  188. /* CAF */
  189. unsigned int edit_number ;
  191. #if HAVE_FLEXIBLE_ARRAY
  192. /* the per channel peak info */
  193. PEAK_POS peaks [] ;
  194. #else
  195. /*
  196. ** This is not ISO compliant C. It works on some compilers which
  197. ** don't support the ISO standard flexible struct array which is
  198. ** used above. If your compiler doesn't like this I suggest you find
  199. ** youself a 1999 ISO C standards compilant compiler. GCC-3.X is
  200. ** highly recommended.
  201. */
  202. PEAK_POS peaks [0] ;
  203. #endif
  204. } PEAK_INFO ;
  206. static inline PEAK_INFO *
  207. peak_info_calloc (int channels)
  208. { return calloc (1, sizeof (PEAK_INFO) + channels * sizeof (PEAK_POS)) ;
  209. } /* peak_info_calloc */
  211. typedef struct
  212. { int type ;
  213. int flags ;
  214. char  *str ;
  215. } STR_DATA ;
  217. static inline size_t
  218. make_size_t (int x)
  219. { return (size_t) x ;
  220. } /* size_t_of_int */
  222. /*
  223. ** This version of isprint specifically ignores any locale info. Its used for
  224. ** determining which characters can be printed in things like hexdumps.
  225. */
  226. static inline int
  227. psf_isprint (int ch)
  228. { return (ch >= ' ' && ch <= '~') ;
  229. } /* psf_isprint */
  231. /*=======================================================================================
  232. ** SF_PRIVATE stuct - a pointer to this struct is passed back to the caller of the
  233. ** sf_open_XXXX functions. The caller however has no knowledge of the struct's
  234. ** contents.
  235. */
  238. typedef struct
  239. { int size ;
  240. SF_BROADCAST_INFO binfo ;
  241. } PSF_BROADCAST_VAR ;
  243. #if SIZEOF_WCHAR_T == 2
  244. typedef wchar_t sfwchar_t ;
  245. #else
  246. typedef int16_t sfwchar_t ;
  247. #endif
  250. typedef struct
  251. {
  252. union
  253. { char c [SF_FILENAME_LEN] ;
  254. sfwchar_t wc [SF_FILENAME_LEN] ;
  255. } path ;
  257. union
  258. { char c [SF_FILENAME_LEN] ;
  259. sfwchar_t wc [SF_FILENAME_LEN] ;
  260. } dir ;
  262. union
  263. { char c [SF_FILENAME_LEN / 4] ;
  264. sfwchar_t wc [SF_FILENAME_LEN / 4] ;
  265. } name ;
  267. #if USE_WINDOWS_API
  268. /*
  269. ** These fields can only be used in src/file_io.c.
  270. ** They are basically the same as a windows file HANDLE.
  271. */
  272. void  *handle, *hsaved ;
  274. int use_wchar ;
  275. #else
  276. /* These fields can only be used in src/file_io.c. */
  277. int  filedes, savedes ;
  278. #endif
  280. int do_not_close_descriptor ;
  281. int mode ; /* Open mode : SFM_READ, SFM_WRITE or SFM_RDWR. */
  282. } PSF_FILE ;
  285. typedef struct sf_private_tag
  286. {
  287. /* Canary in a coal mine. */
  288. union
  289. { /* Place a double here to encourage double alignment. */
  290. double d [2] ;
  291. char c [16] ;
  292. } canary ;
  294. /* Force the compiler to double align the start of buffer. */
  295. union
  296. { double dbuf [SF_BUFFER_LEN / sizeof (double)] ;
  297. #if (defined (SIZEOF_INT64_T) && (SIZEOF_INT64_T == 8))
  298. int64_t lbuf [SF_BUFFER_LEN / sizeof (int64_t)] ;
  299. #else
  300. long lbuf [SF_BUFFER_LEN / sizeof (double)] ;
  301. #endif
  302. float fbuf [SF_BUFFER_LEN / sizeof (float)] ;
  303. int ibuf [SF_BUFFER_LEN / sizeof (int)] ;
  304. short sbuf [SF_BUFFER_LEN / sizeof (short)] ;
  305. char cbuf [SF_BUFFER_LEN / sizeof (char)] ;
  306. signed char scbuf [SF_BUFFER_LEN / sizeof (signed char)] ;
  307. unsigned char ucbuf [SF_BUFFER_LEN / sizeof (signed char)] ;
  308. } u ;
  311. PSF_FILE file, rsrc ;
  313. char syserr [SF_SYSERR_LEN] ;
  315. /* logbuffer and logindex should only be changed within the logging functions
  316. ** of common.c
  317. */
  318. char logbuffer [SF_BUFFER_LEN] ;
  319. unsigned char header [SF_HEADER_LEN] ; /* Must be unsigned */
  320. int rwf_endian ; /* Header endian-ness flag. */
  322. /* Storage and housekeeping data for adding/reading strings from
  323. ** sound files.
  324. */
  325. STR_DATA strings [SF_MAX_STRINGS] ;
  326. char str_storage [SF_STR_BUFFER_LEN] ;
  327. char *str_end ;
  328. int str_flags ;
  330. /* Guard value. If this changes the buffers above have overflowed. */
  331. int Magick ;
  333. unsigned unique_id ;
  335. /* Index variables for maintaining logbuffer and header above. */
  336. int logindex ;
  337. int headindex, headend ;
  338. int has_text ;
  340. int error ;
  342. int endian ; /* File endianness : SF_ENDIAN_LITTLE or SF_ENDIAN_BIG. */
  343. int data_endswap ; /* Need to endswap data? */
  345. /*
  346. ** Maximum float value for calculating the multiplier for
  347. ** float/double to short/int conversions.
  348. */
  349. int float_int_mult ;
  350. float float_max ;
  352. int scale_int_float ;
  354. /* Vairables for handling pipes. */
  355. int is_pipe ; /* True if file is a pipe. */
  356. sf_count_t pipeoffset ; /* Number of bytes read from a pipe. */
  358. /* True if clipping must be performed on float->int conversions. */
  359. int add_clipping ;
  361. SF_INFO sf ;
  363. int have_written ; /* Has a single write been done to the file? */
  364. PEAK_INFO *peak_info ;
  366. /* Loop Info */
  367. SF_LOOP_INFO *loop_info ;
  368. SF_INSTRUMENT *instrument ;
  370. /* Broadcast (EBU) Info */
  371. PSF_BROADCAST_VAR *broadcast_var ;
  373. /* Channel map data (if present) : an array of ints. */
  374. int *channel_map ;
  376. sf_count_t filelength ; /* Overall length of (embedded) file. */
  377. sf_count_t fileoffset ; /* Offset in number of bytes from beginning of file. */
  379. sf_count_t rsrclength ; /* Length of the resource fork (if it exists). */
  381. sf_count_t dataoffset ; /* Offset in number of bytes from beginning of file. */
  382. sf_count_t datalength ; /* Length in bytes of the audio data. */
  383. sf_count_t dataend ; /* Offset to file tailer. */
  385. int blockwidth ; /* Size in bytes of one set of interleaved samples. */
  386. int bytewidth ; /* Size in bytes of one sample (one channel). */
  388. void *dither ;
  389. void *interleave ;
  391. int last_op ; /* Last operation; either SFM_READ or SFM_WRITE */
  392. sf_count_t read_current ;
  393. sf_count_t write_current ;
  395. void *container_data ; /* This is a pointer to dynamically allocated file
  396. ** container format specific data.
  397. */
  399. void *codec_data ; /* This is a pointer to dynamically allocated file
  400. ** codec format specific data.
  401. */
  403. SF_DITHER_INFO write_dither ;
  404. SF_DITHER_INFO read_dither ;
  406. int norm_double ;
  407. int norm_float ;
  409. int auto_header ;
  411. int ieee_replace ;
  413. /* A set of file specific function pointers */
  414. sf_count_t (*read_short) (struct sf_private_tag*, short *ptr, sf_count_t len) ;
  415. sf_count_t (*read_int) (struct sf_private_tag*, int *ptr, sf_count_t len) ;
  416. sf_count_t (*read_float) (struct sf_private_tag*, float *ptr, sf_count_t len) ;
  417. sf_count_t (*read_double) (struct sf_private_tag*, double *ptr, sf_count_t len) ;
  419. sf_count_t (*write_short) (struct sf_private_tag*, const short *ptr, sf_count_t len) ;
  420. sf_count_t (*write_int) (struct sf_private_tag*, const int *ptr, sf_count_t len) ;
  421. sf_count_t (*write_float) (struct sf_private_tag*, const float *ptr, sf_count_t len) ;
  422. sf_count_t (*write_double) (struct sf_private_tag*, const double *ptr, sf_count_t len) ;
  424. sf_count_t (*seek)  (struct sf_private_tag*, int mode, sf_count_t samples_from_start) ;
  425. int (*write_header) (struct sf_private_tag*, int calc_length) ;
  426. int (*command) (struct sf_private_tag*, int command, void *data, int datasize) ;
  428. /*
  429. ** Separate close functions for the codec and the container.
  430. ** The codec close function is always called first.
  431. */
  432. int (*codec_close) (struct sf_private_tag*) ;
  433. int (*container_close) (struct sf_private_tag*) ;
  435. char *format_desc ;
  437. /* Virtual I/O functions. */
  438. int virtual_io ;
  439. SF_VIRTUAL_IO vio ;
  440. void *vio_user_data ;
  441. } SF_PRIVATE ;
  445. enum
  446. { SFE_NO_ERROR = SF_ERR_NO_ERROR,
  447. SFE_BAD_OPEN_FORMAT = SF_ERR_UNRECOGNISED_FORMAT,
  448. SFE_SYSTEM = SF_ERR_SYSTEM,
  449. SFE_MALFORMED_FILE = SF_ERR_MALFORMED_FILE,
  450. SFE_UNSUPPORTED_ENCODING = SF_ERR_UNSUPPORTED_ENCODING,
  452. SFE_ZERO_MAJOR_FORMAT,
  453. SFE_ZERO_MINOR_FORMAT,
  454. SFE_BAD_FILE,
  455. SFE_BAD_FILE_READ,
  456. SFE_OPEN_FAILED,
  457. SFE_BAD_SNDFILE_PTR,
  458. SFE_BAD_SF_INFO_PTR,
  459. SFE_BAD_SF_INCOMPLETE,
  460. SFE_BAD_FILE_PTR,
  461. SFE_BAD_INT_PTR,
  462. SFE_BAD_STAT_SIZE,
  463. SFE_MALLOC_FAILED,
  464. SFE_UNIMPLEMENTED,
  465. SFE_BAD_READ_ALIGN,
  466. SFE_BAD_WRITE_ALIGN,
  467. SFE_UNKNOWN_FORMAT,
  468. SFE_NOT_READMODE,
  469. SFE_NOT_WRITEMODE,
  470. SFE_BAD_MODE_RW,
  471. SFE_BAD_SF_INFO,
  472. SFE_BAD_OFFSET,
  473. SFE_NO_EMBED_SUPPORT,
  474. SFE_NO_EMBEDDED_RDWR,
  475. SFE_NO_PIPE_WRITE,
  477. SFE_INTERNAL,
  478. SFE_BAD_COMMAND_PARAM,
  479. SFE_BAD_ENDIAN,
  480. SFE_CHANNEL_COUNT_ZERO,
  481. SFE_CHANNEL_COUNT,
  483. SFE_BAD_VIRTUAL_IO,
  485. SFE_INTERLEAVE_MODE,
  486. SFE_INTERLEAVE_SEEK,
  487. SFE_INTERLEAVE_READ,
  489. SFE_BAD_SEEK,
  490. SFE_NOT_SEEKABLE,
  491. SFE_AMBIGUOUS_SEEK,
  492. SFE_WRONG_SEEK,
  493. SFE_SEEK_FAILED,
  495. SFE_BAD_OPEN_MODE,
  496. SFE_OPEN_PIPE_RDWR,
  497. SFE_RDWR_POSITION,
  498. SFE_RDWR_BAD_HEADER,
  499. SFE_CMD_HAS_DATA,
  500. SFE_BAD_BROADCAST_INFO_SIZE,
  502. SFE_STR_NO_SUPPORT,
  503. SFE_STR_NOT_WRITE,
  504. SFE_STR_MAX_DATA,
  505. SFE_STR_MAX_COUNT,
  506. SFE_STR_BAD_TYPE,
  507. SFE_STR_NO_ADD_END,
  508. SFE_STR_BAD_STRING,
  509. SFE_STR_WEIRD,
  511. SFE_WAV_NO_RIFF,
  512. SFE_WAV_NO_WAVE,
  513. SFE_WAV_NO_FMT,
  514. SFE_WAV_BAD_FMT,
  515. SFE_WAV_FMT_SHORT,
  516. SFE_WAV_BAD_FACT,
  517. SFE_WAV_BAD_PEAK,
  518. SFE_WAV_PEAK_B4_FMT,
  519. SFE_WAV_BAD_FORMAT,
  520. SFE_WAV_BAD_BLOCKALIGN,
  521. SFE_WAV_NO_DATA,
  522. SFE_WAV_BAD_LIST,
  523. SFE_WAV_ADPCM_NOT4BIT,
  524. SFE_WAV_ADPCM_CHANNELS,
  525. SFE_WAV_GSM610_FORMAT,
  526. SFE_WAV_UNKNOWN_CHUNK,
  527. SFE_WAV_WVPK_DATA,
  529. SFE_AIFF_NO_FORM,
  530. SFE_AIFF_AIFF_NO_FORM,
  531. SFE_AIFF_COMM_NO_FORM,
  532. SFE_AIFF_SSND_NO_COMM,
  533. SFE_AIFF_UNKNOWN_CHUNK,
  534. SFE_AIFF_COMM_CHUNK_SIZE,
  535. SFE_AIFF_BAD_COMM_CHUNK,
  536. SFE_AIFF_PEAK_B4_COMM,
  537. SFE_AIFF_BAD_PEAK,
  538. SFE_AIFF_NO_SSND,
  539. SFE_AIFF_NO_DATA,
  540. SFE_AIFF_RW_SSND_NOT_LAST,
  542. SFE_AU_UNKNOWN_FORMAT,
  543. SFE_AU_NO_DOTSND,
  544. SFE_AU_EMBED_BAD_LEN,
  546. SFE_RAW_READ_BAD_SPEC,
  547. SFE_RAW_BAD_BITWIDTH,
  548. SFE_RAW_BAD_FORMAT,
  550. SFE_PAF_NO_MARKER,
  551. SFE_PAF_VERSION,
  552. SFE_PAF_UNKNOWN_FORMAT,
  553. SFE_PAF_SHORT_HEADER,
  555. SFE_SVX_NO_FORM,
  556. SFE_SVX_NO_BODY,
  557. SFE_SVX_NO_DATA,
  558. SFE_SVX_BAD_COMP,
  559. SFE_SVX_BAD_NAME_LENGTH,
  561. SFE_NIST_BAD_HEADER,
  562. SFE_NIST_CRLF_CONVERISON,
  563. SFE_NIST_BAD_ENCODING,
  565. SFE_VOC_NO_CREATIVE,
  566. SFE_VOC_BAD_FORMAT,
  567. SFE_VOC_BAD_VERSION,
  568. SFE_VOC_BAD_MARKER,
  569. SFE_VOC_BAD_SECTIONS,
  570. SFE_VOC_MULTI_SAMPLERATE,
  571. SFE_VOC_MULTI_SECTION,
  572. SFE_VOC_MULTI_PARAM,
  573. SFE_VOC_SECTION_COUNT,
  574. SFE_VOC_NO_PIPE,
  576. SFE_IRCAM_NO_MARKER,
  577. SFE_IRCAM_BAD_CHANNELS,
  578. SFE_IRCAM_UNKNOWN_FORMAT,
  580. SFE_W64_64_BIT,
  581. SFE_W64_NO_RIFF,
  582. SFE_W64_NO_WAVE,
  583. SFE_W64_NO_DATA,
  584. SFE_W64_ADPCM_NOT4BIT,
  585. SFE_W64_ADPCM_CHANNELS,
  586. SFE_W64_GSM610_FORMAT,
  588. SFE_MAT4_BAD_NAME,
  589. SFE_MAT4_NO_SAMPLERATE,
  591. SFE_MAT5_BAD_ENDIAN,
  592. SFE_MAT5_NO_BLOCK,
  593. SFE_MAT5_SAMPLE_RATE,
  595. SFE_PVF_NO_PVF1,
  596. SFE_PVF_BAD_HEADER,
  597. SFE_PVF_BAD_BITWIDTH,
  599. SFE_DWVW_BAD_BITWIDTH,
  600. SFE_G72X_NOT_MONO,
  602. SFE_XI_BAD_HEADER,
  603. SFE_XI_EXCESS_SAMPLES,
  604. SFE_XI_NO_PIPE,
  606. SFE_HTK_NO_PIPE,
  608. SFE_SDS_NOT_SDS,
  609. SFE_SDS_BAD_BIT_WIDTH,
  611. SFE_SD2_FD_DISALLOWED,
  612. SFE_SD2_BAD_DATA_OFFSET,
  613. SFE_SD2_BAD_MAP_OFFSET,
  614. SFE_SD2_BAD_DATA_LENGTH,
  615. SFE_SD2_BAD_MAP_LENGTH,
  616. SFE_SD2_BAD_RSRC,
  617. SFE_SD2_BAD_SAMPLE_SIZE,
  619. SFE_FLAC_BAD_HEADER,
  620. SFE_FLAC_NEW_DECODER,
  621. SFE_FLAC_INIT_DECODER,
  622. SFE_FLAC_LOST_SYNC,
  623. SFE_FLAC_BAD_SAMPLE_RATE,
  624. SFE_FLAC_UNKOWN_ERROR,
  626. SFE_WVE_NOT_WVE,
  627. SFE_WVE_NO_PIPE,
  629. SFE_VORBIS_ENCODER_BUG,
  631. SFE_RF64_NOT_RF64,
  633. SFE_MAX_ERROR /* This must be last in list. */
  634. } ;
  636. int subformat_to_bytewidth (int format) ;
  637. int s_bitwidth_to_subformat (int bits) ;
  638. int u_bitwidth_to_subformat (int bits) ;
  640. /*  Functions for reading and writing floats and doubles on processors
  641. ** with non-IEEE floats/doubles.
  642. */
  643. float float32_be_read (unsigned char *cptr) ;
  644. float float32_le_read (unsigned char *cptr) ;
  645. void float32_be_write (float in, unsigned char *out) ;
  646. void float32_le_write (float in, unsigned char *out) ;
  648. double double64_be_read (unsigned char *cptr) ;
  649. double double64_le_read (unsigned char *cptr) ;
  650. void double64_be_write (double in, unsigned char *out) ;
  651. void double64_le_write (double in, unsigned char *out) ;
  653. /* Functions for writing to the internal logging buffer. */
  655. void psf_log_printf (SF_PRIVATE *psf, const char *format, ...) ;
  656. void psf_log_SF_INFO  (SF_PRIVATE *psf) ;
  658. int32_t psf_rand_int32 (void) ;
  660. void append_snprintf (char * dest, size_t maxlen, const char * fmt, ...) ;
  662. /* Functions used when writing file headers. */
  664. int psf_binheader_writef (SF_PRIVATE *psf, const char *format, ...) ;
  665. void psf_asciiheader_printf (SF_PRIVATE *psf, const char *format, ...) ;
  667. /* Functions used when reading file headers. */
  669. int psf_binheader_readf (SF_PRIVATE *psf, char const *format, ...) ;
  671. /* Functions used in the write function for updating the peak chunk. */
  673. void peak_update_short (SF_PRIVATE *psf, short *ptr, size_t items) ;
  674. void peak_update_int (SF_PRIVATE *psf, int *ptr, size_t items) ;
  675. void peak_update_double (SF_PRIVATE *psf, double *ptr, size_t items) ;
  677. /* Functions defined in command.c. */
  679. int psf_get_format_simple_count (void) ;
  680. int psf_get_format_simple (SF_FORMAT_INFO *data) ;
  682. int psf_get_format_info (SF_FORMAT_INFO *data) ;
  684. int psf_get_format_major_count (void) ;
  685. int psf_get_format_major (SF_FORMAT_INFO *data) ;
  687. int psf_get_format_subtype_count (void) ;
  688. int psf_get_format_subtype (SF_FORMAT_INFO *data) ;
  690. void psf_generate_format_desc (SF_PRIVATE *psf) ;
  692. double psf_calc_signal_max (SF_PRIVATE *psf, int normalize) ;
  693. int psf_calc_max_all_channels (SF_PRIVATE *psf, double *peaks, int normalize) ;
  695. int psf_get_signal_max (SF_PRIVATE *psf, double *peak) ;
  696. int psf_get_max_all_channels (SF_PRIVATE *psf, double *peaks) ;
  698. /* Functions in strings.c. */
  700. const char* psf_get_string (SF_PRIVATE *psf, int str_type) ;
  701. int psf_set_string (SF_PRIVATE *psf, int str_type, const char *str) ;
  702. int psf_store_string (SF_PRIVATE *psf, int str_type, const char *str) ;
  703. int psf_location_string_count (const SF_PRIVATE * psf, int location) ;
  705. /* Default seek function. Use for PCM and float encoded data. */
  706. sf_count_t psf_default_seek (SF_PRIVATE *psf, int mode, sf_count_t samples_from_start) ;
  708. int macos_guess_file_type (SF_PRIVATE *psf, const char *filename) ;
  710. /*------------------------------------------------------------------------------------
  711. ** File I/O functions which will allow access to large files (> 2 Gig) on
  712. ** some 32 bit OSes. Implementation in file_io.c.
  713. */
  715. int psf_fopen (SF_PRIVATE *psf) ;
  716. int psf_set_stdio (SF_PRIVATE *psf) ;
  717. int psf_file_valid (SF_PRIVATE *psf) ;
  718. void psf_set_file (SF_PRIVATE *psf, int fd) ;
  719. void psf_init_files (SF_PRIVATE *psf) ;
  720. void psf_use_rsrc (SF_PRIVATE *psf, int on_off) ;
  722. SNDFILE * psf_open_file (SF_PRIVATE *psf, SF_INFO *sfinfo) ;
  724. sf_count_t psf_fseek (SF_PRIVATE *psf, sf_count_t offset, int whence) ;
  725. sf_count_t psf_fread (void *ptr, sf_count_t bytes, sf_count_t count, SF_PRIVATE *psf) ;
  726. sf_count_t psf_fwrite (const void *ptr, sf_count_t bytes, sf_count_t count, SF_PRIVATE *psf) ;
  727. sf_count_t psf_fgets (char *buffer, sf_count_t bufsize, SF_PRIVATE *psf) ;
  728. sf_count_t psf_ftell (SF_PRIVATE *psf) ;
  729. sf_count_t psf_get_filelen (SF_PRIVATE *psf) ;
  731. void psf_fsync (SF_PRIVATE *psf) ;
  733. int psf_is_pipe (SF_PRIVATE *psf) ;
  735. int psf_ftruncate (SF_PRIVATE *psf, sf_count_t len) ;
  736. int psf_fclose (SF_PRIVATE *psf) ;
  738. /* Open and close the resource fork of a file. */
  739. int psf_open_rsrc (SF_PRIVATE *psf) ;
  740. int psf_close_rsrc (SF_PRIVATE *psf) ;
  742. /*
  743. void psf_fclearerr (SF_PRIVATE *psf) ;
  744. int psf_ferror (SF_PRIVATE *psf) ;
  745. */
  747. /*------------------------------------------------------------------------------------
  748. ** Functions for reading and writing different file formats.
  749. */
  751. int aiff_open (SF_PRIVATE *psf) ;
  752. int au_open (SF_PRIVATE *psf) ;
  753. int avr_open (SF_PRIVATE *psf) ;
  754. int htk_open (SF_PRIVATE *psf) ;
  755. int ircam_open (SF_PRIVATE *psf) ;
  756. int mat4_open (SF_PRIVATE *psf) ;
  757. int mat5_open (SF_PRIVATE *psf) ;
  758. int nist_open (SF_PRIVATE *psf) ;
  759. int paf_open (SF_PRIVATE *psf) ;
  760. int pvf_open (SF_PRIVATE *psf) ;
  761. int raw_open (SF_PRIVATE *psf) ;
  762. int sd2_open (SF_PRIVATE *psf) ;
  763. int sds_open (SF_PRIVATE *psf) ;
  764. int svx_open (SF_PRIVATE *psf) ;
  765. int voc_open (SF_PRIVATE *psf) ;
  766. int w64_open (SF_PRIVATE *psf) ;
  767. int wav_open (SF_PRIVATE *psf) ;
  768. int xi_open (SF_PRIVATE *psf) ;
  769. int flac_open (SF_PRIVATE *psf) ;
  770. int caf_open (SF_PRIVATE *psf) ;
  771. int mpc2k_open (SF_PRIVATE *psf) ;
  772. int rf64_open (SF_PRIVATE *psf) ;
  774. /* In progress. Do not currently work. */
  776. int mpeg_open (SF_PRIVATE *psf) ;
  777. int ogg_open (SF_PRIVATE *psf) ;
  778. int rx2_open (SF_PRIVATE *psf) ;
  779. int txw_open (SF_PRIVATE *psf) ;
  780. int wve_open (SF_PRIVATE *psf) ;
  781. int dwd_open (SF_PRIVATE *psf) ;
  783. int macbinary3_open (SF_PRIVATE *psf) ;
  785. /*------------------------------------------------------------------------------------
  786. ** Init functions for a number of common data encodings.
  787. */
  789. int pcm_init (SF_PRIVATE *psf) ;
  790. int ulaw_init (SF_PRIVATE *psf) ;
  791. int alaw_init (SF_PRIVATE *psf) ;
  792. int float32_init (SF_PRIVATE *psf) ;
  793. int double64_init (SF_PRIVATE *psf) ;
  794. int dwvw_init (SF_PRIVATE *psf, int bitwidth) ;
  795. int gsm610_init (SF_PRIVATE *psf) ;
  796. int vox_adpcm_init (SF_PRIVATE *psf) ;
  797. int flac_init (SF_PRIVATE *psf) ;
  798. int g72x_init  (SF_PRIVATE * psf) ;
  800. int  dither_init (SF_PRIVATE *psf, int mode) ;
  802. int wav_w64_ima_init (SF_PRIVATE *psf, int blockalign, int samplesperblock) ;
  803. int wav_w64_msadpcm_init (SF_PRIVATE *psf, int blockalign, int samplesperblock) ;
  805. int aiff_ima_init (SF_PRIVATE *psf, int blockalign, int samplesperblock) ;
  807. int interleave_init (SF_PRIVATE *psf) ;
  809. /*------------------------------------------------------------------------------------
  810. ** Chunk logging functions.
  811. */
  813. typedef struct
  814. { struct
  815. { int chunk ;
  816. sf_count_t offset ;
  817. sf_count_t len ;
  818. } l [100] ;
  820. int count ;
  821. } PRIV_CHUNK4 ;
  823. void pchk4_store (PRIV_CHUNK4 * pchk, int marker, sf_count_t offset, sf_count_t len) ;
  824. int pchk4_find (PRIV_CHUNK4 * pchk, int marker) ;
  826. /*------------------------------------------------------------------------------------
  827. ** Other helper functions.
  828. */
  830. void *psf_memset (void *s, int c, sf_count_t n) ;
  832. SF_INSTRUMENT * psf_instrument_alloc (void) ;
  834. void psf_sanitize_string (char * cptr, int len) ;
  836. /* Generate the current date as a string. */
  837. void psf_get_date_str (char *str, int maxlen) ;
  839. PSF_BROADCAST_VAR* broadcast_var_alloc (size_t datasize) ;
  840. int broadcast_var_set (SF_PRIVATE *psf, const SF_BROADCAST_INFO * data, size_t datasize) ;
  841. int broadcast_var_get (SF_PRIVATE *psf, SF_BROADCAST_INFO * data, size_t datasize) ;
  844. typedef struct
  845. { int channels ;
  846. int endianness ;
  847. } AUDIO_DETECT ;
  849. int audio_detect (SF_PRIVATE * psf, AUDIO_DETECT *ad, const unsigned char * data, int datalen) ;
  852. /*------------------------------------------------------------------------------------
  853. ** Helper/debug functions.
  854. */
  856. void psf_hexdump (const void *ptr, int len) ;
  858. const char * str_of_major_format (int format) ;
  859. const char * str_of_minor_format (int format) ;
  860. const char * str_of_open_mode (int mode) ;
  861. const char * str_of_endianness (int end) ;
  863. /*------------------------------------------------------------------------------------
  864. ** Extra commands for sf_command(). Not for public use yet.
  865. */
  867. enum
  868. { SFC_TEST_AIFF_ADD_INST_CHUNK = 0x2000,
  869. SFC_TEST_WAV_ADD_INFO_CHUNK = 0x2010
  870. } ;
  872. /*
  873. ** Maybe, one day, make these functions or something like them, public.
  874. **
  875. ** Buffer to buffer dithering. Pointer in and out are allowed to point
  876. ** to the same buffer for in-place dithering.
  877. */
  879. #if 0
  880. int sf_dither_short (const SF_DITHER_INFO *dither, const short *in, short *out, int count) ;
  881. int sf_dither_int (const SF_DITHER_INFO *dither, const int *in, int *out, int count) ;
  882. int sf_dither_float (const SF_DITHER_INFO *dither, const float *in, float *out, int count) ;
  883. int sf_dither_double (const SF_DITHER_INFO *dither, const double *in, double *out, int count) ;
  884. #endif
  886. #endif /* SNDFILE_COMMON_H */