异步加载给定的图片 URL。加载完成后,将返回一个解析为
Image
的 promise,如果图片加载失败,则返回拒绝。
Name | Type | Default | Description |
---|---|---|---|
url |
String | 影像的源 URL。 | |
allowCrossOrigin |
Boolean |
true
|
optional 是否使用跨源资源共享(CORS)请求影像。只有当影像 URL 实际上是跨源时,才会实际使用 CORS。数据 URI 从不使用 CORS 请求。 |
request |
Request | optional 请求对象。仅供内部使用。 |
Returns:
加载时将解析请求数据的Promise。如果 request.throttle 为 true 且请求的优先级不够高,则返回未定义。
Example:
// load a single image asynchronously
SuperMap3D.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
});