1 /* libFLAC++ - Free Lossless Audio Codec library
2 * Copyright (C) 2002,2003,2004,2005,2006,2007,2008,2009 Josh Coalson
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
8 * - Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
15 * - Neither the name of the Xiph.org Foundation nor the names of its
16 * contributors may be used to endorse or promote products derived from
17 * this software without specific prior written permission.
19 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR
23 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
24 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
25 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
26 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
27 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
28 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
29 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32 #define __STDC_LIMIT_MACROS 1 /* otherwise SIZE_MAX is not defined for c++ */
33 #include "share/alloc.h"
34 #include "FLAC++/metadata.h"
35 #include "FLAC/assert.h"
36 #include <stdlib.h> // for malloc(), free()
37 #include <string.h> // for memcpy() etc.
40 // warning C4800: 'int' : forcing to bool 'true' or 'false' (performance warning)
41 #pragma warning ( disable : 4800 )
47 // local utility routines
51 Prototype *construct_block(::FLAC__StreamMetadata *object)
54 switch(object->type) {
55 case FLAC__METADATA_TYPE_STREAMINFO:
56 ret = new StreamInfo(object, /*copy=*/false);
58 case FLAC__METADATA_TYPE_PADDING:
59 ret = new Padding(object, /*copy=*/false);
61 case FLAC__METADATA_TYPE_APPLICATION:
62 ret = new Application(object, /*copy=*/false);
64 case FLAC__METADATA_TYPE_SEEKTABLE:
65 ret = new SeekTable(object, /*copy=*/false);
67 case FLAC__METADATA_TYPE_VORBIS_COMMENT:
68 ret = new VorbisComment(object, /*copy=*/false);
70 case FLAC__METADATA_TYPE_CUESHEET:
71 ret = new CueSheet(object, /*copy=*/false);
73 case FLAC__METADATA_TYPE_PICTURE:
74 ret = new Picture(object, /*copy=*/false);
77 ret = new Unknown(object, /*copy=*/false);
85 FLACPP_API Prototype *clone(const Prototype *object)
87 FLAC__ASSERT(0 != object);
89 const StreamInfo *streaminfo = dynamic_cast<const StreamInfo *>(object);
90 const Padding *padding = dynamic_cast<const Padding *>(object);
91 const Application *application = dynamic_cast<const Application *>(object);
92 const SeekTable *seektable = dynamic_cast<const SeekTable *>(object);
93 const VorbisComment *vorbiscomment = dynamic_cast<const VorbisComment *>(object);
94 const CueSheet *cuesheet = dynamic_cast<const CueSheet *>(object);
95 const Picture *picture = dynamic_cast<const Picture *>(object);
96 const Unknown *unknown = dynamic_cast<const Unknown *>(object);
99 return new StreamInfo(*streaminfo);
100 else if(0 != padding)
101 return new Padding(*padding);
102 else if(0 != application)
103 return new Application(*application);
104 else if(0 != seektable)
105 return new SeekTable(*seektable);
106 else if(0 != vorbiscomment)
107 return new VorbisComment(*vorbiscomment);
108 else if(0 != cuesheet)
109 return new CueSheet(*cuesheet);
110 else if(0 != picture)
111 return new Picture(*picture);
112 else if(0 != unknown)
113 return new Unknown(*unknown);
124 Prototype::Prototype(const Prototype &object):
125 object_(::FLAC__metadata_object_clone(object.object_)),
128 FLAC__ASSERT(object.is_valid());
131 Prototype::Prototype(const ::FLAC__StreamMetadata &object):
132 object_(::FLAC__metadata_object_clone(&object)),
137 Prototype::Prototype(const ::FLAC__StreamMetadata *object):
138 object_(::FLAC__metadata_object_clone(object)),
141 FLAC__ASSERT(0 != object);
144 Prototype::Prototype(::FLAC__StreamMetadata *object, bool copy):
145 object_(copy? ::FLAC__metadata_object_clone(object) : object),
148 FLAC__ASSERT(0 != object);
151 Prototype::~Prototype()
156 void Prototype::clear()
158 if(0 != object_ && !is_reference_)
159 FLAC__metadata_object_delete(object_);
163 Prototype &Prototype::operator=(const Prototype &object)
165 FLAC__ASSERT(object.is_valid());
167 is_reference_ = false;
168 object_ = ::FLAC__metadata_object_clone(object.object_);
172 Prototype &Prototype::operator=(const ::FLAC__StreamMetadata &object)
175 is_reference_ = false;
176 object_ = ::FLAC__metadata_object_clone(&object);
180 Prototype &Prototype::operator=(const ::FLAC__StreamMetadata *object)
182 FLAC__ASSERT(0 != object);
184 is_reference_ = false;
185 object_ = ::FLAC__metadata_object_clone(object);
189 Prototype &Prototype::assign_object(::FLAC__StreamMetadata *object, bool copy)
191 FLAC__ASSERT(0 != object);
193 object_ = (copy? ::FLAC__metadata_object_clone(object) : object);
194 is_reference_ = false;
198 bool Prototype::get_is_last() const
200 FLAC__ASSERT(is_valid());
201 return (bool)object_->is_last;
204 FLAC__MetadataType Prototype::get_type() const
206 FLAC__ASSERT(is_valid());
207 return object_->type;
210 unsigned Prototype::get_length() const
212 FLAC__ASSERT(is_valid());
213 return object_->length;
216 void Prototype::set_is_last(bool value)
218 FLAC__ASSERT(is_valid());
219 object_->is_last = value;
227 StreamInfo::StreamInfo():
228 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_STREAMINFO), /*copy=*/false)
231 StreamInfo::~StreamInfo()
234 unsigned StreamInfo::get_min_blocksize() const
236 FLAC__ASSERT(is_valid());
237 return object_->data.stream_info.min_blocksize;
240 unsigned StreamInfo::get_max_blocksize() const
242 FLAC__ASSERT(is_valid());
243 return object_->data.stream_info.max_blocksize;
246 unsigned StreamInfo::get_min_framesize() const
248 FLAC__ASSERT(is_valid());
249 return object_->data.stream_info.min_framesize;
252 unsigned StreamInfo::get_max_framesize() const
254 FLAC__ASSERT(is_valid());
255 return object_->data.stream_info.max_framesize;
258 unsigned StreamInfo::get_sample_rate() const
260 FLAC__ASSERT(is_valid());
261 return object_->data.stream_info.sample_rate;
264 unsigned StreamInfo::get_channels() const
266 FLAC__ASSERT(is_valid());
267 return object_->data.stream_info.channels;
270 unsigned StreamInfo::get_bits_per_sample() const
272 FLAC__ASSERT(is_valid());
273 return object_->data.stream_info.bits_per_sample;
276 FLAC__uint64 StreamInfo::get_total_samples() const
278 FLAC__ASSERT(is_valid());
279 return object_->data.stream_info.total_samples;
282 const FLAC__byte *StreamInfo::get_md5sum() const
284 FLAC__ASSERT(is_valid());
285 return object_->data.stream_info.md5sum;
288 void StreamInfo::set_min_blocksize(unsigned value)
290 FLAC__ASSERT(is_valid());
291 FLAC__ASSERT(value >= FLAC__MIN_BLOCK_SIZE);
292 FLAC__ASSERT(value <= FLAC__MAX_BLOCK_SIZE);
293 object_->data.stream_info.min_blocksize = value;
296 void StreamInfo::set_max_blocksize(unsigned value)
298 FLAC__ASSERT(is_valid());
299 FLAC__ASSERT(value >= FLAC__MIN_BLOCK_SIZE);
300 FLAC__ASSERT(value <= FLAC__MAX_BLOCK_SIZE);
301 object_->data.stream_info.max_blocksize = value;
304 void StreamInfo::set_min_framesize(unsigned value)
306 FLAC__ASSERT(is_valid());
307 FLAC__ASSERT(value < (1u << FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN));
308 object_->data.stream_info.min_framesize = value;
311 void StreamInfo::set_max_framesize(unsigned value)
313 FLAC__ASSERT(is_valid());
314 FLAC__ASSERT(value < (1u << FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN));
315 object_->data.stream_info.max_framesize = value;
318 void StreamInfo::set_sample_rate(unsigned value)
320 FLAC__ASSERT(is_valid());
321 FLAC__ASSERT(FLAC__format_sample_rate_is_valid(value));
322 object_->data.stream_info.sample_rate = value;
325 void StreamInfo::set_channels(unsigned value)
327 FLAC__ASSERT(is_valid());
328 FLAC__ASSERT(value > 0);
329 FLAC__ASSERT(value <= FLAC__MAX_CHANNELS);
330 object_->data.stream_info.channels = value;
333 void StreamInfo::set_bits_per_sample(unsigned value)
335 FLAC__ASSERT(is_valid());
336 FLAC__ASSERT(value >= FLAC__MIN_BITS_PER_SAMPLE);
337 FLAC__ASSERT(value <= FLAC__MAX_BITS_PER_SAMPLE);
338 object_->data.stream_info.bits_per_sample = value;
341 void StreamInfo::set_total_samples(FLAC__uint64 value)
343 FLAC__ASSERT(is_valid());
344 FLAC__ASSERT(value < (((FLAC__uint64)1) << FLAC__STREAM_METADATA_STREAMINFO_TOTAL_SAMPLES_LEN));
345 object_->data.stream_info.total_samples = value;
348 void StreamInfo::set_md5sum(const FLAC__byte value[16])
350 FLAC__ASSERT(is_valid());
351 FLAC__ASSERT(0 != value);
352 memcpy(object_->data.stream_info.md5sum, value, 16);
361 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_PADDING), /*copy=*/false)
364 Padding::Padding(unsigned length):
365 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_PADDING), /*copy=*/false)
373 void Padding::set_length(unsigned length)
375 FLAC__ASSERT(is_valid());
376 object_->length = length;
384 Application::Application():
385 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_APPLICATION), /*copy=*/false)
388 Application::~Application()
391 const FLAC__byte *Application::get_id() const
393 FLAC__ASSERT(is_valid());
394 return object_->data.application.id;
397 const FLAC__byte *Application::get_data() const
399 FLAC__ASSERT(is_valid());
400 return object_->data.application.data;
403 void Application::set_id(const FLAC__byte value[4])
405 FLAC__ASSERT(is_valid());
406 FLAC__ASSERT(0 != value);
407 memcpy(object_->data.application.id, value, 4);
410 bool Application::set_data(const FLAC__byte *data, unsigned length)
412 FLAC__ASSERT(is_valid());
413 return (bool)::FLAC__metadata_object_application_set_data(object_, (FLAC__byte*)data, length, true);
416 bool Application::set_data(FLAC__byte *data, unsigned length, bool copy)
418 FLAC__ASSERT(is_valid());
419 return (bool)::FLAC__metadata_object_application_set_data(object_, data, length, copy);
427 SeekTable::SeekTable():
428 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_SEEKTABLE), /*copy=*/false)
431 SeekTable::~SeekTable()
434 unsigned SeekTable::get_num_points() const
436 FLAC__ASSERT(is_valid());
437 return object_->data.seek_table.num_points;
440 ::FLAC__StreamMetadata_SeekPoint SeekTable::get_point(unsigned indx) const
442 FLAC__ASSERT(is_valid());
443 FLAC__ASSERT(indx < object_->data.seek_table.num_points);
444 return object_->data.seek_table.points[indx];
447 bool SeekTable::resize_points(unsigned new_num_points)
449 FLAC__ASSERT(is_valid());
450 return (bool)::FLAC__metadata_object_seektable_resize_points(object_, new_num_points);
453 void SeekTable::set_point(unsigned indx, const ::FLAC__StreamMetadata_SeekPoint &point)
455 FLAC__ASSERT(is_valid());
456 FLAC__ASSERT(indx < object_->data.seek_table.num_points);
457 ::FLAC__metadata_object_seektable_set_point(object_, indx, point);
460 bool SeekTable::insert_point(unsigned indx, const ::FLAC__StreamMetadata_SeekPoint &point)
462 FLAC__ASSERT(is_valid());
463 FLAC__ASSERT(indx <= object_->data.seek_table.num_points);
464 return (bool)::FLAC__metadata_object_seektable_insert_point(object_, indx, point);
467 bool SeekTable::delete_point(unsigned indx)
469 FLAC__ASSERT(is_valid());
470 FLAC__ASSERT(indx < object_->data.seek_table.num_points);
471 return (bool)::FLAC__metadata_object_seektable_delete_point(object_, indx);
474 bool SeekTable::is_legal() const
476 FLAC__ASSERT(is_valid());
477 return (bool)::FLAC__metadata_object_seektable_is_legal(object_);
480 bool SeekTable::template_append_placeholders(unsigned num)
482 FLAC__ASSERT(is_valid());
483 return (bool)::FLAC__metadata_object_seektable_template_append_placeholders(object_, num);
486 bool SeekTable::template_append_point(FLAC__uint64 sample_number)
488 FLAC__ASSERT(is_valid());
489 return (bool)::FLAC__metadata_object_seektable_template_append_point(object_, sample_number);
492 bool SeekTable::template_append_points(FLAC__uint64 sample_numbers[], unsigned num)
494 FLAC__ASSERT(is_valid());
495 return (bool)::FLAC__metadata_object_seektable_template_append_points(object_, sample_numbers, num);
498 bool SeekTable::template_append_spaced_points(unsigned num, FLAC__uint64 total_samples)
500 FLAC__ASSERT(is_valid());
501 return (bool)::FLAC__metadata_object_seektable_template_append_spaced_points(object_, num, total_samples);
504 bool SeekTable::template_append_spaced_points_by_samples(unsigned samples, FLAC__uint64 total_samples)
506 FLAC__ASSERT(is_valid());
507 return (bool)::FLAC__metadata_object_seektable_template_append_spaced_points_by_samples(object_, samples, total_samples);
510 bool SeekTable::template_sort(bool compact)
512 FLAC__ASSERT(is_valid());
513 return (bool)::FLAC__metadata_object_seektable_template_sort(object_, compact);
518 // VorbisComment::Entry
521 VorbisComment::Entry::Entry()
526 VorbisComment::Entry::Entry(const char *field, unsigned field_length)
529 construct(field, field_length);
532 VorbisComment::Entry::Entry(const char *field)
538 VorbisComment::Entry::Entry(const char *field_name, const char *field_value, unsigned field_value_length)
541 construct(field_name, field_value, field_value_length);
544 VorbisComment::Entry::Entry(const char *field_name, const char *field_value)
547 construct(field_name, field_value);
550 VorbisComment::Entry::Entry(const Entry &entry)
552 FLAC__ASSERT(entry.is_valid());
554 construct((const char *)entry.entry_.entry, entry.entry_.length);
557 VorbisComment::Entry &VorbisComment::Entry::operator=(const Entry &entry)
559 FLAC__ASSERT(entry.is_valid());
561 construct((const char *)entry.entry_.entry, entry.entry_.length);
565 VorbisComment::Entry::~Entry()
570 bool VorbisComment::Entry::is_valid() const
575 unsigned VorbisComment::Entry::get_field_length() const
577 FLAC__ASSERT(is_valid());
578 return entry_.length;
581 unsigned VorbisComment::Entry::get_field_name_length() const
583 FLAC__ASSERT(is_valid());
584 return field_name_length_;
587 unsigned VorbisComment::Entry::get_field_value_length() const
589 FLAC__ASSERT(is_valid());
590 return field_value_length_;
593 ::FLAC__StreamMetadata_VorbisComment_Entry VorbisComment::Entry::get_entry() const
595 FLAC__ASSERT(is_valid());
599 const char *VorbisComment::Entry::get_field() const
601 FLAC__ASSERT(is_valid());
602 return (const char *)entry_.entry;
605 const char *VorbisComment::Entry::get_field_name() const
607 FLAC__ASSERT(is_valid());
611 const char *VorbisComment::Entry::get_field_value() const
613 FLAC__ASSERT(is_valid());
617 bool VorbisComment::Entry::set_field(const char *field, unsigned field_length)
619 FLAC__ASSERT(is_valid());
620 FLAC__ASSERT(0 != field);
622 if(!::FLAC__format_vorbiscomment_entry_is_legal((const ::FLAC__byte*)field, field_length))
623 return is_valid_ = false;
627 if(0 == (entry_.entry = (FLAC__byte*)safe_malloc_add_2op_(field_length, /*+*/1))) {
631 entry_.length = field_length;
632 memcpy(entry_.entry, field, field_length);
633 entry_.entry[field_length] = '\0';
634 (void) parse_field();
640 bool VorbisComment::Entry::set_field(const char *field)
642 return set_field(field, strlen(field));
645 bool VorbisComment::Entry::set_field_name(const char *field_name)
647 FLAC__ASSERT(is_valid());
648 FLAC__ASSERT(0 != field_name);
650 if(!::FLAC__format_vorbiscomment_entry_name_is_legal(field_name))
651 return is_valid_ = false;
655 if(0 == (field_name_ = strdup(field_name))) {
659 field_name_length_ = strlen(field_name_);
666 bool VorbisComment::Entry::set_field_value(const char *field_value, unsigned field_value_length)
668 FLAC__ASSERT(is_valid());
669 FLAC__ASSERT(0 != field_value);
671 if(!::FLAC__format_vorbiscomment_entry_value_is_legal((const FLAC__byte*)field_value, field_value_length))
672 return is_valid_ = false;
676 if(0 == (field_value_ = (char *)safe_malloc_add_2op_(field_value_length, /*+*/1))) {
680 field_value_length_ = field_value_length;
681 memcpy(field_value_, field_value, field_value_length);
682 field_value_[field_value_length] = '\0';
689 bool VorbisComment::Entry::set_field_value(const char *field_value)
691 return set_field_value(field_value, strlen(field_value));
694 void VorbisComment::Entry::zero()
700 field_name_length_ = 0;
702 field_value_length_ = 0;
705 void VorbisComment::Entry::clear()
713 void VorbisComment::Entry::clear_entry()
715 if(0 != entry_.entry) {
722 void VorbisComment::Entry::clear_field_name()
724 if(0 != field_name_) {
727 field_name_length_ = 0;
731 void VorbisComment::Entry::clear_field_value()
733 if(0 != field_value_) {
736 field_value_length_ = 0;
740 void VorbisComment::Entry::construct(const char *field, unsigned field_length)
742 if(set_field(field, field_length))
746 void VorbisComment::Entry::construct(const char *field)
748 construct(field, strlen(field));
751 void VorbisComment::Entry::construct(const char *field_name, const char *field_value, unsigned field_value_length)
753 if(set_field_name(field_name) && set_field_value(field_value, field_value_length))
757 void VorbisComment::Entry::construct(const char *field_name, const char *field_value)
759 construct(field_name, field_value, strlen(field_value));
762 void VorbisComment::Entry::compose_field()
766 if(0 == (entry_.entry = (FLAC__byte*)safe_malloc_add_4op_(field_name_length_, /*+*/1, /*+*/field_value_length_, /*+*/1))) {
770 memcpy(entry_.entry, field_name_, field_name_length_);
771 entry_.length += field_name_length_;
772 memcpy(entry_.entry + entry_.length, "=", 1);
774 memcpy(entry_.entry + entry_.length, field_value_, field_value_length_);
775 entry_.length += field_value_length_;
776 entry_.entry[entry_.length] = '\0';
781 void VorbisComment::Entry::parse_field()
786 const char *p = (const char *)memchr(entry_.entry, '=', entry_.length);
789 p = (const char *)entry_.entry + entry_.length;
791 field_name_length_ = (unsigned)(p - (const char *)entry_.entry);
792 if(0 == (field_name_ = (char *)safe_malloc_add_2op_(field_name_length_, /*+*/1))) { // +1 for the trailing \0
796 memcpy(field_name_, entry_.entry, field_name_length_);
797 field_name_[field_name_length_] = '\0';
799 if(entry_.length - field_name_length_ == 0) {
800 field_value_length_ = 0;
801 if(0 == (field_value_ = (char *)safe_malloc_(0))) {
807 field_value_length_ = entry_.length - field_name_length_ - 1;
808 if(0 == (field_value_ = (char *)safe_malloc_add_2op_(field_value_length_, /*+*/1))) { // +1 for the trailing \0
812 memcpy(field_value_, ++p, field_value_length_);
813 field_value_[field_value_length_] = '\0';
824 VorbisComment::VorbisComment():
825 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_VORBIS_COMMENT), /*copy=*/false)
828 VorbisComment::~VorbisComment()
831 unsigned VorbisComment::get_num_comments() const
833 FLAC__ASSERT(is_valid());
834 return object_->data.vorbis_comment.num_comments;
837 const FLAC__byte *VorbisComment::get_vendor_string() const
839 FLAC__ASSERT(is_valid());
840 return object_->data.vorbis_comment.vendor_string.entry;
843 VorbisComment::Entry VorbisComment::get_comment(unsigned indx) const
845 FLAC__ASSERT(is_valid());
846 FLAC__ASSERT(indx < object_->data.vorbis_comment.num_comments);
847 return Entry((const char *)object_->data.vorbis_comment.comments[indx].entry, object_->data.vorbis_comment.comments[indx].length);
850 bool VorbisComment::set_vendor_string(const FLAC__byte *string)
852 FLAC__ASSERT(is_valid());
853 // vendor_string is a special kind of entry
854 const ::FLAC__StreamMetadata_VorbisComment_Entry vendor_string = { static_cast<FLAC__uint32>(strlen((const char *)string)), (FLAC__byte*)string }; // we can cheat on const-ness because we make a copy below:
855 return (bool)::FLAC__metadata_object_vorbiscomment_set_vendor_string(object_, vendor_string, /*copy=*/true);
858 bool VorbisComment::resize_comments(unsigned new_num_comments)
860 FLAC__ASSERT(is_valid());
861 return (bool)::FLAC__metadata_object_vorbiscomment_resize_comments(object_, new_num_comments);
864 bool VorbisComment::set_comment(unsigned indx, const VorbisComment::Entry &entry)
866 FLAC__ASSERT(is_valid());
867 FLAC__ASSERT(indx < object_->data.vorbis_comment.num_comments);
868 return (bool)::FLAC__metadata_object_vorbiscomment_set_comment(object_, indx, entry.get_entry(), /*copy=*/true);
871 bool VorbisComment::insert_comment(unsigned indx, const VorbisComment::Entry &entry)
873 FLAC__ASSERT(is_valid());
874 FLAC__ASSERT(indx <= object_->data.vorbis_comment.num_comments);
875 return (bool)::FLAC__metadata_object_vorbiscomment_insert_comment(object_, indx, entry.get_entry(), /*copy=*/true);
878 bool VorbisComment::append_comment(const VorbisComment::Entry &entry)
880 FLAC__ASSERT(is_valid());
881 return (bool)::FLAC__metadata_object_vorbiscomment_append_comment(object_, entry.get_entry(), /*copy=*/true);
884 bool VorbisComment::replace_comment(const VorbisComment::Entry &entry, bool all)
886 FLAC__ASSERT(is_valid());
887 return (bool)::FLAC__metadata_object_vorbiscomment_replace_comment(object_, entry.get_entry(), all, /*copy=*/true);
890 bool VorbisComment::delete_comment(unsigned indx)
892 FLAC__ASSERT(is_valid());
893 FLAC__ASSERT(indx < object_->data.vorbis_comment.num_comments);
894 return (bool)::FLAC__metadata_object_vorbiscomment_delete_comment(object_, indx);
897 int VorbisComment::find_entry_from(unsigned offset, const char *field_name)
899 FLAC__ASSERT(is_valid());
900 return ::FLAC__metadata_object_vorbiscomment_find_entry_from(object_, offset, field_name);
903 int VorbisComment::remove_entry_matching(const char *field_name)
905 FLAC__ASSERT(is_valid());
906 return ::FLAC__metadata_object_vorbiscomment_remove_entry_matching(object_, field_name);
909 int VorbisComment::remove_entries_matching(const char *field_name)
911 FLAC__ASSERT(is_valid());
912 return ::FLAC__metadata_object_vorbiscomment_remove_entries_matching(object_, field_name);
920 CueSheet::Track::Track():
921 object_(::FLAC__metadata_object_cuesheet_track_new())
924 CueSheet::Track::Track(const ::FLAC__StreamMetadata_CueSheet_Track *track):
925 object_(::FLAC__metadata_object_cuesheet_track_clone(track))
928 CueSheet::Track::Track(const Track &track):
929 object_(::FLAC__metadata_object_cuesheet_track_clone(track.object_))
932 CueSheet::Track &CueSheet::Track::operator=(const Track &track)
935 ::FLAC__metadata_object_cuesheet_track_delete(object_);
936 object_ = ::FLAC__metadata_object_cuesheet_track_clone(track.object_);
940 CueSheet::Track::~Track()
943 ::FLAC__metadata_object_cuesheet_track_delete(object_);
946 bool CueSheet::Track::is_valid() const
948 return(0 != object_);
951 ::FLAC__StreamMetadata_CueSheet_Index CueSheet::Track::get_index(unsigned i) const
953 FLAC__ASSERT(is_valid());
954 FLAC__ASSERT(i < object_->num_indices);
955 return object_->indices[i];
958 void CueSheet::Track::set_isrc(const char value[12])
960 FLAC__ASSERT(is_valid());
961 FLAC__ASSERT(0 != value);
962 memcpy(object_->isrc, value, 12);
963 object_->isrc[12] = '\0';
966 void CueSheet::Track::set_type(unsigned value)
968 FLAC__ASSERT(is_valid());
969 FLAC__ASSERT(value <= 1);
970 object_->type = value;
973 void CueSheet::Track::set_index(unsigned i, const ::FLAC__StreamMetadata_CueSheet_Index &indx)
975 FLAC__ASSERT(is_valid());
976 FLAC__ASSERT(i < object_->num_indices);
977 object_->indices[i] = indx;
985 CueSheet::CueSheet():
986 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_CUESHEET), /*copy=*/false)
989 CueSheet::~CueSheet()
992 const char *CueSheet::get_media_catalog_number() const
994 FLAC__ASSERT(is_valid());
995 return object_->data.cue_sheet.media_catalog_number;
998 FLAC__uint64 CueSheet::get_lead_in() const
1000 FLAC__ASSERT(is_valid());
1001 return object_->data.cue_sheet.lead_in;
1004 bool CueSheet::get_is_cd() const
1006 FLAC__ASSERT(is_valid());
1007 return object_->data.cue_sheet.is_cd? true : false;
1010 unsigned CueSheet::get_num_tracks() const
1012 FLAC__ASSERT(is_valid());
1013 return object_->data.cue_sheet.num_tracks;
1016 CueSheet::Track CueSheet::get_track(unsigned i) const
1018 FLAC__ASSERT(is_valid());
1019 FLAC__ASSERT(i < object_->data.cue_sheet.num_tracks);
1020 return Track(object_->data.cue_sheet.tracks + i);
1023 void CueSheet::set_media_catalog_number(const char value[128])
1025 FLAC__ASSERT(is_valid());
1026 FLAC__ASSERT(0 != value);
1027 memcpy(object_->data.cue_sheet.media_catalog_number, value, 128);
1028 object_->data.cue_sheet.media_catalog_number[128] = '\0';
1031 void CueSheet::set_lead_in(FLAC__uint64 value)
1033 FLAC__ASSERT(is_valid());
1034 object_->data.cue_sheet.lead_in = value;
1037 void CueSheet::set_is_cd(bool value)
1039 FLAC__ASSERT(is_valid());
1040 object_->data.cue_sheet.is_cd = value;
1043 void CueSheet::set_index(unsigned track_num, unsigned index_num, const ::FLAC__StreamMetadata_CueSheet_Index &indx)
1045 FLAC__ASSERT(is_valid());
1046 FLAC__ASSERT(track_num < object_->data.cue_sheet.num_tracks);
1047 FLAC__ASSERT(index_num < object_->data.cue_sheet.tracks[track_num].num_indices);
1048 object_->data.cue_sheet.tracks[track_num].indices[index_num] = indx;
1051 bool CueSheet::resize_indices(unsigned track_num, unsigned new_num_indices)
1053 FLAC__ASSERT(is_valid());
1054 FLAC__ASSERT(track_num < object_->data.cue_sheet.num_tracks);
1055 return (bool)::FLAC__metadata_object_cuesheet_track_resize_indices(object_, track_num, new_num_indices);
1058 bool CueSheet::insert_index(unsigned track_num, unsigned index_num, const ::FLAC__StreamMetadata_CueSheet_Index &indx)
1060 FLAC__ASSERT(is_valid());
1061 FLAC__ASSERT(track_num < object_->data.cue_sheet.num_tracks);
1062 FLAC__ASSERT(index_num <= object_->data.cue_sheet.tracks[track_num].num_indices);
1063 return (bool)::FLAC__metadata_object_cuesheet_track_insert_index(object_, track_num, index_num, indx);
1066 bool CueSheet::insert_blank_index(unsigned track_num, unsigned index_num)
1068 FLAC__ASSERT(is_valid());
1069 FLAC__ASSERT(track_num < object_->data.cue_sheet.num_tracks);
1070 FLAC__ASSERT(index_num <= object_->data.cue_sheet.tracks[track_num].num_indices);
1071 return (bool)::FLAC__metadata_object_cuesheet_track_insert_blank_index(object_, track_num, index_num);
1074 bool CueSheet::delete_index(unsigned track_num, unsigned index_num)
1076 FLAC__ASSERT(is_valid());
1077 FLAC__ASSERT(track_num < object_->data.cue_sheet.num_tracks);
1078 FLAC__ASSERT(index_num < object_->data.cue_sheet.tracks[track_num].num_indices);
1079 return (bool)::FLAC__metadata_object_cuesheet_track_delete_index(object_, track_num, index_num);
1082 bool CueSheet::resize_tracks(unsigned new_num_tracks)
1084 FLAC__ASSERT(is_valid());
1085 return (bool)::FLAC__metadata_object_cuesheet_resize_tracks(object_, new_num_tracks);
1088 bool CueSheet::set_track(unsigned i, const CueSheet::Track &track)
1090 FLAC__ASSERT(is_valid());
1091 FLAC__ASSERT(i < object_->data.cue_sheet.num_tracks);
1092 // We can safely const_cast since copy=true
1093 return (bool)::FLAC__metadata_object_cuesheet_set_track(object_, i, const_cast< ::FLAC__StreamMetadata_CueSheet_Track*>(track.get_track()), /*copy=*/true);
1096 bool CueSheet::insert_track(unsigned i, const CueSheet::Track &track)
1098 FLAC__ASSERT(is_valid());
1099 FLAC__ASSERT(i <= object_->data.cue_sheet.num_tracks);
1100 // We can safely const_cast since copy=true
1101 return (bool)::FLAC__metadata_object_cuesheet_insert_track(object_, i, const_cast< ::FLAC__StreamMetadata_CueSheet_Track*>(track.get_track()), /*copy=*/true);
1104 bool CueSheet::insert_blank_track(unsigned i)
1106 FLAC__ASSERT(is_valid());
1107 FLAC__ASSERT(i <= object_->data.cue_sheet.num_tracks);
1108 return (bool)::FLAC__metadata_object_cuesheet_insert_blank_track(object_, i);
1111 bool CueSheet::delete_track(unsigned i)
1113 FLAC__ASSERT(is_valid());
1114 FLAC__ASSERT(i < object_->data.cue_sheet.num_tracks);
1115 return (bool)::FLAC__metadata_object_cuesheet_delete_track(object_, i);
1118 bool CueSheet::is_legal(bool check_cd_da_subset, const char **violation) const
1120 FLAC__ASSERT(is_valid());
1121 return (bool)::FLAC__metadata_object_cuesheet_is_legal(object_, check_cd_da_subset, violation);
1124 FLAC__uint32 CueSheet::calculate_cddb_id() const
1126 FLAC__ASSERT(is_valid());
1127 return ::FLAC__metadata_object_cuesheet_calculate_cddb_id(object_);
1136 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_PICTURE), /*copy=*/false)
1142 ::FLAC__StreamMetadata_Picture_Type Picture::get_type() const
1144 FLAC__ASSERT(is_valid());
1145 return object_->data.picture.type;
1148 const char *Picture::get_mime_type() const
1150 FLAC__ASSERT(is_valid());
1151 return object_->data.picture.mime_type;
1154 const FLAC__byte *Picture::get_description() const
1156 FLAC__ASSERT(is_valid());
1157 return object_->data.picture.description;
1160 FLAC__uint32 Picture::get_width() const
1162 FLAC__ASSERT(is_valid());
1163 return object_->data.picture.width;
1166 FLAC__uint32 Picture::get_height() const
1168 FLAC__ASSERT(is_valid());
1169 return object_->data.picture.height;
1172 FLAC__uint32 Picture::get_depth() const
1174 FLAC__ASSERT(is_valid());
1175 return object_->data.picture.depth;
1178 FLAC__uint32 Picture::get_colors() const
1180 FLAC__ASSERT(is_valid());
1181 return object_->data.picture.colors;
1184 FLAC__uint32 Picture::get_data_length() const
1186 FLAC__ASSERT(is_valid());
1187 return object_->data.picture.data_length;
1190 const FLAC__byte *Picture::get_data() const
1192 FLAC__ASSERT(is_valid());
1193 return object_->data.picture.data;
1196 void Picture::set_type(::FLAC__StreamMetadata_Picture_Type type)
1198 FLAC__ASSERT(is_valid());
1199 object_->data.picture.type = type;
1202 bool Picture::set_mime_type(const char *string)
1204 FLAC__ASSERT(is_valid());
1205 // We can safely const_cast since copy=true
1206 return (bool)::FLAC__metadata_object_picture_set_mime_type(object_, const_cast<char*>(string), /*copy=*/true);
1209 bool Picture::set_description(const FLAC__byte *string)
1211 FLAC__ASSERT(is_valid());
1212 // We can safely const_cast since copy=true
1213 return (bool)::FLAC__metadata_object_picture_set_description(object_, const_cast<FLAC__byte*>(string), /*copy=*/true);
1216 void Picture::set_width(FLAC__uint32 value) const
1218 FLAC__ASSERT(is_valid());
1219 object_->data.picture.width = value;
1222 void Picture::set_height(FLAC__uint32 value) const
1224 FLAC__ASSERT(is_valid());
1225 object_->data.picture.height = value;
1228 void Picture::set_depth(FLAC__uint32 value) const
1230 FLAC__ASSERT(is_valid());
1231 object_->data.picture.depth = value;
1234 void Picture::set_colors(FLAC__uint32 value) const
1236 FLAC__ASSERT(is_valid());
1237 object_->data.picture.colors = value;
1240 bool Picture::set_data(const FLAC__byte *data, FLAC__uint32 data_length)
1242 FLAC__ASSERT(is_valid());
1243 // We can safely const_cast since copy=true
1244 return (bool)::FLAC__metadata_object_picture_set_data(object_, const_cast<FLAC__byte*>(data), data_length, /*copy=*/true);
1247 bool Picture::is_legal(const char **violation)
1249 FLAC__ASSERT(is_valid());
1250 return (bool)::FLAC__metadata_object_picture_is_legal(object_, violation);
1259 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_APPLICATION), /*copy=*/false)
1265 const FLAC__byte *Unknown::get_data() const
1267 FLAC__ASSERT(is_valid());
1268 return object_->data.application.data;
1271 bool Unknown::set_data(const FLAC__byte *data, unsigned length)
1273 FLAC__ASSERT(is_valid());
1274 return (bool)::FLAC__metadata_object_application_set_data(object_, (FLAC__byte*)data, length, true);
1277 bool Unknown::set_data(FLAC__byte *data, unsigned length, bool copy)
1279 FLAC__ASSERT(is_valid());
1280 return (bool)::FLAC__metadata_object_application_set_data(object_, data, length, copy);
1284 // ============================================================
1288 // ============================================================
1290 FLACPP_API bool get_streaminfo(const char *filename, StreamInfo &streaminfo)
1292 FLAC__ASSERT(0 != filename);
1294 ::FLAC__StreamMetadata object;
1296 if(::FLAC__metadata_get_streaminfo(filename, &object)) {
1297 streaminfo = object;
1304 FLACPP_API bool get_tags(const char *filename, VorbisComment *&tags)
1306 FLAC__ASSERT(0 != filename);
1308 ::FLAC__StreamMetadata *object;
1312 if(::FLAC__metadata_get_tags(filename, &object)) {
1313 tags = new VorbisComment(object, /*copy=*/false);
1320 FLACPP_API bool get_tags(const char *filename, VorbisComment &tags)
1322 FLAC__ASSERT(0 != filename);
1324 ::FLAC__StreamMetadata *object;
1326 if(::FLAC__metadata_get_tags(filename, &object)) {
1327 tags.assign(object, /*copy=*/false);
1334 FLACPP_API bool get_cuesheet(const char *filename, CueSheet *&cuesheet)
1336 FLAC__ASSERT(0 != filename);
1338 ::FLAC__StreamMetadata *object;
1342 if(::FLAC__metadata_get_cuesheet(filename, &object)) {
1343 cuesheet = new CueSheet(object, /*copy=*/false);
1350 FLACPP_API bool get_cuesheet(const char *filename, CueSheet &cuesheet)
1352 FLAC__ASSERT(0 != filename);
1354 ::FLAC__StreamMetadata *object;
1356 if(::FLAC__metadata_get_cuesheet(filename, &object)) {
1357 cuesheet.assign(object, /*copy=*/false);
1364 FLACPP_API bool get_picture(const char *filename, Picture *&picture, ::FLAC__StreamMetadata_Picture_Type type, const char *mime_type, const FLAC__byte *description, unsigned max_width, unsigned max_height, unsigned max_depth, unsigned max_colors)
1366 FLAC__ASSERT(0 != filename);
1368 ::FLAC__StreamMetadata *object;
1372 if(::FLAC__metadata_get_picture(filename, &object, type, mime_type, description, max_width, max_height, max_depth, max_colors)) {
1373 picture = new Picture(object, /*copy=*/false);
1380 FLACPP_API bool get_picture(const char *filename, Picture &picture, ::FLAC__StreamMetadata_Picture_Type type, const char *mime_type, const FLAC__byte *description, unsigned max_width, unsigned max_height, unsigned max_depth, unsigned max_colors)
1382 FLAC__ASSERT(0 != filename);
1384 ::FLAC__StreamMetadata *object;
1386 if(::FLAC__metadata_get_picture(filename, &object, type, mime_type, description, max_width, max_height, max_depth, max_colors)) {
1387 picture.assign(object, /*copy=*/false);
1395 // ============================================================
1399 // ============================================================
1401 SimpleIterator::SimpleIterator():
1402 iterator_(::FLAC__metadata_simple_iterator_new())
1405 SimpleIterator::~SimpleIterator()
1410 void SimpleIterator::clear()
1413 FLAC__metadata_simple_iterator_delete(iterator_);
1417 bool SimpleIterator::init(const char *filename, bool read_only, bool preserve_file_stats)
1419 FLAC__ASSERT(0 != filename);
1420 FLAC__ASSERT(is_valid());
1421 return (bool)::FLAC__metadata_simple_iterator_init(iterator_, filename, read_only, preserve_file_stats);
1424 bool SimpleIterator::is_valid() const
1426 return 0 != iterator_;
1429 SimpleIterator::Status SimpleIterator::status()
1431 FLAC__ASSERT(is_valid());
1432 return Status(::FLAC__metadata_simple_iterator_status(iterator_));
1435 bool SimpleIterator::is_writable() const
1437 FLAC__ASSERT(is_valid());
1438 return (bool)::FLAC__metadata_simple_iterator_is_writable(iterator_);
1441 bool SimpleIterator::next()
1443 FLAC__ASSERT(is_valid());
1444 return (bool)::FLAC__metadata_simple_iterator_next(iterator_);
1447 bool SimpleIterator::prev()
1449 FLAC__ASSERT(is_valid());
1450 return (bool)::FLAC__metadata_simple_iterator_prev(iterator_);
1454 bool SimpleIterator::is_last() const
1456 FLAC__ASSERT(is_valid());
1457 return (bool)::FLAC__metadata_simple_iterator_is_last(iterator_);
1461 off_t SimpleIterator::get_block_offset() const
1463 FLAC__ASSERT(is_valid());
1464 return ::FLAC__metadata_simple_iterator_get_block_offset(iterator_);
1467 ::FLAC__MetadataType SimpleIterator::get_block_type() const
1469 FLAC__ASSERT(is_valid());
1470 return ::FLAC__metadata_simple_iterator_get_block_type(iterator_);
1474 unsigned SimpleIterator::get_block_length() const
1476 FLAC__ASSERT(is_valid());
1477 return ::FLAC__metadata_simple_iterator_get_block_length(iterator_);
1481 bool SimpleIterator::get_application_id(FLAC__byte *id)
1483 FLAC__ASSERT(is_valid());
1484 return (bool)::FLAC__metadata_simple_iterator_get_application_id(iterator_, id);
1487 Prototype *SimpleIterator::get_block()
1489 FLAC__ASSERT(is_valid());
1490 return local::construct_block(::FLAC__metadata_simple_iterator_get_block(iterator_));
1493 bool SimpleIterator::set_block(Prototype *block, bool use_padding)
1495 FLAC__ASSERT(0 != block);
1496 FLAC__ASSERT(is_valid());
1497 return (bool)::FLAC__metadata_simple_iterator_set_block(iterator_, block->object_, use_padding);
1500 bool SimpleIterator::insert_block_after(Prototype *block, bool use_padding)
1502 FLAC__ASSERT(0 != block);
1503 FLAC__ASSERT(is_valid());
1504 return (bool)::FLAC__metadata_simple_iterator_insert_block_after(iterator_, block->object_, use_padding);
1507 bool SimpleIterator::delete_block(bool use_padding)
1509 FLAC__ASSERT(is_valid());
1510 return (bool)::FLAC__metadata_simple_iterator_delete_block(iterator_, use_padding);
1514 // ============================================================
1518 // ============================================================
1521 chain_(::FLAC__metadata_chain_new())
1532 FLAC__metadata_chain_delete(chain_);
1536 bool Chain::is_valid() const
1541 Chain::Status Chain::status()
1543 FLAC__ASSERT(is_valid());
1544 return Status(::FLAC__metadata_chain_status(chain_));
1547 bool Chain::read(const char *filename, bool is_ogg)
1549 FLAC__ASSERT(0 != filename);
1550 FLAC__ASSERT(is_valid());
1552 (bool)::FLAC__metadata_chain_read_ogg(chain_, filename) :
1553 (bool)::FLAC__metadata_chain_read(chain_, filename)
1557 bool Chain::read(FLAC__IOHandle handle, ::FLAC__IOCallbacks callbacks, bool is_ogg)
1559 FLAC__ASSERT(is_valid());
1561 (bool)::FLAC__metadata_chain_read_ogg_with_callbacks(chain_, handle, callbacks) :
1562 (bool)::FLAC__metadata_chain_read_with_callbacks(chain_, handle, callbacks)
1566 bool Chain::check_if_tempfile_needed(bool use_padding)
1568 FLAC__ASSERT(is_valid());
1569 return (bool)::FLAC__metadata_chain_check_if_tempfile_needed(chain_, use_padding);
1572 bool Chain::write(bool use_padding, bool preserve_file_stats)
1574 FLAC__ASSERT(is_valid());
1575 return (bool)::FLAC__metadata_chain_write(chain_, use_padding, preserve_file_stats);
1578 bool Chain::write(bool use_padding, ::FLAC__IOHandle handle, ::FLAC__IOCallbacks callbacks)
1580 FLAC__ASSERT(is_valid());
1581 return (bool)::FLAC__metadata_chain_write_with_callbacks(chain_, use_padding, handle, callbacks);
1584 bool Chain::write(bool use_padding, ::FLAC__IOHandle handle, ::FLAC__IOCallbacks callbacks, ::FLAC__IOHandle temp_handle, ::FLAC__IOCallbacks temp_callbacks)
1586 FLAC__ASSERT(is_valid());
1587 return (bool)::FLAC__metadata_chain_write_with_callbacks_and_tempfile(chain_, use_padding, handle, callbacks, temp_handle, temp_callbacks);
1590 void Chain::merge_padding()
1592 FLAC__ASSERT(is_valid());
1593 ::FLAC__metadata_chain_merge_padding(chain_);
1596 void Chain::sort_padding()
1598 FLAC__ASSERT(is_valid());
1599 ::FLAC__metadata_chain_sort_padding(chain_);
1603 Iterator::Iterator():
1604 iterator_(::FLAC__metadata_iterator_new())
1607 Iterator::~Iterator()
1612 void Iterator::clear()
1615 FLAC__metadata_iterator_delete(iterator_);
1619 bool Iterator::is_valid() const
1621 return 0 != iterator_;
1624 void Iterator::init(Chain &chain)
1626 FLAC__ASSERT(is_valid());
1627 FLAC__ASSERT(chain.is_valid());
1628 ::FLAC__metadata_iterator_init(iterator_, chain.chain_);
1631 bool Iterator::next()
1633 FLAC__ASSERT(is_valid());
1634 return (bool)::FLAC__metadata_iterator_next(iterator_);
1637 bool Iterator::prev()
1639 FLAC__ASSERT(is_valid());
1640 return (bool)::FLAC__metadata_iterator_prev(iterator_);
1643 ::FLAC__MetadataType Iterator::get_block_type() const
1645 FLAC__ASSERT(is_valid());
1646 return ::FLAC__metadata_iterator_get_block_type(iterator_);
1649 Prototype *Iterator::get_block()
1651 FLAC__ASSERT(is_valid());
1652 Prototype *block = local::construct_block(::FLAC__metadata_iterator_get_block(iterator_));
1654 block->set_reference(true);
1658 bool Iterator::set_block(Prototype *block)
1660 FLAC__ASSERT(0 != block);
1661 FLAC__ASSERT(is_valid());
1662 bool ret = (bool)::FLAC__metadata_iterator_set_block(iterator_, block->object_);
1664 block->set_reference(true);
1670 bool Iterator::delete_block(bool replace_with_padding)
1672 FLAC__ASSERT(is_valid());
1673 return (bool)::FLAC__metadata_iterator_delete_block(iterator_, replace_with_padding);
1676 bool Iterator::insert_block_before(Prototype *block)
1678 FLAC__ASSERT(0 != block);
1679 FLAC__ASSERT(is_valid());
1680 bool ret = (bool)::FLAC__metadata_iterator_insert_block_before(iterator_, block->object_);
1682 block->set_reference(true);
1688 bool Iterator::insert_block_after(Prototype *block)
1690 FLAC__ASSERT(0 != block);
1691 FLAC__ASSERT(is_valid());
1692 bool ret = (bool)::FLAC__metadata_iterator_insert_block_after(iterator_, block->object_);
1694 block->set_reference(true);