| /**************************************************************************** |
| ** |
| ** Copyright (C) 2015 The Qt Company Ltd. |
| ** Contact: http://www.qt.io/licensing/ |
| ** |
| ** This file is part of the QtGui module of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:LGPL21$ |
| ** Commercial License Usage |
| ** Licensees holding valid commercial Qt licenses may use this file in |
| ** accordance with the commercial license agreement provided with the |
| ** Software or, alternatively, in accordance with the terms contained in |
| ** a written agreement between you and The Qt Company. For licensing terms |
| ** and conditions see http://www.qt.io/terms-conditions. For further |
| ** information use the contact form at http://www.qt.io/contact-us. |
| ** |
| ** GNU Lesser General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU Lesser |
| ** General Public License version 2.1 or version 3 as published by the Free |
| ** Software Foundation and appearing in the file LICENSE.LGPLv21 and |
| ** LICENSE.LGPLv3 included in the packaging of this file. Please review the |
| ** following information to ensure the GNU Lesser General Public License |
| ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and |
| ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. |
| ** |
| ** As a special exception, The Qt Company gives you certain additional |
| ** rights. These rights are described in The Qt Company LGPL Exception |
| ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| #ifndef QPIXELFORMAT_H |
| #define QPIXELFORMAT_H |
| |
| #include <QtCore/qglobal.h> |
| |
| QT_BEGIN_NAMESPACE |
| |
| class QPixelFormat |
| { |
| // QPixelFormat basically is a glorified quint64, split into several fields. |
| // We could use bit-fields, but GCC at least generates horrible, horrible code for them, |
| // so we do the bit-twiddling ourselves. |
| enum FieldWidth { |
| ModelFieldWidth = 4, |
| FirstFieldWidth = 6, |
| SecondFieldWidth = FirstFieldWidth, |
| ThirdFieldWidth = FirstFieldWidth, |
| FourthFieldWidth = FirstFieldWidth, |
| FifthFieldWidth = FirstFieldWidth, |
| AlphaFieldWidth = FirstFieldWidth, |
| AlphaUsageFieldWidth = 1, |
| AlphaPositionFieldWidth = 1, |
| PremulFieldWidth = 1, |
| TypeInterpretationFieldWidth = 4, |
| ByteOrderFieldWidth = 2, |
| SubEnumFieldWidth = 6, |
| UnusedFieldWidth = 9, |
| |
| TotalFieldWidthByWidths = ModelFieldWidth + FirstFieldWidth + SecondFieldWidth + ThirdFieldWidth + |
| FourthFieldWidth + FifthFieldWidth + AlphaFieldWidth + AlphaUsageFieldWidth + |
| AlphaPositionFieldWidth + PremulFieldWidth + TypeInterpretationFieldWidth + |
| ByteOrderFieldWidth + SubEnumFieldWidth + UnusedFieldWidth |
| }; |
| |
| enum Field { |
| ModelField = 0, |
| // work around bug in old clang versions: when building webkit |
| // with XCode 4.6 and older this fails compilation, thus cast to int |
| FirstField = ModelField + int(ModelFieldWidth), |
| SecondField = FirstField + FirstFieldWidth, |
| ThirdField = SecondField + SecondFieldWidth, |
| FourthField = ThirdField + ThirdFieldWidth, |
| FifthField = FourthField + FourthFieldWidth, |
| AlphaField = FifthField + FifthFieldWidth, |
| AlphaUsageField = AlphaField + AlphaFieldWidth, |
| AlphaPositionField = AlphaUsageField + AlphaUsageFieldWidth, |
| PremulField = AlphaPositionField + AlphaPositionFieldWidth, |
| TypeInterpretationField = PremulField + PremulFieldWidth, |
| ByteOrderField = TypeInterpretationField + TypeInterpretationFieldWidth, |
| SubEnumField = ByteOrderField + ByteOrderFieldWidth, |
| UnusedField = SubEnumField + SubEnumFieldWidth, |
| |
| TotalFieldWidthByOffsets = UnusedField + UnusedFieldWidth |
| }; |
| |
| Q_STATIC_ASSERT(uint(TotalFieldWidthByWidths) == uint(TotalFieldWidthByOffsets)); |
| Q_STATIC_ASSERT(uint(TotalFieldWidthByWidths) == 8 * sizeof(quint64)); |
| |
| Q_DECL_CONSTEXPR inline uchar get(Field offset, FieldWidth width) const Q_DECL_NOTHROW |
| { return uchar((data >> uint(offset)) & ((Q_UINT64_C(1) << uint(width)) - Q_UINT64_C(1))); } |
| Q_DECL_CONSTEXPR static inline quint64 set(Field offset, FieldWidth width, uchar value) |
| { return (quint64(value) & ((Q_UINT64_C(1) << uint(width)) - Q_UINT64_C(1))) << uint(offset); } |
| |
| public: |
| enum ColorModel { |
| RGB, |
| BGR, |
| Indexed, |
| Grayscale, |
| CMYK, |
| HSL, |
| HSV, |
| YUV, |
| Alpha |
| }; |
| |
| enum AlphaUsage { |
| UsesAlpha, |
| IgnoresAlpha |
| }; |
| |
| enum AlphaPosition { |
| AtBeginning, |
| AtEnd |
| }; |
| |
| enum AlphaPremultiplied { |
| NotPremultiplied, |
| Premultiplied |
| }; |
| |
| enum TypeInterpretation { |
| UnsignedInteger, |
| UnsignedShort, |
| UnsignedByte, |
| FloatingPoint |
| }; |
| |
| enum YUVLayout { |
| YUV444, |
| YUV422, |
| YUV411, |
| YUV420P, |
| YUV420SP, |
| YV12, |
| UYVY, |
| YUYV, |
| NV12, |
| NV21, |
| IMC1, |
| IMC2, |
| IMC3, |
| IMC4, |
| Y8, |
| Y16 |
| }; |
| |
| enum ByteOrder { |
| LittleEndian, |
| BigEndian, |
| CurrentSystemEndian |
| }; |
| |
| Q_DECL_CONSTEXPR inline QPixelFormat() Q_DECL_NOTHROW : data(0) {} |
| Q_DECL_CONSTEXPR inline QPixelFormat(ColorModel colorModel, |
| uchar firstSize, |
| uchar secondSize, |
| uchar thirdSize, |
| uchar fourthSize, |
| uchar fifthSize, |
| uchar alphaSize, |
| AlphaUsage alphaUsage, |
| AlphaPosition alphaPosition, |
| AlphaPremultiplied premultiplied, |
| TypeInterpretation typeInterpretation, |
| ByteOrder byteOrder = CurrentSystemEndian, |
| uchar subEnum = 0) Q_DECL_NOTHROW; |
| |
| Q_DECL_CONSTEXPR inline ColorModel colorModel() const Q_DECL_NOTHROW { return ColorModel(get(ModelField, ModelFieldWidth)); } |
| Q_DECL_CONSTEXPR inline uchar channelCount() const Q_DECL_NOTHROW { return (get(FirstField, FirstFieldWidth) > 0) + |
| (get(SecondField, SecondFieldWidth) > 0) + |
| (get(ThirdField, ThirdFieldWidth) > 0) + |
| (get(FourthField, FourthFieldWidth) > 0) + |
| (get(FifthField, FifthFieldWidth) > 0) + |
| (get(AlphaField, AlphaFieldWidth) > 0); } |
| |
| Q_DECL_CONSTEXPR inline uchar redSize() const Q_DECL_NOTHROW { return get(FirstField, FirstFieldWidth); } |
| Q_DECL_CONSTEXPR inline uchar greenSize() const Q_DECL_NOTHROW { return get(SecondField, SecondFieldWidth); } |
| Q_DECL_CONSTEXPR inline uchar blueSize() const Q_DECL_NOTHROW { return get(ThirdField, ThirdFieldWidth); } |
| |
| Q_DECL_CONSTEXPR inline uchar cyanSize() const Q_DECL_NOTHROW { return get(FirstField, FirstFieldWidth); } |
| Q_DECL_CONSTEXPR inline uchar magentaSize() const Q_DECL_NOTHROW { return get(SecondField, SecondFieldWidth); } |
| Q_DECL_CONSTEXPR inline uchar yellowSize() const Q_DECL_NOTHROW { return get(ThirdField, ThirdFieldWidth); } |
| Q_DECL_CONSTEXPR inline uchar blackSize() const Q_DECL_NOTHROW { return get(FourthField, FourthFieldWidth); } |
| |
| Q_DECL_CONSTEXPR inline uchar hueSize() const Q_DECL_NOTHROW { return get(FirstField, FirstFieldWidth); } |
| Q_DECL_CONSTEXPR inline uchar saturationSize() const Q_DECL_NOTHROW { return get(SecondField, SecondFieldWidth); } |
| Q_DECL_CONSTEXPR inline uchar lightnessSize() const Q_DECL_NOTHROW { return get(ThirdField, ThirdFieldWidth); } |
| Q_DECL_CONSTEXPR inline uchar brightnessSize() const Q_DECL_NOTHROW { return get(ThirdField, ThirdFieldWidth); } |
| |
| Q_DECL_CONSTEXPR inline uchar alphaSize() const Q_DECL_NOTHROW { return get(AlphaField, AlphaFieldWidth); } |
| |
| Q_DECL_CONSTEXPR inline uchar bitsPerPixel() const Q_DECL_NOTHROW { return get(FirstField, FirstFieldWidth) + |
| get(SecondField, SecondFieldWidth) + |
| get(ThirdField, ThirdFieldWidth) + |
| get(FourthField, FourthFieldWidth) + |
| get(FifthField, FifthFieldWidth) + |
| get(AlphaField, AlphaFieldWidth); } |
| |
| Q_DECL_CONSTEXPR inline AlphaUsage alphaUsage() const Q_DECL_NOTHROW { return AlphaUsage(get(AlphaUsageField, AlphaUsageFieldWidth)); } |
| Q_DECL_CONSTEXPR inline AlphaPosition alphaPosition() const Q_DECL_NOTHROW { return AlphaPosition(get(AlphaPositionField, AlphaPositionFieldWidth)); } |
| Q_DECL_CONSTEXPR inline AlphaPremultiplied premultiplied() const Q_DECL_NOTHROW { return AlphaPremultiplied(get(PremulField, PremulFieldWidth)); } |
| Q_DECL_CONSTEXPR inline TypeInterpretation typeInterpretation() const Q_DECL_NOTHROW { return TypeInterpretation(get(TypeInterpretationField, TypeInterpretationFieldWidth)); } |
| Q_DECL_CONSTEXPR inline ByteOrder byteOrder() const Q_DECL_NOTHROW { return ByteOrder(get(ByteOrderField, ByteOrderFieldWidth)); } |
| |
| Q_DECL_CONSTEXPR inline YUVLayout yuvLayout() const Q_DECL_NOTHROW { return YUVLayout(get(SubEnumField, SubEnumFieldWidth)); } |
| Q_DECL_CONSTEXPR inline uchar subEnum() const Q_DECL_NOTHROW { return get(SubEnumField, SubEnumFieldWidth); } |
| |
| private: |
| Q_DECL_CONSTEXPR static inline ByteOrder resolveByteOrder(ByteOrder bo) |
| { return bo == CurrentSystemEndian ? Q_BYTE_ORDER == Q_LITTLE_ENDIAN ? LittleEndian : BigEndian : bo ; } |
| |
| private: |
| quint64 data; |
| |
| friend Q_DECL_CONST_FUNCTION Q_DECL_CONSTEXPR inline bool operator==(QPixelFormat fmt1, QPixelFormat fmt2) |
| { return fmt1.data == fmt2.data; } |
| |
| friend Q_DECL_CONST_FUNCTION Q_DECL_CONSTEXPR inline bool operator!=(QPixelFormat fmt1, QPixelFormat fmt2) |
| { return !(fmt1 == fmt2); } |
| }; |
| Q_STATIC_ASSERT(sizeof(QPixelFormat) == sizeof(quint64)); |
| Q_DECLARE_TYPEINFO(QPixelFormat, Q_PRIMITIVE_TYPE); |
| |
| |
| namespace QtPrivate { |
| QPixelFormat Q_GUI_EXPORT QPixelFormat_createYUV(QPixelFormat::YUVLayout yuvLayout, |
| uchar alphaSize, |
| QPixelFormat::AlphaUsage alphaUsage, |
| QPixelFormat::AlphaPosition alphaPosition, |
| QPixelFormat::AlphaPremultiplied premultiplied, |
| QPixelFormat::TypeInterpretation typeInterpretation, |
| QPixelFormat::ByteOrder byteOrder); |
| } |
| |
| Q_DECL_CONSTEXPR |
| QPixelFormat::QPixelFormat(ColorModel mdl, |
| uchar firstSize, |
| uchar secondSize, |
| uchar thirdSize, |
| uchar fourthSize, |
| uchar fifthSize, |
| uchar alfa, |
| AlphaUsage usage, |
| AlphaPosition position, |
| AlphaPremultiplied premult, |
| TypeInterpretation typeInterp, |
| ByteOrder b_order, |
| uchar s_enum) Q_DECL_NOTHROW |
| : data(set(ModelField, ModelFieldWidth, uchar(mdl)) | |
| set(FirstField, FirstFieldWidth, firstSize) | |
| set(SecondField, SecondFieldWidth, secondSize) | |
| set(ThirdField, ThirdFieldWidth, thirdSize) | |
| set(FourthField, FourthFieldWidth, fourthSize) | |
| set(FifthField, FifthFieldWidth, fifthSize) | |
| set(AlphaField, AlphaFieldWidth, alfa) | |
| set(AlphaUsageField, AlphaUsageFieldWidth, uchar(usage)) | |
| set(AlphaPositionField, AlphaPositionFieldWidth, uchar(position)) | |
| set(PremulField, PremulFieldWidth, uchar(premult)) | |
| set(TypeInterpretationField, TypeInterpretationFieldWidth, uchar(typeInterp)) | |
| set(ByteOrderField, ByteOrderFieldWidth, uchar(resolveByteOrder(b_order))) | |
| set(SubEnumField, SubEnumFieldWidth, s_enum) | |
| set(UnusedField, UnusedFieldWidth, 0)) |
| { |
| } |
| |
| Q_DECL_CONSTEXPR inline QPixelFormat qPixelFormatRgba(uchar red, |
| uchar green, |
| uchar blue, |
| uchar alfa, |
| QPixelFormat::AlphaUsage usage, |
| QPixelFormat::AlphaPosition position, |
| QPixelFormat::AlphaPremultiplied pmul=QPixelFormat::NotPremultiplied, |
| QPixelFormat::TypeInterpretation typeInt=QPixelFormat::UnsignedInteger) Q_DECL_NOTHROW |
| { |
| return QPixelFormat(QPixelFormat::RGB, |
| red, |
| green, |
| blue, |
| 0, |
| 0, |
| alfa, |
| usage, |
| position, |
| pmul, |
| typeInt); |
| } |
| |
| Q_DECL_CONSTEXPR inline QPixelFormat qPixelFormatGrayscale(uchar channelSize, |
| QPixelFormat::TypeInterpretation typeInt=QPixelFormat::UnsignedInteger) Q_DECL_NOTHROW |
| { |
| return QPixelFormat(QPixelFormat::Grayscale, |
| channelSize, |
| 0, |
| 0, |
| 0, |
| 0, |
| 0, |
| QPixelFormat::IgnoresAlpha, |
| QPixelFormat::AtBeginning, |
| QPixelFormat::NotPremultiplied, |
| typeInt); |
| } |
| |
| Q_DECL_CONSTEXPR inline QPixelFormat qPixelFormatAlpha(uchar channelSize, |
| QPixelFormat::TypeInterpretation typeInt=QPixelFormat::UnsignedInteger) Q_DECL_NOTHROW |
| { |
| return QPixelFormat(QPixelFormat::Alpha, |
| 0, |
| 0, |
| 0, |
| 0, |
| 0, |
| channelSize, |
| QPixelFormat::UsesAlpha, |
| QPixelFormat::AtBeginning, |
| QPixelFormat::NotPremultiplied, |
| typeInt); |
| } |
| |
| Q_DECL_CONSTEXPR inline QPixelFormat qPixelFormatCmyk(uchar channelSize, |
| uchar alfa=0, |
| QPixelFormat::AlphaUsage usage=QPixelFormat::IgnoresAlpha, |
| QPixelFormat::AlphaPosition position=QPixelFormat::AtBeginning, |
| QPixelFormat::TypeInterpretation typeInt=QPixelFormat::UnsignedInteger) Q_DECL_NOTHROW |
| { |
| return QPixelFormat(QPixelFormat::CMYK, |
| channelSize, |
| channelSize, |
| channelSize, |
| channelSize, |
| 0, |
| alfa, |
| usage, |
| position, |
| QPixelFormat::NotPremultiplied, |
| typeInt); |
| } |
| |
| Q_DECL_CONSTEXPR inline QPixelFormat qPixelFormatHsl(uchar channelSize, |
| uchar alfa=0, |
| QPixelFormat::AlphaUsage usage=QPixelFormat::IgnoresAlpha, |
| QPixelFormat::AlphaPosition position=QPixelFormat::AtBeginning, |
| QPixelFormat::TypeInterpretation typeInt=QPixelFormat::FloatingPoint) Q_DECL_NOTHROW |
| { |
| return QPixelFormat(QPixelFormat::HSL, |
| channelSize, |
| channelSize, |
| channelSize, |
| 0, |
| 0, |
| alfa, |
| usage, |
| position, |
| QPixelFormat::NotPremultiplied, |
| typeInt); |
| } |
| |
| Q_DECL_CONSTEXPR inline QPixelFormat qPixelFormatHsv(uchar channelSize, |
| uchar alfa=0, |
| QPixelFormat::AlphaUsage usage=QPixelFormat::IgnoresAlpha, |
| QPixelFormat::AlphaPosition position=QPixelFormat::AtBeginning, |
| QPixelFormat::TypeInterpretation typeInt=QPixelFormat::FloatingPoint) Q_DECL_NOTHROW |
| { |
| return QPixelFormat(QPixelFormat::HSV, |
| channelSize, |
| channelSize, |
| channelSize, |
| 0, |
| 0, |
| alfa, |
| usage, |
| position, |
| QPixelFormat::NotPremultiplied, |
| typeInt); |
| } |
| |
| inline QPixelFormat qPixelFormatYuv(QPixelFormat::YUVLayout layout, |
| uchar alfa=0, |
| QPixelFormat::AlphaUsage usage=QPixelFormat::IgnoresAlpha, |
| QPixelFormat::AlphaPosition position=QPixelFormat::AtBeginning, |
| QPixelFormat::AlphaPremultiplied p_mul=QPixelFormat::NotPremultiplied, |
| QPixelFormat::TypeInterpretation typeInt=QPixelFormat::UnsignedByte, |
| QPixelFormat::ByteOrder b_order=QPixelFormat::LittleEndian) |
| { |
| return QtPrivate::QPixelFormat_createYUV(layout, |
| alfa, |
| usage, |
| position, |
| p_mul, |
| typeInt, |
| b_order); |
| } |
| |
| QT_END_NAMESPACE |
| |
| #endif //QPIXELFORMAT_H |
