File indexing completed on 2024-05-19 04:49:16

0001 /****************************************************************************************
0002  * Copyright (c) 2010 Maximilian Kossick <maximilian.kossick@googlemail.com>            *
0003  *                                                                                      *
0004  * This program is free software; you can redistribute it and/or modify it under        *
0005  * the terms of the GNU General Public License as published by the Free Software        *
0006  * Foundation; either version 2 of the License, or (at your option) any later           *
0007  * version.                                                                             *
0008  *                                                                                      *
0009  * This program is distributed in the hope that it will be useful, but WITHOUT ANY      *
0010  * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A      *
0011  * PARTICULAR PURPOSE. See the GNU General Public License for more details.             *
0012  *                                                                                      *
0013  * You should have received a copy of the GNU General Public License along with         *
0014  * this program.  If not, see <http://www.gnu.org/licenses/>.                           *
0015  ****************************************************************************************/
0016 
0017 #ifndef ARTISTHELPER_H
0018 #define ARTISTHELPER_H
0019 
0020 #include "amarok_export.h"
0021 
0022 #include <QString>
0023 
0024 namespace ArtistHelper
0025 {
0026     /**
0027      * Return the best guess of the album artist.
0028      *
0029      * Guessing algorithm includes extracting artist from composer for classical tracks,
0030      * falling back to trackArtist if albumArtist is empty etc. Returns empty string for
0031      * tracks that are believed to belong into a compilation.
0032      */
0033     AMAROK_EXPORT QString bestGuessAlbumArtist( const QString &albumArtist, const QString &trackArtist,
0034                                   const QString &genre, const QString &composer );
0035 
0036     /**
0037       * This helper function will determine the actual track artist.
0038       * It takes into account "A featuring B" strings, in which case
0039       * the actual track artist would be A.
0040       */
0041     AMAROK_EXPORT QString realTrackArtist( const QString &trackArtistTag );
0042 }
0043 
0044 #endif