TraceCanvas QML Type

Trace 객체를 렌더링하기 위한 특수한 Canvas 유형입니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• autoDestroy : bool
• autoDestroyDelay : int
• renderFunction : var
• trace : Trace

신호

• onRecycle(var traceCanvas) (since 6.1)

방법

• recycle() (since 6.1)
• renderClear() (since 6.1)
• renderSmoothedLine()

상세 설명

이 유형은 화면에 Trace 객체를 렌더링하는 기능을 제공합니다.

키보드에서 Trace 렌더링을 사용할 수 있게 하려면, 이 타입을 ` KeyboardStyle.traceCanvasDelegate ` 컴포넌트로 선언해야 합니다.

traceCanvasDelegate: TraceCanvas {
}

Canvas.available 신호에서 사용자 정의 그리기 속성을 초기화할 수 있습니다. 예:

onAvailableChanged: {
    if (!available)
        return;
    var ctx = getContext("2d")
    ctx.lineWidth = 8 * scaleHint
    ctx.lineCap = "round"
    ctx.strokeStyle = Qt.rgba(0xFF, 0xFF, 0xFF)
    ctx.fillStyle = ctx.strokeStyle
}

이 타입은 Trace 렌더링을 위한 내장 옵션을 제공합니다. 현재 다음과 같은 렌더링 옵션을 사용할 수 있습니다:

• renderSmoothedLine 모서리가 둥근 부드러운 선을 렌더링합니다(기본값).

renderFunction 속성을 사용하여 렌더링 함수를 변경할 수 있습니다.

renderFunction: renderSmoothedLine

사용자 정의 렌더링 함수도 지원됩니다. 다음 예제를 참고하십시오:

renderFunction: renderCustomLine

function renderCustomLine() {
    getContext("2d")
    var points = trace.points()

    ...
}

속성 설명서

autoDestroy : bool

자동 소멸 모드를 활성화합니다.

이 항목이 활성화되면, ` trace ` 객체가 소멸될 때 이 항목도 함께 소멸됩니다.

기본값은 false입니다. 이 경우 onRecycle 신호가 트리거된 후에도 캔버스를 재사용할 수 있습니다.

autoDestroyDelay : int

객체가 소멸되거나 재활용되기까지, 자동 소멸이 시작된 시점부터 계산된 대략적인 지연 시간을 밀리초 단위로 지정합니다.

이 지연 시간을 통해, 예를 들어, 객체가 소멸되기 전에 애니메이션을 적용할 수 있습니다.

기본값은 0입니다.

renderFunction : var

이 속성은 렌더링 함수를 정의합니다.

기본값은 renderSmoothedLine

trace : Trace

Trace 객체에 대한 액세스를 제공합니다.

Signal 문서

[since 6.1] onRecycle(var traceCanvas)

traceCanvas 이 재활용될 때 발생합니다.

이 신호는 Qt 6.1에서 도입되었습니다.

메서드 문서

[since 6.1] recycle()

모든 그림을 지우고 변수를 초기화하여 트레이스 캔버스를 재설정합니다.

이 함수는 완료 후(반환 전)에 ` onRecycle ` 신호를 트리거합니다.

재활용이 성공하면 이 함수는 true를 반환합니다.

이 메서드는 Qt 6.1에서 도입되었습니다.

[since 6.1] renderClear()

화면을 지우고 렌더링을 초기화합니다.

이 메서드는 Qt 6.1에서 도입되었습니다.

renderSmoothedLine()

모서리가 둥근 매끄러운 선을 렌더링합니다.

이 함수는 증분 방식으로 작동하며, Trace에 추가된 새로운 부분만 렌더링합니다.

이 함수는 캔버스 속성을 변경하지 않습니다(즉, 속성은 다른 곳에서 설정할 수 있습니다).