TagLib
2.1
|
An implementation of TagLib::File with DSDIFF specific methods. More...
#include <dsdifffile.h>
Public Types | |
enum | TagTypes { NoTags = 0x0000 , DIIN = 0x0001 , ID3v2 = 0x0002 , AllTags = 0xffff } |
Public Types inherited from TagLib::File | |
enum | Position { Beginning , Current , End } |
enum | StripTags { StripNone , StripOthers } |
enum | DuplicateTags { Duplicate , DoNotDuplicate } |
Public Member Functions | |
File (FileName file, bool readProperties=true, Properties::ReadStyle propertiesStyle=Properties::Average, ID3v2::FrameFactory *frameFactory=nullptr) | |
File (IOStream *stream, bool readProperties=true, Properties::ReadStyle propertiesStyle=Properties::Average, ID3v2::FrameFactory *frameFactory=nullptr) | |
~File () override | |
Tag * | tag () const override |
ID3v2::Tag * | ID3v2Tag (bool create=false) const |
DSDIFF::DIIN::Tag * | DIINTag (bool create=false) const |
PropertyMap | properties () const override |
void | removeUnsupportedProperties (const StringList &properties) override |
PropertyMap | setProperties (const PropertyMap &) override |
Properties * | audioProperties () const override |
bool | save () override |
bool | save (int tags, StripTags strip=StripOthers, ID3v2::Version version=ID3v2::v4) |
void | strip (int tags=AllTags) |
bool | hasID3v2Tag () const |
bool | hasDIINTag () const |
Public Member Functions inherited from TagLib::File | |
File (const File &)=delete | |
File & | operator= (const File &)=delete |
FileName | name () const |
virtual StringList | complexPropertyKeys () const |
virtual List< VariantMap > | complexProperties (const String &key) const |
virtual bool | setComplexProperties (const String &key, const List< VariantMap > &value) |
ByteVector | readBlock (size_t length) |
void | writeBlock (const ByteVector &data) |
offset_t | find (const ByteVector &pattern, offset_t fromOffset=0, const ByteVector &before=ByteVector()) |
offset_t | rfind (const ByteVector &pattern, offset_t fromOffset=0, const ByteVector &before=ByteVector()) |
void | insert (const ByteVector &data, offset_t start=0, size_t replace=0) |
void | removeBlock (offset_t start=0, size_t length=0) |
bool | readOnly () const |
bool | isOpen () const |
bool | isValid () const |
void | seek (offset_t offset, Position p=Beginning) |
void | clear () |
offset_t | tell () const |
offset_t | length () |
Static Public Member Functions | |
static bool | isSupported (IOStream *stream) |
Protected Types | |
enum | Endianness { BigEndian , LittleEndian } |
Additional Inherited Members | |
Protected Member Functions inherited from TagLib::File | |
File (FileName fileName) | |
File (IOStream *stream) | |
void | setValid (bool valid) |
void | truncate (offset_t length) |
Static Protected Member Functions inherited from TagLib::File | |
static unsigned int | bufferSize () |
An implementation of TagLib::File with DSDIFF specific methods.
This implements and provides an interface for DSDIFF files to the TagLib::Tag and TagLib::AudioProperties interfaces by way of implementing the abstract TagLib::File API as well as providing some additional information specific to DSDIFF files.
|
protected |
TagLib::DSDIFF::File::File | ( | FileName | file, |
bool | readProperties = true, | ||
Properties::ReadStyle | propertiesStyle = Properties::Average, | ||
ID3v2::FrameFactory * | frameFactory = nullptr ) |
Constructs a DSDIFF file from file. If readProperties is true
the file's audio properties will also be read.
If this file contains an ID3v2 tag, the frames will be created using frameFactory (default if null).
References TagLib::AudioProperties::Average.
TagLib::DSDIFF::File::File | ( | IOStream * | stream, |
bool | readProperties = true, | ||
Properties::ReadStyle | propertiesStyle = Properties::Average, | ||
ID3v2::FrameFactory * | frameFactory = nullptr ) |
Constructs a DSDIFF file from stream. If readProperties is true
the file's audio properties will also be read.
If this file contains an ID3v2 tag, the frames will be created using frameFactory (default if null).
References TagLib::AudioProperties::Average.
|
overridevirtual |
Destroys this instance of the File.
Reimplemented from TagLib::File.
|
overridevirtual |
Returns the AIFF::Properties for this file. If no audio properties were read then this will return a null pointer.
Implements TagLib::File.
DSDIFF::DIIN::Tag * TagLib::DSDIFF::File::DIINTag | ( | bool | create = false | ) | const |
bool TagLib::DSDIFF::File::hasDIINTag | ( | ) | const |
bool TagLib::DSDIFF::File::hasID3v2Tag | ( | ) | const |
Returns whether or not the file on disk actually has an ID3v2 tag.
ID3v2::Tag * TagLib::DSDIFF::File::ID3v2Tag | ( | bool | create = false | ) | const |
Returns the ID3V2 Tag for this file.
|
static |
Returns whether or not the given stream can be opened as a DSDIFF file.
|
overridevirtual |
Implements the unified property interface – export function. This method forwards to ID3v2::Tag::properties().
Reimplemented from TagLib::File.
Referenced by removeUnsupportedProperties().
|
overridevirtual |
Removes unsupported properties, or a subset of them, from the file's metadata. The parameter properties must contain only entries from properties().unsupportedData().
Reimplemented from TagLib::File.
References properties().
|
overridevirtual |
Save the file. If at least one tag – ID3v1 or DIIN – exists this will duplicate its content into the other tag. This returns true
if saving was successful.
If neither exists or if both tags are empty, this will strip the tags from the file.
This is the same as calling save(AllTags);
If you would like more granular control over the content of the tags, with the concession of generality, use parameterized save call below.
Implements TagLib::File.
bool TagLib::DSDIFF::File::save | ( | int | tags, |
StripTags | strip = StripOthers, | ||
ID3v2::Version | version = ID3v2::v4 ) |
Save the file. If strip is specified, it is possible to choose if tags not specified in tags should be stripped from the file or retained. With version, it is possible to specify whether ID3v2.4 or ID3v2.3 should be used.
References strip(), TagLib::File::StripOthers, and TagLib::ID3v2::v4.
|
overridevirtual |
Implements the unified property interface – import function. This method forwards to ID3v2::Tag::setProperties().
Reimplemented from TagLib::File.
void TagLib::DSDIFF::File::strip | ( | int | tags = AllTags | ) |
|
overridevirtual |
Returns a pointer to a tag that is the union of the ID3v2 and DIIN tags. The ID3v2 tag is given priority in reading the information – if requested information exists in both the ID3v2 tag and the ID3v1 tag, the information from the ID3v2 tag will be returned.
If you would like more granular control over the content of the tags, with the concession of generality, use the tag-type specific calls.
Implements TagLib::File.