File indexing completed on 2025-01-05 04:25:43

 /****************************************************************************************
  * Copyright (c) 2009-2010 Joffrey Clavel <jclavel@clabert.info>                        *
  * Copyright (c) 2010 Alexandre Mendes <alex.mendes1988@gmail.com>                      *
  *                                                                                      *
  * This program 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 2 of the License, or (at your option) any later           *
  * version.                                                                             *
  *                                                                                      *
  * This program 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         *
  * this program.  If not, see <http://www.gnu.org/licenses/>.                           *
  ****************************************************************************************/
 
 #ifndef ARTIST_WIDGET_H
 #define ARTIST_WIDGET_H
 
 #include "core/meta/forward_declarations.h"
 #include "network/NetworkAccessManagerProxy.h"
 #include "SimilarArtist.h"
 
 #include <QUrl>
 #include <KDateTime>
 #include <Plasma/ScrollWidget>
 
 #include <QTextLayout>
 
 class QGraphicsGridLayout;
 class QGraphicsLinearLayout;
 class QSignalMapper;
 class QLabel;
 
 namespace Plasma {
     class PushButton;
 }
 
 /**
  * A widget for display an artist with some details
  * @author Joffrey Clavel
  * @version 0.2
  */
 class ArtistWidget : public QGraphicsWidget
 {
     Q_OBJECT
     Q_PROPERTY( KDateTime bioPublished READ bioPublished )
     Q_PROPERTY( QString fullBio READ fullBio )
 
 public:
     /**
      * ArtistWidget constructor
      * @param artist The pointer to the artist item
      * @param parent The widget parent
      * @param wFlags The Qt::WindowFlags
      */
     explicit ArtistWidget( const SimilarArtistPtr &artist,
                   QGraphicsWidget *parent = nullptr, Qt::WindowFlags wFlags = 0 );
 
     /**
      * ArtistWidget destructor
      */
     ~ArtistWidget();
 
     virtual void paint( QPainter *p, const QStyleOptionGraphicsItem *option, QWidget *widget = 0 );
 
     /**
      * Pointer to the similar artist this widget is associated with
      */
     SimilarArtistPtr artist() const;
 
     /**
      * Clean the widget => the content of the QLabel is empty
      */
     void clear();
 
     /**
      * The date/time the bio was published
      * @return date/time
      */
     KDateTime bioPublished() const;
 
     /**
      * Complete bio of artist on last.fm
      * @return bio of artist
      */
     QString fullBio() const;
 
     /**
      * Change the most known track of this artist
      * @param topTrack the top track of this artist
      */
     void setTopTrack( const QString &topTrack );
 
     bool eventFilter( QObject *obj, QEvent *event );
 
 Q_SIGNALS:
     /**
      * Show similar artists to the artist associated with this widget
      */
     void showSimilarArtists();
 
     /**
      * Show full bio of artist
      */
     void showBio();
 
 protected:
     void resizeEvent( QGraphicsSceneResizeEvent *event );
 
 private:
     void fetchPhoto();       //!< Fetch the photo of the artist
     void fetchInfo();        //!< Fetch the artist info
     void fetchTopTrack();    //!< Fetch the artist'stop track
 
     /**
      * Set the artist bio summary
      * @param bio The bio of this artist
      */
     void setBioSummary( const QString &bio );
 
     /**
      * Set artist tags
      */
     void setTags();
 
     /**
      * Layout the text for artist's bio summary
      */
     void layoutBio();
 
     /**
      * Layout for the formatting of the widget contents
      */
     QGraphicsGridLayout *m_layout;
 
     /**
      * Image of the artist
      */
     QLabel *m_image;
 
     /**
      * Label showing the name of the artist
      */
     QLabel *m_nameLabel;
 
     /**
      * Similarity match percentage
      */
     QLabel *m_match;
 
     /**
      * Title of the top track
      */
     QString m_topTrackTitle;
 
     /**
      * Label showing the title of the top track of the artist
      */
     QLabel *m_topTrackLabel;
 
     /**
      * Label showing artist tags
      */
     QLabel *m_tagsLabel;
 
     /**
      * Meta::LabelPtr to the top track, if it's in a collection
      */
     Meta::TrackPtr m_topTrack;
 
     /**
      * Button to add the top track to the playlist
      */
     Plasma::PushButton *m_topTrackButton;
 
     /**
      * Button to add the last.fm similar artist station for this artist to the playlist
      */
     Plasma::PushButton *m_lastfmStationButton;
 
     /**
      * Button to navigate to the artist in the local collection
      */
     Plasma::PushButton *m_navigateButton;
 
     /**
      * Button to open Last.fm's artist webpage using external browser
      */
     Plasma::PushButton *m_urlButton;
 
     /**
      * Button to show similar artists to the artist associated with this widget
      */
     Plasma::PushButton *m_similarArtistButton;
 
     /**
      * Bio summary of the artist
      */
     QGraphicsWidget *m_bio;
 
     /**
      * Text layout for the artist bio
      */
     QTextLayout m_bioLayout;
 
     /**
      * Whether all of artist bio is shown
      */
     bool m_bioCropped;
 
     /**
      * The complete bio with its published date
      */
     QPair<KDateTime, QString> m_fullBio;
 
     /**
      * List of artist tags
      */
     QStringList m_tags;
 
     const SimilarArtistPtr m_artist;
 
 private Q_SLOTS:
     /**
      * Handle artist photo retrieved from Last.fm
      */
     void photoFetched( const QUrl &url, QByteArray data, NetworkAccessManagerProxy::Error e );
 
     /**
      * Parse the xml fetched on the lastFM API for the artist info.
      * Launched when the download of the data are finished and for each similarArtists.
      */
     void parseInfo( const QUrl &url, QByteArray data, NetworkAccessManagerProxy::Error e );
 
     /**
      * Parse the xml fetched on the lastFM API for the similarArtist most known track.
      * Launched when the download of the data are finished and for each similarArtists.
      */
     void parseTopTrack( const QUrl &url, QByteArray data, NetworkAccessManagerProxy::Error e );
 
     /**
      * Open an URL
      * @param url The URL of the artist
      */
     void openArtistUrl();
 
     /**
      * Add top track to the playlist
      */
     void addTopTrackToPlaylist();
 
     /**
      * Navigate to this artist in the local collection
      */
     void navigateToArtist();
 
     /**
      * Add this artists last.fm similar artist stream
      */
     void addLastfmArtistStation();
 
     /**
      * Get results from the query maker
      */
     void resultReady( const Meta::TrackList &tracks );
 
     void updateInfo();
 };
 
 class ArtistsListWidget : public Plasma::ScrollWidget
 {
     Q_OBJECT
     Q_PROPERTY( QString name READ name WRITE setName )
 
 public:
     explicit ArtistsListWidget( QGraphicsWidget *parent = nullptr );
     ~ArtistsListWidget();
 
     int count() const;
     bool isEmpty() const;
 
     void addArtists( const SimilarArtist::List &artists );
 
     QString name() const;
     void setName( const QString &name );
 
     void clear();
 
     ArtistWidget *widget( const QString &artistName );
 
     QSizeF sizeHint( Qt::SizeHint which, const QSizeF &constraint = QSizeF() ) const;
 
 Q_SIGNALS:
     void showSimilarArtists( const QString &artist );
     void showBio( const QString &artist );
 
 private:
     void addArtist( const SimilarArtistPtr &artist );
     void addSeparator();
     int m_separatorCount;
     QString m_name;
     QGraphicsLinearLayout *m_layout;
     QSignalMapper *m_showArtistsSigMapper;
     QSignalMapper *m_showBioSigMapper;
     QList<ArtistWidget*> m_widgets;
     Q_DISABLE_COPY( ArtistsListWidget )
 };
 
 #endif // ARTIST_WIDGET_H