Class TiledImageSource

An image source powered by OpenLayers to load tiled images. Supports all subclasses of the OpenLayers TileSource.

If the tiles of the source are in a format that is not supported directly by the browser, i.e not JPG/PNG/WebP, then you must pass a decoder with the format constructor option.

To filter out no-data pixels, you may pass the noDataValue option in the constructor.

Example

// To create a source based on the Stamen OpenLayers source, with the 'toner' style.
const source = new TiledImageSource({
     source: new Stamen({ layer: 'toner' })
});

// To create a WMS source that downloads TIFF images, eliminating all pixels that have the
// value -9999 and replacing them with transparent pixels.
const source = new TiledImageSource({
     source: new TileWMS({
         url: 'http://example.com/wms',
         params: {
             LAYERS: 'theLayer',
             FORMAT: 'image/tiff',
         },
         projection: 'EPSG:3946',
         crossOrigin: 'anonymous',
         version: '1.3.0',
     }),
     format: new GeoTIFFFormat(),
     noDataValue: -9999,
});

Hierarchy (view full)

Constructors

constructor

Properties

containsFn datatype flipY format isImageSource isTiledImageSource noDataValue olprojection source type version

Accessors

colorSpace

Methods

adjustExtentAndPixelSize contains dispose getCrs getExtent getImages getMemoryUsage initialize intersects update

Constructors

constructor

Properties

Readonly containsFn

containsFn: CustomContainsFn

datatype

datatype: TextureDataType

Gets the datatype of images generated by this source.

Readonly flipY

flipY: boolean

Gets whether images generated from this source should be flipped vertically.

Readonly format

format: ImageFormat

Readonly isImageSource

isImageSource: boolean = true

Readonly isTiledImageSource

isTiledImageSource: boolean = true

Readonly noDataValue

noDataValue: number

Readonly olprojection

olprojection: Projection

Readonly source

source: UrlTile

type

type: string

version

version: number

Accessors

colorSpace

  • get colorSpace(): ColorSpace

  • Gets the color space of the textures generated by this source.

    Returns ColorSpace

Methods

adjustExtentAndPixelSize

  • adjustExtentAndPixelSize(requestExtent, requestWidth, requestHeight, margin?): {
        extent: Extent;
        height: number;
        width: number;
    }

  • Returns an adjusted extent, width and height so that request pixels are aligned with source pixels, and requests do not oversample the source.

    Parameters

    • requestExtent: Extent

      The request extent.

    • requestWidth: number

      The width, in pixels, of the request extent.

    • requestHeight: number

      The height, in pixels, of the request extent.

    • margin: number = 0

      The margin, in pixels, around the initial extent.

    Returns {
        extent: Extent;
        height: number;
        width: number;
    }

    The adjusted parameters.

    • extent: Extent
    • height: number
    • width: number

contains

  • contains(extent): boolean

  • Gets whether this source contains the specified extent. If a custom contains function is provided, it will be used. Otherwise, intersects is used.

    This method is mainly used to discard non-relevant requests (i.e don't process regions that are not relevant to this source).

    Parameters

    • extent: Extent

      The extent to test.

    Returns boolean

dispose

getCrs

getExtent

getImages

getMemoryUsage

initialize

  • initialize(options): Promise<void>

  • Initializes the source.

    Parameters

    • options: {
          targetProjection: string;
      }

      Options.

      • targetProjection: string

        The target projection. Only useful for sources that are able to reproject their data on the fly (typically vector sources).

    Returns Promise<void>

    A promise that resolves when the source is initialized.

intersects

  • intersects(extent): boolean

  • Test the intersection between the specified extent and this source's extent. This method may be overriden to perform special logic.

    Parameters

    • extent: Extent

      The extent to test.

    Returns boolean

    true if the extent and this source extent intersects, false otherwise.

update

Settings

Member Visibility

On This Page

constructorcontainsFndatatypeflipYformatisImageSourceisTiledImageSourcenoDataValueolprojectionsourcetypeversioncolorSpaceadjustExtentAndPixelSizecontainsdisposegetCrsgetExtentgetImagesgetMemoryUsageinitializeintersectsupdate