The Effect.MaskImage effect is a pixel effect that masks its parent Item (and children) against the alpha channel of an image.

The following example shows a dinosaur mask being applied to a video.

Video {
    with Effect.MaskImage {
        source: "dinosaur.png"

property Bool enabled: true

When the effect is disabled, the mask is not applied.

property Url source

The path or URL of the image to use for the alpha mask.

property Int imageWidthread only

property Int imageHeightread only

The size of the source image.

property Effect.MaskImage.Status statusread only


No source url has been specified.


The element is loading the image.


The element has successfully loaded the image.


The element has failed to load the image.