QCanvasImage Class

static QImage logoImage(":/qtlogo.png");
// Paint an image pattern.
QCanvasImage bg = painter.addImage(logoImage,
             QCanvasPainter::ImageFlag::Repeat |
             QCanvasPainter::ImageFlag::GenerateMipmaps);
QCanvasImagePattern ip(bg, 0, 0, 44, 32);
painter.setFillStyle(ip);
painter.fillRect(50, 50, 320, 230);
// Paint a single image, with tint color.
QCanvasImage logo = painter.addImage(logoImage);
logo.setTintColor("#2cde85");
painter.drawImage(logo, 100, 80);

Documentation des fonctions membres

QCanvasImage::QCanvasImage()

Crée une image par défaut.

QCanvasImage::QCanvasImage(const QCanvasImage &image)

Crée une image qui est une copie de l'image.

[constexpr noexcept default] QCanvasImage::QCanvasImage(QCanvasImage &&other)

Crée par « move » un nouvel objet `QCanvasImage` à partir de ` other`.

[noexcept] QCanvasImage::~QCanvasImage()

Cela détruit l'image.

qreal QCanvasImage::devicePixelRatio() const

Renvoie le rapport de pixels de l'appareil pour l'image. Il s'agit du rapport entre les pixels de l'appareil et les pixels indépendants de l'appareil.

Un « QCanvasImage » dont le rapport de pixels de l'appareil est supérieur à 1 applique ce facteur d'échelle lors de l'utilisation de l'image. Par exemple, drawImage(image, 0, 0) équivaut alors à drawImage(image, 0, 0, image.width() / image.devicePixelRatio(), image.height() / image.devicePixelRatio()).

La valeur par défaut est 1,0.

Cette valeur est héritée de l’ QImage à partir de laquelle l’ QCanvasImage a été créée. Une QCanvasImage créée à partir d’une texture ou d’un offscreen canvas présente toujours un ratio de pixels de périphérique égal à 1.

Voir également « QImage ».

int QCanvasImage::height() const

Renvoie la hauteur de cette image en pixels ;

int QCanvasImage::id() const

Renvoie l'identifiant de texture de cette image. Si l'image n'a pas encore été attribuée, cette fonction renvoie 0.

Voir aussi isNull().

bool QCanvasImage::isNull() const

Renvoie « true » si l'image n'a pas encore été attribuée. Pour plus d'informations, consultez la fonction QCanvasPainter::addImage().

void QCanvasImage::setTintColor(QColor color)

Définit la teinte color de l'image. Cette couleur sera multipliée par la couleur de l'image pour la colorer. Cette fonction peut être utilisée, par exemple, pour mettre en valeur des icônes ou pour adapter les images au thème.

Voir aussi tintColor().

QSize QCanvasImage::size() const

Renvoie les dimensions (largeur et hauteur) de cette image en pixels.

qsizetype QCanvasImage::sizeInBytes() const

Renvoie la taille de cette image en octets.

QCanvasPainter Ne conserve pas de copies des données d'QImage s côté CPU une fois que la fonction ` addImage()` a renvoyé sa valeur. Si la source est un ` offscreen canvas`, il n'y a de toute façon pas de données d'image côté CPU. Par conséquent, le résultat de cette fonction est une approximation de la mémoire GPU utilisée pour la texture sous-jacente.

[noexcept] void QCanvasImage::swap(QCanvasImage &other)

Remplace cette image par celle de other. Cette opération est très rapide et ne pose jamais de problème.

QColor QCanvasImage::tintColor() const

Renvoie la couleur de teinte de l'image. La valeur par défaut est Qt::white.

Voir aussi setTintColor().

int QCanvasImage::width() const

Renvoie la largeur de cette image en pixels.

QCanvasImage::operator QVariant() const

Renvoie l'image sous la forme d'un objet ` QVariant`.

[noexcept] QCanvasImage &QCanvasImage::operator=(QCanvasImage &&other)

Cette opération attribue l'other à cette instance QCanvasImage.

QCanvasImage &QCanvasImage::operator=(const QCanvasImage &image)

Attribue l'image ion indiquée à cette image et renvoie une référence à cette image.