mirror of
https://github.com/taglib/taglib.git
synced 2025-05-27 21:20:26 -04:00
7fe6647435
a server-side copy/move. git-svn-id: svn://anonsvn.kde.org/home/kde/trunk/kdesupport/taglib@288617 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
156 lines
4.0 KiB
C++
156 lines
4.0 KiB
C++
/***************************************************************************
|
|
copyright : (C) 2003 by Scott Wheeler
|
|
email : wheeler@kde.org
|
|
***************************************************************************/
|
|
|
|
/***************************************************************************
|
|
* This library is free software; you can redistribute it and/or modify *
|
|
* it under the terms of the GNU Lesser General Public License version *
|
|
* 2.1 as published by the Free Software Foundation. *
|
|
* *
|
|
* This library is distributed in the hope that it will be useful, but *
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of *
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
|
|
* Lesser General Public License for more details. *
|
|
* *
|
|
* You should have received a copy of the GNU Lesser General Public *
|
|
* License along with this library; if not, write to the Free Software *
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 *
|
|
* USA *
|
|
***************************************************************************/
|
|
|
|
#ifndef TAGLIB_MPEGHEADER_H
|
|
#define TAGLIB_MPEGHEADER_H
|
|
|
|
namespace TagLib {
|
|
|
|
class ByteVector;
|
|
|
|
namespace MPEG {
|
|
|
|
//! An implementation of MP3 frame headers
|
|
|
|
/*!
|
|
* This is an implementation of MPEG Layer III headers. The API follows more
|
|
* or less the binary format of these headers. I've used
|
|
* <a href="http://www.mp3-tech.org/programmer/frame_header.html">this</a>
|
|
* document as a reference.
|
|
*/
|
|
|
|
class Header
|
|
{
|
|
public:
|
|
/*!
|
|
* Parses an MPEG header based on \a data.
|
|
*/
|
|
Header(const ByteVector &data);
|
|
|
|
/*!
|
|
* Does a shallow copy of \a h.
|
|
*/
|
|
Header(const Header &h);
|
|
|
|
/*!
|
|
* Destroys this Header instance.
|
|
*/
|
|
virtual ~Header();
|
|
|
|
/*!
|
|
* Returns true if the frame is at least an appropriate size and has
|
|
* legal values.
|
|
*/
|
|
bool isValid() const;
|
|
|
|
/*!
|
|
* The MPEG Version.
|
|
*/
|
|
enum Version {
|
|
//! MPEG Version 1
|
|
Version1 = 0,
|
|
//! MPEG Version 2
|
|
Version2 = 1,
|
|
//! MPEG Version 2.5
|
|
Version2_5 = 2
|
|
};
|
|
|
|
/*!
|
|
* Returns the MPEG Version of the header.
|
|
*/
|
|
Version version() const;
|
|
|
|
/*!
|
|
* Returns the layer version. This will be between the values 1-3.
|
|
*/
|
|
int layer() const;
|
|
|
|
/*!
|
|
* Returns true if the MPEG protection bit is enabled.
|
|
*/
|
|
bool protectionEnabled() const;
|
|
|
|
/*!
|
|
* Returns the bitrate encoded in the header.
|
|
*/
|
|
int bitrate() const;
|
|
|
|
/*!
|
|
* Returns the sample rate in Hz.
|
|
*/
|
|
int sampleRate() const;
|
|
|
|
/*!
|
|
* Returns true if the frame is padded.
|
|
*/
|
|
bool isPadded() const;
|
|
|
|
/*!
|
|
* There are a few combinations or one or two channel audio that are
|
|
* possible:
|
|
*/
|
|
enum ChannelMode {
|
|
//! Stereo
|
|
Stereo = 0,
|
|
//! Stereo
|
|
JointStereo = 1,
|
|
//! Dual Mono
|
|
DualChannel = 2,
|
|
//! Mono
|
|
SingleChannel = 3
|
|
};
|
|
|
|
/*!
|
|
* Returns the channel mode for this frame.
|
|
*/
|
|
ChannelMode channelMode() const;
|
|
|
|
/*!
|
|
* Returns true if the copyrighted bit is set.
|
|
*/
|
|
bool isCopyrighted() const;
|
|
|
|
/*!
|
|
* Returns true if the "original" bit is set.
|
|
*/
|
|
bool isOriginal() const;
|
|
|
|
/*!
|
|
* Returns the frame length.
|
|
*/
|
|
int frameLength() const;
|
|
|
|
/*!
|
|
* Makes a shallow copy of the header.
|
|
*/
|
|
Header &operator=(const Header &h);
|
|
|
|
private:
|
|
void parse(const ByteVector &data);
|
|
|
|
class HeaderPrivate;
|
|
HeaderPrivate *d;
|
|
};
|
|
}
|
|
}
|
|
|
|
#endif
|