VectorImage QML Type

벡터 이미지 파일을 불러와 ‘ Qt Quick ’ 씬에 표시합니다. 더 보기...

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

속성

• animations (since 6.10)
  • animations.loops : int (since 6.10)
  • animations.paused : bool (since 6.10)
• assumeTrustedSource : bool (since 6.10)
• asynchronous : bool (since 6.12)
• asynchronousShapes : bool (since 6.11)
• fillMode : enumeration
• generatedItem : Item (since 6.12)
• preferredRendererType : enumeration
• retainWhileLoading : bool (since 6.12)
• source : url
• status : enumeration (since 6.12)

상세 설명

VectorImage는 벡터 이미지 파일을 불러와 Qt Quick 장면의 아이템으로 표시하는 데 사용할 수 있습니다.

현재는 SVG 파일 형식을 지원합니다. 또한, ` assumeTrustedSource ` 속성을 true로 설정하고 Qt Lottie Animation 모듈에서 플러그인을 포함하면 Lottie 지원을 활성화할 수 있습니다.

속성 설명서

animations group

이미지에 애니메이션이 포함되어 있는 경우, 이러한 속성을 사용하여 애니메이션을 제어할 수 있습니다.

paused 속성을 true로 설정하면 모든 애니메이션을 일시적으로 일시 정지할 수 있습니다. 이 속성을 false 로 재설정하면 애니메이션이 중단된 지점부터 다시 재생됩니다. 기본적으로 이 속성의 값은 false 입니다.

loops 속성은 문서 내 애니메이션이 반복될 횟수를 정의합니다. 기본적으로 이 속성의 값은 1입니다. 원본 이미지에서 무한 반복되도록 설정된 애니메이션은 이 속성의 영향을 받지 않습니다. 문서 내 모든 애니메이션을 무한히 반복하려면 loops 속성을 Animation.Infinite 으로 설정할 수 있습니다.

이 속성들은 Qt 6.10에서 도입되었습니다.

assumeTrustedSource : bool [since 6.10]

신뢰할 수 있는 소스 파일을 불러올 때 이 값을 true로 설정하면, 통제되지 않은 환경에서는 안전하지 않을 수 있는 일부 기능에 대한 지원이 확대됩니다. 특히 SVG의 경우, 이는 ` AssumeTrustedSource option`에 해당합니다.

이 설정이 'true'로 설정되면, ' VectorImage '는 Lottie 형식 플러그인을 사용할 수 있는 경우 이를 통해 이미지를 로드하려고 시도합니다. Qt Lottie Animation 를 참조하십시오.

기본적으로 이 속성의 값은 false 입니다.

이 속성은 Qt 6.10에서 도입되었습니다.

svgtoqml 및 lottietoqml항목도 참조하십시오 .

asynchronous : bool [since 6.12]

이 속성은 이미지가 비동기적으로 로드될지 여부를 결정합니다. ` true`로 설정하면, 이미지가 로드되는 동안에도 UI는 계속 반응적으로 동작합니다. 현재 진행 상황을 확인하려면 ` status ` 속성을 사용할 수 있습니다.

기본적으로 이 속성의 값은 false 입니다.

이 속성은 Qt 6.12에서 도입되었습니다.

asynchronousShapes 및 status도 참조하십시오 .

asynchronousShapes : bool [since 6.11]

이 속성은 VectorImage 가 이미지를 표현하기 위해 생성하는 Quick 장면 내의 Shape 항목에 대한 {QtQuick.Shapes::Shape::asynchronous}{asynchronous} 속성을 제어합니다.

이 속성을 true 로 설정하면 도형 렌더링 처리 중 CPU 관련 작업을 별도의 작업자 스레드로 오프로드합니다. 이를 통해 CPU 사용률과 사용자 인터페이스의 응답성을 향상시킬 수 있습니다.

기본적으로 이 속성의 값은 false 입니다.

이 속성은 Qt 6.11에서 도입되었습니다.

asynchronous도 참조하십시오 .

fillMode : enumeration

이 속성은 ` VectorImage `의 너비와 높이가 내용의 암시적 크기와 다를 경우 어떻게 처리될지를 정의합니다.

generatedItem : Item [read-only, since 6.12]

벡터 이미지 파일이 로드되면, 이 속성은 생성된 ` Qt Quick ` 장면의 최상위 `Item`을 가리킵니다. 파일이 로드되지 않은 경우, 이 속성의 값은 ` null`입니다.

이 속성은 Qt 6.12에서 도입되었습니다.

preferredRendererType : enumeration

VectorImage 에서 도형을 렌더링하는 데 사용할 특정 백엔드를 요청합니다.

기본값은 ` VectorImage.GeometryRenderer`입니다.

retainWhileLoading : bool [since 6.12]

이 속성은 ` source ` 속성이 변경되고 로딩이 비동기적으로 수행될 때의 동작을 정의합니다. 이는 ` asynchronous ` 속성이 ` true`로 설정된 경우에 해당합니다.

retainWhileLoading 가 false (기본값)인 경우, 기존 이미지는 즉시 제거되며 새 이미지가 로드되는 동안 컴포넌트가 비워집니다. true 로 설정된 경우, 기존 이미지는 유지되며 새 이미지가 준비될 때까지 계속 표시됩니다.

이 속성을 활성화하면 새 이미지를 로드하는 데 오랜 시간이 걸리는 경우 깜빡임을 방지할 수 있습니다. 단, 새 이미지를 로드하는 동안 메모리 사용량이 다소 증가한다는 단점이 있습니다.

이 속성은 Qt 6.12에서 도입되었습니다.

asynchronous도 참조하십시오 .

source : url

이 속성은 로드할 벡터 이미지 파일의 URL을 저장합니다.

VectorImage 현재는 SVG 파일 형식을 지원합니다. 또한, assumeTrustedSource 속성을 true로 설정하고 Qt Lottie Animation 모듈에서 플러그인을 포함시킴으로써 Lottie 지원을 활성화할 수 있습니다.

status : enumeration [since 6.12]

이 속성은 벡터 이미지 로딩 상태를 나타냅니다. 다음 중 하나일 수 있습니다:

이 속성은 Qt 6.12에서 도입되었습니다.