QPixelFormat Class

Dokumentation der Mitgliedsfunktionen

[constexpr noexcept] QPixelFormat::QPixelFormat()

Erstellt ein Null-Pixelformat. Dieses Format entspricht „ QImage::Format_Invalid “.

[constexpr noexcept] QPixelFormat::QPixelFormat(QPixelFormat::ColorModel colorModel, uchar firstSize, uchar secondSize, uchar thirdSize, uchar fourthSize, uchar fifthSize, uchar alphaSize, QPixelFormat::AlphaUsage alphaUsage, QPixelFormat::AlphaPosition alphaPosition, QPixelFormat::AlphaPremultiplied premultiplied, QPixelFormat::TypeInterpretation typeInterpretation, QPixelFormat::ByteOrder byteOrder = CurrentSystemEndian, uchar subEnum = 0)

Erstellt ein `QPixelFormat`, das seine Daten den Attributen zuordnet. ` colorModel ` wird in einen 4 Bit langen Puffer geschrieben.

firstSize secondSize thirdSize sollen alle die Größe eines Kanals darstellen. Die Kanäle werden je nach „ “ für unterschiedliche Zwecke verwendet. Bei RGB steht „firstSize“ für den Rotkanal. Bei CMYK steht es für den Wert des Cyan-Kanals. fourthSize fifthSize alphaSize colorModel

alphaUsage Gibt an, ob der Alphakanal verwendet wird oder nicht.

alphaPosition ist die Position des Alphakanals.

premultiplied Gibt an, ob der Alphakanal bereits mit den Farbkanälen multipliziert wurde.

typeInterpretation Gibt an, wie das Pixel interpretiert wird.

byteOrder Gibt die Endianness des Pixelformats an. Der Standardwert ist „ CurrentSystemEndian “, was bei nicht byte-geordneten Formaten auf die Endianness des Systems zurückgeführt wird, und „ QPixelFormat::BigEndian “ für „ QPixelFormat::UnsignedByte “.

subEnum Wird für Farbmodelle verwendet, die zusätzliche Informationen speichern müssen, indem eine zusätzliche Enumeration bereitgestellt wird. Dies wird von YUV verwendet, um den YUV-Typ zu speichern. Der Standardwert ist 0.

[constexpr noexcept] QPixelFormat::AlphaPosition QPixelFormat::alphaPosition() const

Accessor-Funktion für die Position des Alphakanals relativ zu den Farbkanälen.

Bei Formaten, bei denen die einzelnen Kanäle einzelnen Einheiten zugeordnet sind, ist die Alpha-Position relativ zu diesen Einheiten. Beispielsweise ist bei „ QImage::Format_RGBA16FPx4 “, das eine Alpha-Position von „ QPixelFormat::AtEnd “ hat, der Alpha-Wert der zuletzt gelesene Wert „ qfloat16 “.

Bei Formaten, bei denen mehrere Kanäle in einer einzigen Einheit zusammengefasst sind, werden die Werte ` QPixelFormat::AtBeginning ` und ` QPixelFormat::AtEnd ` den höchstwertigen und niedrigstwertigen Bits der zusammengefassten Einheit zugeordnet, bezogen auf die formatinterne ` byteOrder()`-Funktion.

Beispielsweise bedeutet bei „ QImage::Format_ARGB32 “, das eine Typinterpretation von „ QPixelFormat::UnsignedInteger “ und eine „ byteOrder()“ aufweist, die immer mit dem Host-System übereinstimmt, die Alpha-Position von „ QPixelFormat::AtBeginning “, dass das Alpha immer unter „ 0xFF000000 “ zu finden ist.

Wenn das Pixelformat und die Endianness des Hosts nicht übereinstimmen, muss darauf geachtet werden, das Layout des Pixelformats korrekt auf das Speicherlayout des Hosts abzubilden.

Siehe auch alphaUsage(), alphaSize() und premultiplied().

[constexpr noexcept] uchar QPixelFormat::alphaSize() const

Accessor-Funktion für die Größe des Alphakanals.

[constexpr noexcept] QPixelFormat::AlphaUsage QPixelFormat::alphaUsage() const

Accessor-Funktion, die angibt, ob der Alphakanal verwendet wird oder nicht.

Manchmal reserviert das Pixelformat Platz für einen Alphakanal, sodass ` alphaSize()` einen Wert > 0 zurückgibt, der Alphakanal jedoch nicht verwendet bzw. ignoriert wird.

Beispielsweise beträgt bei „ QImage::Format_RGB32 “ der Wert von „ bitsPerPixel()“ 32, da der Alphakanal eine Größe von 8 hat, „alphaUsage()“ jedoch den Wert „ QPixelFormat::IgnoresAlpha “ zurückgibt.

Beachten Sie, dass in solchen Situationen die „ position “ des ungenutzten Alphakanals dennoch wichtig ist, da sie die Anordnung der Farbkanäle beeinflusst.

Siehe auch „ alphaPosition()“, „ alphaSize()“ und „ premultiplied()“.

[constexpr noexcept] uchar QPixelFormat::bitsPerPixel() const

Accessor-Funktion für die pro Pixel verwendeten Bits. Diese Funktion gibt die Summe aller Farbkanäle plus die Größe des Alphakanals zurück.

[constexpr noexcept] uchar QPixelFormat::blackSize() const

Accessor-Funktion für den Schwarz-/Schlüssel-Farbkanal.

[constexpr noexcept] uchar QPixelFormat::blueSize() const

Accessor-Funktion für die Größe des blauen Farbkanals.

[constexpr noexcept] uchar QPixelFormat::brightnessSize() const

Accessor-Funktion für die Größe des Helligkeitskanals.

[constexpr noexcept] QPixelFormat::ByteOrder QPixelFormat::byteOrder() const

Die Byte-Reihenfolge des Pixelformats bestimmt die Speicheranordnung der einzelnen Typ-Einheiten, wie in der Funktion „ typeInterpretation()“ beschrieben.

Diese Funktion gibt niemals „ QPixelFormat::CurrentSystemEndian “ zurück, da dieser Wert im Konstruktor in den Endian-Wert des Systems übersetzt wird.

Bei Pixelformaten mit typeInterpretation() QPixelFormat::UnsignedByte ist dies typischerweise QPixelFormat::BigEndian, während andere Typinterpretationen in der Regel die Endianness des aktuellen Systems widerspiegeln.

Wenn die Byte-Reihenfolge des Pixelformats mit der des aktuellen Systems übereinstimmt, können die einzelnen Typ-Einheiten mit denselben Bitmasken und Operationen gelesen und bearbeitet werden, unabhängig von der Endianness des Host-Systems. Bei „ QImage::Format_ARGB32 “ beispielsweise, das eine Typinterpretation vom Typ „ QPixelFormat::UnsignedInteger “ aufweist, kann der Alpha-Wert immer durch Maskieren des „ unsigned int “ mit „ 0xFF000000 “ gelesen werden, unabhängig von der Endianness des Host-Systems.

Wenn das Pixelformat und die Endianness des Hostsystems nicht übereinstimmen, muss dies berücksichtigt werden. Klassen wie QImage tauschen in diesen Fällen die internen Bits nicht aus, um sie an die Endianness des Hostsystems anzupassen.

Siehe auch typeInterpretation() und alphaPosition().

[constexpr noexcept] uchar QPixelFormat::channelCount() const

Zugriffsfunktion für die Kanalanzahl.

Die Kanalanzahl gibt die Anzahl der Kanäle (Farbe und Alpha) mit einer Größe > 0 an.

[constexpr noexcept] QPixelFormat::ColorModel QPixelFormat::colorModel() const

Zugriffsfunktion für das Farbmodell.

Beachten Sie, dass bei „ QPixelFormat::YUV “ die einzelnen Makropixel nicht beschrieben werden können. Stattdessen wird eine Liste von „ YUV formats “ bereitgestellt, und der Wert von „ bitsPerPixel()“ wird aus dem YUV-Layout abgeleitet.

[constexpr noexcept] uchar QPixelFormat::cyanSize() const

Accessor-Funktion für den Cyan-Farbkanal.

[constexpr noexcept] uchar QPixelFormat::greenSize() const

Accessor-Funktion für die Größe des grünen Farbkanals.

[constexpr noexcept] uchar QPixelFormat::hueSize() const

Accessor-Funktion für die Größe des Farbtonkanals.

[constexpr noexcept] uchar QPixelFormat::lightnessSize() const

Accessor-Funktion für die Größe des Helligkeitskanals.

[constexpr noexcept] uchar QPixelFormat::magentaSize() const

Accessor-Funktion für den Magenta-Farbkanal.

[constexpr noexcept] QPixelFormat::AlphaPremultiplied QPixelFormat::premultiplied() const

Accessor-Funktion, die angibt, ob der Alphakanal in die Farbkanäle eingerechnet wird.

[constexpr noexcept] uchar QPixelFormat::redSize() const

Accessor-Funktion für die Größe des roten Farbkanals.

[constexpr noexcept] uchar QPixelFormat::saturationSize() const

Accessor-Funktion für die Größe des Sättigungskanals.

[constexpr noexcept] QPixelFormat::TypeInterpretation QPixelFormat::typeInterpretation() const

Die Typinterpretation legt fest, wie jedes Pixel ausgelesen werden soll.

Jedes Pixel wird als eine oder mehrere Einheiten des angegebenen Typs dargestellt, die sequenziell im Speicher angeordnet sind.

Beispielsweise hat „ QImage::Format_Mono “ eine „ pixel format “ von 1 Bit pro Pixel und eine Typinterpretation „ QPixelFormat::UnsignedByte “, die als einzelnes „ byte “ gelesen werden sollte. Ähnlich verhält es sich bei „ QImage::Format_RGB888 “ mit einer „ pixel format “ von 24 Bit pro Pixel und einer Typinterpretation „ QPixelFormat::UnsignedByte “, die als drei aufeinanderfolgende „ byte“ gelesen werden sollte.

Viele der QImage formats sind 32-Bit-Werte mit einer Typinterpretation von QPixelFormat::UnsignedInteger, die als einzelnes unsigned int gelesen werden sollten.

Bei QPixelFormat::FloatingPoint -Formaten wie QImage::Format_RGBA16FPx4 oder QImage::Format_RGBA32FPx4 wird der Typ anhand der Größe der einzelnen Farb-/Alpha-Kanäle bestimmt, wobei qfloat16 für 16-Bit-Half-Float-Formate und float für 32-Bit-Full-Float-Formate gilt.

Siehe auch byteOrder().

[constexpr noexcept] uchar QPixelFormat::yellowSize() const

Accessor-Funktion für den gelben Farbkanal.

[constexpr noexcept] QPixelFormat::YUVLayout QPixelFormat::yuvLayout() const

Accessor-Funktion für die ` YUVLayout`. Es ist schwierig, die Farbkanäle eines YUV-Pixelformats zu beschreiben, da das YUV-Farbmodell Makropixel verwendet. Stattdessen wird die Anordnung der Pixel als Enumeration gespeichert.