1
/***************************************************************************
2
copyright : (C) 2006 by Lukáš Lalinský
3
email : lalinsky@gmail.com
5
copyright : (C) 2002 by Scott Wheeler
6
email : wheeler@kde.org
7
(original Vorbis implementation)
8
***************************************************************************/
10
/***************************************************************************
11
* This library is free software; you can redistribute it and/or modify *
12
* it under the terms of the GNU Lesser General Public License version *
13
* 2.1 as published by the Free Software Foundation. *
15
* This library is distributed in the hope that it will be useful, but *
16
* WITHOUT ANY WARRANTY; without even the implied warranty of *
17
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
18
* Lesser General Public License for more details. *
20
* You should have received a copy of the GNU Lesser General Public *
21
* License along with this library; if not, write to the Free Software *
22
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, *
24
***************************************************************************/
26
#ifndef TAGLIB_SPEEXFILE_H
27
#define TAGLIB_SPEEXFILE_H
30
#include <xiphcomment.h>
32
#include "speexproperties.h"
38
//! A namespace containing classes for Speex metadata
42
//! An implementation of Ogg::File with Speex specific methods
45
* This is the central class in the Ogg Speex metadata processing collection
46
* of classes. It's built upon Ogg::File which handles processing of the Ogg
47
* logical bitstream and breaking it down into pages which are handled by
48
* the codec implementations, in this case Speex specifically.
51
class File : public Ogg::File
55
* Contructs a Speex file from \a file. If \a readProperties is true the
56
* file's audio properties will also be read using \a propertiesStyle. If
57
* false, \a propertiesStyle is ignored.
59
explicit File(const char *file, bool readProperties = true,
60
Properties::ReadStyle propertiesStyle = Properties::Average);
63
* Destroys this instance of the File.
68
* Returns the XiphComment for this file. XiphComment implements the tag
69
* interface, so this serves as the reimplementation of
70
* TagLib::File::tag().
72
virtual Ogg::XiphComment *tag() const;
75
* Returns the Speex::Properties for this file. If no audio properties
76
* were read then this will return a null pointer.
78
virtual Properties *audioProperties() const;
84
File &operator=(const File &);
86
void read(bool readProperties, Properties::ReadStyle propertiesStyle);