TTKMusicPlayer  4.3.0.0
TTKMusicPlayer imitates Kugou UI, the music player uses of qmmp core library based on Qt for windows and linux
Public Member Functions | Private Member Functions | Private Attributes | List of all members
MusicSongMeta Class Reference

The class of the music song meta. More...

#include <musicsongmeta.h>

Public Member Functions

 MusicSongMeta () noexcept
 
 ~MusicSongMeta () noexcept
 
bool read (const QString &url)
 
bool save ()
 
QString filePath () const noexcept
 
QString fileBasePath () noexcept
 
QString fileRelatedPath () noexcept
 
QString artist () noexcept
 
QString title () noexcept
 
QString album () noexcept
 
QString comment () noexcept
 
QString year () noexcept
 
QString trackNum () noexcept
 
QString genre () noexcept
 
QString rating () noexcept
 
QString channel () noexcept
 
QString format () noexcept
 
QString description () noexcept
 
void setArtist (const QString &artist) noexcept
 
void setTitle (const QString &title) noexcept
 
void setAlbum (const QString &album) noexcept
 
void setComment (const QString &comment) noexcept
 
void setYear (const QString &year) noexcept
 
void setTrackNum (const QString &track) noexcept
 
void setGenre (const QString &genre) noexcept
 
void setRating (const QString &rating) noexcept
 
void setCover (const QPixmap &cover)
 
void setCover (const QByteArray &data)
 
QPixmap cover () noexcept
 
QString lyrics () noexcept
 
QString sampleRate () noexcept
 
QString bitrate () noexcept
 
QString duration () noexcept
 
 MusicSongMeta (const MusicSongMeta &other) noexcept
 
 MusicSongMeta (MusicSongMeta &&other) noexcept
 
MusicSongMeta & operator= (const MusicSongMeta &other) noexcept
 
MusicSongMeta & operator= (MusicSongMeta &&other) noexcept
 
void setSongMetaIndex (int index) noexcept
 
int songMetaCount () const noexcept
 

Private Member Functions

void clearSongMeta () noexcept
 
Data * songMeta () noexcept
 
QString formatString (TagMeta::Type type) noexcept
 
bool readInformation ()
 
bool saveInformation ()
 

Private Attributes

int m_offset
 
QString m_path
 
QList< Data * > m_songMetas
 

Detailed Description

The class of the music song meta.

Author
Greedysky greed.nosp@m.ysky.nosp@m.@163..nosp@m.com

Definition at line 30 of file musicsongmeta.h.

Constructor & Destructor Documentation

MusicSongMeta::MusicSongMeta ( )
noexcept

Object constructor.

Definition at line 23 of file musicsongmeta.cpp.

MusicSongMeta::~MusicSongMeta ( )
noexcept

Object destructor.

Definition at line 29 of file musicsongmeta.cpp.

References clearSongMeta().

MusicSongMeta::MusicSongMeta ( const MusicSongMeta &  other)
noexcept

Definition at line 250 of file musicsongmeta.cpp.

References qAsConst.

MusicSongMeta::MusicSongMeta ( MusicSongMeta &&  other)
noexcept

Definition at line 266 of file musicsongmeta.cpp.

Member Function Documentation

QString MusicSongMeta::album ( )
noexcept

Get song album.

Definition at line 97 of file musicsongmeta.cpp.

References TagMeta::ALBUM, and formatString().

Referenced by MusicDownloadMetaDataRequest::downloadFinished(), MusicFileInformationWidget::initialize(), MusicLocalManagerWidget::refreshItems(), and saveInformation().

QString MusicSongMeta::artist ( )
noexcept

Get artist name.

Definition at line 87 of file musicsongmeta.cpp.

References TagMeta::ARTIST, and formatString().

Referenced by MusicDownloadMetaDataRequest::downloadFinished(), TTK::generateSongList(), MusicFileInformationWidget::initialize(), MusicLocalManagerWidget::refreshItems(), MusicSongCheckToolsRenameThread::run(), and saveInformation().

QString MusicSongMeta::bitrate ( )
noexcept

Get song bitrate.

Definition at line 239 of file musicsongmeta.cpp.

References TagMeta::BITRATE, Data::m_metaData, songMeta(), and TTK_DEFAULT_STR.

Referenced by MusicFileInformationWidget::initialize(), MusicSongRingtoneMaker::initInputPath(), readInformation(), MusicSongCheckToolsDuplicateThread::run(), and MusicSongCheckToolsQualityThread::run().

QString MusicSongMeta::channel ( )
noexcept

Get song channel.

Definition at line 133 of file musicsongmeta.cpp.

References TagMeta::CHANNEL, Data::m_metaData, and songMeta().

Referenced by MusicFileInformationWidget::initialize().

void MusicSongMeta::clearSongMeta ( )
privatenoexcept

Clear media song meta.

Definition at line 319 of file musicsongmeta.cpp.

References m_offset, and m_songMetas.

Referenced by readInformation(), and ~MusicSongMeta().

QString MusicSongMeta::comment ( )
noexcept

Get song comment.

Definition at line 102 of file musicsongmeta.cpp.

References TagMeta::COMMENT, Data::m_metaData, and songMeta().

Referenced by MusicDownloadMetaDataRequest::downloadFinished().

QPixmap MusicSongMeta::cover ( )
noexcept

Get song image cover artist.

Definition at line 220 of file musicsongmeta.cpp.

References Data::m_cover, and songMeta().

Referenced by MusicSongsListItemInfoWidget::initialize(), MusicFileInformationWidget::initialize(), MusicSongsListPlayWidget::initialize(), MusicFileInformationWidget::openDynamicImage(), readInformation(), MusicFileInformationWidget::saveAlbumImage(), saveInformation(), and setCover().

QString MusicSongMeta::description ( )
noexcept

Read media description.

Definition at line 143 of file musicsongmeta.cpp.

References TagMeta::DESCRIPTION, Data::m_metaData, and songMeta().

Referenced by MusicFileInformationWidget::initialize(), and readInformation().

QString MusicSongMeta::duration ( )
noexcept

Get song time duration.

Definition at line 245 of file musicsongmeta.cpp.

References TagMeta::LENGTH, Data::m_metaData, and songMeta().

Referenced by TTK::generateNetworkSongTime(), TTK::generateSongList(), MusicFileInformationWidget::initialize(), MusicSongsListPlayWidget::initialize(), and MusicSongRingtoneMaker::initInputPath().

QString MusicSongMeta::fileBasePath ( )
noexcept

Get file url.

Definition at line 77 of file musicsongmeta.cpp.

References Data::m_path, and songMeta().

Referenced by TTK::generateSongList().

QString MusicSongMeta::filePath ( ) const
noexcept

Read media file path.

Definition at line 72 of file musicsongmeta.cpp.

References m_path.

QString MusicSongMeta::fileRelatedPath ( )
noexcept

Get file related path.

Definition at line 82 of file musicsongmeta.cpp.

References Data::m_metaData, songMeta(), and TagMeta::URL.

Referenced by MusicSongsListItemInfoWidget::initialize(), and MusicFileInformationWidget::initialize().

QString MusicSongMeta::format ( )
noexcept

Read media description.

Definition at line 138 of file musicsongmeta.cpp.

References TagMeta::FORMAT, Data::m_metaData, and songMeta().

Referenced by readInformation().

QString MusicSongMeta::formatString ( TagMeta::Type  type)
privatenoexcept

Format legal data string.

Definition at line 337 of file musicsongmeta.cpp.

References TTK::String::charactersReplace().

Referenced by album(), artist(), genre(), rating(), and title().

QString MusicSongMeta::genre ( )
noexcept

Get song genre.

Definition at line 123 of file musicsongmeta.cpp.

References formatString(), and TagMeta::GENRE.

Referenced by MusicFileInformationWidget::initialize(), MusicLocalManagerWidget::refreshItems(), and saveInformation().

QString MusicSongMeta::lyrics ( )
noexcept

Get song lyrics buffer data.

Definition at line 229 of file musicsongmeta.cpp.

References Data::m_lyrics, and songMeta().

Referenced by TTK::generateSongList(), and readInformation().

MusicSongMeta & MusicSongMeta::operator= ( const MusicSongMeta &  other)
noexcept

Definition at line 274 of file musicsongmeta.cpp.

References m_offset, and qAsConst.

MusicSongMeta & MusicSongMeta::operator= ( MusicSongMeta &&  other)
noexcept

Definition at line 291 of file musicsongmeta.cpp.

References m_offset, m_path, m_songMetas, and std::swap().

QString MusicSongMeta::rating ( )
noexcept

Get song rating.

Definition at line 128 of file musicsongmeta.cpp.

References formatString(), and TagMeta::RATING.

Referenced by MusicFileInformationWidget::initialize(), and readInformation().

bool MusicSongMeta::read ( const QString &  url)

Read media file to anaylsis.

Definition at line 34 of file musicsongmeta.cpp.

References MusicFormats::isTrack(), m_path, readInformation(), setSongMetaIndex(), TTK_SEPARATOR, and TTK_WSEPARATOR.

Referenced by MusicDownloadMetaDataRequest::downloadFinished(), TTK::generateNetworkSongTime(), TTK::generateSongList(), MusicSongsListItemInfoWidget::initialize(), MusicFileInformationWidget::initialize(), MusicSongsListPlayWidget::initialize(), MusicSongRingtoneMaker::initInputPath(), MusicFileInformationWidget::openDynamicImage(), MusicLocalManagerWidget::refreshItems(), MusicSongCheckToolsRenameThread::run(), MusicSongCheckToolsDuplicateThread::run(), MusicSongCheckToolsQualityThread::run(), MusicFileInformationWidget::saveAlbumImage(), and MusicFileInformationWidget::saveTag().

bool MusicSongMeta::readInformation ( )
private

Read other taglib not by plugin.

Definition at line 350 of file musicsongmeta.cpp.

References TagMeta::ALBUM, Qmmp::ALBUM, TrackInfo::AllParts, TagMeta::ARTIST, Qmmp::ARTIST, TagMeta::BITRATE, Qmmp::BITRATE, bitrate(), TagMeta::CHANNEL, Qmmp::CHANNELS, clearSongMeta(), TagMeta::COMMENT, Qmmp::COMMENT, MetaDataModel::cover(), cover(), DecoderFactory::createMetaDataModel(), DecoderFactory::createPlayList(), DecoderProperties::description, TagMeta::DESCRIPTION, description(), MetaDataModel::descriptions(), MetaDataModel::extraProperties(), Decoder::findByFilePath(), TagMeta::FORMAT, format(), Qmmp::FORMAT_NAME, TTKTime::formatDuration(), TagMeta::GENRE, Qmmp::GENRE, TagMeta::LENGTH, MetaDataModel::lyrics(), lyrics(), Data::m_metaData, m_offset, Data::m_path, m_path, m_songMetas, DecoderProperties::name, DecoderFactory::properties(), qAsConst, TagMeta::RATING, rating(), TagMeta::SAMPLERATE, Qmmp::SAMPLERATE, DecoderProperties::shortName, SPLITER, TagMeta::TITLE, Qmmp::TITLE, TagMeta::TRACK, Qmmp::TRACK, TTK_LINEFEED, TagMeta::URL, TagMeta::YEAR, and Qmmp::YEAR.

Referenced by read().

QString MusicSongMeta::sampleRate ( )
noexcept

Get song sample rate.

Definition at line 234 of file musicsongmeta.cpp.

References Data::m_metaData, TagMeta::SAMPLERATE, and songMeta().

Referenced by MusicFileInformationWidget::initialize(), and MusicSongRingtoneMaker::initInputPath().

bool MusicSongMeta::save ( )

Save media tags to file.

Definition at line 67 of file musicsongmeta.cpp.

References saveInformation().

Referenced by MusicDownloadMetaDataRequest::downloadFinished(), and MusicFileInformationWidget::saveTag().

bool MusicSongMeta::saveInformation ( )
private

Save other taglib not by plugin.

Definition at line 480 of file musicsongmeta.cpp.

References album(), Qmmp::ALBUM, artist(), Qmmp::ARTIST, cover(), DecoderFactory::createMetaDataModel(), Decoder::findByFilePath(), genre(), Qmmp::GENRE, m_path, MetaDataModel::removeCover(), TagModel::save(), MetaDataModel::setCover(), TagModel::setValue(), MetaDataModel::tags(), title(), Qmmp::TITLE, Qmmp::TRACK, trackNum(), year(), and Qmmp::YEAR.

Referenced by save().

void MusicSongMeta::setAlbum ( const QString &  album)
noexcept

Set song album.

Definition at line 158 of file musicsongmeta.cpp.

References TagMeta::ALBUM.

Referenced by MusicDownloadMetaDataRequest::downloadFinished(), MusicFileInformationWidget::saveTag(), and MusicDownloadWidget::startToRequestMusic().

void MusicSongMeta::setArtist ( const QString &  artist)
noexcept

Set artist name.

Definition at line 148 of file musicsongmeta.cpp.

References TagMeta::ARTIST.

Referenced by MusicDownloadMetaDataRequest::downloadFinished(), MusicFileInformationWidget::saveTag(), and MusicDownloadWidget::startToRequestMusic().

void MusicSongMeta::setComment ( const QString &  comment)
noexcept

Set song comment.

Definition at line 163 of file musicsongmeta.cpp.

References TagMeta::COMMENT.

Referenced by MusicDownloadWidget::startToRequestMusic().

void MusicSongMeta::setCover ( const QPixmap &  cover)

Set song image cover artist.

Definition at line 188 of file musicsongmeta.cpp.

References cover(), Data::m_cover, and songMeta().

Referenced by MusicDownloadMetaDataRequest::downloadFinished(), MusicFileInformationWidget::saveTag(), and setCover().

void MusicSongMeta::setCover ( const QByteArray &  data)

Set song image cover artist.

Definition at line 204 of file musicsongmeta.cpp.

References setCover(), and TTK_ERROR_STREAM.

void MusicSongMeta::setGenre ( const QString &  genre)
noexcept

Set song genre.

Definition at line 178 of file musicsongmeta.cpp.

References TagMeta::GENRE.

Referenced by MusicFileInformationWidget::saveTag().

void MusicSongMeta::setRating ( const QString &  rating)
noexcept

Set song rating.

Definition at line 183 of file musicsongmeta.cpp.

References TagMeta::RATING.

void MusicSongMeta::setSongMetaIndex ( int  index)
noexcept

Set media song meta index offset.

Definition at line 304 of file musicsongmeta.cpp.

Referenced by TTK::generateSongList(), and read().

void MusicSongMeta::setTitle ( const QString &  title)
noexcept

Set song title.

Definition at line 153 of file musicsongmeta.cpp.

References TagMeta::TITLE.

Referenced by MusicDownloadMetaDataRequest::downloadFinished(), MusicFileInformationWidget::saveTag(), and MusicDownloadWidget::startToRequestMusic().

void MusicSongMeta::setTrackNum ( const QString &  track)
noexcept

Set song track number.

Definition at line 173 of file musicsongmeta.cpp.

References TagMeta::TRACK.

Referenced by MusicDownloadMetaDataRequest::downloadFinished(), and MusicDownloadWidget::startToRequestMusic().

void MusicSongMeta::setYear ( const QString &  year)
noexcept

Set song year.

Definition at line 168 of file musicsongmeta.cpp.

References TagMeta::YEAR.

Referenced by MusicDownloadMetaDataRequest::downloadFinished(), MusicFileInformationWidget::saveTag(), and MusicDownloadWidget::startToRequestMusic().

Data * MusicSongMeta::songMeta ( )
privatenoexcept

Get media song meta pointer.

Definition at line 326 of file musicsongmeta.cpp.

References m_offset, m_songMetas, and songMetaCount().

Referenced by bitrate(), channel(), comment(), cover(), description(), duration(), fileBasePath(), fileRelatedPath(), format(), lyrics(), sampleRate(), setCover(), trackNum(), and year().

int MusicSongMeta::songMetaCount ( ) const
noexcept

Get media song meta count.

Definition at line 314 of file musicsongmeta.cpp.

References m_songMetas.

Referenced by TTK::generateSongList(), and songMeta().

QString MusicSongMeta::title ( )
noexcept

Get song title.

Definition at line 92 of file musicsongmeta.cpp.

References formatString(), and TagMeta::TITLE.

Referenced by MusicDownloadMetaDataRequest::downloadFinished(), TTK::generateSongList(), MusicFileInformationWidget::initialize(), MusicLocalManagerWidget::refreshItems(), MusicSongCheckToolsRenameThread::run(), and saveInformation().

QString MusicSongMeta::trackNum ( )
noexcept

Get song track number.

Definition at line 112 of file musicsongmeta.cpp.

References Data::m_metaData, songMeta(), TagMeta::TRACK, and TTK_DEFAULT_STR.

Referenced by MusicDownloadMetaDataRequest::downloadFinished(), MusicFileInformationWidget::initialize(), MusicLocalManagerWidget::refreshItems(), and saveInformation().

QString MusicSongMeta::year ( )
noexcept

Get song year.

Definition at line 107 of file musicsongmeta.cpp.

References Data::m_metaData, songMeta(), and TagMeta::YEAR.

Referenced by MusicDownloadMetaDataRequest::downloadFinished(), MusicFileInformationWidget::initialize(), MusicLocalManagerWidget::refreshItems(), and saveInformation().

Member Data Documentation

int MusicSongMeta::m_offset
private

Definition at line 211 of file musicsongmeta.h.

Referenced by clearSongMeta(), operator=(), readInformation(), and songMeta().

QString MusicSongMeta::m_path
private

Definition at line 212 of file musicsongmeta.h.

Referenced by filePath(), operator=(), read(), readInformation(), and saveInformation().

QList<Data*> MusicSongMeta::m_songMetas
private

Definition at line 213 of file musicsongmeta.h.

Referenced by clearSongMeta(), operator=(), readInformation(), songMeta(), and songMetaCount().

The documentation for this class was generated from the following files:
Generated on Mon Feb 23 2026 13:10:00 for TTKMusicPlayer by   doxygen 1.8.8