TagLib  1.13.1
apefile.h
Go to the documentation of this file.
1 /***************************************************************************
2  copyright : (C) 2010 by Alex Novichkov
3  email : novichko@atnet.ru
4 
5  copyright : (C) 2006 by Lukáš Lalinský
6  email : lalinsky@gmail.com
7  (original WavPack implementation)
8 
9  copyright : (C) 2004 by Allan Sandfeld Jensen
10  email : kde@carewolf.org
11  (original MPC implementation)
12  ***************************************************************************/
13 
14 /***************************************************************************
15  * This library is free software; you can redistribute it and/or modify *
16  * it under the terms of the GNU Lesser General Public License version *
17  * 2.1 as published by the Free Software Foundation. *
18  * *
19  * This library is distributed in the hope that it will be useful, but *
20  * WITHOUT ANY WARRANTY; without even the implied warranty of *
21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
22  * Lesser General Public License for more details. *
23  * *
24  * You should have received a copy of the GNU Lesser General Public *
25  * License along with this library; if not, write to the Free Software *
26  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA *
27  * 02110-1301 USA *
28  * *
29  * Alternatively, this file is available under the Mozilla Public *
30  * License Version 1.1. You may obtain a copy of the License at *
31  * http://www.mozilla.org/MPL/ *
32  ***************************************************************************/
33 
34 #ifndef TAGLIB_APEFILE_H
35 #define TAGLIB_APEFILE_H
36 
37 #include "tfile.h"
38 #include "taglib_export.h"
39 #include "apeproperties.h"
40 
41 namespace TagLib {
42 
43  class Tag;
44 
45  namespace ID3v1 { class Tag; }
46  namespace APE { class Tag; }
47 
49 
57  namespace APE {
58 
60 
69  {
70  public:
75  enum TagTypes {
77  NoTags = 0x0000,
79  ID3v1 = 0x0001,
81  APE = 0x0002,
83  AllTags = 0xffff
84  };
85 
92  File(FileName file, bool readProperties = true,
93  Properties::ReadStyle propertiesStyle = Properties::Average);
94 
104  File(IOStream *stream, bool readProperties = true,
105  Properties::ReadStyle propertiesStyle = Properties::Average);
106 
110  virtual ~File();
111 
116  virtual TagLib::Tag *tag() const;
117 
124 
129  void removeUnsupportedProperties(const StringList &properties);
130 
137 
142  virtual Properties *audioProperties() const;
143 
150  virtual bool save();
151 
169  ID3v1::Tag *ID3v1Tag(bool create = false);
170 
188  APE::Tag *APETag(bool create = false);
189 
198  void strip(int tags = AllTags);
199 
205  bool hasAPETag() const;
206 
212  bool hasID3v1Tag() const;
213 
221  static bool isSupported(IOStream *stream);
222 
223  private:
224  File(const File &);
225  File &operator=(const File &);
226 
227  void read(bool readProperties);
228 
229  class FilePrivate;
230  FilePrivate *d;
231  };
232  } // namespace APE
233 } // namespace TagLib
234 
235 #endif
An implementation of TagLib::File with APE specific methods.
Definition: apefile.h:69
static bool isSupported(IOStream *stream)
void removeUnsupportedProperties(const StringList &properties)
TagTypes
Definition: apefile.h:75
PropertyMap properties() const
File(IOStream *stream, bool readProperties=true, Properties::ReadStyle propertiesStyle=Properties::Average)
APE::Tag * APETag(bool create=false)
void strip(int tags=AllTags)
File(FileName file, bool readProperties=true, Properties::ReadStyle propertiesStyle=Properties::Average)
bool hasAPETag() const
virtual bool save()
ID3v1::Tag * ID3v1Tag(bool create=false)
PropertyMap setProperties(const PropertyMap &)
virtual TagLib::Tag * tag() const
virtual Properties * audioProperties() const
bool hasID3v1Tag() const
An implementation of audio property reading for APE.
Definition: apeproperties.h:50
An APE tag implementation.
Definition: apetag.h:58
ReadStyle
Definition: audioproperties.h:53
@ Average
Read more of the file and make better values guesses.
Definition: audioproperties.h:57
A file class with some useful methods for tag manipulation.
Definition: tfile.h:51
The main class in the ID3v1 implementation.
Definition: id3v1tag.h:106
An abstract class that provides operations on a sequence of bytes.
Definition: tiostream.h:63
A map for format-independent <key,valuelist> tag representations.
Definition: tpropertymap.h:119
A list of strings.
Definition: tstringlist.h:46
Definition: tag.h:47
A namespace for all TagLib related classes and functions.
Definition: apefile.h:41
const char * FileName
Definition: tiostream.h:57
#define TAGLIB_EXPORT
Definition: taglib_export.h:40