Sayonara Player
CoverFetcherInterface.h
1 /* CoverFetcherInterface.h */
2 
3 /* Copyright (C) 2011-2019 Lucio Carreras
4  *
5  * This file is part of sayonara player
6  *
7  * This program is free software: you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation, either version 3 of the License, or
10  * (at your option) any later version.
11 
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15  * GNU General Public License for more details.
16 
17  * You should have received a copy of the GNU General Public License
18  * along with this program. If not, see <http://www.gnu.org/licenses/>.
19  */
20 
21 
22 
23 #ifndef ABSTRACTCOVERFETCHER_H
24 #define ABSTRACTCOVERFETCHER_H
25 
26 class QString;
27 class QByteArray;
28 class QStringList;
29 
30 namespace Cover
31 {
32 
33 namespace Fetcher
34 {
39  class Base
40  {
41 
42  public:
43  Base();
44  virtual ~Base();
45 
50  virtual bool can_fetch_cover_directly() const=0;
51 
58  virtual QStringList calc_addresses_from_website(const QByteArray& website) const=0;
59 
64  virtual QString keyword() const=0;
65 
72  virtual QString artist_address(const QString& artist) const=0;
73 
81  virtual QString album_address(const QString& artist, const QString& album) const=0;
82 
89  virtual QString search_address(const QString& str) const=0;
90 
95  virtual bool is_search_supported() const=0;
96 
101  virtual bool is_album_supported() const=0;
102 
107  virtual bool is_artist_supported() const=0;
108 
113  virtual int estimated_size() const=0;
114  };
115 
116 } // Fetcher
117 } // Cover
118 
119 #endif // ABSTRACTCOVERFETCHER_H
virtual QString search_address(const QString &str) const =0
Get a custom search address This is called if is_search_supported returns true.
The CoverFetcherInterface interface.
Definition: CoverFetcherInterface.h:39
virtual QString keyword() const =0
get name of CoverFetcherInterface like e.g. Discogs
virtual bool is_search_supported() const =0
Is text search supported.
virtual QStringList calc_addresses_from_website(const QByteArray &website) const =0
Get addresses from the downloaded website. If can_fetch_cover_directly returns true, this method is not called.
virtual bool is_artist_supported() const =0
is artist search supported
virtual bool is_album_supported() const =0
is album search supported
virtual QString artist_address(const QString &artist) const =0
Get the artist search url. This is called if is_artist_supported returns true.
virtual bool can_fetch_cover_directly() const =0
Can the cover be fetched from the adress without starting a two-stage query?
Definition: SomaFMStation.h:33
virtual QString album_address(const QString &artist, const QString &album) const =0
Get the album search url. This is called if is_album_supported returns true.
virtual int estimated_size() const =0
get_estimated_size. Rough image size of the CoverFetchInterface