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