Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 | 65x 64x 63x 363x 6x 57x 57x 57x 50x | 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 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.
* @param {boolean} [skipColorSpaceConversion=false] If true, any custom gamma or color profiles in the images will be ignored.
* @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
* }).catch(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, skipColorSpaceConversion) {
//>>includeStart('debug', pragmas.debug);
Check.defined("context", context);
Check.defined("urls", urls);
if (
Object.values(CubeMap.FaceName).some((faceName) => !defined(urls[faceName]))
) {
throw new DeveloperError(
"urls 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.
const flipOptions = {
flipY: true,
skipColorSpaceConversion: skipColorSpaceConversion,
preferImageBitmap: true,
};
const 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 Promise.all(facePromises).then(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;
|