VectorImage QML Type

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

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

Item

속성

자세한 설명

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

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

속성 문서

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 파일 형식만 지원합니다.


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