Back to Qt.io
Contact Us Blog Download Qt

VectorImage QML Type

벡터 이미지 파일을 로드하여 Qt Quick 장면에 표시합니다. 더 보기...

Import Statement: import QtQuick.VectorImage
Since: Qt 6.8
Inherits:

Item

속성

자세한 설명

벡터이미지는 벡터 이미지 파일을 로드하고 이를 Qt Quick 장면의 항목으로 표시하는 데 사용할 수 있습니다.

현재 SVG 파일 형식을 지원합니다. 또한 assumeTrustedSource 속성을 true로 설정하고 플러그인을 모듈의 Qt Lottie Animation 모듈에서 플러그인을 포함하면 됩니다. 이 플러그인은 현재 기술 미리보기로 간주됩니다.

참고: Image 요소를 통해 벡터 이미지 파일을 로드하는 방식을 보완합니다. Image 은 요청된 크기로 이미지의 래스터 버전을 생성합니다. VectorImage는 이미지를 나타내는 Qt Quick 장면을 만듭니다. 즉, 결과 항목은 품질 저하 없이 크기를 조정하고 회전할 수 있으며 일반적으로 래스터화된 버전보다 메모리를 덜 사용합니다.

속성 문서

animations group

animations.loops : int [since 6.10]

animations.paused : bool [since 6.10]

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

paused 속성을 true로 설정하면 모든 애니메이션을 일시적으로 일시 중지할 수 있습니다. 이 속성을 false 으로 재설정하면 애니메이션이 원래 위치에서 다시 시작됩니다. 기본적으로 이 속성은 false 입니다.

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

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


assumeTrustedSource : bool [since 6.10]

신뢰할 수 있는 소스 파일을 로드할 때 이 속성을 true로 설정하면 제어되지 않은 설정에서 안전하지 않을 수 있는 일부 기능에 대한 지원이 확장됩니다. 특히 SVG의 경우 AssumeTrustedSource option 에 매핑됩니다.

이 옵션을 true로 설정하면 VectorImage 에서도 로티 형식 플러그인을 사용할 수 있는 경우 이를 사용하여 이미지를 로드하려고 시도합니다. 이 플러그인은 현재 기술 미리보기로 간주됩니다. 자세한 내용은 Qt Lottie Animation 를 참조하세요.

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

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

svgtoqml 및lottietoqml도 참조하세요 .


fillMode : enumeration

이 속성은 VectorImage 의 너비와 높이가 콘텐츠의 암시적 크기와 다를 경우 발생하는 상황을 정의합니다.

Constant설명
VectorImage.NoResize콘텐츠는 여전히 입력에 제공된 크기로 렌더링됩니다.
VectorImage.StretchVectorImage 의 너비와 높이에 맞게 콘텐츠의 크기가 조정됩니다(기본값).
VectorImage.PreserveAspectFit콘텐츠는 가로 세로 비율을 유지하면서 VectorImage 의 경계 안에 맞도록 크기가 조정됩니다. 콘텐츠의 실제 경계 직사각형이 VectorImage 항목보다 작을 수 있습니다.
VectorImage.PreserveAspectCrop가로 세로 비율을 유지하면서 VectorImage 항목을 채우도록 콘텐츠의 크기가 조정됩니다. 콘텐츠의 실제 바운드가 VectorImage 항목보다 큰 경우가 있습니다.

preferredRendererType : enumeration

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

Constant설명
VectorImage.GeometryRendererShape.GeometryRenderer와 동일합니다. 이 백엔드는 커브를 평평하게 하고 결과를 삼각형으로 만듭니다. 다중 샘플링이 활성화되어 있지 않으면 에일리어싱된 결과를 제공하며, 항목의 크기가 조정되면 커브 평탄화가 표시될 수 있습니다.
VectorImage.CurveRendererShape.CurveRenderer와 동일합니다. 이 백엔드를 사용하면 커브가 GPU에서 렌더링되고 앤티 앨리어싱이 내장됩니다. 일반적으로 더 나은 시각적 결과를 제공하지만 성능에 약간의 추가 비용이 발생합니다.

기본값은 VectorImage.GeometryRenderer 입니다.


source : url

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

VectorImage 현재 SVG 파일 형식을 지원합니다. 또한 assumeTrustedSource 속성을 true로 설정하고 플러그인의 Qt Lottie Animation 모듈에서 플러그인을 포함하면 됩니다. 이 플러그인은 현재 기술 미리보기로 간주됩니다.


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