QCanvasImagePattern Class
QCanvasImagePattern es un pincel para pintar motivos gráficos. Más información...
| Encabezado: | #include <QCanvasImagePattern> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS CanvasPainter) target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter) |
| Desde: | Qt 6.11 |
Funciones públicas
| QCanvasImagePattern(const QCanvasImage &image) | |
| QCanvasImagePattern(const QCanvasImage &image, QPointF startPosition, QSizeF imageSize) | |
| QCanvasImagePattern(const QCanvasImage &image, qreal startX, qreal startY, qreal imageWidth, qreal imageHeight) | |
| QCanvasImagePattern(const QCanvasImagePattern &) | |
| QCanvasImagePattern(QCanvasImagePattern &&) | |
| QCanvasImage | image() const |
| QSizeF | imageSize() const |
| qreal | rotation() const |
| void | setImage(const QCanvasImage &image) |
| void | setImageSize(qreal width, qreal height) |
| void | setImageSize(QSizeF size) |
| void | setRotation(qreal rotation) |
| void | setStartPosition(qreal x, qreal y) |
| void | setStartPosition(QPointF point) |
| void | setTintColor(QColor color) |
| QPointF | startPosition() const |
| QColor | tintColor() const |
| operator QVariant() const |
Elementos no miembros relacionados
| bool | operator!=(const QCanvasImagePattern &lhs, const QCanvasImagePattern &rhs) |
| QDataStream & | operator<<(QDataStream &stream, const QCanvasImagePattern &pattern) |
| bool | operator==(const QCanvasImagePattern &lhs, const QCanvasImagePattern &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QCanvasImagePattern &pattern) |
Descripción detallada
QCanvasImage es un pincel para pintar patrones de imagen. Para utilizar como patrón, debe tener activados algunos indicadores de repetición, como QCanvasPainter::ImageFlag::Repeat.
A continuación se muestra un ejemplo sencillo:
// Setup 2 image patterns
static QImage image1(":/pattern2.png");
static QImage image2(":/pattern3.png");
auto flags = QCanvasPainter::ImageFlag::Repeat |
QCanvasPainter::ImageFlag::GenerateMipmaps;
QCanvasImage bg1 = painter.addImage(image1, flags);
QCanvasImage bg2 = painter.addImage(image2, flags);
QCanvasImagePattern ip1(bg1, 0, 0, 64, 64);
QCanvasImagePattern ip2(bg2, 0, 0, 32, 32);
// Fill and stroke round rectangle with
// these image pattern brushes.
painter.beginPath();
painter.roundRect(50, 50, 180, 180, 40);
painter.setFillStyle(ip1);
painter.setStrokeStyle(ip2);
painter.fill();
painter.setLineWidth(20);
painter.stroke();
Nota: Al utilizar patrones de imagen, las imágenes suelen reducirse de tamaño, por lo que puede resultar útil establecer QCanvasPainter::ImageFlag::GenerateMipmaps para el QCanvasImage utilizado, a fin de obtener patrones uniformes.
Documentación de las funciones de miembro
QCanvasImagePattern::QCanvasImagePattern(const QCanvasImage &image)
Crea un patrón de imagen. El patrón utilizará image. Ten en cuenta que image suele tener, como mínimo, el indicador QCanvasPainter::ImageFlag::Repeat activado. La posición inicial del patrón es (0, 0) y su tamaño es (100, 100). El ángulo del patrón es 0,0 y el color de matiz es blanco (sin matiz).
QCanvasImagePattern::QCanvasImagePattern(const QCanvasImage &image, QPointF startPosition, QSizeF imageSize)
Crea un patrón de imagen utilizando image, comenzando en startPosition y dibujando la imagen en imageSize. Ten en cuenta que image suele tener, como mínimo, el indicador QCanvasPainter::ImageFlag::Repeat activado.
Véase también setStartPosition() y setImageSize().
QCanvasImagePattern::QCanvasImagePattern(const QCanvasImage &image, qreal startX, qreal startY, qreal imageWidth, qreal imageHeight)
Crea un patrón de imagen utilizando image, comenzando en startX, startY y dibujando la imagen en imageWidth, imageHeight. Ten en cuenta que image suele requerir que se active al menos el indicador QCanvasPainter::ImageFlag::Repeat.
Véase también setRotation() y setTintColor().
QCanvasImagePattern::QCanvasImagePattern(const QCanvasImagePattern &)
Destruye el patrón de la imagen.
[constexpr noexcept default] QCanvasImagePattern::QCanvasImagePattern(QCanvasImagePattern &&)
Crea una instancia de ` QCanvasImagePattern` mediante la construcción «move».
QCanvasImage QCanvasImagePattern::image() const
Devuelve la imagen del patrón.
Véase también setImage().
QSizeF QCanvasImagePattern::imageSize() const
Devuelve el tamaño de una sola imagen del patrón.
Véase también setImageSize().
qreal QCanvasImagePattern::rotation() const
Devuelve la rotación del patrón en radianes.
Véase también setRotation().
void QCanvasImagePattern::setImage(const QCanvasImage &image)
Establece la imagen del patrón en image. Nota: Por lo general, la imagen debe tener activado el indicador « Repeat » cuando se utilice en un patrón de imagen.
Véase también image().
void QCanvasImagePattern::setImageSize(qreal width, qreal height)
Establece el tamaño de una sola imagen del patrón en ( width, height).
Véase también imageSize().
void QCanvasImagePattern::setImageSize(QSizeF size)
Establece el tamaño de una sola imagen del patrón en size.
Esta es una función sobrecargada.
void QCanvasImagePattern::setRotation(qreal rotation)
Establece la rotación del patrón en rotation en radianes. La rotación se realiza alrededor de la imagen startPosition(). El valor por defecto es 0.0, lo que significa que la imagen no se gira.
Véase también rotation().
void QCanvasImagePattern::setStartPosition(qreal x, qreal y)
Establece el punto de inicio del patrón de la imagen en (x, y). La posición de inicio corresponde a la esquina superior izquierda de una imagen del patrón. A continuación, el patrón se extenderá a todas las posiciones a partir de ahí (si se ha activado el indicador « Repeat »).
Véase también startPosition().
void QCanvasImagePattern::setStartPosition(QPointF point)
Establece el punto de inicio del patrón de la imagen en point. La posición inicial corresponde a la esquina superior izquierda de una imagen del patrón. A continuación, el patrón se extenderá a todas las posiciones a partir de ahí (si se ha activado el indicador « Repeat »).
Esta es una función sobrecargada.
void QCanvasImagePattern::setTintColor(QColor color)
Establece el color de tinte del patrón en color. El color de la imagen del patrón se multiplicará por este color de tinte en el shader. El valor por defecto es el blanco, lo que significa que no se aplica ningún tinte.
Nota: Para establecer el alfa de forma global, utiliza QCanvasPainter::setGlobalAlpha()
Véase también tintColor().
QPointF QCanvasImagePattern::startPosition() const
Devuelve el punto inicial del patrón de la imagen.
Véase también ` setStartPosition()`.
QColor QCanvasImagePattern::tintColor() const
Devuelve el color de matiz del patrón.
Véase también setTintColor().
QCanvasImagePattern::operator QVariant() const
Devuelve el patrón de la imagen como un objeto ` QVariant`.
Elementos relacionados que no son miembros
[noexcept] bool operator!=(const QCanvasImagePattern &lhs, const QCanvasImagePattern &rhs)
Devuelve ` true ` si el patrón de la imagen ` lhs ` es diferente de ` rhs`; en caso contrario, devuelve ` false `.
Véase también operator==().
QDataStream &operator<<(QDataStream &stream, const QCanvasImagePattern &pattern)
Escribe el objeto ` pattern ` especificado en el objeto ` stream ` especificado y devuelve una referencia al objeto ` stream`.
Véase también «Serialización detipos de datos de Qt».
[noexcept] bool operator==(const QCanvasImagePattern &lhs, const QCanvasImagePattern &rhs)
Devuelve « true » si el patrón de imagen « lhs » es igual a « rhs »; en caso contrario, devuelve « false ».
Véase también operator!=().
QDataStream &operator>>(QDataStream &stream, QCanvasImagePattern &pattern)
Lee el objeto ` pattern ` especificado a partir del objeto ` stream ` especificado y devuelve una referencia al objeto ` stream`.
Véase también «Serialización detipos de datos de Qt».
© 2026 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.