| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163 |
- import buildModuleUrl from "../Core/buildModuleUrl.js";
- import CubeMapPanorama from "./CubeMapPanorama.js";
- import SceneMode from "./SceneMode.js";
- import destroyObject from "../Core/destroyObject.js";
-
- /**
- * A sky box around the scene to draw stars. The sky box is defined using the True Equator Mean Equinox (TEME) axes.
- * <p>
- * This is only supported in 3D. The sky box is faded out when morphing to 2D or Columbus view. The size of
- * the sky box must not exceed {@link Scene#maximumCubeMapSize}.
- * </p>
- *
- * @alias SkyBox
- * @constructor
- *
- * @param {object} options Object with the following properties:
- * @param {object} [options.sources] The source URL or <code>Image</code> object for each of the six cube map faces. See the example below.
- * @param {boolean} [options.show=true] Determines if this primitive will be shown.
- *
- *
- * @example
- * scene.skyBox = new Cesium.SkyBox({
- * sources : {
- * positiveX : 'skybox_px.png',
- * negativeX : 'skybox_nx.png',
- * positiveY : 'skybox_py.png',
- * negativeY : 'skybox_ny.png',
- * positiveZ : 'skybox_pz.png',
- * negativeZ : 'skybox_nz.png'
- * }
- * });
- *
- * @see Scene#skyBox
- * @see Transforms.computeTemeToPseudoFixedMatrix
- */
- function SkyBox(options) {
- this._sources = options.sources;
- this._show = options.show ?? true;
- this._panorama = new CubeMapPanorama({
- sources: this._sources,
- show: this._show,
- returnCommand: true,
- });
- }
-
- Object.defineProperties(SkyBox.prototype, {
- /**
- * Gets or sets the the primitive object.
- * @memberof SkyBox.prototype
- * @type {object}
- */
- sources: {
- get: function () {
- return this._panorama.sources;
- },
- set: function (value) {
- this._panorama.sources = value;
- },
- },
-
- /**
- * Determines if the sky box will be shown.
- * @memberof SkyBox.prototype
- * @type {boolean}
- * @default true
- */
-
- show: {
- get: function () {
- return this._panorama.show;
- },
- set: function (value) {
- this._panorama.show = value;
- },
- },
- });
-
- /**
- * Called when {@link Viewer} or {@link CesiumWidget} render the scene to
- * get the draw commands needed to render this primitive.
- * <p>
- * Do not call this function directly. This is documented just to
- * list the exceptions that may be propagated when the scene is rendered:
- * </p>
- *
- * @exception {DeveloperError} this.sources is required and must have positiveX, negativeX, positiveY, negativeY, positiveZ, and negativeZ properties.
- * @exception {DeveloperError} this.sources properties must all be the same type.
- */
- SkyBox.prototype.update = function (frameState, useHdr) {
- const { mode, passes } = frameState;
-
- if (mode !== SceneMode.SCENE3D && mode !== SceneMode.MORPHING) {
- return;
- }
-
- if (!passes.render) {
- return;
- }
-
- // Delegate completely
- return this._panorama.update(frameState, useHdr);
- };
-
- /**
- * Returns true if this object was destroyed; otherwise, false.
- * <br /><br />
- * If this object was destroyed, it should not be used; calling any function other than
- * <code>isDestroyed</code> will result in a {@link DeveloperError} exception.
- *
- * @returns {boolean} <code>true</code> if this object was destroyed; otherwise, <code>false</code>.
- *
- * @see SkyBox#destroy
- */
- SkyBox.prototype.isDestroyed = function () {
- return false;
- };
-
- /**
- * Destroys the WebGL resources held by this object. Destroying an object allows for deterministic
- * release of WebGL resources, instead of relying on the garbage collector to destroy this object.
- * <br /><br />
- * Once an object is destroyed, it should not be used; calling any function other than
- * <code>isDestroyed</code> will result in a {@link DeveloperError} exception. Therefore,
- * assign the return value (<code>undefined</code>) to the object as done in the example.
- *
- * @exception {DeveloperError} This object was destroyed, i.e., destroy() was called.
- *
- *
- * @example
- * skyBox = skyBox && skyBox.destroy();
- *
- * @see SkyBox#isDestroyed
- */
- SkyBox.prototype.destroy = function () {
- this._panorama = this._panorama && this._panorama.destroy();
- return destroyObject(this);
- };
-
- function getDefaultSkyBoxUrl(suffix) {
- return buildModuleUrl(`Assets/Textures/SkyBox/tycho2t3_80_${suffix}.jpg`);
- }
-
- /**
- * Creates a skybox instance with the default starmap for the Earth.
- * @return {SkyBox} The default skybox for the Earth
- *
- * @example
- * viewer.scene.skyBox = Cesium.SkyBox.createEarthSkyBox();
- */
- SkyBox.createEarthSkyBox = function () {
- return new SkyBox({
- sources: {
- positiveX: getDefaultSkyBoxUrl("px"),
- negativeX: getDefaultSkyBoxUrl("mx"),
- positiveY: getDefaultSkyBoxUrl("py"),
- negativeY: getDefaultSkyBoxUrl("my"),
- positiveZ: getDefaultSkyBoxUrl("pz"),
- negativeZ: getDefaultSkyBoxUrl("mz"),
- },
- });
- };
-
- export default SkyBox;
|