Playlist Class Reference

#include <mythplugins/mythmusic/mythmusic/playlist.h>

Inheritance diagram for Playlist:

Collaboration diagram for Playlist:

Public Member Functions
	Playlist (void)
	~Playlist () override
void	setParent (PlaylistContainer *myparent)
void	loadPlaylist (const QString &a_name, const QString &a_host)
void	loadPlaylistByID (int id, const QString &a_host)
void	savePlaylist (const QString &a_name, const QString &a_host)
void	shuffleTracks (MusicPlayer::ShuffleMode mode)
void	describeYourself (void) const
void	fillSongsFromSonglist (const QString &songList)
int	fillSonglistFromQuery (const QString &whereClause, bool removeDuplicates=false, InsertPLOption insertOption=PL_REPLACE, int currentTrackID=0)
int	fillSonglistFromSmartPlaylist (const QString &category, const QString &name, bool removeDuplicates=false, InsertPLOption insertOption=PL_REPLACE, int currentTrackID=0)
int	fillSonglistFromList (const QList< int > &songList, bool removeDuplicates, InsertPLOption insertOption, int currentTrackID)
QString	toRawSonglist (bool shuffled=false, bool tracksOnly=false)
MusicMetadata *	getSongAt (int pos) const
int	getTrackCount (void)
void	moveTrackUpDown (bool flag, int where_its_at)
bool	checkTrack (MusicMetadata::IdType trackID) const
void	addTrack (MusicMetadata::IdType trackID, bool update_display)
	Given a tracks ID, add that track to this playlist. More...
int	getTrackPosition (MusicMetadata::IdType trackID)
void	removeTrack (MusicMetadata::IdType trackID)
void	removeAllTracks (void)
void	removeAllCDTracks (void)
void	copyTracks (Playlist *to_ptr, bool update_display)
bool	hasChanged (void) const
void	changed (void)
void	disableSaves (void)
	whether any changes should be saved to the DB More...
void	enableSaves (void)
bool	doSaves (void) const
QString	getName (void)
void	setName (const QString &a_name)
bool	isActivePlaylist (void)
int	getID (void) const
void	setID (int x)
void	getStats (uint *trackCount, std::chrono::seconds *totalLength, uint currentTrack=0, std::chrono::seconds *playedLength=nullptr) const
void	resync (void)
	make sure all tracks are still valid after a scan More...

Private Member Functions
MusicMetadata *	getRawSongAt (int pos) const

Static Private Member Functions
static QString	removeItemsFromList (const QString &remove_list, const QString &source_list)

Private Attributes
int	m_playlistid {0}
QString	m_name
SongList	m_songs
SongList	m_shuffledSongs
PlaylistContainer *	m_parent {nullptr}
bool	m_changed {false}
bool	m_doSave {true}

Detailed Description

Definition at line 45 of file playlist.h.

Constructor & Destructor Documentation

Playlist()

Playlist::Playlist

(

void

)

Definition at line 145 of file playlist.cpp.

~Playlist()

Playlist::~Playlist ( )

override

Definition at line 150 of file playlist.cpp.

Member Function Documentation

setParent()

void Playlist::setParent ( PlaylistContainer *  myparent )

inline

Definition at line 53 of file playlist.h.

Referenced by PlaylistContainer::load().

loadPlaylist()

void Playlist::loadPlaylist	(	const QString &	a_name,
		const QString &	a_host
	)

Definition at line 528 of file playlist.cpp.

Referenced by PlaylistContainer::load().

loadPlaylistByID()

void Playlist::loadPlaylistByID	(	int	id,
		const QString &	a_host
	)

Definition at line 584 of file playlist.cpp.

savePlaylist()

void Playlist::savePlaylist	(	const QString &	a_name,
		const QString &	a_host
	)

Definition at line 997 of file playlist.cpp.

Referenced by changed(), loadPlaylist(), and PlaylistContainer::save().

shuffleTracks()

void Playlist::shuffleTracks

(

MusicPlayer::ShuffleMode

mode

)

Definition at line 156 of file playlist.cpp.

Referenced by fillSongsFromSonglist(), loadPlaylist(), and MusicPlayer::setShuffleMode().

describeYourself()

void Playlist::describeYourself

(

void

)

const

Definition at line 480 of file playlist.cpp.

Referenced by PlaylistContainer::describeYourself().

fillSongsFromSonglist()

void Playlist::fillSongsFromSonglist

(

const QString &

songList

)

Definition at line 640 of file playlist.cpp.

Referenced by MusicCommon::customEvent(), fillSonglistFromList(), fillSonglistFromQuery(), loadPlaylist(), and loadPlaylistByID().

fillSonglistFromQuery()

int Playlist::fillSonglistFromQuery	(	const QString &	whereClause,
		bool	removeDuplicates = false,
		InsertPLOption	insertOption = PL_REPLACE,
		int	currentTrackID = 0
	)

Definition at line 685 of file playlist.cpp.

Referenced by MusicCommon::doUpdatePlaylist(), and fillSonglistFromSmartPlaylist().

fillSonglistFromSmartPlaylist()

int Playlist::fillSonglistFromSmartPlaylist	(	const QString &	category,
		const QString &	name,
		bool	removeDuplicates = false,
		InsertPLOption	insertOption = PL_REPLACE,
		int	currentTrackID = 0
	)

Definition at line 897 of file playlist.cpp.

fillSonglistFromList()

int Playlist::fillSonglistFromList	(	const QList< int > &	songList,
		bool	removeDuplicates,
		InsertPLOption	insertOption,
		int	currentTrackID
	)

Definition at line 784 of file playlist.cpp.

Referenced by MusicCommon::doUpdatePlaylist(), and handleMedia().

toRawSonglist()

QString Playlist::toRawSonglist	(	bool	shuffled = false,
		bool	tracksOnly = false
	)

Definition at line 854 of file playlist.cpp.

Referenced by MusicCommon::customEvent(), fillSonglistFromList(), fillSonglistFromQuery(), and savePlaylist().

getSongAt()

MusicMetadata * Playlist::getSongAt

(

int

pos

)

const

Definition at line 1095 of file playlist.cpp.

Referenced by MusicPlayer::activePlaylistChanged(), MusicPlayer::getCurrentMetadata(), MusicPlayer::getNextMetadata(), PlaylistEditorView::getPlaylistTracks(), getStats(), MusicPlayer::moveTrackUpDown(), MusicCommon::restorePosition(), MusicPlayer::restorePosition(), MusicPlayer::setShuffleMode(), PlaylistEditorView::updateSonglist(), StreamView::updateStreamList(), and MusicCommon::updateUIPlaylist().

getTrackCount()

int Playlist::getTrackCount ( void  )

inline

Definition at line 82 of file playlist.h.

Referenced by MusicPlayer::activePlaylistChanged(), MusicCommon::customEvent(), MusicCommon::doUpdatePlaylist(), PlaylistEditorView::getPlaylistTracks(), MusicPlayer::restorePosition(), MusicPlayer::setShuffleMode(), MusicCommon::showPlaylistOptionsMenu(), PlaylistEditorView::treeItemClicked(), MusicCommon::updatePlaylistStats(), PlaylistEditorView::updateSonglist(), and MusicCommon::updateUIPlaylist().

moveTrackUpDown()

void Playlist::moveTrackUpDown	(	bool	flag,
		int	where_its_at
	)

Definition at line 129 of file playlist.cpp.

Referenced by MusicPlayer::moveTrackUpDown().

checkTrack()

bool Playlist::checkTrack

(

MusicMetadata::IdType

trackID

)

const

Definition at line 37 of file playlist.cpp.

Referenced by SearchView::customEvent(), PlaylistEditorView::filterTracks(), PlaylistEditorView::getCDTracks(), PlaylistEditorView::getPlaylistTracks(), PlaylistEditorView::getSmartPlaylistTracks(), SearchView::ShowMenu(), SearchView::trackClicked(), PlaylistEditorView::treeItemClicked(), PlaylistEditorView::updateSelectedTracks(), and SearchView::updateTracksList().

addTrack()

void Playlist::addTrack	(	MusicMetadata::IdType	trackID,
		bool	update_display
	)

Given a tracks ID, add that track to this playlist.

Definition at line 62 of file playlist.cpp.

Referenced by MusicPlayer::addTrack(), copyTracks(), MusicPlayer::loadStreamPlaylist(), and SearchView::trackClicked().

getTrackPosition()

int Playlist::getTrackPosition ( MusicMetadata::IdType  trackID )

inline

Definition at line 90 of file playlist.h.

Referenced by MusicPlayer::moveTrackUpDown(), and MusicPlayer::removeTrack().

removeTrack()

void Playlist::removeTrack

(

MusicMetadata::IdType

trackID

)

Definition at line 118 of file playlist.cpp.

Referenced by MusicPlayer::removeTrack(), and SearchView::trackClicked().

removeAllTracks()

void Playlist::removeAllTracks

(

void

)

Definition at line 88 of file playlist.cpp.

Referenced by PlaylistContainer::clearActive(), PlaylistContainer::copyToActive(), MusicCommon::customEvent(), PlaylistContainer::deletePlaylist(), fillSonglistFromList(), fillSonglistFromQuery(), handleMedia(), and MusicPlayer::loadStreamPlaylist().

removeAllCDTracks()

void Playlist::removeAllCDTracks

(

void

)

Definition at line 96 of file playlist.cpp.

Referenced by handleMedia().

copyTracks()

void Playlist::copyTracks	(	Playlist *	to_ptr,
		bool	update_display
	)

Definition at line 42 of file playlist.cpp.

Referenced by PlaylistContainer::copyNewPlaylist(), and PlaylistContainer::copyToActive().

hasChanged()

bool Playlist::hasChanged ( void  ) const

inline

Definition at line 98 of file playlist.h.

changed()

void Playlist::changed

(

void

)

Definition at line 989 of file playlist.cpp.

Referenced by addTrack(), copyTracks(), MusicCommon::customEvent(), fillSonglistFromList(), fillSonglistFromQuery(), fillSongsFromSonglist(), moveTrackUpDown(), removeAllCDTracks(), removeAllTracks(), removeTrack(), PlaylistContainer::renamePlaylist(), and resync().

disableSaves()

void Playlist::disableSaves ( void  )

inline

whether any changes should be saved to the DB

Definition at line 102 of file playlist.h.

Referenced by copyTracks(), fillSonglistFromList(), fillSonglistFromQuery(), and MusicPlayer::loadStreamPlaylist().

enableSaves()

void Playlist::enableSaves ( void  )

inline

Definition at line 103 of file playlist.h.

Referenced by copyTracks(), fillSonglistFromList(), fillSonglistFromQuery(), and MusicPlayer::loadStreamPlaylist().

doSaves()

bool Playlist::doSaves ( void  ) const

inline

Definition at line 104 of file playlist.h.

getName()

QString Playlist::getName ( void  )

inline

Definition at line 106 of file playlist.h.

Referenced by PlaylistContainer::getPlaylist(), PlaylistContainer::getPlaylistName(), PlaylistEditorView::getPlaylists(), and MusicCommon::updatePlaylistStats().

setName()

void Playlist::setName ( const QString &  a_name )

inline

Definition at line 107 of file playlist.h.

Referenced by PlaylistContainer::renamePlaylist().

isActivePlaylist()

bool Playlist::isActivePlaylist ( void  )

inline

Definition at line 109 of file playlist.h.

Referenced by addTrack(), fillSongsFromSonglist(), removeTrack(), and resync().

getID()

int Playlist::getID ( void  ) const

inline

Definition at line 111 of file playlist.h.

Referenced by MusicCommon::customEvent(), PlaylistContainer::getPlaylist(), PlaylistContainer::getPlaylistName(), and PlaylistEditorView::getPlaylists().

setID()

void Playlist::setID ( int  x )

inline

Definition at line 112 of file playlist.h.

getStats()

void Playlist::getStats	(	uint *	trackCount,
		std::chrono::seconds *	totalLength,
		uint	currentTrack = 0,
		std::chrono::seconds *	playedLength = nullptr
	)		const

Definition at line 500 of file playlist.cpp.

Referenced by MusicCommon::customEvent(), MusicCommon::doUpdatePlaylist(), MusicCommon::init(), MusicCommon::keyPressEvent(), savePlaylist(), and MusicCommon::updateShuffleMode().

resync()

void Playlist::resync

(

void

)

make sure all tracks are still valid after a scan

Definition at line 612 of file playlist.cpp.

Referenced by PlaylistContainer::resync().

getRawSongAt()

MusicMetadata * Playlist::getRawSongAt ( int  pos ) const

private

Definition at line 1113 of file playlist.cpp.

Referenced by copyTracks(), removeAllCDTracks(), resync(), and shuffleTracks().

removeItemsFromList()

QString Playlist::removeItemsFromList ( const QString &  remove_list, const QString &  source_list  )

staticprivate

Definition at line 1080 of file playlist.cpp.

Referenced by fillSonglistFromList(), and fillSonglistFromQuery().

Member Data Documentation

m_playlistid

int Playlist::m_playlistid {0}

private

Definition at line 135 of file playlist.h.

Referenced by getID(), loadPlaylist(), loadPlaylistByID(), resync(), savePlaylist(), and setID().

m_name

QString Playlist::m_name

private

Definition at line 136 of file playlist.h.

Referenced by changed(), getName(), isActivePlaylist(), loadPlaylist(), loadPlaylistByID(), savePlaylist(), and setName().

m_songs

SongList Playlist::m_songs

private

Definition at line 138 of file playlist.h.

Referenced by addTrack(), checkTrack(), copyTracks(), describeYourself(), fillSongsFromSonglist(), getRawSongAt(), getTrackCount(), removeAllCDTracks(), removeAllTracks(), removeTrack(), resync(), shuffleTracks(), toRawSonglist(), and ~Playlist().

m_shuffledSongs

SongList Playlist::m_shuffledSongs

private

Definition at line 139 of file playlist.h.

Referenced by addTrack(), getSongAt(), getStats(), getTrackPosition(), moveTrackUpDown(), removeAllCDTracks(), removeAllTracks(), removeTrack(), resync(), shuffleTracks(), toRawSonglist(), and ~Playlist().

m_parent

PlaylistContainer* Playlist::m_parent {nullptr}

private

Definition at line 141 of file playlist.h.

Referenced by setParent(), and shuffleTracks().

m_changed

bool Playlist::m_changed {false}

private

Definition at line 142 of file playlist.h.

Referenced by changed(), hasChanged(), and savePlaylist().

m_doSave

bool Playlist::m_doSave {true}

private

Definition at line 143 of file playlist.h.

Referenced by changed(), disableSaves(), doSaves(), and enableSaves().

---

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

• mythplugins/mythmusic/mythmusic/playlist.h
• mythplugins/mythmusic/mythmusic/playlist.cpp