QPixelFormat Class

Mitgliederfunktion Dokumentation

[constexpr noexcept] QPixelFormat::QPixelFormat()

Erzeugt ein Null-Pixelformat. Dieses Format wird auf QImage::Format_Invalid abgebildet.

[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)

Erzeugt ein QPixelFormat, das seine Daten den Attributen zuordnet. colorModel wird in einen 4 Bit langen Puffer gelegt.

firstSize secondSize thirdSize fourthSize fifthSize alphaSize sind alle dazu gedacht, die Größe eines Kanals zu repräsentieren. Die Kanäle werden je nach colorModel für unterschiedliche Zwecke verwendet. Bei RGB steht firstSize für den Rotkanal. Bei CMYK steht er für den Wert des Cyan-Kanals.

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 steht dafür, wie das Pixel interpretiert wird.

byteOrder steht für die Endianness des Pixelformats. Der Standardwert ist CurrentSystemEndian, der bei Formaten ohne Byte-Reihenfolge in die Endianness des Systems aufgelöst wird, und QPixelFormat::BigEndian für QPixelFormat::UnsignedByte.

subEnum wird für colorModels verwendet, die einige zusätzliche Informationen speichern müssen, indem sie ein zusätzliches Enum liefern. 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 auf einzelne Einheiten abgebildet werden, ist die Alpha-Position relativ zu diesen Einheiten. Zum Beispiel für QImage::Format_RGBA16FPx4, das eine Alphaposition von QPixelFormat::AtEnd hat, ist die Alphaposition die zuletzt gelesene qfloat16.

Bei Formaten, bei denen mehrere Kanäle in eine einzige Einheit gepackt sind, werden die Werte QPixelFormat::AtBeginning und QPixelFormat::AtEnd den höchst- und niedrigstwertigen Bits der gepackten Einheit zugeordnet, und zwar in Bezug auf die formatinterne byteOrder().

Für QImage::Format_ARGB32 beispielsweise, das eine Typinterpretation von QPixelFormat::UnsignedInteger und ein byteOrder() hat, das immer mit dem Hostsystem übereinstimmt, bedeutet die Alpha-Position von QPixelFormat::AtBeginning, dass das Alpha immer unter 0xFF000000 zu finden ist.

Wenn das Pixelformat und die Host-Endianness nicht übereinstimmen, muss darauf geachtet werden, dass das Pixelformat-Layout korrekt auf das Host-Speicherlayout abgebildet wird.

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 anzeigt, ob der Alphakanal verwendet wird oder nicht.

Manchmal reserviert das Pixelformat Platz für einen Alphakanal, so dass alphaSize() > 0 zurückgibt, aber der Alphakanal nicht verwendet/ignoriert wird.

Für QImage::Format_RGB32 ist bitsPerPixel() zum Beispiel 32, weil der Alphakanal eine Größe von 8 hat, aber alphaUsage() spiegelt QPixelFormat::IgnoresAlpha wider.

Beachten Sie, dass in solchen Situationen die position des nicht verwendeten Alphakanals immer noch wichtig ist, da sie die Platzierung 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 + die Größe des Alphakanals zurück.

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

Accessor-Funktion für den Schwarz/Key-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 Bytereihenfolge des Pixelformats bestimmt das Speicherlayout der einzelnen Typeneinheiten, wie durch typeInterpretation() beschrieben.

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

Für Pixelformate mit typeInterpretation() QPixelFormat::UnsignedByte wird dies typischerweise QPixelFormat::BigEndian sein, während andere Typinterpretationen typischerweise die Endianness des aktuellen Systems widerspiegeln werden.

Wenn die Bytereihenfolge des Pixelformats mit dem aktuellen System übereinstimmt, können die einzelnen Typeinheiten unabhängig von der Endianness des Hostsystems mit denselben Bitmasken und Operationen gelesen und bearbeitet werden. So kann z. B. bei QImage::Format_ARGB32, das eine QPixelFormat::UnsignedInteger -Typinterpretation hat, Alpha immer gelesen werden, indem unsigned int durch 0xFF000000 maskiert wird, unabhängig von der Endianness des Hostsystems.

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

Siehe auch typeInterpretation() und alphaPosition().

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

Accessor-Funktion für die Kanalanzahl.

Die Kanalanzahl repräsentiert Kanäle (Farbe und Alpha) mit einer Größe > 0.

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

Accessor-Funktion für das Farbmodell.

Beachten Sie, dass für QPixelFormat::YUV die einzelnen Makro-Pixel nicht beschrieben werden können. Stattdessen wird eine Liste von YUV formats bereitgestellt, und der Wert 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 Megenta-Farbkanal.

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

Zugriffsfunktion für die Angabe, ob der Alphakanal mit den Farbkanälen multipliziert 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 Interpretation des Typs bestimmt, wie jedes Pixel gelesen werden soll.

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

Zum Beispiel hat QImage::Format_Mono eine pixel format von 1 Bit pro Pixel und eine QPixelFormat::UnsignedByte Typinterpretation, die als eine einzige byte gelesen werden sollte. In ähnlicher Weise hat QImage::Format_RGB888 eine pixel format von 24 Bits pro Pixel und eine QPixelFormat::UnsignedByte Interpretation, die als drei aufeinanderfolgende bytegelesen werden sollte.

Viele der Formate QImage formats sind 32-Bit-Formate mit einer Typinterpretation von QPixelFormat::UnsignedInteger, die als ein 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-/Alphakanäle bestimmt, wobei qfloat16 für 16-Bit-Halbfließkommaformate und float für 32-Bit-Vollfließkommaformate steht.

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 das Layout der Pixel als Enum gespeichert.