Read and write Vorbis (Xiph) tags in a FLAC file. More...

#include <metaioflacvorbis.h>

Inheritance diagram for MetaIOFLACVorbis:

Collaboration diagram for MetaIOFLACVorbis:

Public Member Functions
	MetaIOFLACVorbis (void)

virtual	~MetaIOFLACVorbis (void)

bool	write (const QString &filename, MusicMetadata *mdata)
	Writes all metadata back to a file. More...

bool	writeAlbumArt (const QString &filename, const AlbumArtImage *albumart)
	Write the albumart image to the file. More...

bool	removeAlbumArt (const QString &filename, const AlbumArtImage *albumart)
	Remove the albumart image from the file. More...

MusicMetadata *	read (const QString &filename)
	Reads MusicMetadata from a file. More...

AlbumArtList	getAlbumArtList (const QString &filename)
	Read the albumart images from the file. More...

QImage *	getAlbumArt (const QString &filename, ImageType type)
	Read the albumart image from the file. More...

bool	supportsEmbeddedImages (void)
	Does the tag support embedded cover art. More...

bool	changeImageType (const QString &filename, const AlbumArtImage *albumart, ImageType newType)

virtual bool	TagExists (const QString &filename)

Public Member Functions inherited from MetaIOTagLib
	MetaIOTagLib (void)

virtual	~MetaIOTagLib (void)

Public Member Functions inherited from MetaIO
	MetaIO (void)
	Constructor. More...

virtual	~MetaIO (void)
	Destructor. More...

virtual bool	writeVolatileMetadata (const QString &filename, MusicMetadata *mdata)
	Writes rating and playcount back to a file. More...

void	readFromFilename (const QString &filename, QString &artist, QString &album, QString &title, QString &genre, int &tracknum)
	Reads MusicMetadata based on the folder/filename. More...

MusicMetadata *	readFromFilename (const QString &filename, bool blnLength=false)
	Reads MusicMetadata based on the folder/filename. More...

void	readFromFilename (MusicMetadata *metadata)
	Reads MusicMetadata based on the folder/filename. More...

Private Member Functions
TagLib::FLAC::File *	OpenFile (const QString &filename)
	Open the file to read the tag. More...

TagLib::FLAC::Picture *	getPictureFromFile (TagLib::FLAC::File *flacfile, ImageType type)

TagLib::FLAC::Picture::Type	PictureTypeFromImageType (ImageType itype)

QString	getExtFromMimeType (const QString &mimeType)

Additional Inherited Members
Static Public Member Functions inherited from MetaIO
static MetaIO *	createTagger (const QString &filename)
	Finds an appropriate tagger for the given file. More...

static MusicMetadata *	readMetadata (const QString &filename)
	Read the metadata from `filename` directly. More...

static MusicMetadata *	getMetadata (const QString &filename)
	Get the metadata for `filename`. More...

Static Public Attributes inherited from MetaIO
static const QString	ValidFileExtensions

Protected Member Functions inherited from MetaIOTagLib
int	getTrackLength (TagLib::File *file)
	Find the length of the track (in seconds) More...

int	getTrackLength (const QString &filename)
	Find the length of the track (in seconds) More...

void	ReadGenericMetadata (TagLib::Tag tag, MusicMetadata metadata)
	Writes metadata common to all tag formats to the tag. More...

void	WriteGenericMetadata (TagLib::Tag tag, const MusicMetadata metadata)
	Writes metadata common to all tag formats to the tag. More...

Protected Member Functions inherited from MetaIO
void	saveTimeStamps (void)

void	restoreTimeStamps (void)

Protected Attributes inherited from MetaIO
QString	m_filename

QString	m_filenameFormat

struct stat	m_fileinfo

Detailed Description

Read and write Vorbis (Xiph) tags in a FLAC file.

Definition at line 21 of file metaioflacvorbis.h.

Constructor & Destructor Documentation

◆ MetaIOFLACVorbis()

MetaIOFLACVorbis::MetaIOFLACVorbis ( void )

Definition at line 16 of file metaioflacvorbis.cpp.

◆ ~MetaIOFLACVorbis()

MetaIOFLACVorbis::~MetaIOFLACVorbis ( void )

virtual

Definition at line 21 of file metaioflacvorbis.cpp.

Member Function Documentation

◆ write()

bool MetaIOFLACVorbis::write	(	const QString &	filename,
		MusicMetadata *	mdata
	)

virtual

Writes all metadata back to a file.

Parameters

filename	The filename to write metadata to
mdata	A pointer to a MusicMetadata object

Returns: Boolean to indicate success/failure.

Implements MetaIOTagLib.

Definition at line 50 of file metaioflacvorbis.cpp.

Referenced by FlacEncoder::~FlacEncoder().

◆ writeAlbumArt()

bool MetaIOFLACVorbis::writeAlbumArt	(	const QString &	filename,
		const AlbumArtImage *	albumart
	)

virtual

Write the albumart image to the file.

Parameters

filename	The music file to add the albumart
albumart	The Album Art image to write

Returns: True if successful

Note: We always save the image in JPEG format

Reimplemented from MetaIO.

Definition at line 343 of file metaioflacvorbis.cpp.

◆ removeAlbumArt()

bool MetaIOFLACVorbis::removeAlbumArt	(	const QString &	filename,
		const AlbumArtImage *	albumart
	)

virtual

Remove the albumart image from the file.

Parameters

filename	The music file to remove the albumart
albumart	The Album Art image to remove

Returns: True if successful

Reimplemented from MetaIO.

Definition at line 420 of file metaioflacvorbis.cpp.

◆ read()

MusicMetadata * MetaIOFLACVorbis::read ( const QString & filename )

virtual

Reads MusicMetadata from a file.

Parameters

filename The filename to read metadata from.

Returns: MusicMetadata pointer or NULL on error

Implements MetaIOTagLib.

Definition at line 108 of file metaioflacvorbis.cpp.

◆ getAlbumArtList()

AlbumArtList MetaIOFLACVorbis::getAlbumArtList ( const QString & filename )

virtual

Read the albumart images from the file.

Parameters

filename The filename for which we want to find the images.

Reimplemented from MetaIO.

Definition at line 256 of file metaioflacvorbis.cpp.

◆ getAlbumArt()

QImage * MetaIOFLACVorbis::getAlbumArt	(	const QString &	filename,
		ImageType	type
	)

virtual

Read the albumart image from the file.

Parameters

filename	The filename for which we want to find the albumart.
type	The type of image we want - front/back etc

Returns: A pointer to a QImage owned by the caller or NULL if not found.

Reimplemented from MetaIO.

Definition at line 165 of file metaioflacvorbis.cpp.

◆ supportsEmbeddedImages()

bool MetaIOFLACVorbis::supportsEmbeddedImages ( void )

inlinevirtual

Does the tag support embedded cover art.

Returns: true if reading/writing embedded images are supported

Reimplemented from MetaIO.

Definition at line 35 of file metaioflacvorbis.h.

◆ changeImageType()

bool MetaIOFLACVorbis::changeImageType	(	const QString &	filename,
		const AlbumArtImage *	albumart,
		ImageType	newType
	)

virtual

Reimplemented from MetaIO.

Definition at line 465 of file metaioflacvorbis.cpp.

◆ TagExists()

bool MetaIOFLACVorbis::TagExists ( const QString & filename )

virtual

Reimplemented from MetaIO.

Definition at line 506 of file metaioflacvorbis.cpp.

Referenced by MetaIO::createTagger().

◆ OpenFile()

TagLib::FLAC::File * MetaIOFLACVorbis::OpenFile ( const QString & filename )

private

Open the file to read the tag.

Parameters

filename The filename

Returns: A taglib file object for this format

Definition at line 31 of file metaioflacvorbis.cpp.

Referenced by changeImageType(), getAlbumArt(), getAlbumArtList(), read(), removeAlbumArt(), TagExists(), write(), and writeAlbumArt().

◆ getPictureFromFile()

TagLib::FLAC::Picture * MetaIOFLACVorbis::getPictureFromFile	(	TagLib::FLAC::File *	flacfile,
		ImageType	type
	)

private

Definition at line 190 of file metaioflacvorbis.cpp.

Referenced by changeImageType(), getAlbumArt(), removeAlbumArt(), and writeAlbumArt().

◆ PictureTypeFromImageType()

TagLib::FLAC::Picture::Type MetaIOFLACVorbis::PictureTypeFromImageType ( ImageType itype )

private

Definition at line 220 of file metaioflacvorbis.cpp.

Referenced by changeImageType(), getPictureFromFile(), and writeAlbumArt().

◆ getExtFromMimeType()

QString MetaIOFLACVorbis::getExtFromMimeType ( const QString & mimeType )

private

Definition at line 524 of file metaioflacvorbis.cpp.

Referenced by getAlbumArtList().

The documentation for this class was generated from the following files:

Public Member Functions

Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ MetaIOFLACVorbis()

◆ ~MetaIOFLACVorbis()

Member Function Documentation

◆ write()

◆ writeAlbumArt()

◆ removeAlbumArt()

◆ read()

◆ getAlbumArtList()

◆ getAlbumArt()

◆ supportsEmbeddedImages()

◆ changeImageType()

◆ TagExists()

◆ OpenFile()

◆ getPictureFromFile()

◆ PictureTypeFromImageType()

◆ getExtFromMimeType()