Home | History | Annotate | Download | only in sbc
      1 /*
      2  *
      3  *  Bluetooth low-complexity, subband codec (SBC) library
      4  *
      5  *  Copyright (C) 2004-2009  Marcel Holtmann <marcel (at) holtmann.org>
      6  *  Copyright (C) 2004-2005  Henryk Ploetz <henryk (at) ploetzli.ch>
      7  *  Copyright (C) 2005-2006  Brad Midgley <bmidgley (at) xmission.com>
      8  *
      9  *
     10  *  This library is free software; you can redistribute it and/or
     11  *  modify it under the terms of the GNU Lesser General Public
     12  *  License as published by the Free Software Foundation; either
     13  *  version 2.1 of the License, or (at your option) any later version.
     14  *
     15  *  This library is distributed in the hope that it will be useful,
     16  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
     17  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     18  *  Lesser General Public License for more details.
     19  *
     20  *  You should have received a copy of the GNU Lesser General Public
     21  *  License along with this library; if not, write to the Free Software
     22  *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
     23  *
     24  */
     25 
     26 #ifndef __SBC_H
     27 #define __SBC_H
     28 
     29 #ifdef __cplusplus
     30 extern "C" {
     31 #endif
     32 
     33 #include <stdint.h>
     34 #include <sys/types.h>
     35 
     36 /* sampling frequency */
     37 #define SBC_FREQ_16000		0x00
     38 #define SBC_FREQ_32000		0x01
     39 #define SBC_FREQ_44100		0x02
     40 #define SBC_FREQ_48000		0x03
     41 
     42 /* blocks */
     43 #define SBC_BLK_4		0x00
     44 #define SBC_BLK_8		0x01
     45 #define SBC_BLK_12		0x02
     46 #define SBC_BLK_16		0x03
     47 
     48 /* channel mode */
     49 #define SBC_MODE_MONO		0x00
     50 #define SBC_MODE_DUAL_CHANNEL	0x01
     51 #define SBC_MODE_STEREO		0x02
     52 #define SBC_MODE_JOINT_STEREO	0x03
     53 
     54 /* allocation method */
     55 #define SBC_AM_LOUDNESS		0x00
     56 #define SBC_AM_SNR		0x01
     57 
     58 /* subbands */
     59 #define SBC_SB_4		0x00
     60 #define SBC_SB_8		0x01
     61 
     62 /* Data endianess */
     63 #define SBC_LE			0x00
     64 #define SBC_BE			0x01
     65 
     66 struct sbc_struct {
     67 	unsigned long flags;
     68 
     69 	uint8_t frequency;
     70 	uint8_t blocks;
     71 	uint8_t subbands;
     72 	uint8_t mode;
     73 	uint8_t allocation;
     74 	uint8_t bitpool;
     75 	uint8_t endian;
     76 
     77 	void *priv;
     78 	void *priv_alloc_base;
     79 };
     80 
     81 typedef struct sbc_struct sbc_t;
     82 
     83 int sbc_init(sbc_t *sbc, unsigned long flags);
     84 int sbc_reinit(sbc_t *sbc, unsigned long flags);
     85 
     86 ssize_t sbc_parse(sbc_t *sbc, const void *input, size_t input_len);
     87 
     88 /* Decodes ONE input block into ONE output block */
     89 ssize_t sbc_decode(sbc_t *sbc, const void *input, size_t input_len,
     90 			void *output, size_t output_len, size_t *written);
     91 
     92 /* Encodes ONE input block into ONE output block */
     93 ssize_t sbc_encode(sbc_t *sbc, const void *input, size_t input_len,
     94 			void *output, size_t output_len, size_t *written);
     95 
     96 /* Returns the output block size in bytes */
     97 size_t sbc_get_frame_length(sbc_t *sbc);
     98 
     99 /* Returns the time one input/output block takes to play in msec*/
    100 unsigned sbc_get_frame_duration(sbc_t *sbc);
    101 
    102 /* Returns the input block size in bytes */
    103 size_t sbc_get_codesize(sbc_t *sbc);
    104 
    105 const char *sbc_get_implementation_info(sbc_t *sbc);
    106 void sbc_finish(sbc_t *sbc);
    107 
    108 #ifdef __cplusplus
    109 }
    110 #endif
    111 
    112 #endif /* __SBC_H */
    113