17 #if !defined(_opusfile_h)
18 # define _opusfile_h (1)
103 # if defined(__cplusplus)
109 # include <ogg/ogg.h>
110 # include <opus_multistream.h>
115 # if !defined(OP_GNUC_PREREQ)
116 # if defined(__GNUC__)&&defined(__GNUC_MINOR__)
117 # define OP_GNUC_PREREQ(_maj,_min) \
118 ((__GNUC__<<16)+__GNUC_MINOR__>=((_maj)<<16)+(_min))
120 # define OP_GNUC_PREREQ(_maj,_min) 0
124 # if OP_GNUC_PREREQ(4,0)
125 # pragma GCC visibility push(default)
133 typedef struct OggOpusFile OggOpusFile;
136 # if OP_GNUC_PREREQ(3,4)
137 # define OP_WARN_UNUSED_RESULT __attribute__((__warn_unused_result__))
139 # define OP_WARN_UNUSED_RESULT
141 # if OP_GNUC_PREREQ(3,4)
142 # define OP_ARG_NONNULL(_x) __attribute__((__nonnull__(_x)))
144 # define OP_ARG_NONNULL(_x)
160 #define OP_FALSE (-1)
168 #define OP_EREAD (-128)
172 #define OP_EFAULT (-129)
175 #define OP_EIMPL (-130)
177 #define OP_EINVAL (-131)
182 #define OP_ENOTFORMAT (-132)
185 #define OP_EBADHEADER (-133)
187 #define OP_EVERSION (-134)
189 #define OP_ENOTAUDIO (-135)
193 #define OP_EBADPACKET (-136)
197 #define OP_EBADLINK (-137)
199 #define OP_ENOSEEK (-138)
201 #define OP_EBADTIMESTAMP (-139)
210 #define OPUS_CHANNEL_COUNT_MAX (255)
268 unsigned char mapping[OPUS_CHANNEL_COUNT_MAX];
318 #define OP_PIC_FORMAT_UNKNOWN (-1)
320 #define OP_PIC_FORMAT_URL (0)
322 #define OP_PIC_FORMAT_JPEG (1)
324 #define OP_PIC_FORMAT_PNG (2)
326 #define OP_PIC_FORMAT_GIF (3)
428 OP_WARN_UNUSED_RESULT
int opus_head_parse(
OpusHead *_head,
429 const unsigned char *_data,
size_t _len) OP_ARG_NONNULL(2);
445 ogg_int64_t opus_granule_sample(
const OpusHead *_head,ogg_int64_t _gp)
462 OP_WARN_UNUSED_RESULT
int opus_tags_parse(
OpusTags *_tags,
463 const unsigned char *_data,
size_t _len) OP_ARG_NONNULL(2);
478 void opus_tags_init(
OpusTags *_tags) OP_ARG_NONNULL(1);
491 int opus_tags_add(
OpusTags *_tags,
const char *_tag,
const char *_value)
492 OP_ARG_NONNULL(1) OP_ARG_NONNULL(2) OP_ARG_NONNULL(3);
504 int opus_tags_add_comment(
OpusTags *_tags,const
char *_comment)
505 OP_ARG_NONNULL(1) OP_ARG_NONNULL(2);
520 int opus_tags_set_binary_suffix(
OpusTags *_tags,
521 const
unsigned char *_data,
int _len) OP_ARG_NONNULL(1);
538 const
char *opus_tags_query(const
OpusTags *_tags,const
char *_tag,
int _count)
539 OP_ARG_NONNULL(1) OP_ARG_NONNULL(2);
548 int opus_tags_query_count(const
OpusTags *_tags,const
char *_tag)
549 OP_ARG_NONNULL(1) OP_ARG_NONNULL(2);
556 const
unsigned char *opus_tags_get_binary_suffix(const
OpusTags *_tags,
557 int *_len) OP_ARG_NONNULL(1) OP_ARG_NONNULL(2);
574 int opus_tags_get_album_gain(const
OpusTags *_tags,
int *_gain_q8)
575 OP_ARG_NONNULL(1) OP_ARG_NONNULL(2);
592 int opus_tags_get_track_gain(const
OpusTags *_tags,
int *_gain_q8)
593 OP_ARG_NONNULL(1) OP_ARG_NONNULL(2);
600 void opus_tags_clear(
OpusTags *_tags) OP_ARG_NONNULL(1);
611 int opus_tagcompare(const
char *_tag_name,const
char *_comment);
626 int opus_tagncompare(const
char *_tag_name,
int _tag_len,const
char *_comment);
658 OP_WARN_UNUSED_RESULT
int opus_picture_tag_parse(
OpusPictureTag *_pic,
659 const
char *_tag) OP_ARG_NONNULL(1) OP_ARG_NONNULL(2);
665 void opus_picture_tag_init(
OpusPictureTag *_pic) OP_ARG_NONNULL(1);
672 void opus_picture_tag_clear(
OpusPictureTag *_pic) OP_ARG_NONNULL(1);
694 #define OP_SSL_SKIP_CERTIFICATE_CHECK_REQUEST (6464)
695 #define OP_HTTP_PROXY_HOST_REQUEST (6528)
696 #define OP_HTTP_PROXY_PORT_REQUEST (6592)
697 #define OP_HTTP_PROXY_USER_REQUEST (6656)
698 #define OP_HTTP_PROXY_PASS_REQUEST (6720)
699 #define OP_GET_SERVER_INFO_REQUEST (6784)
701 #define OP_URL_OPT(_request) ((char *)(_request))
705 #define OP_CHECK_INT(_x) ((void)((_x)==(opus_int32)0),(opus_int32)(_x))
706 #define OP_CHECK_CONST_CHAR_PTR(_x) ((_x)+((_x)-(const char *)(_x)))
707 #define OP_CHECK_SERVER_INFO_PTR(_x) ((_x)+((_x)-(OpusServerInfo *)(_x)))
756 void opus_server_info_init(
OpusServerInfo *_info) OP_ARG_NONNULL(1);
764 void opus_server_info_clear(
OpusServerInfo *_info) OP_ARG_NONNULL(1);
772 #define OP_SSL_SKIP_CERTIFICATE_CHECK(_b) \
773 OP_URL_OPT(OP_SSL_SKIP_CERTIFICATE_CHECK_REQUEST),OP_CHECK_INT(_b)
783 #define OP_HTTP_PROXY_HOST(_host) \
784 OP_URL_OPT(OP_HTTP_PROXY_HOST_REQUEST),OP_CHECK_CONST_CHAR_PTR(_host)
796 #define OP_HTTP_PROXY_PORT(_port) \
797 OP_URL_OPT(OP_HTTP_PROXY_PORT_REQUEST),OP_CHECK_INT(_port)
809 #define OP_HTTP_PROXY_USER(_user) \
810 OP_URL_OPT(OP_HTTP_PROXY_USER_REQUEST),OP_CHECK_CONST_CHAR_PTR(_user)
822 #define OP_HTTP_PROXY_PASS(_pass) \
823 OP_URL_OPT(OP_HTTP_PROXY_PASS_REQUEST),OP_CHECK_CONST_CHAR_PTR(_pass)
843 #define OP_GET_SERVER_INFO(_info) \
844 OP_URL_OPT(OP_GET_SERVER_INFO_REQUEST),OP_CHECK_SERVER_INFO_PTR(_info)
869 typedef int (*op_read_func)(
void *_stream,
unsigned char *_ptr,
int _nbytes);
880 typedef int (*op_seek_func)(
void *_stream,opus_int64 _offset,
int _whence);
884 typedef opus_int64 (*op_tell_func)(
void *_stream);
890 typedef int (*op_close_func)(
void *_stream);
934 const char *_path,
const char *_mode) OP_ARG_NONNULL(1) OP_ARG_NONNULL(2)
951 int _fd,const
char *_mode) OP_ARG_NONNULL(1) OP_ARG_NONNULL(3);
973 const
char *_path,const
char *_mode,
void *_stream) OP_ARG_NONNULL(1)
974 OP_ARG_NONNULL(2) OP_ARG_NONNULL(3) OP_ARG_NONNULL(4);
987 const
unsigned char *_data,
size_t _size) OP_ARG_NONNULL(1);
1013 const
char *_url,va_list _ap) OP_ARG_NONNULL(1) OP_ARG_NONNULL(2);
1035 const
char *_url,...) OP_ARG_NONNULL(1) OP_ARG_NONNULL(2);
1081 const
unsigned char *_initial_data,
size_t _initial_bytes);
1092 OP_WARN_UNUSED_RESULT OggOpusFile *op_open_file(const
char *_path,
int *_error)
1103 OP_WARN_UNUSED_RESULT OggOpusFile *op_open_memory(const
unsigned char *_data,
1104 size_t _size,
int *_error);
1132 OP_WARN_UNUSED_RESULT OggOpusFile *op_vopen_url(const
char *_url,
1133 int *_error,va_list _ap) OP_ARG_NONNULL(1);
1154 OP_WARN_UNUSED_RESULT OggOpusFile *op_open_url(const
char *_url,
1155 int *_error,...) OP_ARG_NONNULL(1);
1236 OP_WARN_UNUSED_RESULT OggOpusFile *op_open_callbacks(
void *_stream,
1238 size_t _initial_bytes,
int *_error) OP_ARG_NONNULL(2);
1250 OP_WARN_UNUSED_RESULT OggOpusFile *op_test_file(const
char *_path,
int *_error)
1262 OP_WARN_UNUSED_RESULT OggOpusFile *op_test_memory(const
unsigned char *_data,
1263 size_t _size,
int *_error);
1293 OP_WARN_UNUSED_RESULT OggOpusFile *op_vtest_url(const
char *_url,
1294 int *_error,va_list _ap) OP_ARG_NONNULL(1);
1317 OP_WARN_UNUSED_RESULT OggOpusFile *op_test_url(const
char *_url,
1318 int *_error,...) OP_ARG_NONNULL(1);
1385 OP_WARN_UNUSED_RESULT OggOpusFile *op_test_callbacks(
void *_stream,
1387 size_t _initial_bytes,
int *_error) OP_ARG_NONNULL(2);
1415 int op_test_open(OggOpusFile *_of) OP_ARG_NONNULL(1);
1419 void op_free(OggOpusFile *_of);
1456 int op_seekable(const OggOpusFile *_of) OP_ARG_NONNULL(1);
1466 int op_link_count(const OggOpusFile *_of) OP_ARG_NONNULL(1);
1481 opus_uint32 op_serialno(const OggOpusFile *_of,
int _li) OP_ARG_NONNULL(1);
1498 int op_channel_count(const OggOpusFile *_of,
int _li) OP_ARG_NONNULL(1);
1520 opus_int64 op_raw_total(const OggOpusFile *_of,
int _li) OP_ARG_NONNULL(1);
1538 ogg_int64_t op_pcm_total(const OggOpusFile *_of,
int _li) OP_ARG_NONNULL(1);
1554 const
OpusHead *op_head(const OggOpusFile *_of,
int _li) OP_ARG_NONNULL(1);
1572 const
OpusTags *op_tags(const OggOpusFile *_of,
int _li) OP_ARG_NONNULL(1);
1589 int op_current_link(const OggOpusFile *_of) OP_ARG_NONNULL(1);
1611 opus_int32 op_bitrate(const OggOpusFile *_of,
int _li) OP_ARG_NONNULL(1);
1624 opus_int32 op_bitrate_instant(OggOpusFile *_of) OP_ARG_NONNULL(1);
1630 opus_int64 op_raw_tell(const OggOpusFile *_of) OP_ARG_NONNULL(1);
1639 ogg_int64_t op_pcm_tell(const OggOpusFile *_of) OP_ARG_NONNULL(1);
1687 int op_raw_seek(OggOpusFile *_of,opus_int64 _byte_offset) OP_ARG_NONNULL(1);
1703 int op_pcm_seek(OggOpusFile *_of,ogg_int64_t _pcm_offset) OP_ARG_NONNULL(1);
1751 #define OP_DEC_FORMAT_SHORT (7008)
1754 #define OP_DEC_FORMAT_FLOAT (7040)
1758 #define OP_DEC_USE_DEFAULT (6720)
1791 typedef int (*op_decode_cb_func)(
void *_ctx,OpusMSDecoder *_decoder,
void *_pcm,
1792 const ogg_packet *_op,
int _nsamples,
int _nchannels,
int _format,
int _li);
1815 void op_set_decode_callback(OggOpusFile *_of,
1816 op_decode_cb_func _decode_cb,
void *_ctx) OP_ARG_NONNULL(1);
1821 #define OP_HEADER_GAIN (0)
1825 #define OP_ALBUM_GAIN (3007)
1829 #define OP_TRACK_GAIN (3008)
1833 #define OP_ABSOLUTE_GAIN (3009)
1852 int op_set_gain_offset(OggOpusFile *_of,
1853 int _gain_type,opus_int32 _gain_offset_q8) OP_ARG_NONNULL(1);
1865 void op_set_dither_enabled(OggOpusFile *_of,
int _enabled) OP_ARG_NONNULL(1);
1947 OP_WARN_UNUSED_RESULT
int op_read(OggOpusFile *_of,
1948 opus_int16 *_pcm,
int _buf_size,
int *_li) OP_ARG_NONNULL(1);
2028 OP_WARN_UNUSED_RESULT
int op_read_float(OggOpusFile *_of,
2029 float *_pcm,
int _buf_size,
int *_li) OP_ARG_NONNULL(1);
2089 OP_WARN_UNUSED_RESULT
int op_read_stereo(OggOpusFile *_of,
2090 opus_int16 *_pcm,
int _buf_size) OP_ARG_NONNULL(1);
2150 OP_WARN_UNUSED_RESULT
int op_read_float_stereo(OggOpusFile *_of,
2151 float *_pcm,
int _buf_size) OP_ARG_NONNULL(1);
2156 # if OP_GNUC_PREREQ(4,0)
2157 # pragma GCC visibility pop
2160 # if defined(__cplusplus)