tagparser/adts/adtsframe.h

152 lines
3.3 KiB
C++

#ifndef TAG_PARSER_ADTSFRAME_H
#define TAG_PARSER_ADTSFRAME_H
#include "../global.h"
#include <cstdint>
namespace CppUtilities {
class BinaryReader;
}
namespace TagParser {
class TAG_PARSER_EXPORT AdtsFrame {
public:
constexpr AdtsFrame();
void parseHeader(CppUtilities::BinaryReader &reader);
constexpr bool isValid() const;
constexpr bool isMpeg4() const;
constexpr bool hasCrc() const;
constexpr std::uint8_t mpeg4AudioObjectId() const;
constexpr std::uint8_t mpeg4SamplingFrequencyIndex() const;
constexpr std::uint8_t mpeg4ChannelConfig() const;
constexpr std::uint16_t totalSize() const;
constexpr std::uint8_t headerSize() const;
constexpr std::uint16_t dataSize() const;
constexpr std::uint16_t bufferFullness() const;
constexpr std::uint8_t frameCount() const;
constexpr std::uint16_t crc() const;
private:
std::uint16_t m_header1;
std::uint64_t m_header2;
};
/*!
* \brief Constructs a new frame.
*/
constexpr AdtsFrame::AdtsFrame()
: m_header1(0)
, m_header2(0)
{
}
/*!
* \brief Returns an indication whether the frame is valid.
*/
constexpr bool AdtsFrame::isValid() const
{
return ((m_header1 & 0xFFF6u) == 0xFFF0u) && (totalSize() >= headerSize());
}
/*!
* \brief Returns whether the MPEG version is MPEG-4; otherwise the MPEG version is MPEG-2.
*/
constexpr bool AdtsFrame::isMpeg4() const
{
return m_header1 & 0x8u;
}
/*!
* \brief Returns whether a CRC-16 checksum is present ("protection absent" bit is NOT set).
*/
constexpr bool AdtsFrame::hasCrc() const
{
return (m_header1 & 0x1u) == 0;
}
/*!
* \brief Returns the MPEG-4 audio object type ID.
* \sa TagParser::Mpeg4AudioObjectIds
* \sa Mpeg4AudioObjectIds::idToMediaFormat()
*/
constexpr std::uint8_t AdtsFrame::mpeg4AudioObjectId() const
{
return (m_header2 >> 0x36) + 0x1u;
}
/*!
* \brief Returns the MPEG-4 sample rate index.
* \sa TagParser::mpeg4SampleRateTable
*/
constexpr std::uint8_t AdtsFrame::mpeg4SamplingFrequencyIndex() const
{
return (m_header2 >> 0x32) & 0xFu;
}
/*!
* \brief Returns the MPEG-4 channel configuration.
* \sa TagParser::Mpeg4ChannelConfigs
* \sa TagParser::mpeg4SampleRateTable::channelConfigString()
*/
constexpr std::uint8_t AdtsFrame::mpeg4ChannelConfig() const
{
return (m_header2 >> 0x2E) & 0x7u;
}
/*!
* \brief Returns the size of the frame (including the header) in bytes.
*/
constexpr std::uint16_t AdtsFrame::totalSize() const
{
return (m_header2 >> 0x1D) & 0x1FFFu;
}
/*!
* \brief Retruns the header size in bytes (9 if CRC is present; otherwise 7).
*/
constexpr std::uint8_t AdtsFrame::headerSize() const
{
return hasCrc() ? 9 : 7;
}
/*!
* \brief Returns the data size (total size minus header size) in bytes.
*/
constexpr std::uint16_t AdtsFrame::dataSize() const
{
return totalSize() - headerSize();
}
/*!
* \brief Returns the buffer fullness.
*/
constexpr std::uint16_t AdtsFrame::bufferFullness() const
{
return (m_header2 >> 0x12) & 0x7FFu;
}
/*!
* \brief Returns the number of AAC frames (RDBs) in the ADTS frame.
*/
constexpr std::uint8_t AdtsFrame::frameCount() const
{
return ((m_header2 >> 0x10) & 0x3u) + 0x1u;
}
/*!
* \brief Returns the CRC-16 checksum of the frame.
* \sa hasCrc()
*/
constexpr std::uint16_t AdtsFrame::crc() const
{
return m_header2 & 0xFFFFu;
}
} // namespace TagParser
#endif // TAG_PARSER_ADTSFRAME_H