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

Dokumentation der Mitgliedsfunktionen

QCanvasImage::QCanvasImage()

Erstellt ein Standardbild.

QCanvasImage::QCanvasImage(const QCanvasImage &image)

Erstellt ein Bild, das eine Kopie des angegebenen „ image “ ist.

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

Erstellt ein neues `QCanvasImage` aus ` other`.

[noexcept] QCanvasImage::~QCanvasImage()

Zerstört das Bild.

qreal QCanvasImage::devicePixelRatio() const

Gibt das Gerätepixelverhältnis für das Bild zurück. Dabei handelt es sich um das Verhältnis zwischen Gerätepixeln und geräteunabhängigen Pixeln.

Ein „ QCanvasImage “ mit einem Gerätepixelverhältnis größer als 1 wendet diesen Skalierungsfaktor bei der Verwendung des Bildes an. Beispielsweise entspricht „ drawImage(image, 0, 0) “ dann „ drawImage(image, 0, 0, image.width() / image.devicePixelRatio(), image.height() / image.devicePixelRatio()) “.

Der Standardwert ist 1,0.

Der Wert wird von dem „ QImage “ übernommen, aus dem der „ QCanvasImage “ erstellt wurde. Ein „ QCanvasImage “, das aus einer Textur oder einem „ offscreen canvas “ erstellt wurde, hat immer ein Gerätepixelverhältnis von 1.

Siehe auch „ QImage “.

int QCanvasImage::height() const

Gibt die Höhe dieses Bildes in Pixeln zurück;

int QCanvasImage::id() const

Gibt die Textur-ID für dieses Bild zurück. Wenn dem Bild noch keine Textur zugewiesen wurde, wird 0 zurückgegeben.

Siehe auch isNull().

bool QCanvasImage::isNull() const

Gibt „true“ zurück, wenn das Bild noch nicht zugewiesen wurde. Weitere Informationen finden Sie unter QCanvasPainter::addImage().

void QCanvasImage::setTintColor(QColor color)

Legen Sie den Farbton color des Bildes fest. Diese Farbe wird mit der Bildfarbe multipliziert, um das Bild einzufärben. Dies kann beispielsweise verwendet werden, um Symbole hervorzuheben oder Bilder an das Design anzupassen.

Siehe auch tintColor().

QSize QCanvasImage::size() const

Gibt die Größe (Breite und Höhe) dieses Bildes in Pixeln zurück.

qsizetype QCanvasImage::sizeInBytes() const

Gibt die Größe dieses Bildes in Byte zurück.

QCanvasPainter Es werden keine Kopien der CPU-seitigen „ QImage “-Daten beibehalten, sobald „ addImage()“ zurückgegeben hat. Handelt es sich bei der Quelle um ein „ offscreen canvas “, liegen von vornherein keine CPU-seitigen Bilddaten vor. Daher ist das Ergebnis dieser Funktion eine Annäherung an den GPU-Speicher, der für die zugrunde liegende Textur verwendet wird.

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

Ersetzt dieses Bild durch other. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

QColor QCanvasImage::tintColor() const

Gibt die Farbnuance des Bildes zurück. Der Standardwert ist „ Qt::white “.

Siehe auch setTintColor().

int QCanvasImage::width() const

Gibt die Breite dieses Bildes in Pixeln zurück.

QCanvasImage::operator QVariant() const

Gibt das Bild als „ QVariant “ zurück.

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

Weist „ other “ dieser „ QCanvasImage “-Instanz zu.

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

Weist diesem Bild die angegebene „ image “ zu und gibt eine Referenz auf dieses Bild zurück.