This is the documentation of version 0.61.0. Go to the latest version, 1.0.0-rc.5.

Variable deriveMapColorsFromImage`Const`

deriveMapColorsFromImage: (
source: MapThemeImageSource,
options?: MapThemeExtractionOptions,
) => Promise<Required<MapColors>>

Derives the map colours from an image — a photo, a logo, a poster — by extracting its dominant colours and assigning them roles with deriveMapColors.

Type Declaration

- (
  source: MapThemeImageSource,
  options?: MapThemeExtractionOptions,
  ): Promise<Required<MapColors>>
- Parameters
  - source: MapThemeImageSource
  - Optionaloptions: MapThemeExtractionOptions
  Returns Promise<Required<MapColors>>

Throws

RangeError when the image has no opaque pixels, or an error when it cannot be read (not CORS-readable, no DOM to decode it).

Example

// A File from an <input type="file">, a Blob, an <img>, an ImageBitmap or a CORS-readable URL
styling.setMapColors(await deriveMapColorsFromImage(fileInput.files[0], { mode: 'dark' }));