1 /***************************************************************************
2 copyright : (C) 2008 by Lukas Lalinsky
3 email : lalinsky@gmail.com
4 ***************************************************************************/
6 /***************************************************************************
7 * This library is free software; you can redistribute it and/or modify *
8 * it under the terms of the GNU Lesser General Public License version *
9 * 2.1 as published by the Free Software Foundation. *
11 * This library is distributed in the hope that it will be useful, but *
12 * WITHOUT ANY WARRANTY; without even the implied warranty of *
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
14 * Lesser General Public License for more details. *
16 * You should have received a copy of the GNU Lesser General Public *
17 * License along with this library; if not, write to the Free Software *
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 *
21 * Alternatively, this file is available under the Mozilla Public *
22 * License Version 1.1. You may obtain a copy of the License at *
23 * http://www.mozilla.org/MPL/ *
24 ***************************************************************************/
26 #ifndef TAGLIB_POPULARIMETERFRAME_H
27 #define TAGLIB_POPULARIMETERFRAME_H
29 #include "id3v2frame.h"
30 #include "taglib_export.h"
36 //! An implementation of ID3v2 "popularimeter"
39 * This implements the ID3v2 popularimeter (POPM frame). It concists of
40 * an email, a rating and an optional counter.
43 class TAGLIB_EXPORT PopularimeterFrame : public Frame
45 friend class FrameFactory;
49 * Construct an empty popularimeter frame.
51 explicit PopularimeterFrame();
54 * Construct a popularimeter based on the data in \a data.
56 explicit PopularimeterFrame(const ByteVector &data);
59 * Destroys this PopularimeterFrame instance.
61 virtual ~PopularimeterFrame();
64 * Returns the text of this popularimeter.
68 virtual String toString() const;
82 void setEmail(const String &email);
96 void setRating(int rating);
99 * Returns the counter.
103 uint counter() const;
110 void setCounter(uint counter);
113 // Reimplementations.
115 virtual void parseFields(const ByteVector &data);
116 virtual ByteVector renderFields() const;
120 * The constructor used by the FrameFactory.
122 PopularimeterFrame(const ByteVector &data, Header *h);
123 PopularimeterFrame(const PopularimeterFrame &);
124 PopularimeterFrame &operator=(const PopularimeterFrame &);
126 class PopularimeterFramePrivate;
127 PopularimeterFramePrivate *d;