Asynchronously loads the given image URL. Returns a promise that will resolve to
an
Image
once loaded, or reject if the image failed to load.Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
url |
String | Promise.<String> | The source of the image, or a promise for the URL. | ||
allowCrossOrigin |
Boolean |
<optional> |
true | Whether to request the image using Cross-Origin Resource Sharing (CORS). CORS is only actually used if the image URL is actually cross-origin. Data URIs are never requested using CORS. |
Returns:
a promise that will resolve to the requested data when loaded.
- Type
- Promise.<Image>
Example
// load a single image asynchronously
Cesium.loadImage('some/image/url.png').then(function(image) {
// use the loaded image
}).otherwise(function(error) {
// an error occurred
});
// load several images in parallel
when.all([loadImage('image1.png'), loadImage('image2.png')]).then(function(images) {
// images is an array containing all the loaded images
});