FLAC 1.5.0 Free Lossless Audio Codec

metadata.h
Go to the documentation of this file.
1/* libFLAC - Free Lossless Audio Codec library
2 * Copyright (C) 2001-2009 Josh Coalson
3 * Copyright (C) 2011-2025 Xiph.Org Foundation
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 *
12 * - Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 *
16 * - Neither the name of the Xiph.org Foundation nor the names of its
17 * contributors may be used to endorse or promote products derived from
18 * this software without 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
22 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION 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
27 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
28 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
29 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
30 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 */
32
33#ifndef FLAC__METADATA_H
34#define FLAC__METADATA_H
35
36#include <sys/types.h> /* for off_t */
37#include "export.h"
38#include "callback.h"
39#include "format.h"
40
41/* --------------------------------------------------------------------
42 (For an example of how all these routines are used, see the source
43 code for the unit tests in src/test_libFLAC/metadata_*.c, or
44 metaflac in src/metaflac/)
45 ------------------------------------------------------------------*/
46
124#ifdef __cplusplus
125 extern "C" {
126#endif
127
128
165 FLAC_API FLAC__bool FLAC__metadata_get_streaminfo(const char *filename, FLAC__StreamMetadata *streaminfo);
166
185 FLAC_API FLAC__bool FLAC__metadata_get_tags(const char *filename, FLAC__StreamMetadata **tags);
186
205 FLAC_API FLAC__bool FLAC__metadata_get_cuesheet(const char *filename, FLAC__StreamMetadata **cuesheet);
206
246 FLAC_API FLAC__bool FLAC__metadata_get_picture(const char *filename, FLAC__StreamMetadata **picture, FLAC__StreamMetadata_Picture_Type type, const char *mime_type, const FLAC__byte *description, uint32_t max_width, uint32_t max_height, uint32_t max_depth, uint32_t max_colors);
247
248/* \} */
249
250
306 struct FLAC__Metadata_SimpleIterator;
312 typedef struct FLAC__Metadata_SimpleIterator FLAC__Metadata_SimpleIterator;
313
318 typedef enum {
319
320 FLAC__METADATA_SIMPLE_ITERATOR_STATUS_OK = 0,
323 FLAC__METADATA_SIMPLE_ITERATOR_STATUS_ILLEGAL_INPUT,
326 FLAC__METADATA_SIMPLE_ITERATOR_STATUS_ERROR_OPENING_FILE,
329 FLAC__METADATA_SIMPLE_ITERATOR_STATUS_NOT_A_FLAC_FILE,
332 FLAC__METADATA_SIMPLE_ITERATOR_STATUS_NOT_WRITABLE,
335 FLAC__METADATA_SIMPLE_ITERATOR_STATUS_BAD_METADATA,
338 FLAC__METADATA_SIMPLE_ITERATOR_STATUS_READ_ERROR,
341 FLAC__METADATA_SIMPLE_ITERATOR_STATUS_SEEK_ERROR,
344 FLAC__METADATA_SIMPLE_ITERATOR_STATUS_WRITE_ERROR,
347 FLAC__METADATA_SIMPLE_ITERATOR_STATUS_RENAME_ERROR,
350 FLAC__METADATA_SIMPLE_ITERATOR_STATUS_UNLINK_ERROR,
353 FLAC__METADATA_SIMPLE_ITERATOR_STATUS_MEMORY_ALLOCATION_ERROR,
356 FLAC__METADATA_SIMPLE_ITERATOR_STATUS_INTERNAL_ERROR
359} FLAC__Metadata_SimpleIteratorStatus;
360
366 extern FLAC_API const char * const FLAC__Metadata_SimpleIteratorStatusString[];
367
368
374 FLAC_API FLAC__Metadata_SimpleIterator *FLAC__metadata_simple_iterator_new(void);
375
382 FLAC_API void FLAC__metadata_simple_iterator_delete(FLAC__Metadata_SimpleIterator *iterator);
383
394 FLAC_API FLAC__Metadata_SimpleIteratorStatus FLAC__metadata_simple_iterator_status(FLAC__Metadata_SimpleIterator *iterator);
395
420 FLAC_API FLAC__bool FLAC__metadata_simple_iterator_init(FLAC__Metadata_SimpleIterator *iterator, const char *filename, FLAC__bool read_only, FLAC__bool preserve_file_stats);
421
432 FLAC_API FLAC__bool FLAC__metadata_simple_iterator_is_writable(const FLAC__Metadata_SimpleIterator *iterator);
433
446 FLAC_API FLAC__bool FLAC__metadata_simple_iterator_next(FLAC__Metadata_SimpleIterator *iterator);
447
460 FLAC_API FLAC__bool FLAC__metadata_simple_iterator_prev(FLAC__Metadata_SimpleIterator *iterator);
461
473 FLAC_API FLAC__bool FLAC__metadata_simple_iterator_is_last(const FLAC__Metadata_SimpleIterator *iterator);
474
489 FLAC_API off_t FLAC__metadata_simple_iterator_get_block_offset(const FLAC__Metadata_SimpleIterator *iterator);
490
503 FLAC_API FLAC__MetadataType FLAC__metadata_simple_iterator_get_block_type(const FLAC__Metadata_SimpleIterator *iterator);
504
520 FLAC_API uint32_t FLAC__metadata_simple_iterator_get_block_length(const FLAC__Metadata_SimpleIterator *iterator);
521
545 FLAC_API FLAC__bool FLAC__metadata_simple_iterator_get_application_id(FLAC__Metadata_SimpleIterator *iterator, FLAC__byte *id);
546
563 FLAC_API FLAC__StreamMetadata *FLAC__metadata_simple_iterator_get_block(FLAC__Metadata_SimpleIterator *iterator);
564
619 FLAC_API FLAC__bool FLAC__metadata_simple_iterator_set_block(FLAC__Metadata_SimpleIterator *iterator, FLAC__StreamMetadata *block, FLAC__bool use_padding);
620
644 FLAC_API FLAC__bool FLAC__metadata_simple_iterator_insert_block_after(FLAC__Metadata_SimpleIterator *iterator, FLAC__StreamMetadata *block, FLAC__bool use_padding);
645
663 FLAC_API FLAC__bool FLAC__metadata_simple_iterator_delete_block(FLAC__Metadata_SimpleIterator *iterator, FLAC__bool use_padding);
664
665/* \} */
666
667
725 struct FLAC__Metadata_Chain;
728 typedef struct FLAC__Metadata_Chain FLAC__Metadata_Chain;
729
730 struct FLAC__Metadata_Iterator;
733 typedef struct FLAC__Metadata_Iterator FLAC__Metadata_Iterator;
734
735 typedef enum {
736 FLAC__METADATA_CHAIN_STATUS_OK = 0,
739 FLAC__METADATA_CHAIN_STATUS_ILLEGAL_INPUT,
742 FLAC__METADATA_CHAIN_STATUS_ERROR_OPENING_FILE,
745 FLAC__METADATA_CHAIN_STATUS_NOT_A_FLAC_FILE,
748 FLAC__METADATA_CHAIN_STATUS_NOT_WRITABLE,
751 FLAC__METADATA_CHAIN_STATUS_BAD_METADATA,
754 FLAC__METADATA_CHAIN_STATUS_READ_ERROR,
757 FLAC__METADATA_CHAIN_STATUS_SEEK_ERROR,
760 FLAC__METADATA_CHAIN_STATUS_WRITE_ERROR,
763 FLAC__METADATA_CHAIN_STATUS_RENAME_ERROR,
766 FLAC__METADATA_CHAIN_STATUS_UNLINK_ERROR,
769 FLAC__METADATA_CHAIN_STATUS_MEMORY_ALLOCATION_ERROR,
772 FLAC__METADATA_CHAIN_STATUS_INTERNAL_ERROR,
775 FLAC__METADATA_CHAIN_STATUS_INVALID_CALLBACKS,
778 FLAC__METADATA_CHAIN_STATUS_READ_WRITE_MISMATCH,
787 FLAC__METADATA_CHAIN_STATUS_WRONG_WRITE_CALL
794} FLAC__Metadata_ChainStatus;
795
801 extern FLAC_API const char * const FLAC__Metadata_ChainStatusString[];
802
803/*********** FLAC__Metadata_Chain ***********/
804
810 FLAC_API FLAC__Metadata_Chain *FLAC__metadata_chain_new(void);
811
818 FLAC_API void FLAC__metadata_chain_delete(FLAC__Metadata_Chain *chain);
819
830 FLAC_API FLAC__Metadata_ChainStatus FLAC__metadata_chain_status(FLAC__Metadata_Chain *chain);
831
849 FLAC_API FLAC__bool FLAC__metadata_chain_read(FLAC__Metadata_Chain *chain, const char *filename);
850
871 FLAC_API FLAC__bool FLAC__metadata_chain_read_ogg(FLAC__Metadata_Chain *chain, const char *filename);
872
893 FLAC_API FLAC__bool FLAC__metadata_chain_read_with_callbacks(FLAC__Metadata_Chain *chain, FLAC__IOHandle handle, FLAC__IOCallbacks callbacks);
894
918 FLAC_API FLAC__bool FLAC__metadata_chain_read_ogg_with_callbacks(FLAC__Metadata_Chain *chain, FLAC__IOHandle handle, FLAC__IOCallbacks callbacks);
919
946 FLAC_API FLAC__bool FLAC__metadata_chain_check_if_tempfile_needed(FLAC__Metadata_Chain *chain, FLAC__bool use_padding);
947
992 FLAC_API FLAC__bool FLAC__metadata_chain_write(FLAC__Metadata_Chain *chain, FLAC__bool use_padding, FLAC__bool preserve_file_stats);
993
1014 FLAC_API FLAC__bool FLAC__metadata_chain_write_new_file(FLAC__Metadata_Chain *chain, const char *filename, FLAC__bool use_padding);
1015
1044 FLAC_API FLAC__bool FLAC__metadata_chain_write_with_callbacks(FLAC__Metadata_Chain *chain, FLAC__bool use_padding, FLAC__IOHandle handle, FLAC__IOCallbacks callbacks);
1045
1094 FLAC_API FLAC__bool FLAC__metadata_chain_write_with_callbacks_and_tempfile(FLAC__Metadata_Chain *chain, FLAC__bool use_padding, FLAC__IOHandle handle, FLAC__IOCallbacks callbacks, FLAC__IOHandle temp_handle, FLAC__IOCallbacks temp_callbacks);
1095
1108 FLAC_API void FLAC__metadata_chain_merge_padding(FLAC__Metadata_Chain *chain);
1109
1123 FLAC_API void FLAC__metadata_chain_sort_padding(FLAC__Metadata_Chain *chain);
1124
1125
1126/*********** FLAC__Metadata_Iterator ***********/
1127
1133 FLAC_API FLAC__Metadata_Iterator *FLAC__metadata_iterator_new(void);
1134
1141 FLAC_API void FLAC__metadata_iterator_delete(FLAC__Metadata_Iterator *iterator);
1142
1152 FLAC_API void FLAC__metadata_iterator_init(FLAC__Metadata_Iterator *iterator, FLAC__Metadata_Chain *chain);
1153
1166 FLAC_API FLAC__bool FLAC__metadata_iterator_next(FLAC__Metadata_Iterator *iterator);
1167
1180 FLAC_API FLAC__bool FLAC__metadata_iterator_prev(FLAC__Metadata_Iterator *iterator);
1181
1192 FLAC_API FLAC__MetadataType FLAC__metadata_iterator_get_block_type(const FLAC__Metadata_Iterator *iterator);
1193
1213 FLAC_API FLAC__StreamMetadata *FLAC__metadata_iterator_get_block(FLAC__Metadata_Iterator *iterator);
1214
1230 FLAC_API FLAC__bool FLAC__metadata_iterator_set_block(FLAC__Metadata_Iterator *iterator, FLAC__StreamMetadata *block);
1231
1248 FLAC_API FLAC__bool FLAC__metadata_iterator_delete_block(FLAC__Metadata_Iterator *iterator, FLAC__bool replace_with_padding);
1249
1267 FLAC_API FLAC__bool FLAC__metadata_iterator_insert_block_before(FLAC__Metadata_Iterator *iterator, FLAC__StreamMetadata *block);
1268
1285 FLAC_API FLAC__bool FLAC__metadata_iterator_insert_block_after(FLAC__Metadata_Iterator *iterator, FLAC__StreamMetadata *block);
1286
1287/* \} */
1288
1289
1355 FLAC_API FLAC__StreamMetadata *FLAC__metadata_object_new(FLAC__MetadataType type);
1356
1369 FLAC_API FLAC__StreamMetadata *FLAC__metadata_object_clone(const FLAC__StreamMetadata *object);
1370
1380 FLAC_API void FLAC__metadata_object_delete(FLAC__StreamMetadata *object);
1381
1395 FLAC_API FLAC__bool FLAC__metadata_object_is_equal(const FLAC__StreamMetadata *block1, const FLAC__StreamMetadata *block2);
1396
1418 FLAC_API FLAC__bool FLAC__metadata_object_application_set_data(FLAC__StreamMetadata *object, FLAC__byte *data, uint32_t length, FLAC__bool copy);
1419
1436 FLAC_API FLAC__bool FLAC__metadata_object_seektable_resize_points(FLAC__StreamMetadata *object, uint32_t new_num_points);
1437
1448 FLAC_API void FLAC__metadata_object_seektable_set_point(FLAC__StreamMetadata *object, uint32_t point_num, FLAC__StreamMetadata_SeekPoint point);
1449
1462 FLAC_API FLAC__bool FLAC__metadata_object_seektable_insert_point(FLAC__StreamMetadata *object, uint32_t point_num, FLAC__StreamMetadata_SeekPoint point);
1463
1475 FLAC_API FLAC__bool FLAC__metadata_object_seektable_delete_point(FLAC__StreamMetadata *object, uint32_t point_num);
1476
1488 FLAC_API FLAC__bool FLAC__metadata_object_seektable_is_legal(const FLAC__StreamMetadata *object);
1489
1505 FLAC_API FLAC__bool FLAC__metadata_object_seektable_template_append_placeholders(FLAC__StreamMetadata *object, uint32_t num);
1506
1522 FLAC_API FLAC__bool FLAC__metadata_object_seektable_template_append_point(FLAC__StreamMetadata *object, FLAC__uint64 sample_number);
1523
1540 FLAC_API FLAC__bool FLAC__metadata_object_seektable_template_append_points(FLAC__StreamMetadata *object, FLAC__uint64 sample_numbers[], uint32_t num);
1541
1562 FLAC_API FLAC__bool FLAC__metadata_object_seektable_template_append_spaced_points(FLAC__StreamMetadata *object, uint32_t num, FLAC__uint64 total_samples);
1563
1590 FLAC_API FLAC__bool FLAC__metadata_object_seektable_template_append_spaced_points_by_samples(FLAC__StreamMetadata *object, uint32_t samples, FLAC__uint64 total_samples);
1591
1607 FLAC_API FLAC__bool FLAC__metadata_object_seektable_template_sort(FLAC__StreamMetadata *object, FLAC__bool compact);
1608
1632 FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_set_vendor_string(FLAC__StreamMetadata *object, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool copy);
1633
1650 FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_resize_comments(FLAC__StreamMetadata *object, uint32_t new_num_comments);
1651
1677 FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_set_comment(FLAC__StreamMetadata *object, uint32_t comment_num, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool copy);
1678
1707 FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_insert_comment(FLAC__StreamMetadata *object, uint32_t comment_num, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool copy);
1708
1732 FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_append_comment(FLAC__StreamMetadata *object, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool copy);
1733
1767 FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_replace_comment(FLAC__StreamMetadata *object, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool all, FLAC__bool copy);
1768
1780 FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_delete_comment(FLAC__StreamMetadata *object, uint32_t comment_num);
1781
1801 FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_entry_from_name_value_pair(FLAC__StreamMetadata_VorbisComment_Entry *entry, const char *field_name, const char *field_value);
1802
1822 FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_entry_to_name_value_pair(const FLAC__StreamMetadata_VorbisComment_Entry entry, char **field_name, char **field_value);
1823
1836 FLAC_API FLAC__bool FLAC__metadata_object_vorbiscomment_entry_matches(const FLAC__StreamMetadata_VorbisComment_Entry entry, const char *field_name, uint32_t field_name_length);
1837
1855 FLAC_API int FLAC__metadata_object_vorbiscomment_find_entry_from(const FLAC__StreamMetadata *object, uint32_t offset, const char *field_name);
1856
1868 FLAC_API int FLAC__metadata_object_vorbiscomment_remove_entry_matching(FLAC__StreamMetadata *object, const char *field_name);
1869
1881 FLAC_API int FLAC__metadata_object_vorbiscomment_remove_entries_matching(FLAC__StreamMetadata *object, const char *field_name);
1882
1890 FLAC_API FLAC__StreamMetadata_CueSheet_Track *FLAC__metadata_object_cuesheet_track_new(void);
1891
1905 FLAC_API FLAC__StreamMetadata_CueSheet_Track *FLAC__metadata_object_cuesheet_track_clone(const FLAC__StreamMetadata_CueSheet_Track *object);
1906
1913 FLAC_API void FLAC__metadata_object_cuesheet_track_delete(FLAC__StreamMetadata_CueSheet_Track *object);
1914
1934 FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_track_resize_indices(FLAC__StreamMetadata *object, uint32_t track_num, uint32_t new_num_indices);
1935
1957 FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_track_insert_index(FLAC__StreamMetadata *object, uint32_t track_num, uint32_t index_num, FLAC__StreamMetadata_CueSheet_Index index);
1958
1981 FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_track_insert_blank_index(FLAC__StreamMetadata *object, uint32_t track_num, uint32_t index_num);
1982
2000 FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_track_delete_index(FLAC__StreamMetadata *object, uint32_t track_num, uint32_t index_num);
2001
2018 FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_resize_tracks(FLAC__StreamMetadata *object, uint32_t new_num_tracks);
2019
2040 FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_set_track(FLAC__StreamMetadata *object, uint32_t track_num, FLAC__StreamMetadata_CueSheet_Track *track, FLAC__bool copy);
2041
2063 FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_insert_track(FLAC__StreamMetadata *object, uint32_t track_num, FLAC__StreamMetadata_CueSheet_Track *track, FLAC__bool copy);
2064
2082 FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_insert_blank_track(FLAC__StreamMetadata *object, uint32_t track_num);
2083
2097 FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_delete_track(FLAC__StreamMetadata *object, uint32_t track_num);
2098
2118 FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_is_legal(const FLAC__StreamMetadata *object, FLAC__bool check_cd_da_subset, const char **violation);
2119
2131 FLAC_API FLAC__uint32 FLAC__metadata_object_cuesheet_calculate_cddb_id(const FLAC__StreamMetadata *object);
2132
2154 FLAC_API FLAC__bool FLAC__metadata_object_picture_set_mime_type(FLAC__StreamMetadata *object, char *mime_type, FLAC__bool copy);
2155
2176 FLAC_API FLAC__bool FLAC__metadata_object_picture_set_description(FLAC__StreamMetadata *object, FLAC__byte *description, FLAC__bool copy);
2177
2201 FLAC_API FLAC__bool FLAC__metadata_object_picture_set_data(FLAC__StreamMetadata *object, FLAC__byte *data, FLAC__uint32 length, FLAC__bool copy);
2202
2220 FLAC_API FLAC__bool FLAC__metadata_object_picture_is_legal(const FLAC__StreamMetadata *object, const char **violation);
2221
2222
2234 FLAC_API FLAC__byte * FLAC__metadata_object_get_raw(const FLAC__StreamMetadata *object);
2235
2236
2249 FLAC_API FLAC__StreamMetadata * FLAC__metadata_object_set_raw(FLAC__byte *buffer, FLAC__uint32 length);
2250/* \} */
2251
2252#ifdef __cplusplus
2253}
2254#endif
2255
2256#endif
export.h
This module contains #defines and symbols for exporting function calls, and providing version informa...
callback.h
This module defines the structures for describing I/O callbacks to the other FLAC interfaces.
format.h
This module contains structure definitions for the representation of FLAC format components in memory...
FLAC__IOHandle
void * FLAC__IOHandle
Definition: callback.h:89
FLAC_API
#define FLAC_API
Definition: export.h:91
FLAC__MetadataType
FLAC__MetadataType
Definition: format.h:496
FLAC__StreamMetadata_Picture_Type
FLAC__StreamMetadata_Picture_Type
Definition: format.h:739
FLAC__metadata_get_cuesheet
FLAC__bool FLAC__metadata_get_cuesheet(const char *filename, FLAC__StreamMetadata **cuesheet)
FLAC__metadata_get_tags
FLAC__bool FLAC__metadata_get_tags(const char *filename, FLAC__StreamMetadata **tags)
FLAC__metadata_get_streaminfo
FLAC__bool FLAC__metadata_get_streaminfo(const char *filename, FLAC__StreamMetadata *streaminfo)
FLAC__metadata_get_picture
FLAC__bool FLAC__metadata_get_picture(const char *filename, FLAC__StreamMetadata **picture, FLAC__StreamMetadata_Picture_Type type, const char *mime_type, const FLAC__byte *description, uint32_t max_width, uint32_t max_height, uint32_t max_depth, uint32_t max_colors)
FLAC__metadata_simple_iterator_get_block_type
FLAC__MetadataType FLAC__metadata_simple_iterator_get_block_type(const FLAC__Metadata_SimpleIterator *iterator)
FLAC__metadata_simple_iterator_delete
void FLAC__metadata_simple_iterator_delete(FLAC__Metadata_SimpleIterator *iterator)
FLAC__metadata_simple_iterator_is_writable
FLAC__bool FLAC__metadata_simple_iterator_is_writable(const FLAC__Metadata_SimpleIterator *iterator)
FLAC__Metadata_SimpleIterator
struct FLAC__Metadata_SimpleIterator FLAC__Metadata_SimpleIterator
Definition: metadata.h:312
FLAC__metadata_simple_iterator_get_block
FLAC__StreamMetadata * FLAC__metadata_simple_iterator_get_block(FLAC__Metadata_SimpleIterator *iterator)
FLAC__metadata_simple_iterator_prev
FLAC__bool FLAC__metadata_simple_iterator_prev(FLAC__Metadata_SimpleIterator *iterator)
FLAC__metadata_simple_iterator_insert_block_after
FLAC__bool FLAC__metadata_simple_iterator_insert_block_after(FLAC__Metadata_SimpleIterator *iterator, FLAC__StreamMetadata *block, FLAC__bool use_padding)
FLAC__metadata_simple_iterator_new
FLAC__Metadata_SimpleIterator * FLAC__metadata_simple_iterator_new(void)
FLAC__metadata_simple_iterator_is_last
FLAC__bool FLAC__metadata_simple_iterator_is_last(const FLAC__Metadata_SimpleIterator *iterator)
FLAC__Metadata_SimpleIteratorStatusString
const char *const FLAC__Metadata_SimpleIteratorStatusString[]
FLAC__metadata_simple_iterator_init
FLAC__bool FLAC__metadata_simple_iterator_init(FLAC__Metadata_SimpleIterator *iterator, const char *filename, FLAC__bool read_only, FLAC__bool preserve_file_stats)
FLAC__metadata_simple_iterator_next
FLAC__bool FLAC__metadata_simple_iterator_next(FLAC__Metadata_SimpleIterator *iterator)
FLAC__metadata_simple_iterator_delete_block
FLAC__bool FLAC__metadata_simple_iterator_delete_block(FLAC__Metadata_SimpleIterator *iterator, FLAC__bool use_padding)
FLAC__Metadata_SimpleIteratorStatus
FLAC__Metadata_SimpleIteratorStatus
Definition: metadata.h:318
FLAC__metadata_simple_iterator_get_application_id
FLAC__bool FLAC__metadata_simple_iterator_get_application_id(FLAC__Metadata_SimpleIterator *iterator, FLAC__byte *id)
FLAC__metadata_simple_iterator_get_block_offset
off_t FLAC__metadata_simple_iterator_get_block_offset(const FLAC__Metadata_SimpleIterator *iterator)
FLAC__metadata_simple_iterator_set_block
FLAC__bool FLAC__metadata_simple_iterator_set_block(FLAC__Metadata_SimpleIterator *iterator, FLAC__StreamMetadata *block, FLAC__bool use_padding)
FLAC__metadata_simple_iterator_status
FLAC__Metadata_SimpleIteratorStatus FLAC__metadata_simple_iterator_status(FLAC__Metadata_SimpleIterator *iterator)
FLAC__metadata_simple_iterator_get_block_length
uint32_t FLAC__metadata_simple_iterator_get_block_length(const FLAC__Metadata_SimpleIterator *iterator)
FLAC__METADATA_SIMPLE_ITERATOR_STATUS_READ_ERROR
@ FLAC__METADATA_SIMPLE_ITERATOR_STATUS_READ_ERROR
Definition: metadata.h:338
FLAC__METADATA_SIMPLE_ITERATOR_STATUS_ILLEGAL_INPUT
@ FLAC__METADATA_SIMPLE_ITERATOR_STATUS_ILLEGAL_INPUT
Definition: metadata.h:323
FLAC__METADATA_SIMPLE_ITERATOR_STATUS_BAD_METADATA
@ FLAC__METADATA_SIMPLE_ITERATOR_STATUS_BAD_METADATA
Definition: metadata.h:335
FLAC__METADATA_SIMPLE_ITERATOR_STATUS_ERROR_OPENING_FILE
@ FLAC__METADATA_SIMPLE_ITERATOR_STATUS_ERROR_OPENING_FILE
Definition: metadata.h:326
FLAC__METADATA_SIMPLE_ITERATOR_STATUS_SEEK_ERROR
@ FLAC__METADATA_SIMPLE_ITERATOR_STATUS_SEEK_ERROR
Definition: metadata.h:341
FLAC__METADATA_SIMPLE_ITERATOR_STATUS_RENAME_ERROR
@ FLAC__METADATA_SIMPLE_ITERATOR_STATUS_RENAME_ERROR
Definition: metadata.h:347
FLAC__METADATA_SIMPLE_ITERATOR_STATUS_OK
@ FLAC__METADATA_SIMPLE_ITERATOR_STATUS_OK
Definition: metadata.h:320
FLAC__METADATA_SIMPLE_ITERATOR_STATUS_UNLINK_ERROR
@ FLAC__METADATA_SIMPLE_ITERATOR_STATUS_UNLINK_ERROR
Definition: metadata.h:350
FLAC__METADATA_SIMPLE_ITERATOR_STATUS_NOT_A_FLAC_FILE
@ FLAC__METADATA_SIMPLE_ITERATOR_STATUS_NOT_A_FLAC_FILE
Definition: metadata.h:329
FLAC__METADATA_SIMPLE_ITERATOR_STATUS_INTERNAL_ERROR
@ FLAC__METADATA_SIMPLE_ITERATOR_STATUS_INTERNAL_ERROR
Definition: metadata.h:356
FLAC__METADATA_SIMPLE_ITERATOR_STATUS_MEMORY_ALLOCATION_ERROR
@ FLAC__METADATA_SIMPLE_ITERATOR_STATUS_MEMORY_ALLOCATION_ERROR
Definition: metadata.h:353
FLAC__METADATA_SIMPLE_ITERATOR_STATUS_WRITE_ERROR
@ FLAC__METADATA_SIMPLE_ITERATOR_STATUS_WRITE_ERROR
Definition: metadata.h:344
FLAC__METADATA_SIMPLE_ITERATOR_STATUS_NOT_WRITABLE
@ FLAC__METADATA_SIMPLE_ITERATOR_STATUS_NOT_WRITABLE
Definition: metadata.h:332
FLAC__metadata_chain_new
FLAC__Metadata_Chain * FLAC__metadata_chain_new(void)
FLAC__metadata_chain_merge_padding
void FLAC__metadata_chain_merge_padding(FLAC__Metadata_Chain *chain)
FLAC__metadata_iterator_get_block
FLAC__StreamMetadata * FLAC__metadata_iterator_get_block(FLAC__Metadata_Iterator *iterator)
FLAC__metadata_iterator_init
void FLAC__metadata_iterator_init(FLAC__Metadata_Iterator *iterator, FLAC__Metadata_Chain *chain)
FLAC__metadata_iterator_delete
void FLAC__metadata_iterator_delete(FLAC__Metadata_Iterator *iterator)
FLAC__metadata_chain_read_ogg
FLAC__bool FLAC__metadata_chain_read_ogg(FLAC__Metadata_Chain *chain, const char *filename)
FLAC__metadata_chain_check_if_tempfile_needed
FLAC__bool FLAC__metadata_chain_check_if_tempfile_needed(FLAC__Metadata_Chain *chain, FLAC__bool use_padding)
FLAC__metadata_chain_delete
void FLAC__metadata_chain_delete(FLAC__Metadata_Chain *chain)
FLAC__metadata_chain_write
FLAC__bool FLAC__metadata_chain_write(FLAC__Metadata_Chain *chain, FLAC__bool use_padding, FLAC__bool preserve_file_stats)
FLAC__metadata_iterator_insert_block_after
FLAC__bool FLAC__metadata_iterator_insert_block_after(FLAC__Metadata_Iterator *iterator, FLAC__StreamMetadata *block)
FLAC__metadata_chain_read_with_callbacks
FLAC__bool FLAC__metadata_chain_read_with_callbacks(FLAC__Metadata_Chain *chain, FLAC__IOHandle handle, FLAC__IOCallbacks callbacks)
FLAC__metadata_chain_read
FLAC__bool FLAC__metadata_chain_read(FLAC__Metadata_Chain *chain, const char *filename)
FLAC__metadata_iterator_next
FLAC__bool FLAC__metadata_iterator_next(FLAC__Metadata_Iterator *iterator)
FLAC__Metadata_ChainStatusString
const char *const FLAC__Metadata_ChainStatusString[]
FLAC__metadata_chain_write_with_callbacks
FLAC__bool FLAC__metadata_chain_write_with_callbacks(FLAC__Metadata_Chain *chain, FLAC__bool use_padding, FLAC__IOHandle handle, FLAC__IOCallbacks callbacks)
FLAC__metadata_chain_write_with_callbacks_and_tempfile
FLAC__bool FLAC__metadata_chain_write_with_callbacks_and_tempfile(FLAC__Metadata_Chain *chain, FLAC__bool use_padding, FLAC__IOHandle handle, FLAC__IOCallbacks callbacks, FLAC__IOHandle temp_handle, FLAC__IOCallbacks temp_callbacks)
FLAC__metadata_chain_write_new_file
FLAC__bool FLAC__metadata_chain_write_new_file(FLAC__Metadata_Chain *chain, const char *filename, FLAC__bool use_padding)
FLAC__metadata_chain_sort_padding
void FLAC__metadata_chain_sort_padding(FLAC__Metadata_Chain *chain)
FLAC__metadata_iterator_get_block_type
FLAC__MetadataType FLAC__metadata_iterator_get_block_type(const FLAC__Metadata_Iterator *iterator)
FLAC__metadata_iterator_insert_block_before
FLAC__bool FLAC__metadata_iterator_insert_block_before(FLAC__Metadata_Iterator *iterator, FLAC__StreamMetadata *block)
FLAC__metadata_chain_status
FLAC__Metadata_ChainStatus FLAC__metadata_chain_status(FLAC__Metadata_Chain *chain)
FLAC__Metadata_Iterator
struct FLAC__Metadata_Iterator FLAC__Metadata_Iterator
Definition: metadata.h:733
FLAC__metadata_iterator_prev
FLAC__bool FLAC__metadata_iterator_prev(FLAC__Metadata_Iterator *iterator)
FLAC__metadata_iterator_new
FLAC__Metadata_Iterator * FLAC__metadata_iterator_new(void)
FLAC__metadata_chain_read_ogg_with_callbacks
FLAC__bool FLAC__metadata_chain_read_ogg_with_callbacks(FLAC__Metadata_Chain *chain, FLAC__IOHandle handle, FLAC__IOCallbacks callbacks)
FLAC__metadata_iterator_delete_block
FLAC__bool FLAC__metadata_iterator_delete_block(FLAC__Metadata_Iterator *iterator, FLAC__bool replace_with_padding)
FLAC__Metadata_Chain
struct FLAC__Metadata_Chain FLAC__Metadata_Chain
Definition: metadata.h:728
FLAC__metadata_iterator_set_block
FLAC__bool FLAC__metadata_iterator_set_block(FLAC__Metadata_Iterator *iterator, FLAC__StreamMetadata *block)
FLAC__Metadata_ChainStatus
FLAC__Metadata_ChainStatus
Definition: metadata.h:735
FLAC__METADATA_CHAIN_STATUS_READ_ERROR
@ FLAC__METADATA_CHAIN_STATUS_READ_ERROR
Definition: metadata.h:754
FLAC__METADATA_CHAIN_STATUS_READ_WRITE_MISMATCH
@ FLAC__METADATA_CHAIN_STATUS_READ_WRITE_MISMATCH
Definition: metadata.h:778
FLAC__METADATA_CHAIN_STATUS_ILLEGAL_INPUT
@ FLAC__METADATA_CHAIN_STATUS_ILLEGAL_INPUT
Definition: metadata.h:739
FLAC__METADATA_CHAIN_STATUS_UNLINK_ERROR
@ FLAC__METADATA_CHAIN_STATUS_UNLINK_ERROR
Definition: metadata.h:766
FLAC__METADATA_CHAIN_STATUS_OK
@ FLAC__METADATA_CHAIN_STATUS_OK
Definition: metadata.h:736
FLAC__METADATA_CHAIN_STATUS_INTERNAL_ERROR
@ FLAC__METADATA_CHAIN_STATUS_INTERNAL_ERROR
Definition: metadata.h:772
FLAC__METADATA_CHAIN_STATUS_ERROR_OPENING_FILE
@ FLAC__METADATA_CHAIN_STATUS_ERROR_OPENING_FILE
Definition: metadata.h:742
FLAC__METADATA_CHAIN_STATUS_SEEK_ERROR
@ FLAC__METADATA_CHAIN_STATUS_SEEK_ERROR
Definition: metadata.h:757
FLAC__METADATA_CHAIN_STATUS_WRITE_ERROR
@ FLAC__METADATA_CHAIN_STATUS_WRITE_ERROR
Definition: metadata.h:760
FLAC__METADATA_CHAIN_STATUS_BAD_METADATA
@ FLAC__METADATA_CHAIN_STATUS_BAD_METADATA
Definition: metadata.h:751
FLAC__METADATA_CHAIN_STATUS_NOT_A_FLAC_FILE
@ FLAC__METADATA_CHAIN_STATUS_NOT_A_FLAC_FILE
Definition: metadata.h:745
FLAC__METADATA_CHAIN_STATUS_MEMORY_ALLOCATION_ERROR
@ FLAC__METADATA_CHAIN_STATUS_MEMORY_ALLOCATION_ERROR
Definition: metadata.h:769
FLAC__METADATA_CHAIN_STATUS_INVALID_CALLBACKS
@ FLAC__METADATA_CHAIN_STATUS_INVALID_CALLBACKS
Definition: metadata.h:775
FLAC__METADATA_CHAIN_STATUS_NOT_WRITABLE
@ FLAC__METADATA_CHAIN_STATUS_NOT_WRITABLE
Definition: metadata.h:748
FLAC__METADATA_CHAIN_STATUS_RENAME_ERROR
@ FLAC__METADATA_CHAIN_STATUS_RENAME_ERROR
Definition: metadata.h:763
FLAC__METADATA_CHAIN_STATUS_WRONG_WRITE_CALL
@ FLAC__METADATA_CHAIN_STATUS_WRONG_WRITE_CALL
Definition: metadata.h:787
FLAC__metadata_object_cuesheet_track_resize_indices
FLAC__bool FLAC__metadata_object_cuesheet_track_resize_indices(FLAC__StreamMetadata *object, uint32_t track_num, uint32_t new_num_indices)
FLAC__metadata_object_picture_set_data
FLAC__bool FLAC__metadata_object_picture_set_data(FLAC__StreamMetadata *object, FLAC__byte *data, FLAC__uint32 length, FLAC__bool copy)
FLAC__metadata_object_vorbiscomment_remove_entry_matching
int FLAC__metadata_object_vorbiscomment_remove_entry_matching(FLAC__StreamMetadata *object, const char *field_name)
FLAC__metadata_object_vorbiscomment_replace_comment
FLAC__bool FLAC__metadata_object_vorbiscomment_replace_comment(FLAC__StreamMetadata *object, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool all, FLAC__bool copy)
FLAC__metadata_object_vorbiscomment_set_comment
FLAC__bool FLAC__metadata_object_vorbiscomment_set_comment(FLAC__StreamMetadata *object, uint32_t comment_num, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool copy)
FLAC__metadata_object_cuesheet_track_new
FLAC__StreamMetadata_CueSheet_Track * FLAC__metadata_object_cuesheet_track_new(void)
FLAC__metadata_object_set_raw
FLAC__StreamMetadata * FLAC__metadata_object_set_raw(FLAC__byte *buffer, FLAC__uint32 length)
FLAC__metadata_object_seektable_template_append_point
FLAC__bool FLAC__metadata_object_seektable_template_append_point(FLAC__StreamMetadata *object, FLAC__uint64 sample_number)
FLAC__metadata_object_application_set_data
FLAC__bool FLAC__metadata_object_application_set_data(FLAC__StreamMetadata *object, FLAC__byte *data, uint32_t length, FLAC__bool copy)
FLAC__metadata_object_cuesheet_is_legal
FLAC__bool FLAC__metadata_object_cuesheet_is_legal(const FLAC__StreamMetadata *object, FLAC__bool check_cd_da_subset, const char **violation)
FLAC__metadata_object_cuesheet_delete_track
FLAC__bool FLAC__metadata_object_cuesheet_delete_track(FLAC__StreamMetadata *object, uint32_t track_num)
FLAC__metadata_object_vorbiscomment_entry_to_name_value_pair
FLAC__bool FLAC__metadata_object_vorbiscomment_entry_to_name_value_pair(const FLAC__StreamMetadata_VorbisComment_Entry entry, char **field_name, char **field_value)
FLAC__metadata_object_picture_set_description
FLAC__bool FLAC__metadata_object_picture_set_description(FLAC__StreamMetadata *object, FLAC__byte *description, FLAC__bool copy)
FLAC__metadata_object_cuesheet_track_insert_index
FLAC__bool FLAC__metadata_object_cuesheet_track_insert_index(FLAC__StreamMetadata *object, uint32_t track_num, uint32_t index_num, FLAC__StreamMetadata_CueSheet_Index index)
FLAC__metadata_object_vorbiscomment_insert_comment
FLAC__bool FLAC__metadata_object_vorbiscomment_insert_comment(FLAC__StreamMetadata *object, uint32_t comment_num, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool copy)
FLAC__metadata_object_seektable_template_append_points
FLAC__bool FLAC__metadata_object_seektable_template_append_points(FLAC__StreamMetadata *object, FLAC__uint64 sample_numbers[], uint32_t num)
FLAC__metadata_object_picture_set_mime_type
FLAC__bool FLAC__metadata_object_picture_set_mime_type(FLAC__StreamMetadata *object, char *mime_type, FLAC__bool copy)
FLAC__metadata_object_cuesheet_track_insert_blank_index
FLAC__bool FLAC__metadata_object_cuesheet_track_insert_blank_index(FLAC__StreamMetadata *object, uint32_t track_num, uint32_t index_num)
FLAC__metadata_object_vorbiscomment_remove_entries_matching
int FLAC__metadata_object_vorbiscomment_remove_entries_matching(FLAC__StreamMetadata *object, const char *field_name)
FLAC__metadata_object_seektable_insert_point
FLAC__bool FLAC__metadata_object_seektable_insert_point(FLAC__StreamMetadata *object, uint32_t point_num, FLAC__StreamMetadata_SeekPoint point)
FLAC__metadata_object_vorbiscomment_set_vendor_string
FLAC__bool FLAC__metadata_object_vorbiscomment_set_vendor_string(FLAC__StreamMetadata *object, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool copy)
FLAC__metadata_object_is_equal
FLAC__bool FLAC__metadata_object_is_equal(const FLAC__StreamMetadata *block1, const FLAC__StreamMetadata *block2)
FLAC__metadata_object_delete
void FLAC__metadata_object_delete(FLAC__StreamMetadata *object)
FLAC__metadata_object_seektable_resize_points
FLAC__bool FLAC__metadata_object_seektable_resize_points(FLAC__StreamMetadata *object, uint32_t new_num_points)
FLAC__metadata_object_cuesheet_insert_blank_track
FLAC__bool FLAC__metadata_object_cuesheet_insert_blank_track(FLAC__StreamMetadata *object, uint32_t track_num)
FLAC__metadata_object_picture_is_legal
FLAC__bool FLAC__metadata_object_picture_is_legal(const FLAC__StreamMetadata *object, const char **violation)
FLAC__metadata_object_vorbiscomment_append_comment
FLAC__bool FLAC__metadata_object_vorbiscomment_append_comment(FLAC__StreamMetadata *object, FLAC__StreamMetadata_VorbisComment_Entry entry, FLAC__bool copy)
FLAC__metadata_object_get_raw
FLAC__byte * FLAC__metadata_object_get_raw(const FLAC__StreamMetadata *object)
FLAC__metadata_object_cuesheet_resize_tracks
FLAC__bool FLAC__metadata_object_cuesheet_resize_tracks(FLAC__StreamMetadata *object, uint32_t new_num_tracks)
FLAC__metadata_object_seektable_delete_point
FLAC__bool FLAC__metadata_object_seektable_delete_point(FLAC__StreamMetadata *object, uint32_t point_num)
FLAC__metadata_object_cuesheet_track_delete
void FLAC__metadata_object_cuesheet_track_delete(FLAC__StreamMetadata_CueSheet_Track *object)
FLAC__metadata_object_cuesheet_insert_track
FLAC__bool FLAC__metadata_object_cuesheet_insert_track(FLAC__StreamMetadata *object, uint32_t track_num, FLAC__StreamMetadata_CueSheet_Track *track, FLAC__bool copy)
FLAC__metadata_object_vorbiscomment_entry_matches
FLAC__bool FLAC__metadata_object_vorbiscomment_entry_matches(const FLAC__StreamMetadata_VorbisComment_Entry entry, const char *field_name, uint32_t field_name_length)
FLAC__metadata_object_vorbiscomment_resize_comments
FLAC__bool FLAC__metadata_object_vorbiscomment_resize_comments(FLAC__StreamMetadata *object, uint32_t new_num_comments)
FLAC__metadata_object_cuesheet_set_track
FLAC__bool FLAC__metadata_object_cuesheet_set_track(FLAC__StreamMetadata *object, uint32_t track_num, FLAC__StreamMetadata_CueSheet_Track *track, FLAC__bool copy)
FLAC__metadata_object_vorbiscomment_entry_from_name_value_pair
FLAC__bool FLAC__metadata_object_vorbiscomment_entry_from_name_value_pair(FLAC__StreamMetadata_VorbisComment_Entry *entry, const char *field_name, const char *field_value)
FLAC__metadata_object_seektable_template_append_spaced_points
FLAC__bool FLAC__metadata_object_seektable_template_append_spaced_points(FLAC__StreamMetadata *object, uint32_t num, FLAC__uint64 total_samples)
FLAC__metadata_object_seektable_template_append_spaced_points_by_samples
FLAC__bool FLAC__metadata_object_seektable_template_append_spaced_points_by_samples(FLAC__StreamMetadata *object, uint32_t samples, FLAC__uint64 total_samples)
FLAC__metadata_object_cuesheet_track_delete_index
FLAC__bool FLAC__metadata_object_cuesheet_track_delete_index(FLAC__StreamMetadata *object, uint32_t track_num, uint32_t index_num)
FLAC__metadata_object_cuesheet_track_clone
FLAC__StreamMetadata_CueSheet_Track * FLAC__metadata_object_cuesheet_track_clone(const FLAC__StreamMetadata_CueSheet_Track *object)
FLAC__metadata_object_seektable_set_point
void FLAC__metadata_object_seektable_set_point(FLAC__StreamMetadata *object, uint32_t point_num, FLAC__StreamMetadata_SeekPoint point)
FLAC__metadata_object_seektable_template_append_placeholders
FLAC__bool FLAC__metadata_object_seektable_template_append_placeholders(FLAC__StreamMetadata *object, uint32_t num)
FLAC__metadata_object_vorbiscomment_delete_comment
FLAC__bool FLAC__metadata_object_vorbiscomment_delete_comment(FLAC__StreamMetadata *object, uint32_t comment_num)
FLAC__metadata_object_seektable_is_legal
FLAC__bool FLAC__metadata_object_seektable_is_legal(const FLAC__StreamMetadata *object)
FLAC__metadata_object_vorbiscomment_find_entry_from
int FLAC__metadata_object_vorbiscomment_find_entry_from(const FLAC__StreamMetadata *object, uint32_t offset, const char *field_name)
FLAC__metadata_object_new
FLAC__StreamMetadata * FLAC__metadata_object_new(FLAC__MetadataType type)
FLAC__metadata_object_clone
FLAC__StreamMetadata * FLAC__metadata_object_clone(const FLAC__StreamMetadata *object)
FLAC__metadata_object_seektable_template_sort
FLAC__bool FLAC__metadata_object_seektable_template_sort(FLAC__StreamMetadata *object, FLAC__bool compact)
FLAC__metadata_object_cuesheet_calculate_cddb_id
FLAC__uint32 FLAC__metadata_object_cuesheet_calculate_cddb_id(const FLAC__StreamMetadata *object)
FLAC__IOCallbacks
Definition: callback.h:175
FLAC__StreamMetadata_CueSheet_Index
Definition: format.h:654
FLAC__StreamMetadata_CueSheet_Track
Definition: format.h:673
FLAC__StreamMetadata_SeekPoint
Definition: format.h:581
FLAC__StreamMetadata_VorbisComment_Entry
Definition: format.h:631
FLAC__StreamMetadata
Definition: format.h:841

Copyright (c) 2000-2009 Josh Coalson Copyright (c) 2011-2025 Xiph.Org Foundation