image

Returns a /mapbox-gl-js/style-spec/types/#resolvedimage for use in /mapbox-gl-js/style-spec/layers/#layout-symbol-icon-image, *-pattern entries, and as a section in the #types-format expression. A #coalesce expression containing image expressions will evaluate to the first listed image that is currently in the style. This validation process is synchronous and requires the image to have been added to the style before requesting it in the 'image' argument. To implement crossfading between two images within a symbol layer using the /mapbox-gl-js/style-spec/layers/#paint-symbol-icon-image-cross-fade attribute, include a second image as the second argument in the 'image' expression.