QPainterPathStroker Class
QPainterPathStroker 클래스는 주어진 페인터 경로에 대해 채울 수 있는 윤곽선을 생성하는 데 사용됩니다. 더 보기...
Header: | #include <QPainterPathStroker> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake: | QT += gui |
- 상속된 멤버를 포함한 모든 멤버 목록
- QPainterPathStroker는 페인팅 클래스의 일부입니다.
공용 함수
QPainterPathStroker() | |
QPainterPathStroker(const QPen &pen) | |
~QPainterPathStroker() | |
Qt::PenCapStyle | capStyle() const |
QPainterPath | createStroke(const QPainterPath &path) const |
qreal | curveThreshold() const |
qreal | dashOffset() const |
QList<qreal> | dashPattern() const |
Qt::PenJoinStyle | joinStyle() const |
qreal | miterLimit() const |
void | setCapStyle(Qt::PenCapStyle style) |
void | setCurveThreshold(qreal threshold) |
void | setDashOffset(qreal offset) |
void | setDashPattern(Qt::PenStyle style) |
void | setDashPattern(const QList<qreal> &dashPattern) |
void | setJoinStyle(Qt::PenJoinStyle style) |
void | setMiterLimit(qreal limit) |
void | setWidth(qreal width) |
qreal | width() const |
상세 설명
createStroke() 함수를 호출하고 지정된 QPainterPath 을 인수로 전달하면 지정된 경로의 윤곽을 나타내는 새 페인터 경로가 생성됩니다. 그런 다음 새로 생성된 페인터 경로를 채워 원래 페인터 경로의 윤곽선을 그릴 수 있습니다.
다음 함수를 사용하여 윤곽선의 다양한 디자인 측면(너비, 캡 스타일, 조인 스타일 및 대시 패턴)을 제어할 수 있습니다:
setDashPattern() 함수는 Qt::PenStyle 개체와 패턴의 목록 표현을 모두 인수로 사용할 수 있습니다.
또한 setCurveThreshold() 함수를 사용하여 커브의 임계값을 지정하여 커브가 그려지는 세분성을 제어할 수 있습니다. 기본 임계값은 잘 조정된 값(0.25)이며 일반적으로는 수정할 필요가 없습니다. 그러나 값을 낮추면 커브의 모양을 더 부드럽게 만들 수 있습니다.
setMiterLimit() 함수를 사용하여 생성된 윤곽선의 마이터 제한을 제어할 수도 있습니다. 마이터 제한은 마이터 조인이 각 조인에서 얼마나 멀리 확장될 수 있는지를 나타냅니다. 제한은 너비 단위로 지정되므로 픽셀 단위의 마이터 제한은 miterlimit * width
입니다. 이 값은 조인 스타일이 Qt::MiterJoin 인 경우에만 사용됩니다.
createStroke() 함수에 의해 생성된 페인터 경로는 지정된 페인터 경로의 윤곽을 그리는 데만 사용해야 합니다. 그렇지 않으면 예기치 않은 동작이 발생할 수 있습니다. 또한 생성된 윤곽선에는 기본적으로 설정된 Qt::WindingFill 규칙이 필요합니다.
멤버 함수 문서
QPainterPathStroker::QPainterPathStroker()
새 스트로커를 생성합니다.
[explicit]
QPainterPathStroker::QPainterPathStroker(const QPen &pen)
pen 을 기반으로 새 스트로커를 생성합니다.
[noexcept]
QPainterPathStroker::~QPainterPathStroker()
스트로커를 파괴합니다.
Qt::PenCapStyle QPainterPathStroker::capStyle() const
생성된 윤곽선의 캡 스타일을 반환합니다.
setCapStyle()도 참조하세요 .
QPainterPath QPainterPathStroker::createStroke(const QPainterPath &path) const
주어진 path 의 윤곽선을 나타내는 채울 수 있는 영역인 새 경로를 생성합니다.
윤곽선의 다양한 디자인 측면은 스트로커의 속성을 기반으로 합니다: width(), capStyle(), joinStyle(), dashPattern(), curveThreshold() 및 miterLimit().
생성된 경로는 지정된 페인터 경로의 윤곽을 그리는 데만 사용해야 합니다. 그렇지 않으면 예기치 않은 동작이 발생할 수 있습니다. 또한 생성된 윤곽선에는 기본적으로 설정된 Qt::WindingFill 규칙이 필요합니다.
qreal QPainterPathStroker::curveThreshold() const
생성된 윤곽선에 대한 커브 평탄화 임계값을 반환합니다.
setCurveThreshold()도 참조하세요 .
qreal QPainterPathStroker::dashOffset() const
생성된 윤곽선에 대한 대시 오프셋을 반환합니다.
setDashOffset()도 참조하세요 .
QList<qreal> QPainterPathStroker::dashPattern() const
생성된 윤곽선에 대한 대시 패턴을 반환합니다.
setDashPattern()도 참조하세요 .
Qt::PenJoinStyle QPainterPathStroker::joinStyle() const
생성된 윤곽선의 조인 스타일을 반환합니다.
setJoinStyle()도 참조하세요 .
qreal QPainterPathStroker::miterLimit() const
생성된 윤곽선에 대한 마이터 제한을 반환합니다.
setMiterLimit()도 참조하세요 .
void QPainterPathStroker::setCapStyle(Qt::PenCapStyle style)
생성된 윤곽선의 캡 스타일을 style 으로 설정합니다. 대시 패턴이 설정된 경우 패턴의 각 세그먼트에 캡이 적용됩니다 style.
capStyle()도 참조하세요 .
void QPainterPathStroker::setCurveThreshold(qreal threshold)
커브 평탄화( threshold)를 지정하여 생성된 윤곽선의 커브가 그려지는 세분성을 제어합니다.
기본 임계값은 잘 조정된 값(0.25)이며 일반적으로는 수정할 필요가 없습니다. 그러나 값을 낮추면 커브의 모양을 더 부드럽게 만들 수 있습니다.
curveThreshold()도 참조하세요 .
void QPainterPathStroker::setDashOffset(qreal offset)
생성된 윤곽선의 대시 오프셋을 offset 으로 설정합니다.
대시 오프셋에 대한 설명은 QPen::setDashOffset() 설명서를 참조하세요.
dashOffset()도 참조하세요 .
void QPainterPathStroker::setDashPattern(Qt::PenStyle style)
생성된 윤곽선의 대시 패턴을 style 로 설정합니다.
dashPattern()도 참조하세요 .
void QPainterPathStroker::setDashPattern(const QList<qreal> &dashPattern)
이 함수는 오버로드된 함수입니다.
생성된 윤곽선의 대시 패턴을 dashPattern 로 설정합니다. 이 함수를 사용하면 사용자 지정 대시 패턴을 지정할 수 있습니다.
목록의 각 요소에는 첫 번째 요소의 첫 번째 대시, 두 번째 요소의 첫 번째 공백으로 시작하여 다음 요소 쌍마다 대시와 공백이 번갈아 가며 획의 대시 및 공백 길이가 포함됩니다.
목록에는 홀수 개의 요소가 포함될 수 있으며, 이 경우 패턴이 반복될 때 마지막 요소는 첫 번째 요소의 길이만큼 확장됩니다.
void QPainterPathStroker::setJoinStyle(Qt::PenJoinStyle style)
생성된 윤곽선의 조인 스타일을 style 로 설정합니다.
joinStyle()도 참조하세요 .
void QPainterPathStroker::setMiterLimit(qreal limit)
생성된 윤곽선의 연귀 제한을 limit 으로 설정합니다.
마이터 제한은 마이터 조인이 각 조인에서 얼마나 멀리 확장될 수 있는지를 나타냅니다. 제한은 현재 설정된 너비 단위로 지정됩니다. 따라서 픽셀 단위의 마이터 제한은 miterlimit * width
입니다.
이 값은 조인 스타일이 Qt::MiterJoin 인 경우에만 사용됩니다.
miterLimit()도 참조하세요 .
void QPainterPathStroker::setWidth(qreal width)
생성된 윤곽선 페인터 경로의 너비를 width 로 설정합니다.
생성된 윤곽선은 지정된 입력 경로의 원래 윤곽선의 각 측면으로 width 의 약 50%를 확장합니다.
width()도 참조하세요 .
qreal QPainterPathStroker::width() const
생성된 윤곽선의 너비를 반환합니다.
setWidth()도 참조하세요 .
© 2025 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.