QPixelFormat Class

QPixelFormat est une classe permettant de décrire différentes dispositions de pixels dans les tampons graphiques. Plus d'informations...

En-tête : #include <QPixelFormat>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui

Types publics

enum AlphaPosition { AtBeginning, AtEnd }
enum AlphaPremultiplied { NotPremultiplied, Premultiplied }
enum AlphaUsage { IgnoresAlpha, UsesAlpha }
enum ByteOrder { LittleEndian, BigEndian, CurrentSystemEndian }
enum ColorModel { RGB, BGR, Indexed, Grayscale, CMYK, …, Alpha }
enum TypeInterpretation { UnsignedInteger, UnsignedShort, UnsignedByte, FloatingPoint }
enum YUVLayout { YUV444, YUV422, YUV411, YUV420P, YUV420SP, …, Y16 }

Fonctions publiques

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)
QPixelFormat::AlphaPosition alphaPosition() const
uchar alphaSize() const
QPixelFormat::AlphaUsage alphaUsage() const
uchar bitsPerPixel() const
uchar blackSize() const
uchar blueSize() const
uchar brightnessSize() const
QPixelFormat::ByteOrder byteOrder() const
uchar channelCount() const
QPixelFormat::ColorModel colorModel() const
uchar cyanSize() const
uchar greenSize() const
uchar hueSize() const
uchar lightnessSize() const
uchar magentaSize() const
QPixelFormat::AlphaPremultiplied premultiplied() const
uchar redSize() const
uchar saturationSize() const
QPixelFormat::TypeInterpretation typeInterpretation() const
uchar yellowSize() const
QPixelFormat::YUVLayout yuvLayout() const
QPixelFormat qPixelFormatAlpha(uchar channelSize, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)
QPixelFormat qPixelFormatCmyk(uchar channelSize, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)
QPixelFormat qPixelFormatGrayscale(uchar channelSize, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)
QPixelFormat qPixelFormatHsl(uchar channelSize, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::FloatingPoint)
QPixelFormat qPixelFormatHsv(uchar channelSize, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::FloatingPoint)
QPixelFormat qPixelFormatRgba(uchar redSize, uchar greenSize, uchar blueSize, uchar alphaSize, QPixelFormat::AlphaUsage alphaUsage, QPixelFormat::AlphaPosition alphaPosition, QPixelFormat::AlphaPremultiplied premultiplied = QPixelFormat::NotPremultiplied, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)
QPixelFormat qPixelFormatYuv(QPixelFormat::YUVLayout yuvLayout, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::AlphaPremultiplied premultiplied = QPixelFormat::NotPremultiplied, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedByte, QPixelFormat::ByteOrder byteOrder = QPixelFormat::LittleEndian)

Description détaillée

Dans Qt, il est souvent nécessaire de représenter la disposition des pixels dans un tampon graphique. En interne, QPixelFormat stocke tout dans une structure de données 64 bits. Cela permet d'améliorer les performances, mais aussi de limiter les possibilités.

QPixelFormat peut décrire 5 canaux de couleur et 1 canal alpha, chacun pouvant utiliser 6 bits pour décrire la taille du canal de couleur.

La position du canal alpha est décrite dans une énumération distincte. Ceci permet de décrire les formats QImage comme ARGB32, ainsi que les formats OpenGL typiques comme RBGA8888.

La manière dont les pixels sont censés être lus est déterminée par l'enum TypeInterpretation. Il décrit si les valeurs de couleur sont supposées être lues octet par octet, ou si un pixel est supposé être lu comme un int complet et ensuite masqué.

Il n'existe pas de support pour décrire les macro-pixels YUV. À la place, une liste des formats YUV a été établie. Lorsqu'un QPixelFormat décrit un format YUV, la valeur bitsPerPixel a été déduite de l'enum YUV Layout. En outre, les canaux de couleur doivent tous être mis à zéro, à l'exception du cinquième canal de couleur qui doit stocker la valeur bitsPerPixel.

Voir également TypeInterpretation.

Documentation sur les types de membres

enum QPixelFormat::AlphaPosition

Ce type d'énumération est utilisé pour décrire la position des canaux alpha par rapport aux canaux de couleur.

ConstanteValeurDescription
QPixelFormat::AtBeginning0Le canal alpha sera placé devant les canaux de couleur. Par exemple, ARGB.
QPixelFormat::AtEnd1Le canal alpha sera placé à l'arrière des canaux de couleur. Par exemple, RGBA.

enum QPixelFormat::AlphaPremultiplied

Ce type d'énumération décrit l'état booléen selon lequel le canal alpha est multiplié dans les canaux de couleur ou non.

ConstanteValeurDescription
QPixelFormat::NotPremultiplied0Le canal alpha n'est pas multiplié dans les canaux de couleur.
QPixelFormat::Premultiplied1Le canal alpha est multiplié dans les canaux de couleur.

enum QPixelFormat::AlphaUsage

Cette énumération indique si le canal alpha est utilisé ou non. Parfois, le format de pixel indique une taille pour le canal alpha, mais le format de pixel n'utilise pas le canal alpha. Par exemple, le format RGB32 est un format de ce type. Les canaux RVB sont de 8 bits chacun et il n'y a pas de canal alpha. Mais la taille complète de chaque pixel est de 32. La taille du canal alpha est donc de 8, mais le canal alpha est ignoré. Il est important de noter que dans de telles situations, la position du canal alpha est significative.

ConstanteValeurDescription
QPixelFormat::IgnoresAlpha1Le canal alpha n'est pas utilisé.
QPixelFormat::UsesAlpha0Le canal alpha est utilisé.

enum QPixelFormat::ByteOrder

Cette énumération décrit l'ordre des octets du format de pixel. Cette énumération est généralement ignorée, mais elle peut être utilisée dans certains cas pour les formats YUV. Les formats BGR ont leur propre modèle de couleur et ne doivent pas être décrits en utilisant l'endianness opposé à un format RGB.

ConstanteValeurDescription de la constante
QPixelFormat::LittleEndian0L'ordre des octets est little endian.
QPixelFormat::BigEndian1L'ordre des octets est big endian.
QPixelFormat::CurrentSystemEndian2Cet enum n'est pas stocké, mais est converti dans le constructeur en enum endian qui correspond à l'enum du système actuel.

enum QPixelFormat::ColorModel

Ce type d'énumération est utilisé pour décrire le modèle de couleur du pixelformat. L'alpha a été ajouté dans la version 5.5.

ConstanteValeurDescription
QPixelFormat::RGB0Le modèle de couleur est RGB.
QPixelFormat::BGR1Il s'agit logiquement de la version endienne opposée de RGB. Cependant, pour des raisons de facilité d'utilisation, elle possède son propre modèle.
QPixelFormat::Indexed2Le modèle de couleur utilise une palette de couleurs.
QPixelFormat::Grayscale3Le modèle de couleur est l'échelle de gris.
QPixelFormat::CMYK4Le modèle de couleur est CMYK.
QPixelFormat::HSL5Le modèle de couleur est HSL.
QPixelFormat::HSV6Le modèle de couleur est HSV.
QPixelFormat::YUV7Le modèle de couleur est YUV.
QPixelFormat::Alpha8Il n'y a pas de modèle de couleur, seul l'alpha est utilisé.

enum QPixelFormat::TypeInterpretation

Cette énumération décrit la manière dont chaque pixel est interprété. Si un pixel est lu comme un entier non signé de 32 bits, puis chaque canal est masqué, ou si chaque octet est lu comme des valeurs de caractères non signés. En général, les formats QImage interprètent un pixel comme un entier non signé, puis les canaux de couleur sont masqués. OpenGL, quant à lui, interprète typiquement les pixels "un octet après l'autre", c'est-à-dire un octet non signé.

QImage Le format Format_RGBA8888 (et ses dérivés), où les pixels sont interprétés comme des octets non signés, existe également. OpenGL possède des extensions qui permettent de télécharger des tampons de pixels dans un format entier non signé.

Un pixel ARGB32 entier non signé.

L'image ci-dessus montre un pixel ARGB en mémoire lu comme un entier non signé. Cependant, si ce pixel était lu octet par octet sur un système little endian, le premier octet serait l'octet contenant le canal B. L'octet suivant serait le canal G. L'octet suivant serait l'octet contenant le canal B. L'octet suivant serait le canal G, puis le canal R et enfin le canal A. Cela montre que sur les systèmes peu endian, la façon dont chaque pixel est interprété est importante pour les formats entiers. Ce n'est pas le cas sur les systèmes big endian.

ConstanteValeur
QPixelFormat::UnsignedInteger0
QPixelFormat::UnsignedShort1
QPixelFormat::UnsignedByte2
QPixelFormat::FloatingPoint3

enum QPixelFormat::YUVLayout

YUV n'est pas représenté en décrivant la taille des canaux de couleur. En effet, YUV utilise souvent des macro-pixels, ce qui rend le concept de canaux de couleur distincts invalide. Au lieu de cela, les différentes dispositions YUV sont décrites par cette énumération.

ConstanteValeur
QPixelFormat::YUV4440
QPixelFormat::YUV4221
QPixelFormat::YUV4112
QPixelFormat::YUV420P3
QPixelFormat::YUV420SP4
QPixelFormat::YV125
QPixelFormat::UYVY6
QPixelFormat::YUYV7
QPixelFormat::NV128
QPixelFormat::NV219
QPixelFormat::IMC110
QPixelFormat::IMC211
QPixelFormat::IMC312
QPixelFormat::IMC413
QPixelFormat::Y814
QPixelFormat::Y1615

Fonction membre Documentation

[constexpr noexcept] QPixelFormat::QPixelFormat()

Crée un pixelformat nul. Ce format correspond à 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)

Crée un QPixelFormat qui affecte ses données aux attributs. colorModel sera placé dans un tampon de 4 bits de long.

firstSize secondSize thirdSize fourthSize fifthSize alphaSize Les attributs QPixelFormat sont tous censés représenter la taille d'un canal. Les canaux seront utilisés à des fins différentes en fonction du colorModel. Pour RVB, le firstSize représentera le canal rouge. Pour CMYK, il représente la valeur du canal Cyan.

alphaUsage représente l'utilisation ou non du canal alpha.

alphaPosition est la position du canal alpha.

premultiplied représente si le canal alpha est déjà multiplié avec les canaux de couleur.

typeInterpretation représente la manière dont le pixel est interprété.

byteOrder représente l'endianness du pixelformat. La valeur par défaut est CurrentSystemEndian.

subEnum est utilisé pour les colorModels qui doivent stocker des informations supplémentaires en fournissant un enum supplémentaire. Utilisé par YUV pour stocker le type YUV La valeur par défaut est 0.

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

Fonction d'accès pour alphaPosition.

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

Fonction d'accès à la taille du canal alpha.

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

Fonction d'accès à alphaUsage.

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

Fonction d'accès aux bits utilisés par pixel. Cette fonction renvoie la somme des canaux de couleur + la taille du canal alpha.

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

Fonction d'accès au canal de couleur noir/clé.

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

Fonction d'accès à la taille du canal de couleur bleue.

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

Fonction d'accès à la taille du canal de luminosité.

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

L'ordre des octets correspond presque toujours à l'ordre des octets du système actuel. Cependant, il peut être utile pour décrire certains formats YUV. Cette fonction ne devrait jamais renvoyer QPixelFormat::CurrentSystemEndian car cette valeur est convertie en valeur endian dans le constructeur.

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

Fonction d'accès pour obtenir le nombre de canaux. Le nombre de canaux est déduit des canaux de couleur dont la taille est > 0 et si la taille du canal alpha est > 0.

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

Fonction d'accès pour obtenir le modèle de couleur.

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

Fonction d'accès au canal de couleur cyan.

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

Fonction d'accès à la taille du canal de couleur verte.

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

Fonction d'accès à la taille du canal de teinte.

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

Fonction d'accès à la taille du canal de clarté.

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

Fonction d'accès au canal de couleur méga.

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

Fonction d'accès à l'énumération AlphaPremultiplied. Indique si le canal alpha est multiplié par les canaux de couleur.

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

Fonction d'accès à la taille du canal de couleur rouge.

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

Fonction d'accès à la taille du canal de saturation.

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

Fonction d'accès à la représentation du type d'un canal de couleur ou d'un pixel.

Voir aussi TypeInterpretation.

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

Fonction d'accès au canal de couleur jaune.

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

Fonction d'accès à YUVLayout Il est difficile de décrire les canaux de couleur d'un format de pixel YUV car le modèle de couleur YUV utilise des macro-pixels. Au lieu de cela, la disposition des pixels est stockée sous la forme d'une énumération.

Non-membres apparentés

[constexpr noexcept] QPixelFormat qPixelFormatAlpha(uchar channelSize, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)

Fonction de construction pour créer un format Alpha. Un format de masque peut être décrit en passant 1 à channelSize. Il est également possible de définir des formats alpha très précis en utilisant des doubles pour décrire chaque pixel en passant 8 à channelSize et FloatingPoint à typeInterpretation.

Voir aussi QPixelFormat::TypeInterpretation.

[constexpr noexcept] QPixelFormat qPixelFormatCmyk(uchar channelSize, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)

Fonction de construction pour créer des formats CMYK. Le nombre de canaux sera de 4 ou 5 selon que alphaSize est supérieur ou non à zéro. Les canaux de couleur CMJN seront tous réglés sur la valeur de channelSize.

alphaUsage alphaPosition et typeInterpretation sont tous accessibles à l'aide des accesseurs portant le même nom.

Voir aussi QPixelFormat::TypeInterpretation.

[constexpr noexcept] QPixelFormat qPixelFormatGrayscale(uchar channelSize, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)

Fonction de construction pour créer un format en niveaux de gris. Les formats monochromes peuvent être décrits en passant 1 à channelSize. Il est également possible de définir des formats en niveaux de gris très précis en utilisant des doubles pour décrire chaque pixel en passant 8 à channelSize et FloatingPoint à typeInterpretation.

Voir aussi QPixelFormat::TypeInterpretation.

[constexpr noexcept] QPixelFormat qPixelFormatHsl(uchar channelSize, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::FloatingPoint)

Fonction de construction pour créer des formats HSL. Le nombre de canaux sera de 3 ou 4 selon que alphaSize est plus grand que 0.

channelSize définira les valeurs hueSize saturationSize et lightnessSize à la même valeur.

alphaUsage alphaPosition et typeInterpretation sont tous accessibles avec les accesseurs portant le même nom.

[constexpr noexcept] QPixelFormat qPixelFormatHsv(uchar channelSize, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::FloatingPoint)

Fonction de construction pour créer des formats HSV. Le nombre de canaux sera de 3 ou 4 selon que alphaSize est plus grand que 0.

channelSize définira les valeurs hueSize saturationSize et brightnessSize à la même valeur.

alphaUsage alphaPosition et typeInterpretation sont tous accessibles avec les accesseurs portant le même nom.

[constexpr noexcept] QPixelFormat qPixelFormatRgba(uchar redSize, uchar greenSize, uchar blueSize, uchar alphaSize, QPixelFormat::AlphaUsage alphaUsage, QPixelFormat::AlphaPosition alphaPosition, QPixelFormat::AlphaPremultiplied premultiplied = QPixelFormat::NotPremultiplied, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedInteger)

Fonction de construction d'un pixelformat RVB. redSize greenSize blueSize représentent la taille de chaque canal de couleur. alphaSize décrit la taille du canal alpha et sa position est décrite par alphaPosition. alphaUsage est utilisé pour déterminer si le canal alpha est utilisé ou non. En réglant la taille du canal alpha sur 8 et alphaUsage sur IgnoresAlpha, il est possible de créer un format 32 bits dans lequel les canaux rgb n'utilisent que 24 bits combinés. premultiplied typeInterpretation sont accessibles par des accesseurs portant le même nom.

Voir aussi QPixelFormat::TypeInterpretation.

QPixelFormat qPixelFormatYuv(QPixelFormat::YUVLayout yuvLayout, uchar alphaSize = 0, QPixelFormat::AlphaUsage alphaUsage = QPixelFormat::IgnoresAlpha, QPixelFormat::AlphaPosition alphaPosition = QPixelFormat::AtBeginning, QPixelFormat::AlphaPremultiplied premultiplied = QPixelFormat::NotPremultiplied, QPixelFormat::TypeInterpretation typeInterpretation = QPixelFormat::UnsignedByte, QPixelFormat::ByteOrder byteOrder = QPixelFormat::LittleEndian)

Fonction de construction pour créer un QPixelFormat décrivant un format YUV avec yuvLayout. alphaSize décrit la taille d'un canal alpha potentiel et sa position est décrite avec alphaPosition. Les canaux "premier", "deuxième" et "cinquième" sont tous réglés sur 0. alphaUsage premultiplied typeInterpretation et byteOrder fonctionneront comme avec les autres formats.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.