tagparser/aspectratio.h

#ifndef TAG_PARSER_ASPECTRATIO_H
#define TAG_PARSER_ASPECTRATIO_H

#include "./global.h"

#include <c++utilities/conversion/types.h>

namespace TagParser {

struct TAG_PARSER_EXPORT AspectRatio {
    constexpr AspectRatio();
    AspectRatio(byte aspectRatioType);
    constexpr AspectRatio(uint16 numerator, uint16 denominator);
    constexpr bool isValid() const;
    constexpr bool isExtended() const;

    byte type;
    uint16 numerator;
    uint16 denominator;
};

/*!
 * \brief Constructs an invalid aspect ratio.
 */
constexpr AspectRatio::AspectRatio()
    : type(0)
    , numerator(0)
    , denominator(0)
{
}

/*!
 * \brief Constructs a aspect ratio with the specified \a numerator and \a denominator.
 * \remarks Allows defining a custom aspect ratio, hence counts as "extended" (see isExtended()).
 */
constexpr AspectRatio::AspectRatio(uint16 numerator, uint16 denominator)
    : type(0xFF)
    , numerator(numerator)
    , denominator(denominator)
{
}

/*!
 * \brief Returns an indication whether the aspect ratio is present and valid.
 */
constexpr bool AspectRatio::isValid() const
{
    return type && numerator && denominator;
}

/*!
 * \brief Returns whether numerator and denominator must be read from extended SAR header.
 */
constexpr bool AspectRatio::isExtended() const
{
    return type == 0xFF;
}

} // namespace TagParser

#endif // TAG_PARSER_ASPECTRATIO_H