![]() |
|
#include <trueaudiofile.h>
Public Types | |
enum | TagTypes { NoTags = 0x0000, ID3v1 = 0x0001, ID3v2 = 0x0002, AllTags = 0xffff } |
Public Member Functions | |
File (FileName file, bool readProperties=true, Properties::ReadStyle propertiesStyle=Properties::Average) | |
File (FileName file, ID3v2::FrameFactory *frameFactory, bool readProperties=true, Properties::ReadStyle propertiesStyle=Properties::Average) | |
File (IOStream *stream, bool readProperties=true, Properties::ReadStyle propertiesStyle=Properties::Average) | |
File (IOStream *stream, ID3v2::FrameFactory *frameFactory, bool readProperties=true, Properties::ReadStyle propertiesStyle=Properties::Average) | |
virtual | ~File () |
virtual TagLib::Tag * | tag () const |
PropertyMap | properties () const |
PropertyMap | setProperties (const PropertyMap &) |
void | removeUnsupportedProperties (const StringList &properties) |
virtual Properties * | audioProperties () const |
void | setID3v2FrameFactory (const ID3v2::FrameFactory *factory) |
virtual bool | save () |
ID3v1::Tag * | ID3v1Tag (bool create=false) |
ID3v2::Tag * | ID3v2Tag (bool create=false) |
void | strip (int tags=AllTags) |
bool | hasID3v1Tag () const |
bool | hasID3v2Tag () const |
This implements and provides an interface for TrueAudio 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 TrueAudio files.
TagLib::TrueAudio::File::File | ( | FileName | file, | |
bool | readProperties = true , |
|||
Properties::ReadStyle | propertiesStyle = Properties::Average | |||
) |
Constructs a TrueAudio file from file. If readProperties is true the file's audio properties will also be read.
TagLib::TrueAudio::File::File | ( | FileName | file, | |
ID3v2::FrameFactory * | frameFactory, | |||
bool | readProperties = true , |
|||
Properties::ReadStyle | propertiesStyle = Properties::Average | |||
) |
TagLib::TrueAudio::File::File | ( | IOStream * | stream, | |
bool | readProperties = true , |
|||
Properties::ReadStyle | propertiesStyle = Properties::Average | |||
) |
TagLib::TrueAudio::File::File | ( | IOStream * | stream, | |
ID3v2::FrameFactory * | frameFactory, | |||
bool | readProperties = true , |
|||
Properties::ReadStyle | propertiesStyle = Properties::Average | |||
) |
Constructs a TrueAudio file from stream. If readProperties is true the file's audio properties will also be read.
virtual TagLib::TrueAudio::File::~File | ( | ) | [virtual] |
Destroys this instance of the File.
Reimplemented from TagLib::File.
virtual TagLib::Tag* TagLib::TrueAudio::File::tag | ( | ) | const [virtual] |
Returns the Tag for this file.
Implements TagLib::File.
PropertyMap TagLib::TrueAudio::File::properties | ( | ) | const |
Implements the unified property interface -- export function. If the file contains both ID3v1 and v2 tags, only ID3v2 will be converted to the PropertyMap.
Reimplemented from TagLib::File.
PropertyMap TagLib::TrueAudio::File::setProperties | ( | const PropertyMap & | ) |
Implements the unified property interface -- import function. Creates in ID3v2 tag if necessary. If an ID3v1 tag exists, it will be updated as well, within the limitations of ID3v1.
Reimplemented from TagLib::File.
void TagLib::TrueAudio::File::removeUnsupportedProperties | ( | const StringList & | properties | ) |
Removes unsupported properties, or a subset of them, from the file's metadata. The parameter properties must contain only entries from properties().unsupportedData(). BIC: Will be mad virtual in future releases.
Reimplemented from TagLib::File.
virtual Properties* TagLib::TrueAudio::File::audioProperties | ( | ) | const [virtual] |
Returns the TrueAudio::Properties for this file. If no audio properties were read then this will return a null pointer.
Implements TagLib::File.
void TagLib::TrueAudio::File::setID3v2FrameFactory | ( | const ID3v2::FrameFactory * | factory | ) |
virtual bool TagLib::TrueAudio::File::save | ( | ) | [virtual] |
Saves the file.
Implements TagLib::File.
ID3v1::Tag* TagLib::TrueAudio::File::ID3v1Tag | ( | bool | create = false |
) |
Returns a pointer to the ID3v1 tag of the file.
If create is false (the default) this may return a null pointer if there is no valid ID3v1 tag. If create is true it will create an ID3v1 tag if one does not exist and returns a valid pointer.
The Tag is still owned by the MPEG::File and should not be deleted by the user. It will be deleted when the file (object) is destroyed.
ID3v2::Tag* TagLib::TrueAudio::File::ID3v2Tag | ( | bool | create = false |
) |
Returns a pointer to the ID3v2 tag of the file.
If create is false (the default) this may return a null pointer if there is no valid ID3v2 tag. If create is true it will create an ID3v2 tag if one does not exist and returns a valid pointer.
The Tag is still owned by the MPEG::File and should not be deleted by the user. It will be deleted when the file (object) is destroyed.
void TagLib::TrueAudio::File::strip | ( | int | tags = AllTags |
) |
This will remove the tags that match the OR-ed together TagTypes from the file. By default it removes all tags.
In order to make the removal permanent save() still needs to be called
bool TagLib::TrueAudio::File::hasID3v1Tag | ( | ) | const |
bool TagLib::TrueAudio::File::hasID3v2Tag | ( | ) | const |