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)
• asynchronousShapes : bool (since 6.11)
• fillMode : enumeration
• preferredRendererType : enumeration
• source : url

详细说明

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 时，如果 Lottie 格式插件可用，VectorImage 还将尝试使用该插件加载图片。更多信息请参见 Qt Lottie Animation了解更多信息。

默认情况下，该属性为false 。

此属性在 Qt 6.10 中引入。

另请参阅 svgtoqml和lottietoqml。

asynchronousShapes : bool [since 6.11]

此属性控制VectorImage 为表示图像而构建的 Quick 场景中Shape 项的 {QtQuick.Shapes::Shape::asynchronous}{asynchronous} 属性。

将此属性设置为true 将把形状渲染处理的 CPU 部分卸载到独立的工作线程中。这可以提高 CPU 利用率和用户界面响应速度。

默认情况下，此属性为false 。

此属性在 Qt 6.11 中引入。

fillMode : enumeration

该属性定义了如果VectorImage 的宽度和高度与内容的隐含大小不同时会发生的情况。

preferredRendererType : enumeration

请求使用特定的后端来渲染VectorImage 中的图形。

默认值为VectorImage.GeometryRenderer 。

source : url

该属性包含要加载的矢量图像文件的 URL。

VectorImage 目前支持SVG 文件格式。此外，将assumeTrustedSource 属性设置为 true 并将插件从 Qt Lottie Animation模块中包含该插件。