musepack.h
上传用户:wstnjxml
上传日期:2014-04-03
资源大小:7248k
文件大小:5k
源码类别:

Windows CE

开发平台:

C/C++

  1. /*
  2.   Copyright (c) 2005, The Musepack Development Team
  3.   All rights reserved.
  4.   Redistribution and use in source and binary forms, with or without
  5.   modification, are permitted provided that the following conditions are
  6.   met:
  7.   * Redistributions of source code must retain the above copyright
  8.   notice, this list of conditions and the following disclaimer.
  9.   * Redistributions in binary form must reproduce the above
  10.   copyright notice, this list of conditions and the following
  11.   disclaimer in the documentation and/or other materials provided
  12.   with the distribution.
  13.   * Neither the name of the The Musepack Development Team nor the
  14.   names of its contributors may be used to endorse or promote
  15.   products derived from this software without specific prior
  16.   written permission.
  17.   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  18.   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  19.   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  20.   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  21.   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  22.   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  23.   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  24.   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  25.   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  26.   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  27.   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  28. */
  29. /// file musepack.h
  30. /// Top level include file for libmusepack.
  31. #ifndef _musepack_h_
  32. #define _musepack_h_
  33. #ifdef __cplusplus
  34. extern "C" {
  35. #endif
  36. #include <stdio.h>
  37. #include <stdlib.h>
  38. #include <string.h>
  39. //#include <math.h>
  40. #include "musepack/config_types.h"
  41. #include "musepack/decoder.h"
  42. #include "musepack/math.h"
  43. #include "musepack/reader.h"
  44. #include "musepack/streaminfo.h"
  45.     
  46. enum {
  47.     MPC_FRAME_LENGTH = (36 * 32),    /// samples per mpc frame
  48.     MPC_DECODER_BUFFER_LENGTH = 4 * MPC_FRAME_LENGTH /// required buffer size for decoder
  49. };
  50. // error codes
  51. #define ERROR_CODE_OK            0
  52. #define ERROR_CODE_FILE         -1
  53. #define ERROR_CODE_SV7BETA       1
  54. #define ERROR_CODE_CBR           2
  55. #define ERROR_CODE_IS            3
  56. #define ERROR_CODE_BLOCKSIZE     4
  57. #define ERROR_CODE_INVALIDSV     5
  58. /// Initializes a streaminfo structure.
  59. /// param si streaminfo structure to initialize
  60. void mpc_streaminfo_init(mpc_streaminfo *si);
  61. /// Reads streaminfo header from the mpc stream supplied by r.
  62. /// param si streaminfo pointer to which info will be written
  63. /// param r stream reader to supply raw data
  64. /// return error code
  65. mpc_int32_t mpc_streaminfo_read(mpc_streaminfo *si, mpc_reader *r);
  66. /// Gets length of stream si, in seconds.
  67. /// return length of stream in seconds
  68. double mpc_streaminfo_get_length(mpc_streaminfo *si);
  69. /// Returns length of stream si, in samples.
  70. /// return length of stream in samples
  71. mpc_int64_t mpc_streaminfo_get_length_samples(mpc_streaminfo *si);
  72. /// Sets up decoder library.
  73. /// Call this first when preparing to decode an mpc stream.
  74. /// param r reader that will supply raw data to the decoder
  75. void mpc_decoder_setup(mpc_decoder *d, mpc_reader *r);
  76. /// Initializes mpc decoder with the supplied stream info parameters.
  77. /// Call this next after calling mpc_decoder_setup.
  78. /// param si streaminfo structure indicating format of source stream
  79. /// return TRUE if decoder was initalized successfully, FALSE otherwise    
  80. mpc_bool_t mpc_decoder_initialize(mpc_decoder *d, mpc_streaminfo *si);
  81. /// Sets decoder sample scaling factor.  All decoded samples will be multiplied
  82. /// by this factor.
  83. /// param scale_factor multiplicative scaling factor
  84. void mpc_decoder_scale_output(mpc_decoder *d, double scale_factor);
  85. /// Actually reads data from previously initialized stream.  Call
  86. /// this iteratively to decode the mpc stream.
  87. /// param buffer destination buffer for decoded samples
  88. /// param vbr_update_acc todo document me
  89. /// param vbr_update_bits todo document me
  90. /// return -1 if an error is encountered
  91. /// return 0 if the stream has been completely decoded successfully and there are no more samples
  92. /// return > 0 to indicate the number of bytes that were actually read from the stream.
  93. mpc_uint32_t mpc_decoder_decode(
  94.     mpc_decoder *d,
  95.     MPC_SAMPLE_FORMAT *buffer, 
  96.     mpc_uint32_t *vbr_update_acc, 
  97.     mpc_uint32_t *vbr_update_bits);
  98. /// Seeks to the specified sample in the source stream.
  99. mpc_bool_t mpc_decoder_seek_sample(mpc_decoder *d, mpc_int64_t destsample);
  100. /// Seeks to specified position in seconds in the source stream.
  101. mpc_bool_t mpc_decoder_seek_seconds(mpc_decoder *d, double seconds);
  102. #ifdef __cplusplus
  103. }
  104. #endif // __cplusplus
  105. #endif // _musepack_h_