Skip To Content ArcGIS for Developers Sign In Dashboard

PictureFillSymbolLayer QML Type

A picture fill symbol layer is a symbol layer intended for use with polygon geometries. More...

Import Statement: import Esri.ArcGISRuntime 100.8
Since: Esri.ArcGISRuntime 100.5





Detailed Description

This symbol layer, if it is the sole symbol layer in a MultilayerPolygonSymbol, fills the geometry associated with the symbol with the specified image. The image, should it not fill the geometry, will be tiled throughout the fill.

The PictureFillSymbolLayer is also used to represent the Web Scene specification's Icon3DSymbolLayers. IconSymbol3DLayers from Web Scene JSON - as long as those Icon3DSymbolLayers contain pictures - rather than primitives or vector paths, those symbol layers are represented as PictureFillSymbolLayer. If those Icon3DSymbolLayers are primitives or vector paths, they are represented as VectorMarkerSymbolLayer.

The PictureFillSymbolLayer provides a similar user experience to the simple PictureFillSymbol, but can be used in a MultilayerSymbol.

This QML type supports the following default properties. A default property may be declared inside another declared object without being assigned explicitly to a property.


Create a PictureFillSymbolLayer and set its URL to an online PNG:

PictureFillSymbolLayer {
    id: pictureFillSymbolLayer
    url: ""

See also Loadable and RemoteResource.

Property Documentation

[default] credential : Credential

The credential to be used to access a secured image URL if provided.

A credential can only be provided before the picture fill symbol is loaded.

error : Error

Returns the error object (read-only).

See also Loadable and Error.

image : url

Returns the picture fill symbol image once loaded (read-only).

If a URL was provided for the picture fill symbol, an attempt to load the symbol must occur and succeed, and then the image provider source is available via this property. Prior to loading in this case, this will return an empty url.

loadError : Error

Returns the load error (read-only).

Note: load errors are also reported on the error property and emit the errorChanged signal.

See also Loadable.

loadStatus : Enums.LoadStatus

Returns the load status (read-only).

See also Loadable and Enums.LoadStatus.

[default] requestConfiguration : RequestConfiguration

The configuration parameters used for network requests sent by this symbol.

tintColor : color

The tint color of the picture marker symbol layer.

The tint color is applied to the entire image by multiplying each RGB color channel in the image by the corresponding color channel of the tint color. The default color is white with 100% opacity (RGBA (255,255,255,255)), which when applied leaves the image with its native colors and unchanged opacity. A white tint color with opacity less than 100% applies the reduced opacity without changing the image colors.

This QML property was introduced in Esri.ArcGISRuntime 100.6.

url : url

The URL path to the picture fill symbol image.

This could be a local file path, Qt resource path, or HTTP path to the image. The URL can only be provided before the picture fill symbol is loaded.

Signal Documentation


Emitted when the credential property changes.


Emitted when the image property changes.


Emitted when the loadError property of this PictureFillSymbolLayer changes.

Note: load errors are also reported on the error property and emit the errorChanged signal.

See also Loadable and Object.


Emitted when the loadStatus property of this PictureFillSymbolLayer changes.

See also Loadable.


Emitted when the requestConfiguration property changes.


Emitted when the tintColor property changes.

This QML signal was introduced in Esri.ArcGISRuntime 100.6.


Emitted when the url property changes.

Method Documentation

void cancelLoad()

See also Loadable.

void load()

See also Loadable.

void retryLoad()

See also Loadable.

Feedback on this topic?