Static Image

This example uses OpenLayers v4.0.1. The latest is v.

#### Static Image

Example of a static image layer.

This example uses a static image as a layer source. The map view is configured with a custom projection that translates image coordinates directly into map coordinates.

Related API documentation:

- ol.Map
,
- ol.View
,
- ol.extent
,
- ol.layer.Image
,
- ol.proj.Projection
,
- ol.source.ImageStatic

Copy Edit
Static Image Example of a static image layer. // Map views always need a projection. Here we just want to map image // coordinates directly to map coordinates, so we create a projection that uses // the image extent in pixels. var extent = [0, 0, 1024, 968]; var projection = new ol.proj.Projection({ code: 'xkcd-image', units: 'pixels', extent: extent }); var map = new ol.Map({ layers: [ new ol.layer.Image({ source: new ol.source.ImageStatic({ attributions: '© <a href="http://xkcd.com/license.html">xkcd</a>', url: 'https://imgs.xkcd.com/comics/online_communities.png', projection: projection, imageExtent: extent }) }) ], target: 'map', view: new ol.View({ projection: projection, center: ol.extent.getCenter(extent), zoom: 2, maxZoom: 8 }) }); <div id="map" class="map"></div>

    <!DOCTYPE html>
    <html>
      <head>
        <title>Static Image</title>
        <link rel="stylesheet" href="https://openlayers.org/en/v4.0.1/css/ol.css" type="text/css">
        <!-- The line below is only needed for old environments like Internet Explorer and Android 4.x -->
        <script src="https://cdn.polyfill.io/v2/polyfill.min.js?features=requestAnimationFrame,Element.prototype.classList,URL"></script>
        <script src="https://openlayers.org/en/v4.0.1/build/ol.js"></script>
      </head>
      <body>
        <div id="map" class="map"></div>
        <script>
          // Map views always need a projection.  Here we just want to map image
          // coordinates directly to map coordinates, so we create a projection that uses
          // the image extent in pixels.
          var extent = [0, 0, 1024, 968];
          var projection = new ol.proj.Projection({
            code: 'xkcd-image',
            units: 'pixels',
            extent: extent
          });

          var map = new ol.Map({
            layers: [
              new ol.layer.Image({
                source: new ol.source.ImageStatic({
                  attributions: '© <a href="http://xkcd.com/license.html">xkcd</a>',
                  url: 'https://imgs.xkcd.com/comics/online_communities.png',
                  projection: projection,
                  imageExtent: extent
                })
              })
            ],
            target: 'map',
            view: new ol.View({
              projection: projection,
              center: ol.extent.getCenter(extent),
              zoom: 2,
              maxZoom: 8
            })
          });
        </script>
      </body>
    </html>