Clementine-audio-player-Mac.../src/playlist/playlist.h

480 lines
16 KiB
C
Raw Normal View History

/* This file is part of Clementine.
Copyright 2010, David Sansome <me@davidsansome.com>
Clementine is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
Clementine is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with Clementine. If not, see <http://www.gnu.org/licenses/>.
*/
2009-12-24 20:16:07 +01:00
#ifndef PLAYLIST_H
#define PLAYLIST_H
#include <QAbstractItemModel>
#include <QList>
2020-09-18 16:15:19 +02:00
#include "core/song.h"
#include "core/tagreaderclient.h"
2009-12-24 20:16:07 +01:00
#include "playlistitem.h"
#include "playlistsequence.h"
#include "smartplaylists/generator_fwd.h"
2009-12-24 20:16:07 +01:00
class LibraryBackend;
class PlaylistBackend;
2010-05-22 18:36:13 +02:00
class PlaylistFilter;
2010-07-11 17:37:40 +02:00
class Queue;
class InternetModel;
class InternetService;
class TaskManager;
2009-12-26 22:35:45 +01:00
2010-05-22 18:36:13 +02:00
class QSortFilterProxyModel;
class QUndoStack;
class QStringList;
namespace PlaylistUndoCommands {
class InsertItems;
class RemoveItems;
class MoveItems;
class ReOrderItems;
class SortItems;
class ShuffleItems;
2020-09-18 16:15:19 +02:00
} // namespace PlaylistUndoCommands
typedef QMap<int, Qt::Alignment> ColumnAlignmentMap;
2019-11-10 00:30:18 +01:00
Q_DECLARE_METATYPE(Qt::Alignment)
Q_DECLARE_METATYPE(ColumnAlignmentMap)
// Objects that may prevent a song being added to the playlist. When there
// is something about to be inserted into it, Playlist notifies all of it's
// listeners about the fact and every one of them picks 'invalid' songs.
class SongInsertVetoListener : public QObject {
Q_OBJECT
public:
// Listener returns a list of 'invalid' songs. 'old_songs' are songs that are
// currently in the playlist and 'new_songs' are the songs about to be added
// if
// nobody exercises a veto.
virtual SongList AboutToInsertSongs(const SongList& old_songs,
const SongList& new_songs) = 0;
};
2009-12-24 20:16:07 +01:00
class Playlist : public QAbstractListModel {
Q_OBJECT
friend class PlaylistUndoCommands::InsertItems;
friend class PlaylistUndoCommands::RemoveItems;
friend class PlaylistUndoCommands::MoveItems;
friend class PlaylistUndoCommands::ReOrderItems;
2009-12-24 20:16:07 +01:00
public:
Playlist(PlaylistBackend* backend, TaskManager* task_manager,
LibraryBackend* library, int id,
const QString& special_type = QString(), bool favorite = false,
QObject* parent = nullptr);
2009-12-24 20:16:07 +01:00
~Playlist();
void SkipTracks(const QModelIndexList& source_indexes);
2014-01-17 07:01:31 +01:00
// Always add new columns to the end of this enum - the values are persisted
2009-12-24 20:16:07 +01:00
enum Column {
Column_Title = 0,
Column_Artist,
Column_Album,
Column_AlbumArtist,
Column_Composer,
2009-12-24 20:16:07 +01:00
Column_Length,
Column_Track,
2009-12-30 05:05:33 +01:00
Column_Disc,
Column_Year,
Column_Genre,
Column_BPM,
Column_Bitrate,
Column_Samplerate,
Column_Filename,
Column_BaseFilename,
2009-12-30 05:05:33 +01:00
Column_Filesize,
Column_Filetype,
Column_DateCreated,
Column_DateModified,
Column_Rating,
Column_PlayCount,
Column_SkipCount,
Column_LastPlayed,
Column_Score,
Column_Comment,
Column_Source,
2012-05-27 17:46:16 +02:00
Column_Mood,
Column_Performer,
Column_Grouping,
Column_OriginalYear,
2009-12-24 20:16:07 +01:00
ColumnCount
};
enum Role {
Role_IsCurrent = Qt::UserRole + 1,
Role_IsPaused,
Role_StopAfter,
Role_QueuePosition,
Role_CanSetRating,
2009-12-24 20:16:07 +01:00
};
enum LastFMStatus {
LastFM_New = 0, // Haven't scrobbled yet, but we want to later
LastFM_Scrobbled, // Scrobbled ok
LastFM_Seeked, // The user seeked so don't scrobble
LastFM_Error, // Tried to scrobble but got an error
LastFM_Invalid, // The song isn't suitable for scrobbling
LastFM_Queued, // Track added to the queue for scrobbling
};
enum Path {
Path_Automatic = 0, // Automatically select path type
Path_Absolute, // Always use absolute paths
Path_Relative, // Always use relative paths
Path_Ask_User, // Only used in preferences: to ask user which of the
// previous values he wants to use.
};
static const char* kCddaMimeType;
2009-12-24 20:16:07 +01:00
static const char* kRowsMimetype;
static const char* kPlayNowMimetype;
2009-12-24 20:16:07 +01:00
static const int kInvalidSongPriority;
static const QRgb kInvalidSongColor;
static const int kDynamicHistoryPriority;
static const QRgb kDynamicHistoryColor;
static const char* kSettingsGroup;
2014-10-05 01:22:19 +02:00
static const char* kPathType;
static const char* kWriteMetadata;
static const char* kSortIgnorePrefix;
static const char* kSortIgnorePrefixList;
2014-10-05 01:22:19 +02:00
static const int kUndoStackSize;
static const int kUndoItemLimit;
static const qint64 kMinScrobblePointNsecs;
static const qint64 kMaxScrobblePointNsecs;
static bool CompareItems(int column, Qt::SortOrder order, PlaylistItemPtr a,
PlaylistItemPtr b, const QStringList& prefixes = {});
2009-12-24 20:16:07 +01:00
static QString column_name(Column column);
static QString abbreviated_column_name(Column column);
static bool column_is_editable(Playlist::Column column);
static bool set_column_value(Song& song, Column column,
const QVariant& value);
// Persistence
void Save() const;
void Restore();
2009-12-24 20:16:07 +01:00
// Accessors
2010-05-22 18:36:13 +02:00
QSortFilterProxyModel* proxy() const;
2010-07-11 17:37:40 +02:00
Queue* queue() const { return queue_; }
2010-05-22 18:36:13 +02:00
int id() const { return id_; }
const QString& ui_path() const { return ui_path_; }
void set_ui_path(const QString& path) { ui_path_ = path; }
bool is_favorite() const { return favorite_; }
void set_favorite(bool favorite) { favorite_ = favorite; }
int current_row() const;
int last_played_row() const;
int next_row(bool ignore_repeat_track = false) const;
int previous_row(bool ignore_repeat_track = false) const;
const QModelIndex current_index() const;
bool stop_after_current() const;
bool is_dynamic() const { return static_cast<bool>(dynamic_playlist_); }
int dynamic_history_length() const;
2009-12-29 20:57:33 +01:00
QString special_type() const { return special_type_; }
void set_special_type(const QString& v) { special_type_ = v; }
const PlaylistItemPtr& item_at(int index) const { return items_[index]; }
const bool has_item_at(int index) const {
return index >= 0 && index < rowCount();
}
PlaylistItemPtr current_item() const;
2009-12-29 20:57:33 +01:00
2009-12-29 17:15:21 +01:00
PlaylistItem::Options current_item_options() const;
2009-12-29 20:57:33 +01:00
Song current_item_metadata() const;
PlaylistItemList library_items_by_id(int id) const;
2010-05-23 00:20:00 +02:00
SongList GetAllSongs() const;
PlaylistItemList GetAllItems() const;
quint64 GetTotalLength() const; // in seconds
2010-05-23 00:20:00 +02:00
void set_sequence(PlaylistSequence* v);
PlaylistSequence* sequence() const { return playlist_sequence_; }
2009-12-29 20:57:33 +01:00
QUndoStack* undo_stack() const { return undo_stack_; }
2009-12-29 20:57:33 +01:00
// Scrobbling
qint64 scrobble_point_nanosec() const { return scrobble_point_; }
LastFMStatus get_lastfm_status() const { return lastfm_status_; }
bool have_incremented_playcount() const {
return have_incremented_playcount_;
}
void set_lastfm_status(LastFMStatus status) { lastfm_status_ = status; }
void set_have_incremented_playcount() { have_incremented_playcount_ = true; }
void UpdateScrobblePoint(qint64 seek_point_nanosec = 0);
2009-12-24 20:16:07 +01:00
// play count tracking
qint64 play_count_point_nanosec() const { return play_count_point_; }
void set_max_play_count_point_nsecs(qint64 max_play_count_point_nsecs) {
max_play_count_point_nsecs_ = max_play_count_point_nsecs;
}
qint64 get_max_play_count_point_nsecs() const {
return max_play_count_point_nsecs_;
}
void UpdatePlayCountPoint(qint64 seek_point_nanosec = 0);
2009-12-24 20:16:07 +01:00
// Changing the playlist
void InsertItems(const PlaylistItemList& items, int pos = -1,
2018-04-14 22:57:06 +02:00
bool play_now = false, bool enqueue = false,
bool enqueue_next = false);
void InsertLibraryItems(const SongList& items, int pos = -1,
2018-04-14 22:57:06 +02:00
bool play_now = false, bool enqueue = false,
bool enqueue_next = false);
void InsertSongs(const SongList& items, int pos = -1, bool play_now = false,
2018-03-19 03:44:00 +01:00
bool enqueue = false, bool enqueue_next = false);
void InsertSongsOrLibraryItems(const SongList& items, int pos = -1,
2018-04-14 22:57:06 +02:00
bool play_now = false, bool enqueue = false,
bool enqueue_next = false);
void InsertSmartPlaylist(smart_playlists::GeneratorPtr gen, int pos = -1,
2018-04-14 22:57:06 +02:00
bool play_now = false, bool enqueue = false,
bool enqueue_next = false);
void InsertInternetItems(InternetService* service, const SongList& songs,
int pos = -1, bool play_now = false,
2018-03-19 03:44:00 +01:00
bool enqueue = false, bool enqueue_next = false);
void ReshuffleIndices();
// If this playlist contains the current item, this method will apply the
// "valid" flag on it.
// If the "valid" flag is false, the song will be greyed out. Otherwise the
// grey color will
// be undone.
// If the song is a local file and it's valid but non existent or invalid but
// exists, the
// song will be reloaded to even out the situation because obviously something
// has changed.
// This returns true if this playlist had current item when the method was
// invoked.
bool ApplyValidityOnCurrentSong(const QUrl& url, bool valid);
// Grays out and reloads all deleted songs in all playlists. Also, "ungreys"
// those songs
2011-03-19 11:43:50 +01:00
// which were once deleted but now got restored somehow.
void InvalidateDeletedSongs();
// Removes from the playlist all local files that don't exist anymore.
void RemoveDeletedSongs();
2009-12-24 20:16:07 +01:00
void StopAfter(int row);
2010-01-16 17:12:47 +01:00
void ReloadItems(const QList<int>& rows);
void InformOfCurrentSongChange();
2009-12-24 20:16:07 +01:00
// Changes rating of a song to the given value asynchronously
void RateSong(const QModelIndex& index, double rating);
void RateSongs(const QModelIndexList& index_list, double rating);
// Registers an object which will get notifications when new songs
// are about to be inserted into this playlist.
void AddSongInsertVetoListener(SongInsertVetoListener* listener);
// Unregisters a SongInsertVetoListener object.
void RemoveSongInsertVetoListener(SongInsertVetoListener* listener);
// Just emits the dataChanged() signal so the mood column is repainted.
void MoodbarUpdated(const QModelIndex& index);
2009-12-24 20:16:07 +01:00
// QAbstractListModel
int rowCount(const QModelIndex& = QModelIndex()) const {
return items_.count();
}
int columnCount(const QModelIndex& = QModelIndex()) const {
return ColumnCount;
}
2009-12-24 20:16:07 +01:00
QVariant data(const QModelIndex& index, int role = Qt::DisplayRole) const;
bool setData(const QModelIndex& index, const QVariant& value, int role);
QVariant headerData(int section, Qt::Orientation orientation,
int role = Qt::DisplayRole) const;
Qt::ItemFlags flags(const QModelIndex& index) const;
2009-12-24 20:16:07 +01:00
QStringList mimeTypes() const;
Qt::DropActions supportedDropActions() const;
QMimeData* mimeData(const QModelIndexList& indexes) const;
bool dropMimeData(const QMimeData* data, Qt::DropAction action, int row,
int column, const QModelIndex& parent);
2009-12-24 20:16:07 +01:00
void sort(int column, Qt::SortOrder order);
bool removeRows(int row, int count,
const QModelIndex& parent = QModelIndex());
2009-12-24 20:16:07 +01:00
static bool ComparePathDepths(Qt::SortOrder, PlaylistItemPtr,
PlaylistItemPtr);
2009-12-24 20:16:07 +01:00
public slots:
void set_current_row(int index, bool is_stopping = false);
2009-12-24 20:16:07 +01:00
void Paused();
void Playing();
void Stopped();
void IgnoreSorting(bool value) { ignore_sorting_ = value; }
2009-12-24 20:16:07 +01:00
2009-12-26 23:15:57 +01:00
void ClearStreamMetadata();
void SetStreamMetadata(const QUrl& url, const Song& song);
void ItemChanged(PlaylistItemPtr item);
void UpdateItems(const SongList& songs);
2009-12-26 23:15:57 +01:00
2010-01-14 13:27:50 +01:00
void Clear();
void RemoveDuplicateSongs();
2014-08-24 10:44:27 +02:00
void RemoveUnavailableSongs();
2010-02-04 00:56:41 +01:00
void Shuffle();
2010-01-14 13:27:50 +01:00
void ShuffleModeChanged(PlaylistSequence::ShuffleMode mode);
void ExpandDynamicPlaylist();
void RepopulateDynamicPlaylist();
void TurnOffDynamicPlaylist();
void SetColumnAlignment(const ColumnAlignmentMap& alignment);
void InsertUrls(const QList<QUrl>& urls, int pos = -1, bool play_now = false,
2018-03-19 03:44:00 +01:00
bool enqueue = false, bool enqueue_next = false);
// Removes items with given indices from the playlist. This operation is not
// undoable.
void RemoveItemsWithoutUndo(const QList<int>& indices);
2020-09-18 16:15:19 +02:00
signals:
void RestoreFinished();
2010-01-08 15:52:05 +01:00
void CurrentSongChanged(const Song& metadata);
void EditingFinished(const QModelIndex& index);
void PlayRequested(const QModelIndex& index);
2010-01-08 15:52:05 +01:00
// Signals that the underlying list of items was changed, meaning that
// something was added to it, removed from it or the ordering changed.
void PlaylistChanged();
void DynamicModeChanged(bool dynamic);
void Error(const QString& message);
// Signals that the queue has changed, meaning that the remaining queued
// items should update their position.
void QueueChanged();
2009-12-24 20:16:07 +01:00
private:
void SetCurrentIsPaused(bool paused);
int NextVirtualIndex(int i, bool ignore_repeat_track) const;
int PreviousVirtualIndex(int i, bool ignore_repeat_track) const;
2010-05-22 18:36:13 +02:00
bool FilterContainsVirtualIndex(int i) const;
void TurnOnDynamicPlaylist(smart_playlists::GeneratorPtr gen);
void InsertInternetItems(const InternetModel* model,
const QModelIndexList& items, int pos, bool play_now,
2018-03-19 03:44:00 +01:00
bool enqueue, bool enqueue_next = false);
template <typename T>
void InsertSongItems(const SongList& songs, int pos, bool play_now,
2018-03-19 03:44:00 +01:00
bool enqueue, bool enqueue_next = false);
void InsertDynamicItems(int count);
// Modify the playlist without changing the undo stack. These are used by
// our friends in PlaylistUndoCommands
void InsertItemsWithoutUndo(const PlaylistItemList& items, int pos,
2018-03-19 03:44:00 +01:00
bool enqueue = false, bool enqueue_next = false);
PlaylistItemList RemoveItemsWithoutUndo(int pos, int count);
void MoveItemsWithoutUndo(const QList<int>& source_rows, int pos);
void MoveItemWithoutUndo(int source, int dest);
void MoveItemsWithoutUndo(int start, const QList<int>& dest_rows);
void ReOrderWithoutUndo(const PlaylistItemList& new_items);
void RemoveItemsNotInQueue();
// Removes rows with given indices from this playlist.
bool removeRows(QList<int>& rows);
private slots:
void TracksAboutToBeDequeued(const QModelIndex&, int begin, int end);
void TracksDequeued();
void TracksEnqueued(const QModelIndex&, int begin, int end);
2010-07-11 19:39:11 +02:00
void QueueLayoutChanged();
void SongSaveComplete(TagReaderReply* reply,
const QPersistentModelIndex& index);
2015-11-26 19:59:44 +01:00
void ItemReloadComplete(const QPersistentModelIndex& index);
2015-11-27 15:22:59 +01:00
void ItemsLoaded(QFuture<PlaylistItemList> future);
void SongInsertVetoListenerDestroyed();
2009-12-24 20:16:07 +01:00
private:
bool is_loading_;
2010-05-22 18:36:13 +02:00
PlaylistFilter* proxy_;
2010-07-11 17:37:40 +02:00
Queue* queue_;
2010-05-22 18:36:13 +02:00
QList<QModelIndex> temp_dequeue_change_indexes_;
PlaylistBackend* backend_;
TaskManager* task_manager_;
LibraryBackend* library_;
int id_;
QString ui_path_;
bool favorite_;
PlaylistItemList items_;
QList<int> virtual_items_; // Contains the indices into items_ in the order
// that they will be played.
// A map of library ID to playlist item - for fast lookups when library
// items change.
QMultiMap<int, PlaylistItemPtr> library_items_by_id_;
2009-12-24 20:16:07 +01:00
QPersistentModelIndex current_item_index_;
QPersistentModelIndex last_played_item_index_;
2009-12-24 20:16:07 +01:00
QPersistentModelIndex stop_after_;
bool current_is_paused_;
int current_virtual_index_;
2009-12-24 20:16:07 +01:00
bool is_shuffled_;
qint64 scrobble_point_;
LastFMStatus lastfm_status_;
bool have_incremented_playcount_;
2009-12-29 20:57:33 +01:00
qint64 play_count_point_;
PlaylistSequence* playlist_sequence_;
2009-12-24 20:16:07 +01:00
// Hack to stop QTreeView::setModel sorting the playlist
bool ignore_sorting_;
QUndoStack* undo_stack_;
smart_playlists::GeneratorPtr dynamic_playlist_;
ColumnAlignmentMap column_alignments_;
QList<SongInsertVetoListener*> veto_listeners_;
QString special_type_;
qint64 min_play_count_point_nsecs_;
qint64 max_play_count_point_nsecs_;
// Cancel async restore if songs are already replaced
bool cancel_restore_;
2009-12-24 20:16:07 +01:00
};
// QDataStream& operator <<(QDataStream&, const Playlist*);
// QDataStream& operator >>(QDataStream&, Playlist*&);
#endif // PLAYLIST_H