QPixelFormat Class

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, qui sera résolu en fonction de l'endianness du système pour les formats non ordonnés par octets, et QPixelFormat::BigEndian pour QPixelFormat::UnsignedByte.

subEnum est utilisé pour les modèles de couleur qui doivent stocker des informations supplémentaires en fournissant une énumération supplémentaire. YUV l'utilise pour stocker le type YUV La valeur par défaut est 0.

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

Fonction d'accès à la position du canal alpha par rapport aux canaux de couleur.

Pour les formats où les canaux individuels correspondent à des unités individuelles, la position alpha est relative à ces unités. Par exemple, pour QImage::Format_RGBA16FPx4, dont la position alpha est QPixelFormat::AtEnd, la position alpha correspond à la dernière lecture de qfloat16.

Pour les formats dans lesquels plusieurs canaux sont regroupés en une seule unité, les valeurs QPixelFormat::AtBeginning et QPixelFormat::AtEnd correspondent aux bits les plus significatifs et les moins significatifs de l'unité regroupée, par rapport au format byteOrder().

Par exemple, pour QImage::Format_ARGB32, qui a une interprétation de type de QPixelFormat::UnsignedInteger et un byteOrder() qui correspond toujours au système hôte, la position alpha de QPixelFormat::AtBeginning signifie que l'alpha peut toujours être trouvé à 0xFF000000.

Si le format de pixel et l'endianness de l'hôte ne correspondent pas, il faut veiller à faire correspondre correctement la disposition du format de pixel à la disposition de la mémoire de l'hôte.

Voir également alphaUsage(), alphaSize() et premultiplied().

[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 permettant de déterminer si le canal alpha est utilisé ou non.

Parfois, le format de pixel réserve une place pour un canal alpha, de sorte que alphaSize() renvoie > 0, mais le canal alpha n'est pas utilisé/ignoré.

Par exemple, pour QImage::Format_RGB32, la valeur de bitsPerPixel() est 32, car le canal alpha a une taille de 8, mais alphaUsage() reflète QPixelFormat::IgnoresAlpha.

Notez que dans de telles situations, le position du canal alpha inutilisé est toujours important, car il affecte l'emplacement des canaux de couleur.

Voir également alphaPosition(), alphaSize() et premultiplied().

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

Fonction d'accès aux bits utilisés par pixel. Cette fonction renvoie la somme de tous les 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 du format des pixels détermine la disposition de la mémoire des unités de type individuelles, comme le décrit la fonction typeInterpretation().

Cette fonction ne renverra jamais QPixelFormat::CurrentSystemEndian car cette valeur est convertie en valeur endian du système dans le constructeur.

Pour les formats de pixels avec typeInterpretation() QPixelFormat::UnsignedByte, cette valeur sera typiquement QPixelFormat::BigEndian, tandis que les autres interprétations de type refléteront typiquement l'endianité du système actuel.

Si l'ordre des octets du format de pixel correspond au système actuel, les unités de type individuelles peuvent être lues et manipulées en utilisant les mêmes masques de bits et les mêmes opérations, indépendamment de l'endianité du système hôte. Par exemple, avec QImage::Format_ARGB32, qui a une interprétation de type QPixelFormat::UnsignedInteger, l'alpha peut toujours être lu en masquant unsigned int par 0xFF000000, quelle que soit l'endiannée de l'hôte.

Si le format du pixel et l'endianness de l'hôte ne correspondent pas, il faut en tenir compte. Les classes comme QImage ne permutent pas les bits internes pour correspondre à l'endianness du système hôte dans ces cas.

Voir également typeInterpretation() et alphaPosition().

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

Fonction d'accès au nombre de canaux.

Le nombre de canaux représente les canaux (couleur et alpha) dont la taille est supérieure à 0.

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

Fonction d'accès au modèle de couleur.

Notez que pour QPixelFormat::YUV, les macro-pixels individuels ne peuvent pas être décrits. Au lieu de cela, une liste de YUV formats est fournie et la valeur de bitsPerPixel() est déduite de l'agencement YUV.

[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 permettant de déterminer 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

L'interprétation du type détermine la manière dont chaque pixel doit être lu.

Chaque pixel est représenté par une ou plusieurs unités du type donné, disposées séquentiellement dans la mémoire.

Par exemple, QImage::Format_Mono a un pixel format de 1 bit par pixel et une interprétation de type QPixelFormat::UnsignedByte, qui doivent être lus comme un seul byte. De même, QImage::Format_RGB888 a une pixel format de 24 bits par pixel et une interprétation de type QPixelFormat::UnsignedByte, qui doit être lue comme trois byteconsécutifs.

Beaucoup de QImage formats sont à 32 bits avec une interprétation de type QPixelFormat::UnsignedInteger, qui doit être lue comme une seule unsigned int.

Pour les formats QPixelFormat::FloatingPoint tels que QImage::Format_RGBA16FPx4 ou QImage::Format_RGBA32FPx4, le type est déterminé en fonction de la taille des canaux couleur/alpha individuels, avec qfloat16 pour les formats demi-float 16 bits et float pour les formats full-float 32 bits.

Voir également byteOrder().

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