wavfile.h
Go to the documentation of this file.
1 /***************************************************************************
2  copyright : (C) 2008 by Scott Wheeler
3  email : wheeler@kde.org
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_WAVFILE_H
27 #define TAGLIB_WAVFILE_H
28 
29 #include "rifffile.h"
30 #include "id3v2tag.h"
31 #include "infotag.h"
32 #include "wavproperties.h"
33 
34 namespace TagLib {
35 
36  namespace RIFF {
37 
39 
47  namespace WAV {
48 
50 
59  {
60  public:
61  enum TagTypes {
63  NoTags = 0x0000,
65  ID3v2 = 0x0001,
67  Info = 0x0002,
69  AllTags = 0xffff
70  };
71 
78  File(FileName file, bool readProperties = true,
79  Properties::ReadStyle propertiesStyle = Properties::Average);
80 
90  File(IOStream *stream, bool readProperties = true,
91  Properties::ReadStyle propertiesStyle = Properties::Average);
92 
96  virtual ~File();
97 
104  ID3v2::Tag *tag() const;
105 
116 
126  Info::Tag *InfoTag() const;
127 
135  void strip(TagTypes tags = AllTags);
136 
142 
143  void removeUnsupportedProperties(const StringList &properties);
144 
150 
155  virtual Properties *audioProperties() const;
156 
160  virtual bool save();
161 
165  TAGLIB_DEPRECATED bool save(TagTypes tags, bool stripOthers, int id3v2Version = 4);
166 
173  bool save(TagTypes tags, StripTags strip = StripOthers,
174  ID3v2::Version version = ID3v2::v4);
175 
181  bool hasID3v2Tag() const;
182 
188  bool hasInfoTag() const;
189 
197  static bool isSupported(IOStream *stream);
198 
199  private:
200  File(const File &);
201  File &operator=(const File &);
202 
203  void read(bool readProperties);
204  void removeTagChunks(TagTypes tags);
205 
206  friend class Properties;
207 
208  class FilePrivate;
209  FilePrivate *d;
210  };
211  }
212  }
213 }
214 
215 #endif
ReadStyle
Definition: audioproperties.h:53
@ Average
Read more of the file and make better values guesses.
Definition: audioproperties.h:57
StripTags
Definition: tfile.h:68
The main class in the ID3v2 implementation.
Definition: id3v2tag.h:128
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:114
An RIFF file class with some useful methods specific to RIFF.
Definition: rifffile.h:47
The main class in the ID3v2 implementation.
Definition: infotag.h:89
An implementation of TagLib::File with WAV specific methods.
Definition: wavfile.h:59
TAGLIB_DEPRECATED bool save(TagTypes tags, bool stripOthers, int id3v2Version=4)
virtual Properties * audioProperties() const
bool hasID3v2Tag() const
void removeUnsupportedProperties(const StringList &properties)
void strip(TagTypes tags=AllTags)
ID3v2::Tag * tag() const
PropertyMap setProperties(const PropertyMap &)
File(IOStream *stream, bool readProperties=true, Properties::ReadStyle propertiesStyle=Properties::Average)
File(FileName file, bool readProperties=true, Properties::ReadStyle propertiesStyle=Properties::Average)
static bool isSupported(IOStream *stream)
TagTypes
Definition: wavfile.h:61
Info::Tag * InfoTag() const
PropertyMap properties() const
bool save(TagTypes tags, StripTags strip=StripOthers, ID3v2::Version version=ID3v2::v4)
ID3v2::Tag * ID3v2Tag() const
An implementation of audio property reading for WAV.
Definition: wavproperties.h:50
A list of strings.
Definition: tstringlist.h:46
Version
Definition: id3v2.h:17
@ v4
Definition: id3v2.h:19
A namespace for all TagLib related classes and functions.
Definition: apefile.h:41
const char * FileName
Definition: tiostream.h:57
#define TAGLIB_DEPRECATED
Definition: taglib.h:54
#define TAGLIB_EXPORT
Definition: taglib_export.h:40