![]() |
|
00001 /*************************************************************************** 00002 copyright : (C) 2002 - 2008 by Scott Wheeler 00003 email : wheeler@kde.org 00004 ***************************************************************************/ 00005 00006 /*************************************************************************** 00007 * This library is free software; you can redistribute it and/or modify * 00008 * it under the terms of the GNU Lesser General Public License version * 00009 * 2.1 as published by the Free Software Foundation. * 00010 * * 00011 * This library is distributed in the hope that it will be useful, but * 00012 * WITHOUT ANY WARRANTY; without even the implied warranty of * 00013 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * 00014 * Lesser General Public License for more details. * 00015 * * 00016 * You should have received a copy of the GNU Lesser General Public * 00017 * License along with this library; if not, write to the Free Software * 00018 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA * 00019 * 02110-1301 USA * 00020 * * 00021 * Alternatively, this file is available under the Mozilla Public * 00022 * License Version 1.1. You may obtain a copy of the License at * 00023 * http://www.mozilla.org/MPL/ * 00024 ***************************************************************************/ 00025 00026 #ifndef TAGLIB_VORBISFILE_H 00027 #define TAGLIB_VORBISFILE_H 00028 00029 #include "taglib_export.h" 00030 #include "oggfile.h" 00031 #include "xiphcomment.h" 00032 00033 #include "vorbisproperties.h" 00034 00035 namespace TagLib { 00036 00037 /* 00038 * This is just to make this appear to be in the Ogg namespace in the 00039 * documentation. The typedef below will make this work with the current code. 00040 * In the next BIC version of TagLib this will be really moved into the Ogg 00041 * namespace. 00042 */ 00043 00044 #ifdef DOXYGEN 00045 namespace Ogg { 00046 #endif 00047 00049 00050 namespace Vorbis { 00051 00052 00054 00062 class TAGLIB_EXPORT File : public Ogg::File 00063 { 00064 public: 00071 File(FileName file, bool readProperties = true, 00072 Properties::ReadStyle propertiesStyle = Properties::Average); 00073 00083 File(IOStream *stream, bool readProperties = true, 00084 Properties::ReadStyle propertiesStyle = Properties::Average); 00085 00089 virtual ~File(); 00090 00096 virtual Ogg::XiphComment *tag() const; 00097 00098 00103 PropertyMap properties() const; 00104 00109 PropertyMap setProperties(const PropertyMap &); 00110 00115 virtual Properties *audioProperties() const; 00116 00125 virtual bool save(); 00126 00127 private: 00128 File(const File &); 00129 File &operator=(const File &); 00130 00131 void read(bool readProperties); 00132 00133 class FilePrivate; 00134 FilePrivate *d; 00135 }; 00136 } 00137 00138 /* 00139 * To keep compatibility with the current version put Vorbis in the Ogg namespace 00140 * only in the docs and provide a typedef to make it work. In the next BIC 00141 * version this will be removed and it will only exist in the Ogg namespace. 00142 */ 00143 00144 #ifdef DOXYGEN 00145 } 00146 #else 00147 namespace Ogg { namespace Vorbis { typedef TagLib::Vorbis::File File; } } 00148 #endif 00149 00150 } 00151 00152 #endif