TagLib API Documentation
chapterframe.h
Go to the documentation of this file.
1/***************************************************************************
2 copyright : (C) 2013 by Lukas Krejci
3 email : krejclu6@fel.cvut.cz
4 ***************************************************************************/
5
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. *
10 * *
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. *
15 * *
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., 51 Franklin Street, Fifth Floor, Boston, MA *
19 * 02110-1301 USA *
20 * *
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 ***************************************************************************/
25
26#ifndef TAGLIB_CHAPTERFRAME
27#define TAGLIB_CHAPTERFRAME
28
29#include "taglib_export.h"
30#include "id3v2tag.h"
31#include "id3v2frame.h"
32
33namespace TagLib {
34
35 namespace ID3v2 {
36
43
45 {
46 friend class FrameFactory;
47
48 public:
53 ChapterFrame(const ID3v2::Header *tagHeader, const ByteVector &data);
54
64 ChapterFrame(const ByteVector &elementID,
65 unsigned int startTime, unsigned int endTime,
66 unsigned int startOffset, unsigned int endOffset,
67 const FrameList &embeddedFrames = FrameList());
68
72 ~ChapterFrame() override;
73
74 ChapterFrame(const ChapterFrame &) = delete;
76
84
90 unsigned int startTime() const;
91
97 unsigned int endTime() const;
98
106 unsigned int startOffset() const;
107
115 unsigned int endOffset() const;
116
123 void setElementID(const ByteVector &eID);
124
130 void setStartTime(const unsigned int &sT);
131
137 void setEndTime(const unsigned int &eT);
138
145 void setStartOffset(const unsigned int &sO);
146
153 void setEndOffset(const unsigned int &eO);
154
170
183
195 const FrameList &embeddedFrameList(const ByteVector &frameID) const;
196
205
213 void removeEmbeddedFrame(Frame *frame, bool del = true);
214
223
224 String toString() const override;
225
226 PropertyMap asProperties() const override;
227
235 static ChapterFrame *findByElementID(const Tag *tag, const ByteVector &eID);
236
237 protected:
238 void parseFields(const ByteVector &data) override;
239 ByteVector renderFields() const override;
240
241 private:
242 ChapterFrame(const ID3v2::Header *tagHeader, const ByteVector &data, Header *h);
243
244 class ChapterFramePrivate;
246 std::unique_ptr<ChapterFramePrivate> d;
247 };
248 } // namespace ID3v2
249} // namespace TagLib
250
251#endif
A byte vector.
Definition: tbytevector.h:46
An implementation of ID3v2 chapter frames.
Definition: chapterframe.h:45
ByteVector elementID() const
ChapterFrame(const ID3v2::Header *tagHeader, const ByteVector &data)
void addEmbeddedFrame(Frame *frame)
void setEndTime(const unsigned int &eT)
unsigned int endTime() const
const FrameListMap & embeddedFrameListMap() const
unsigned int startTime() const
void setElementID(const ByteVector &eID)
unsigned int endOffset() const
void removeEmbeddedFrames(const ByteVector &id)
const FrameList & embeddedFrameList() const
ChapterFrame(const ByteVector &elementID, unsigned int startTime, unsigned int endTime, unsigned int startOffset, unsigned int endOffset, const FrameList &embeddedFrames=FrameList())
void parseFields(const ByteVector &data) override
ChapterFrame(const ChapterFrame &)=delete
void removeEmbeddedFrame(Frame *frame, bool del=true)
void setStartTime(const unsigned int &sT)
void setEndOffset(const unsigned int &eO)
ChapterFrame & operator=(const ChapterFrame &)=delete
const FrameList & embeddedFrameList(const ByteVector &frameID) const
PropertyMap asProperties() const override
void setStartOffset(const unsigned int &sO)
ByteVector renderFields() const override
static ChapterFrame * findByElementID(const Tag *tag, const ByteVector &eID)
unsigned int startOffset() const
String toString() const override
A factory for creating ID3v2 frames during parsing.
Definition: id3v2framefactory.h:68
ID3v2 frame implementation.
Definition: id3v2frame.h:57
An implementation of ID3v2 headers.
Definition: id3v2header.h:49
The main class in the ID3v2 implementation.
Definition: id3v2tag.h:134
A generic, implicitly shared list.
Definition: tlist.h:54
A generic, implicitly shared map.
Definition: tmap.h:45
A map for format-independent <key,values> tag representations.
Definition: tpropertymap.h:123
A wide string class suitable for unicode.
Definition: tstring.h:83
List< Frame * > FrameList
Definition: id3v2tag.h:48
A namespace for all TagLib related classes and functions.
Definition: apefile.h:41
#define TAGLIB_EXPORT
Definition: taglib_export.h:40
#define TAGLIB_MSVC_SUPPRESS_WARNING_NEEDS_TO_HAVE_DLL_INTERFACE
Definition: taglib_export.h:55