1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
|
/*
* Copyright (C) 2005-2018 Team Kodi
* This file is part of Kodi - https://kodi.tv
*
* SPDX-License-Identifier: GPL-2.0-or-later
* See LICENSES/README.md for more information.
*/
#pragma once
/*!
\file Song.h
\brief
*/
#include "Artist.h"
#include "XBDateTime.h"
#include "music/tags/ReplayGain.h"
#include "utils/EmbeddedArt.h"
#include "utils/ISerializable.h"
#include <map>
#include <string>
#include <vector>
class CVariant;
/*!
\ingroup music
\brief Class to store and read album information from CMusicDatabase
\sa CSong, CMusicDatabase
*/
class CGenre
{
public:
int idGenre;
std::string strGenre;
};
class CFileItem;
/*!
\ingroup music
\brief Class to store and read song information from CMusicDatabase
\sa CAlbum, CMusicDatabase
*/
class CSong final : public ISerializable
{
public:
CSong() ;
explicit CSong(CFileItem& item);
void Clear() ;
void MergeScrapedSong(const CSong& source, bool override);
void Serialize(CVariant& value) const override;
bool operator<(const CSong &song) const
{
if (strFileName < song.strFileName) return true;
if (strFileName > song.strFileName) return false;
if (iTrack < song.iTrack) return true;
return false;
}
/*! \brief Get artist names from the vector of artistcredits objects
\return artist names as a vector of strings
*/
const std::vector<std::string> GetArtist() const;
/*! \brief Get artist sort name string
\return artist sort name as a single string
*/
const std::string GetArtistSort() const;
/*! \brief Get artist MusicBrainz IDs from the vector of artistcredits objects
\return artist MusicBrainz IDs as a vector of strings
*/
const std::vector<std::string> GetMusicBrainzArtistID() const;
/*! \brief Get artist names from the artist description string (if it exists)
or concatenated from the vector of artistcredits objects
\return artist names as a single string
*/
const std::string GetArtistString() const;
/*! \brief Get song artist IDs (for json rpc) from the vector of artistcredits objects
\return album artist IDs as a vector of integers
*/
const std::vector<int> GetArtistIDArray() const;
/*! \brief Get album artist names associated with song from tag data
Note for initial album processing only, normalised album artist data belongs to album
and is stored in album artist credits
\return album artist names as a vector of strings
*/
const std::vector<std::string> GetAlbumArtist() const { return m_albumArtist; }
/*! \brief Get album artist sort name string
\return album artist sort name as a single string
*/
const std::string GetAlbumArtistSort() const { return m_strAlbumArtistSort; }
/*! \brief Get disc subtitle string where one exists
\return disc subtitle as a single string
*/
const std::string GetDiscSubtitle() const;
/*! \brief Get composer sort name string
\return composer sort name as a single string
*/
const std::string GetComposerSort() const { return m_strComposerSort; }
/*! \brief Get the full list of artist names and the role each played for those
that contributed to the recording. Given in music file tags other than ARTIST
or ALBUMARTIST, e.g. COMPOSER or CONDUCTOR etc.
\return a vector of all contributing artist names and their roles
*/
const VECMUSICROLES& GetContributors() const { return m_musicRoles; }
//void AddArtistRole(const int &role, const std::string &artist);
void AppendArtistRole(const CMusicRole& musicRole);
/*! \brief Set album artist vector.
Album artist is held local to song until album created for initial processing only.
Normalised album artist data belongs to album and is stored in album artist credits
\param album artist names as a vector of strings
*/
void SetAlbumArtist(const std::vector<std::string>& albumartists) { m_albumArtist = albumartists; }
/*! \brief Whether this song has any artists in artist credits vector
Tests if artist credits has been populated yet, during processing there can be
artists in the artist description but not yet in the credits
*/
bool HasArtistCredits() const { return !artistCredits.empty(); }
/*! \brief Whether this song has any artists in music roles (contributors) vector
Tests if contributors has been populated yet, there may be none.
*/
bool HasContributors() const { return !m_musicRoles.empty(); }
/*! \brief whether this song has art associated with it
Tests both the strThumb and embeddedArt members.
*/
bool HasArt() const;
/*! \brief whether the art from this song matches the art from another
Tests both the strThumb and embeddedArt members.
*/
bool ArtMatches(const CSong &right) const;
/*! \brief Set artist credits using the arrays of tag values.
If strArtistSort (as from ARTISTSORT tag) is already set then individual
artist sort names are also processed.
\param names String vector of artist names (as from ARTIST tag)
\param hints String vector of artist name hints (as from ARTISTS tag)
\param mbids String vector of artist Musicbrainz IDs (as from MUSICBRAINZARTISTID tag)
*/
void SetArtistCredits(const std::vector<std::string>& names, const std::vector<std::string>& hints,
const std::vector<std::string>& mbids);
int idSong;
int idAlbum;
std::string strFileName;
std::string strTitle;
std::string strArtistSort;
std::string strArtistDesc;
VECARTISTCREDITS artistCredits;
std::string strAlbum;
std::vector<std::string> genre;
std::string strThumb;
EmbeddedArtInfo embeddedArt;
std::string strMusicBrainzTrackID;
std::string strComment;
std::string strMood;
std::string strCueSheet;
float rating;
int userrating;
int votes;
int iTrack;
int iDuration;
std::string strOrigReleaseDate;
std::string strReleaseDate;
std::string strDiscSubtitle;
int iTimesPlayed;
CDateTime lastPlayed;
CDateTime dateAdded; // File creation or modification time, or when tags (re-)scanned
CDateTime dateUpdated; // Time db record Last modified
CDateTime dateNew; // Time db record created
int iStartOffset;
int iEndOffset;
bool bCompilation;
int iBPM;
int iSampleRate;
int iBitRate;
int iChannels;
std::string strRecordLabel; // Record label from tag for album processing by CMusicInfoScanner::FileItemsToAlbums
std::string strAlbumType; // (Musicbrainz release type) album type from tag for album processing by CMusicInfoScanner::FileItemsToAlbums
ReplayGain replayGain;
private:
std::vector<std::string> m_albumArtist; // Album artist from tag for album processing, no desc or MBID
std::string m_strAlbumArtistSort; // Albumartist sort string from tag for album processing by CMusicInfoScanner::FileItemsToAlbums
std::string m_strComposerSort;
VECMUSICROLES m_musicRoles;
};
/*!
\ingroup music
\brief A vector of CSong objects, used for CMusicDatabase
\sa CMusicDatabase
*/
typedef std::vector<CSong> VECSONGS;
/*!
\ingroup music
\brief A map of a vector of CSong objects key by filename, used for CMusicDatabase
*/
typedef std::map<std::string, VECSONGS> MAPSONGS;
/*!
\ingroup music
\brief A vector of std::string objects, used for CMusicDatabase
\sa CMusicDatabase
*/
typedef std::vector<CGenre> VECGENRES;
|
