OptionallayerThe layer that shows the image: each loaded image becomes its source (the
previous source is disposed). Without it, use onLoad to show the source.
OptionalsourceOptions for the new EnhancedGeoTIFF. By default the pipeline of the
layer's previous source is kept, and tiles are left as read when the layer
is a GpuCorrectedTileLayer with WebGL2 (the layer corrects them),
else corrected in workers. Images deeper than 8 bits (16-bit, float) are
read raw (normalize: 'auto') and stretched band by band from their own
values, cutting 2 % at each end like QGIS's default
(rawStretch: { lowPercent: 2, highPercent: 2 }). YCbCr (JPEG-compressed
imagery), CMYK and CIELab images are converted to RGB (convertToRGB: 'auto').
OptionalfitZoom the map to the loaded image (default true).
OptionalurlShow the button for a COG URL (default true).
OptionaldropAccept files dropped on the map (default true).
OptionalacceptThe file chooser's accept. Default: TIFF files and images.
OptionalplacementWhere an ordinary picture (one without georeferencing) goes. Default: centered on the view, 80 % of its size, keeping the picture's shape.
OptionallabelsTexts; missing keys come from loadImageLabelsEn. loadImageLabelsJa has Japanese.
OptionalcssAdd the default styles to the document (default true).
OptionalclassExtra class names for the control element.
OptionaltargetPut the control in this element instead of the map's overlay container.
OptionalonTakes the files chosen or dropped instead of the control: the chooser
then accepts several files at once, and the handler decides what to open
(for example call loadFile for each image and read other files itself).
OptionalonCalled instead of the file chooser when the open button is pressed, for
choosing files another way (for example showOpenFilePicker, to keep the
file handles). Call LoadImageControl.openChooser to fall back to
the chooser, and loadFile or your onFiles with the files chosen.
OptionalonTakes a URL entered in the URL form first, for URLs that are not COGs (an image service, say): return (or resolve with) true when it was opened another way, false to load it as a COG. A rejection keeps the form open.
OptionalonCalled after an image is loaded (also fired as a load event).
OptionalonCalled when an image cannot be loaded (also fired as an error event).
Options for LoadImageControl.