이 페이지에서

QPainterPathStroker Class

QPainterPathStroker 클래스는 주어진 페인터 경로에 대해 채울 수 있는 윤곽선을 생성하는 데 사용됩니다. 더 보기...

헤더: #include <QPainterPathStroker>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

공개 함수

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 규칙이 필요합니다.

QPen 및 QBrush도 참조하십시오 .

멤버 함수 문서

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()도 참조하십시오 .

© 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.