Back to Doc.qt.io
Contact Us Blog Download Qt

C

SafeImage QML Type

Provides a QML Image type which can be rendered in the Qt Safe Renderer runtime. More...

Import Statement: import Qt.SafeRenderer

Properties

Detailed Description

On build time, SafeImage objects are prerendered to Safe Renderer image format.

SafeImage supports the same image formats as QImage. For more information, see Reading and Writing Image Files.

The following code provides an example how to use the SafeImage type:

SafeImage {
    id: safeImage1
    objectName: "safeImage1"
    source: "indicator1.png"
    fillColor: "black"  // optionally partially transparent image can be blended over a solid background
    width: 64
    height: 64
    x: 321
    y: 123
}

Property Documentation

fillColor : color

This property holds the background fill color of the item. It only has meaning if the image is not fully opaque, otherwise it has no other effect. The default value is "transparent".

Note: If you are using output verification feature, you should not use the default value "transparent". Instead, define an opaque background color. For more information, see Qt Safe Renderer Output Verification.


height : real

This property holds the image's height. The default value is 64.


objectName : string

This property holds the QObject::objectName for this specific object instance.


opacity : real

This property holds the opacity of the item. Opacity is specified as a number between 0.0 (fully transparent) and 1.0 (fully opaque). The default value is 1.0. For more information, see Opacity Property.


source : url

This property holds the resource locator of the image. Image can handle any image format supported by Qt, loaded from any URL scheme supported by Qt.

The URL may be absolute or relative to the URL of the component.


width : real

This property holds the image's width. The default value is 64.


x : real

This property holds the x-coordinate in the image's position.


y : real

This property holds the y-coordinate in the image's position.


Available under certain Qt licenses.
Find out more.