-
Name Type Description attributions
AttributionLike | undefined Attributions.
crossOrigin
null | string | undefined The
crossOrigin
attribute for loaded images. Note that you must provide acrossOrigin
value if you want to access pixel data with the Canvas renderer. See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.imageExtent
Extent Extent of the image in map coordinates. This is the [left, bottom, right, top] map coordinates of your image.
imageLoadFunction
LoadFunction | undefined Optional function to load an image given a URL.
interpolate
boolean (defaults to true) Use interpolated values when resampling. By default, linear interpolation is used when resampling. Set to false to use the nearest neighbor instead.
projection
ProjectionLike | undefined Projection. Default is the view projection.
url
string Image URL.
Fires:
-
change
(BaseEvent) - Generic change event. Triggered when the revision counter is increased. -
error
(BaseEvent) - Generic error event. Triggered when an error occurs. -
imageloadend
(ImageSourceEvent) - Triggered when an image finishes loading. -
imageloaderror
(ImageSourceEvent) - Triggered if image loading results in an error. -
imageloadstart
(ImageSourceEvent) - Triggered when an image starts loading. -
propertychange
(ObjectEvent) - Triggered when a property is changed.
-
Extends
Methods
-
Increases the revision counter and dispatches a 'change' event.
-
Dispatches an event and calls all listeners listening for events of this type. The event parameter can either be a string or an Object with a
type
property.Name Type Description event
BaseEvent | string Event object.
Returns:
false
if anyone called preventDefault on the event object or if any of the listeners returned false.
-
Gets a value.
Name Type Description key
string Key name.
Returns:
Value.
-
Get the attribution function for the source.
Returns:
Attribution function.
-
Returns:
Attributions are collapsible.
-
Returns the image extent
Returns:
image extent.
-
Get a list of object property names.
Returns:
List of property names.
-
Get the projection of the source.
Returns:
Projection.
-
Get an object of all property names and values.
Returns:
Object.
-
Get the version number for this object. Each time the object is modified, its version number will be incremented.
Returns:
Revision.
-
Get the state of the source, see
State
for possible states.Returns:
State.
-
Return the URL used for this image source.
Returns:
URL.
-
Listen for a certain type of event.
Name Type Description type
string | Array.<string> The event type or array of event types.
listener
function The listener function.
Returns:
Unique key for the listener. If called with an array of event types as the first argument, the return will be an array of keys.
-
Listen once for a certain type of event.
Name Type Description type
string | Array.<string> The event type or array of event types.
listener
function The listener function.
Returns:
Unique key for the listener. If called with an array of event types as the first argument, the return will be an array of keys.
-
Refreshes the source. The source will be cleared, and data from the server will be reloaded.
-
Sets a value.
Name Type Description key
string Key name.
value
* Value.
silent
boolean | undefined Update without triggering an event.
-
Set the attributions of the source.
Name Type Description attributions
AttributionLike | undefined Attributions. Can be passed as
string
,Array<string>
,Attribution
, orundefined
. -
Sets a collection of key-value pairs. Note that this changes any existing properties and adds new ones (it does not remove any existing properties).
Name Type Description values
Object.<string, *> Values.
silent
boolean | undefined Update without triggering an event.
-
Unlisten for a certain type of event.
Name Type Description type
string | Array.<string> The event type or array of event types.
listener
function The listener function.
-
Unsets a property.
Name Type Description key
string Key name.
silent
boolean | undefined Unset without triggering an event.