You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
93 lines
3.1 KiB
JavaScript
93 lines
3.1 KiB
JavaScript
import Check from "../Core/Check.js";
|
|
import defined from "../Core/defined.js";
|
|
import DeveloperError from "../Core/DeveloperError.js";
|
|
import Resource from "../Core/Resource.js";
|
|
import when from "../ThirdParty/when.js";
|
|
import CubeMap from "./CubeMap.js";
|
|
|
|
/**
|
|
* Asynchronously loads six images and creates a cube map. Returns a promise that
|
|
* will resolve to a {@link CubeMap} once loaded, or reject if any image fails to load.
|
|
*
|
|
* @function loadCubeMap
|
|
*
|
|
* @param {Context} context The context to use to create the cube map.
|
|
* @param {Object} urls The source URL of each image. See the example below.
|
|
* @returns {Promise.<CubeMap>} a promise that will resolve to the requested {@link CubeMap} when loaded.
|
|
*
|
|
* @exception {DeveloperError} context is required.
|
|
* @exception {DeveloperError} urls is required and must have positiveX, negativeX, positiveY, negativeY, positiveZ, and negativeZ properties.
|
|
*
|
|
*
|
|
* @example
|
|
* Cesium.loadCubeMap(context, {
|
|
* positiveX : 'skybox_px.png',
|
|
* negativeX : 'skybox_nx.png',
|
|
* positiveY : 'skybox_py.png',
|
|
* negativeY : 'skybox_ny.png',
|
|
* positiveZ : 'skybox_pz.png',
|
|
* negativeZ : 'skybox_nz.png'
|
|
* }).then(function(cubeMap) {
|
|
* // use the cubemap
|
|
* }).otherwise(function(error) {
|
|
* // an error occurred
|
|
* });
|
|
*
|
|
* @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
|
|
* @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
|
|
*
|
|
* @private
|
|
*/
|
|
function loadCubeMap(context, urls) {
|
|
//>>includeStart('debug', pragmas.debug);
|
|
Check.defined("context", context);
|
|
if (
|
|
!defined(urls) ||
|
|
!defined(urls.positiveX) ||
|
|
!defined(urls.negativeX) ||
|
|
!defined(urls.positiveY) ||
|
|
!defined(urls.negativeY) ||
|
|
!defined(urls.positiveZ) ||
|
|
!defined(urls.negativeZ)
|
|
) {
|
|
throw new DeveloperError(
|
|
"urls is required and must have positiveX, negativeX, positiveY, negativeY, positiveZ, and negativeZ properties."
|
|
);
|
|
}
|
|
//>>includeEnd('debug');
|
|
|
|
// PERFORMANCE_IDEA: Given the size of some cube maps, we should consider tiling them, which
|
|
// would prevent hiccups when uploading, for example, six 4096x4096 textures to the GPU.
|
|
//
|
|
// Also, it is perhaps acceptable to use the context here in the callbacks, but
|
|
// ideally, we would do it in the primitive's update function.
|
|
var flipOptions = {
|
|
flipY: true,
|
|
preferImageBitmap: true,
|
|
};
|
|
|
|
var facePromises = [
|
|
Resource.createIfNeeded(urls.positiveX).fetchImage(flipOptions),
|
|
Resource.createIfNeeded(urls.negativeX).fetchImage(flipOptions),
|
|
Resource.createIfNeeded(urls.positiveY).fetchImage(flipOptions),
|
|
Resource.createIfNeeded(urls.negativeY).fetchImage(flipOptions),
|
|
Resource.createIfNeeded(urls.positiveZ).fetchImage(flipOptions),
|
|
Resource.createIfNeeded(urls.negativeZ).fetchImage(flipOptions),
|
|
];
|
|
|
|
return when.all(facePromises, function (images) {
|
|
return new CubeMap({
|
|
context: context,
|
|
source: {
|
|
positiveX: images[0],
|
|
negativeX: images[1],
|
|
positiveY: images[2],
|
|
negativeY: images[3],
|
|
positiveZ: images[4],
|
|
negativeZ: images[5],
|
|
},
|
|
});
|
|
});
|
|
}
|
|
export default loadCubeMap;
|