QCanvasImagePattern Class
QCanvasImagePattern은 이미지 패턴을 그리기 위한 브러시입니다. 더 보기...
| 헤더: | #include <QCanvasImagePattern> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS CanvasPainter)target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter) |
| 이후 | Qt 6.11 |
| 상속합니다: | QCanvasBrush |
| Status: | 기술 미리보기 |
공용 함수
| QCanvasImagePattern() | |
| QCanvasImagePattern(const QCanvasImage &image) | |
| QCanvasImagePattern(const QCanvasImage &image, const QRectF &rect, float angle = 0.0f, const QColor &tintColor = QColorConstants::White) | |
| QCanvasImagePattern(const QCanvasImage &image, float x, float y, float width, float height, float angle = 0.0f, const QColor &tintColor = QColorConstants::White) | |
| ~QCanvasImagePattern() | |
| QCanvasImage | image() const |
| QSizeF | imageSize() const |
| float | rotation() const |
| void | setImage(const QCanvasImage &image) |
| void | setImageSize(float width, float height) |
| void | setImageSize(QSizeF size) |
| void | setRotation(float rotation) |
| void | setStartPosition(float x, float y) |
| void | setStartPosition(QPointF point) |
| void | setTintColor(const QColor &color) |
| QPointF | startPosition() const |
| QColor | tintColor() const |
| operator QVariant() const |
관련 비회원
| 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) |
상세 설명
QCanvasImagePattern은 이미지 패턴을 그리기 위한 브러시입니다. QCanvasImage 을 패턴으로 사용하려면 QCanvasPainter::ImageFlag::Repeat 과 같은 반복 플래그가 켜져 있어야 합니다.
다음은 간단한 예제입니다:
// 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();

참고: 이미지 패턴을 사용할 때 이미지의 크기를 작게 조정하는 경우가 많으며, 부드러운 패턴을 위해 QCanvasImage 에 QCanvasPainter::ImageFlag::GenerateMipmaps 을 설정하는 것이 유용할 수 있습니다.
멤버 함수 문서
QCanvasImagePattern::QCanvasImagePattern()
기본 이미지 패턴을 생성합니다. 이미지가 설정되지 않으므로 이 생성자 뒤에 setImage()를 사용하세요. 패턴 시작 위치는 (0, 0), 패턴 크기는 (100, 100)입니다. 패턴 각도는 0.0, 색조는 흰색(색조 없음)입니다.
setImage()도 참조하세요 .
QCanvasImagePattern::QCanvasImagePattern(const QCanvasImage &image)
이미지 패턴을 구성합니다. 패턴은 image 을 사용합니다. image 에는 일반적으로 QCanvasPainter::ImageFlag::Repeat 플래그가 설정되어 있어야 합니다. 패턴 시작 위치는 (0, 0), 패턴 크기는 (100, 100)입니다. 패턴 각도는 0.0, 색조는 흰색(색조 없음)입니다.
QCanvasImagePattern::QCanvasImagePattern(const QCanvasImage &image, const QRectF &rect, float angle = 0.0f, const QColor &tintColor = QColorConstants::White)
이미지 패턴을 구성합니다. 패턴은 image 을 사용합니다. image 에는 일반적으로 QCanvasPainter::ImageFlag::Repeat 플래그가 설정되어 있어야 합니다. 패턴 이미지 위치와 크기는 rect 로 정의됩니다. 패턴 각도는 angle, 틴트 색상은 tintColor 입니다.
QCanvasImagePattern::QCanvasImagePattern(const QCanvasImage &image, float x, float y, float width, float height, float angle = 0.0f, const QColor &tintColor = QColorConstants::White)
이미지 패턴을 구성합니다. 패턴은 image 을 사용합니다. image 에는 일반적으로 QCanvasPainter::ImageFlag::Repeat 플래그가 설정되어 있어야 합니다. 패턴 이미지 시작 위치는 ( x, y)이고 패턴 크기는 ( width, height)입니다. 패턴 각도는 angle, 틴트 색상은 tintColor 입니다.
[noexcept] QCanvasImagePattern::~QCanvasImagePattern()
이미지 패턴을 파괴합니다.
QCanvasImage QCanvasImagePattern::image() const
패턴의 이미지를 반환합니다.
setImage()도 참조하세요 .
QSizeF QCanvasImagePattern::imageSize() const
단일 이미지의 크기를 패턴으로 반환합니다.
setImageSize()도 참조하세요 .
float QCanvasImagePattern::rotation() const
패턴 회전을 라디안 단위로 반환합니다.
setRotation()도 참조하세요 .
void QCanvasImagePattern::setImage(const QCanvasImage &image)
패턴의 이미지를 image 로 설정합니다. 참고: 이미지 패턴에 사용할 때는 일반적으로 Repeat 플래그가 설정되어 있어야 합니다.
image()도 참조하세요 .
void QCanvasImagePattern::setImageSize(float width, float height)
패턴에서 단일 이미지의 크기를 ( width, height)로 설정합니다.
imageSize()도 참조하세요 .
void QCanvasImagePattern::setImageSize(QSizeF size)
단일 이미지의 패턴 크기를 size 로 설정합니다.
이 함수는 오버로드된 함수입니다.
void QCanvasImagePattern::setRotation(float rotation)
패턴 회전을 라디안 단위( rotation )로 설정합니다. 회전은 이미지 startPosition()를 중심으로 이루어집니다. 기본값은 0.0 으로 이미지가 회전되지 않습니다.
rotation()도 참조하세요 .
void QCanvasImagePattern::setStartPosition(float x, float y)
이미지 패턴의 시작 지점을 (x, y)로 설정합니다. 시작 위치는 패턴에서 이미지의 왼쪽 상단 모서리를 의미합니다. 그런 다음 패턴은 여기에서 모든 위치로 확장됩니다(이미지 Repeat 플래그가 설정된 경우).
startPosition()도 참조하세요 .
void QCanvasImagePattern::setStartPosition(QPointF point)
이미지 패턴의 시작 지점을 point 로 설정합니다. 시작 위치는 패턴에서 이미지의 왼쪽 상단 모서리를 의미합니다. 그런 다음 패턴은 여기에서 모든 위치로 확장됩니다(이미지 Repeat 플래그가 설정된 경우).
이 함수는 오버로드된 함수입니다.
void QCanvasImagePattern::setTintColor(const QColor &color)
패턴 색조 색상을 color 로 설정합니다. 패턴 이미지의 색상에 셰이더에서 이 색조 색상이 곱해집니다. 기본값은 흰색으로, 색조가 없습니다.
참고: 전역적으로 알파를 설정하려면 QCanvasPainter::setGlobalAlpha()를 사용합니다.
tintColor()도 참조하세요 .
QPointF QCanvasImagePattern::startPosition() const
이미지 패턴의 시작점을 반환합니다.
setStartPosition()도 참조하세요 .
QColor QCanvasImagePattern::tintColor() const
패턴 색조 색상을 반환합니다.
setTintColor()도 참조하세요 .
QCanvasImagePattern::operator QVariant() const
이미지 패턴을 QVariant 로 반환합니다.
관련 비회원
[noexcept] bool operator!=(const QCanvasImagePattern &lhs, const QCanvasImagePattern &rhs)
이미지 패턴 lhs 이 rhs 과 다르면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
operator==()도 참조하세요 .
QDataStream &operator<<(QDataStream &stream, const QCanvasImagePattern &pattern)
주어진 pattern 을 주어진 stream 에 쓰고 stream 에 대한 참조를 반환합니다.
Qt 데이터형 직렬화도참조하십시오 .
[noexcept] bool operator==(const QCanvasImagePattern &lhs, const QCanvasImagePattern &rhs)
이미지 패턴 lhs 이 rhs 과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
operator!=()도 참조하세요 .
QDataStream &operator>>(QDataStream &stream, QCanvasImagePattern &pattern)
주어진 stream 에서 주어진 pattern 을 읽고 stream 에 대한 참조를 반환합니다.
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.