Qmmp
Loading...
Searching...
No Matches
Public Member Functions | Static Public Member Functions | List of all members
MetaDataManager Class Reference

#include <metadatamanager.h>

Public Member Functions

QList< TrackInfo * > createPlayList (const QString &path, TrackInfo::Parts parts=TrackInfo::AllParts, QStringList *ignoredPaths=nullptr) const
 
MetaDataModelcreateMetaDataModel (const QString &url, bool readOnly) const
 
QStringList filters () const
 
QStringList nameFilters () const
 
QStringList protocols () const
 
QList< QRegularExpression > regExps () const
 
bool supports (const QString &file) const
 
QPixmap getCover (const QString &url) const
 
QString getCoverPath (const QString &url) const
 
QString findCoverFile (const QString &fileName) const
 
void clearCoverCache ()
 
void prepareForAnotherThread ()
 

Static Public Member Functions

static bool hasMatch (const QList< QRegularExpression > &regExps, const QString &path)
 
static MetaDataManagerinstance ()
 

Detailed Description

The MetaDataManager class is the base class for metadata access.

Author
Ilya Kotov forko.nosp@m.tov0.nosp@m.2@ya..nosp@m.ru

Member Function Documentation

◆ clearCoverCache()

void clearCoverCache ( )

Clears cover path cache.

◆ createMetaDataModel()

MetaDataModel * createMetaDataModel ( const QString & url,
bool readOnly ) const

Creats metadata object, which provides full access to file tags.

Parameters
urlFile path or URL.
readOnlyOpen file in read-only mode (true - enabled, false - disable).
Returns
MetaDataModel pointer or null pointer.

◆ createPlayList()

QList< TrackInfo * > createPlayList ( const QString & path,
TrackInfo::Parts parts = TrackInfo::AllParts,
QStringList * ignoredPaths = nullptr ) const

Extracts metadata and audio information from file path and returns a list of FileInfo items. One file may contain several playlist items (for example: cda disk or flac with embedded cue)

Parameters
pathLocal file path or URL.
partsparts of metadata which should be extracted from file.
ignoredPathsPointer to a list of the files which should be ignored by the recursive search (useful to exclude cue data files from playlist)

◆ filters()

QStringList filters ( ) const

Returns a list of file name filters with description, i.e. "MPEG Files (*.mp3 *.mpg)"

◆ findCoverFile()

QString findCoverFile ( const QString & fileName) const

Returns the cover file path for the given local audio file, or returns an empty string if the cover file is not available. Unlike getCover and getCoverPath this function provides simple file search (without cache) and should be used inside MetaDataModel reimplementation.

Parameters
fileNamePath of the local audio file.

◆ getCover()

QPixmap getCover ( const QString & url) const

Returns the cover pixmap for the given file url, or returns an empty pixmap if cover is not available. IMPORTANT: to avoid infinite recursion, do not use this function inside MetaDataModel reimplementation.

◆ getCoverPath()

QString getCoverPath ( const QString & url) const

Returns the cover file path for the given file url, or returns an empty string if the cover file is not available. This function does not work with embedded covers. IMPORTANT: to avoid infinite recursion, do not use this function inside MetaDataModel reimplementation.

◆ hasMatch()

static bool hasMatch ( const QList< QRegularExpression > & regExps,
const QString & path )
static

Returns true if the one regular expression in the list regExps matched against the path or false otherwise.

◆ instance()

static MetaDataManager * instance ( )
static

Returns a pointer to the MetaDataManager instance.

◆ nameFilters()

QStringList nameFilters ( ) const

Returns a list of file name filters, i.e. "*.mp3 *.mpg".

◆ prepareForAnotherThread()

void prepareForAnotherThread ( )

Prepares object for usage by another thread to avoid warnings about parent from the different thread

◆ protocols()

QStringList protocols ( ) const

Returns a list of the suported protocols

◆ regExps()

QList< QRegularExpression > regExps ( ) const

Returns a list of supported regular expressions for URL.

◆ supports()

bool supports ( const QString & file) const

Returns true if file is supported and exists, otherwise returns false


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