Merge pull request #13058 from CesiumGS/remove-zip-sandcastle

Remove legacy sandcastle from zip file

.git-blame-ignore-revs

@@ -0,0 +1,6 @@
+# Format all code with prettier
+2fd0e8f7e4212bd1e7084299187f70597a6bbfd8
+# var -> const/let
+8143df4436b79260e9861f63c6ac134d7910a818
+# run prettier v3
+09a719b8fb4616ecbcd7370e81dcdc998b64b6e2

.github/actions/verify-package/script.sh

@@ -15,7 +15,9 @@ cp cesium*.tgz ../test
 cp Specs/test.*js ../test
 cd ../test
 
-npm install cesium*.tgz
+npm install cesium-engine*.tgz
+npm install cesium-widgets*.tgz
+npm install cesium-1.*.tgz
 NODE_ENV=development node test.cjs
 NODE_ENV=production node test.cjs
-node test.mjs
+node test.mjs

.github/workflows/cla.yml

@@ -10,9 +10,9 @@ jobs:
       issues: write
       pull-requests: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: install node 22
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: '22'
       - name: install npm packages

.github/workflows/deploy.yml

@@ -2,7 +2,7 @@ name: deploy
 on:
   push:
     branches-ignore:
-      - 'cesium.com'
+      - "cesium.com"
       - production
 concurrency:
   group: deploy-${{ github.ref }}
@@ -22,12 +22,13 @@ jobs:
       GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       GITHUB_REPO: ${{ github.repository }}
       GITHUB_SHA: ${{ github.sha }}
+      DEPLOYED_URL: https://ci-builds.cesium.com/cesium/${{ github.ref_name }}/
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: install node 22
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: "22"
       - name: npm install
         run: npm install
       - name: set the version in package.json

.github/workflows/dev.yml

@@ -11,9 +11,9 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: install node 22
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: '22'
       - name: npm install
@@ -32,9 +32,9 @@ jobs:
       AWS_REGION: us-east-1
       BRANCH: ${{ github.ref_name }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: install node 22
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: '22'
       - name: npm install
@@ -49,9 +49,9 @@ jobs:
   release-tests:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: install node 22
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: '22'
       - name: npm install
@@ -65,9 +65,9 @@ jobs:
   node-20:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: install node 20
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: '20'
       - name: npm install

.github/workflows/prod.yml

@@ -1,17 +1,17 @@
 name: prod
-on: 
+on:
   push:
-    branches: 
-      - 'cesium.com'
+    branches:
+      - "cesium.com"
 jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: install node 22
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: "22"
       - name: npm install
         run: npm install
       - name: lint *.js
@@ -32,23 +32,30 @@ jobs:
       GITHUB_REPO: ${{ github.repository }}
       GITHUB_SHA: ${{ github.sha }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: install node 22
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: "22"
       - name: npm install
         run: npm install
       - name: build website release
         run: npm run website-release
+      - name: build types
+        run: npm run build-ts
       - name: build apps
         run: npm run build-apps
       - name: deploy to cesium.com
         if: ${{ env.AWS_ACCESS_KEY_ID != '' }}
+        # Download zip from the Github release and unzip to Build/release/
+        # Publish that unzipped code to the bucket for https://cesium.com/downloads/cesiumjs/releases/[version]/... urls
+        # Publish the documentation files to the bucket for https://cesium.com/learn/cesiumjs/ref-doc/
+        # Publish the simple viewer app to the bucket for https://cesium.com/cesiumjs/cesium-viewer/
+        # Publish sandcastle to the bucket for https://sandcastle.cesium.com/
         run: |
           curl -LO $(curl https://api.github.com/repos/CesiumGS/cesium/releases/latest -H "Authorization: ${GITHUB_TOKEN}" | jq -r '.assets[0].browser_download_url')
           unzip Cesium-$(cat package.json | jq -r '.version' | sed 's/\.0$//').zip -d Build/release/ -x "Apps"
           aws s3 sync Build/release/ s3://cesium-website/cesiumjs/releases/$(cat package.json | jq -r '.version' | sed 's/\.0$//')/ --cache-control "public, max-age=1800" --delete
           aws s3 sync Build/Documentation/ s3://cesium-website/cesiumjs/ref-doc/ --cache-control "public, max-age=1800" --delete
           aws s3 sync Build/CesiumViewer/ s3://cesium-website/cesiumjs/cesium-viewer/ --cache-control "public, max-age=1800" --delete
-          aws s3 sync Build/Sandcastle/ s3://cesium-sandcastle-website/ --cache-control "public, max-age=1800" --delete
+          aws s3 sync Build/Sandcastle2/ s3://cesium-sandcastle-website/ --cache-control "public, max-age=1800" --delete

.github/workflows/sandcastle-dev.yml

@@ -0,0 +1,35 @@
+name: sandcastle-dev
+on:
+  push:
+    branches:
+      - "main"
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    env:
+      PROD: true
+      AWS_ACCESS_KEY_ID: ${{ secrets.PROD_AWS_ACCESS_KEY_ID }}
+      AWS_SECRET_ACCESS_KEY: ${{ secrets.PROD_AWS_SECRET_ACCESS_KEY }}
+      AWS_REGION: us-east-1
+      BRANCH: ${{ github.ref_name }}
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      GITHUB_REPO: ${{ github.repository }}
+      GITHUB_SHA: ${{ github.sha }}
+    steps:
+      - uses: actions/checkout@v5
+      - name: install node 22
+        uses: actions/setup-node@v6
+        with:
+          node-version: "22"
+      - name: npm install
+        run: npm install
+      - name: build website release
+        run: npm run website-release
+      - name: build types
+        run: npm run build-ts
+      - name: build prod sandcastle
+        run: npm run build-sandcastle
+      - name: deploy to dev-sandcastle.cesium.com
+        if: ${{ env.AWS_ACCESS_KEY_ID != '' }}
+        run: |
+          aws s3 sync Build/Sandcastle2/ s3://cesium-dev-sandcastle-website/ --cache-control "public, max-age=1800" --delete

.idea/codeStyles/Project.xml

@@ -4,9 +4,6 @@
       <option name="SPACE_BEFORE_PROPERTY_COLON" value="true" />
       <option name="SPACE_BEFORE_FUNCTION_LEFT_PARENTH" value="false" />
     </JSCodeStyleSettings>
-    <XML>
-      <option name="XML_LEGACY_SETTINGS_IMPORTED" value="true" />
-    </XML>
     <codeStyleSettings language="JavaScript">
       <option name="KEEP_BLANK_LINES_IN_CODE" value="1" />
       <option name="ALIGN_MULTILINE_BINARY_OPERATION" value="true" />

.markdownlintignore

@@ -1,4 +1,5 @@
 /node_modules
+packages/sandcastle/node_modules
 /ThirdParty
 /Tools/**
 

.npmignore

@@ -23,6 +23,8 @@
 /scripts/
 /favicon.ico
 /gulpfile.js
+/gulpfile.apps.js
+/gulpfile.makezip.js
 /index.html
 /index.release.html
 /launches

.prettierignore

@@ -18,6 +18,7 @@
 !**/*.html
 !**/*.md
 !**/*.ts
+!**/*.tsx
 
 # Re-ignore a few things caught above
 
@@ -33,6 +34,9 @@ packages/widgets/Build/**
 packages/widgets/index.js
 packages/widgets/Source/ThirdParty/**
 
+packages/sandcastle/node_modules/**
+Apps/Sandcastle2/**
+
 Specs/jasmine/**
 
 Apps/Sandcastle/ThirdParty

.vscode/extensions.json

@@ -6,6 +6,7 @@
         "cesium.gltf-vscode",
         "bierner.github-markdown-preview",
         "DavidAnson.vscode-markdownlint",
-        "streetsidesoftware.code-spell-checker"
+        "streetsidesoftware.code-spell-checker",
+        "eamodio.gitlens"
     ]
 }

.vscode/launch.json

@@ -1,6 +1,7 @@
 {
     "version": "0.2.0",
     "configurations": [
+    
         {
             "type": "node",
             "request": "launch",
@@ -21,6 +22,32 @@
             "type": "chrome",
             "url": "http://localhost:8080",
             "webRoot": "${workspaceFolder}"
+        },
+        {
+            "request": "attach",
+            "name": "Attach to Karma",
+            "type": "chrome",
+            "port": 9333, // This is the remote debugging port specified in karma.conf.cjs
+            "webRoot": "${workspaceFolder}",
+            "timeout": 60000
+        },
+        {
+            "type": "node",
+            "request": "launch",
+            "name": "Launch Test Suite",
+            "cwd": "${workspaceFolder}",
+            "runtimeExecutable": "npm",
+            "runtimeArgs": ["run", "test", "--", "--includeName", "${fileDirnameBasename}${/}${fileBasenameNoExtension}", "--debug"],
+            "console": "integratedTerminal"
+        }
+    ],
+    "compounds": [
+        {
+            "name": "Launch Test Suite and Debug in VSCode",
+            "configurations": [
+                "Launch Test Suite",
+                "Attach to Karma"
+            ]
         }
     ]
 }

.vscode/settings.json

@@ -29,5 +29,9 @@
     "javascript.format.insertSpaceAfterOpeningAndBeforeClosingNonemptyBrackets": false,
     "javascript.format.placeOpenBraceOnNewLineForFunctions": false,
     "javascript.format.placeOpenBraceOnNewLineForControlBlocks": false,
-    "glTF.defaultV2Engine": "Cesium"
+    "glTF.defaultV2Engine": "Cesium",
+    "gitlens.advanced.blame.customArguments": [
+        "--ignore-revs-file",
+        "${workspaceFolder}/.git-blame-ignore-revs"
+    ],
 }

Apps/CesiumViewer/CesiumViewer.js

@@ -1,4 +1,3 @@
-// eslint-disable-next-line no-undef
 window.CESIUM_BASE_URL = window.CESIUM_BASE_URL
   ? window.CESIUM_BASE_URL
   : "../../Build/CesiumUnminified/";

Apps/SampleData/MarsPointsOfInterest.geojson

@@ -0,0 +1,276 @@
+{
+  "type": "FeatureCollection",
+  "features": [
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Acidalia Planitia",
+        "destination": [2482963.8874656125, -1390493.34713116, 2003606.997020314],
+        "orientation": [2.9706346891645325, -0.39288074608352463, 0.00013399155612248137],
+        "description": "Acidalia Planitia is a plain on Mars, between the Tharsis volcanic province and Arabia Terra to the north of Valles Marineris, centered at 49.8°N 339.3°E. Most of this region is found in the Mare Acidalium quadrangle, but a small part is in the Ismenius Lacus quadrangle. The plain contains the famous Cydonia region at the contact with the heavily cratered highland terrain.",
+        "sourceURL": "https://en.wikipedia.org/wiki/Acidalia_Planitia",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/3/36/Acidalia_planitia_topo.jpg"
+        },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [-28.039999999999999, 31.210000000000001]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Alba Mons",
+        "destination": [-468768.84888828284, -2636983.410363647, 3193355.1570078987],
+        "orientation": [3.8060647475551765, -0.9801861222357124, 6.281240302469402],
+        "description": "Alba Mons is a volcano located in the northern Tharsis region of the planet Mars. It is the biggest volcano on Mars in terms of surface area, with volcanic flow fields that extend for at least 1,350 km (840 mi) from its summit. Although the volcano has a span comparable to that of the United States, it reaches an elevation of only 6.8 km (22,000 ft) at its highest point.[6] This is about one-third the height of Olympus Mons, the tallest volcano on the planet.",
+        "sourceURL": "https://en.wikipedia.org/wiki/Alba_Mons",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/a/a9/Alba_Mons_Viking_DIM.jpg"
+      },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [250.4, 40.5]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Arabia Terra",
+        "destination": [3173625.979675759, -925087.3184430292, 1281260.6050768741],
+        "orientation": [2.210739895697892, -0.4557150936475227, 0.0003490992512000801],
+        "description": "Arabia Terra is a large upland region in the north of Mars that lies mostly in the Arabia quadrangle, but a small part is in the Mare Acidalium quadrangle. It is densely cratered and heavily eroded. This battered topography indicates great age, and Arabia Terra is presumed to be one of the oldest terrains on the planet. It covers as much as 4,500 km (2,800 mi) at its longest extent, centered roughly at 21°N 6°E with its eastern and southern regions rising 4 km (13,000 ft) above the north-west. Alongside its many craters, canyons wind through the Arabia Terra, many emptying into the large northern lowlands of the planet, which borders Arabia Terra to the north.",
+        "sourceURL": "https://en.wikipedia.org/wiki/Arabia_Terra",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/thumb/4/41/Eden_Patera_THEMIS_day_IR.jpg/2560px-Eden_Patera_THEMIS_day_IR.jpg"
+        },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [-11.870000000000001, 18.02]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Elysium Volcanic Region",
+        "destination": [-3390705.18743154, 1723996.087561009, 1009387.4502178654],
+        "orientation": [5.95184286595793, -0.8844046974415081, 0.005041989289460425],
+        "description": "Elysium, located in the Elysium and Cebrenia quadrangles, is the second largest volcanic region on Mars, after Tharsis. The region includes the volcanoes (from north to south) Hecates Tholus, Elysium Mons and Albor Tholus. The province is centered roughly on Elysium Mons at 24.7°N 150°E. Elysium Planitia is a broad plain to the south of Elysium, centered at 3.0°N 154.7°E. Another large volcano, Apollinaris Mons, lies south of Elysium Planitia and is not part of the province. Besides having large volcanoes, Elysium has several areas with long trenches, called fossa or fossae (plural) on Mars.",
+        "sourceURL": "https://en.wikipedia.org/wiki/Elysium_(volcanic_province)",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/thumb/9/96/Elysium_MOLA_zoom_64.jpg/2560px-Elysium_MOLA_zoom_64.jpg"
+      },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [150, 24.7]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Gale Crater (Curiosity)",
+        "destination": [-2791535.3207, 2189446.3646, -616541.9385],
+        "orientation": [5.5684, -0.636, 0.0],
+        "description": "Curiosity is a car-sized Mars rover that is exploring Gale crater and Mount Sharp on Mars as part of NASA's Mars Science Laboratory (MSL) mission. Launched in 2011 and landed the following year, the rover continues to operate more than a decade after its original two-year mission. Mission goals include an investigation of the Martian climate and geology, an assessment of whether the selected field site inside Gale has ever offered environmental conditions favorable for microbial life (including investigation of the role of water), and planetary habitability studies in preparation for human exploration.",
+        "sourceURL": "https://en.wikipedia.org/wiki/Curiosity_(rover)",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/thumb/f/f3/Curiosity_Self-Portrait_at_%27Big_Sky%27_Drilling_Site.jpg/1280px-Curiosity_Self-Portrait_at_%27Big_Sky%27_Drilling_Site.jpg"
+      },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [137.8, -5.4]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": {
+        "text": "Jezero Crater (Perseverance)",
+        "destination": [596565.83388002, 3353778.00627982, 923026.06801835],
+        "orientation": [5.59008567, -0.59978189, 0.00060998],
+        "description": "Perseverance is a car-sized Mars rover designed to explore the Jezero crater on Mars as part of NASA's Mars 2020 mission. Perseverance has a similar design to its predecessor rover, Curiosity, although it was moderately upgraded. It carries seven primary payload instruments, nineteen cameras, and two microphones. The rover also carried the mini-helicopter Ingenuity to Mars, an experimental technology testbed that made the first powered aircraft flight on another planet on April 19, 2021.",
+        "sourceURL": "https://en.wikipedia.org/wiki/Perseverance_(rover)",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/a/a4/Perseverance-Selfie-at-Rochette-Horizontal-V2.gif"
+      },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [77.58, 18.38]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Marth Crater",
+        "destination": [3327216.4788566492, -218466.2408178681, 946551.8768631018],
+        "orientation": [3.331697871424215, -0.29366873064196347, 6.281659377334691],
+        "description": "In the best-selling novel \"The Martian\" and the movie based on it, stranded astronaut Mark Watney's adventures take him to the rim of Mawrth Crater. The crater rim is not very distinct, and from the Martian surface it would be quite difficult to tell that you are even on the rim of a crater. The terrain is hummocky and rolling, punctuated by smaller impact craters and wind-blown drifts of sand or dust.",
+        "sourceURL": "https://science.nasa.gov/resource/western-edge-of-mars-marth-crater-a-movie-location/",
+        "source": "NASA",
+        "imageURL": "https://assets.science.nasa.gov/dynamicimage/assets/science/psd/mars/resources/detail_files/7/7500_mars-the-martian-marth-crater-PIA19915-full2.jpg?w=1163&h=720&fit=clip&crop=faces%2Cfocalpoint"
+        },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [-4.2680995373239057, 12.660926420007353]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Mawrth Vallis",
+        "destination": [2880337.0763509087, -1422487.4666314998, 1778960.0256092676],
+        "orientation": [2.059623110400561, -0.6237026798827308, 0.0017318644099715286],
+        "description": "Mawrth Vallis (Mawrth means \"Mars\" in Welsh) is a valley on Mars, located in the Oxia Palus quadrangle at 22.3°N, 343.5°E with an elevation approximately two kilometers below datum. Situated between the southern highlands and northern lowlands, the valley is a channel formed by massive flooding which occurred in Mars' ancient past. It is an ancient water outflow channel with light-colored clay-rich rocks.",
+        "sourceURL": "https://en.wikipedia.org/wiki/Mawrth_Vallis",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/thumb/8/8f/Mawrth_Vallis_martian_mosaic.jpg/1280px-Mawrth_Vallis_martian_mosaic.jpg"
+        },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [-20.5, 26.350000000000001]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Olympus Mons",
+        "destination": [-2549089.8672, -2720744.9822, 604987.2427],
+        "orientation": [6.2232, -0.7135, 0.0],
+        "description": "Olympus Mons is a large shield volcano on Mars. It is over 21.9 km high as measured by the Mars Orbiter Laser Altimeter (MOLA), about 2.5 times the elevation of Mount Everest above sea level. It is Mars's tallest volcano, its tallest planetary mountain, and is approximately tied with Rheasilvia on Vesta as the tallest mountain currently discovered in the Solar System. It is associated with the volcanic region of Tharsis Montes. It last erupted 25 million years ago.",
+        "sourceURL": "https://en.wikipedia.org/wiki/Olympus_Mons",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/thumb/c/c2/Olympus_Mons_-_ESA_Mars_Express_-_Flickr_-_Andrea_Luck.png/2880px-Olympus_Mons_-_ESA_Mars_Express_-_Flickr_-_Andrea_Luck.png"
+      },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [226.2, 18.65]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Meridiani Planum (Opportunity)",
+        "destination": [3528252.21590355, -6454.59498861, -190095.70073928],
+        "orientation": [4.91589709, -0.43114195, 5.97503936],
+        "description": "Opportunity, also known as MER-B (Mars Exploration Rover - B) or MER-1, and nicknamed Oppy, is a robotic rover that was active on Mars from 2004 until 2018. Opportunity was operational on Mars for 5111 sols (14 years, 138 days on Earth). Launched on July 7, 2003, as part of NASA's Mars Exploration Rover program, it landed in Meridiani Planum on January 25, 2004, three weeks after its twin, Spirit (MER-A), touched down on the other side of the planet. With a planned 90-sol duration of activity (slightly less than 92.5 Earth days), Spirit functioned until it got stuck in 2009 and ceased communications in 2010, while Opportunity was able to stay operational for 5111 sols after landing, maintaining its power and key systems through continual recharging of its batteries using solar power, and hibernating during events such as dust storms to save power. This careful operation allowed Opportunity to operate for 57 times its designed lifespan, exceeding the initial plan by 14 years, 47 days (in Earth time). By June 10, 2018, when it last contacted NASA, the rover had traveled a distance of 45.16 kilometers (28.06 miles).",
+        "sourceURL": "https://en.wikipedia.org/wiki/Opportunity_(rover)",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/thumb/d/d8/NASA_Mars_Rover.jpg/2560px-NASA_Mars_Rover.jpg"
+      },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [354.4734, -1.9462]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Schiaparelli Crater",
+        "destination": [3513269.5521, 664880.5211, -498902.5607],
+        "orientation": [0.8318, -0.5309, 0.0],
+        "description": "Schiaparelli is an impact crater on Mars, located near the planet's equator at latitude 3° south and longitude 344° in the Sinus Sabaeus quadrangle. It measures approximately 459 kilometers (285-miles) in diameter and was named after Italian astronomer Giovanni Schiaparelli. A crater within Schiaparelli shows many layers that may have formed by the wind, volcanoes, or deposition under water.",
+        "sourceURL": "https://en.wikipedia.org/wiki/Schiaparelli_(Martian_crater)",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/6/6e/SchiaparelliMOLA.jpeg"
+      },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [16.7, -2.7]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Ares Vallis (Sojourner)",
+        "destination": [3002746.35818072, -1674150.97664144, 1015018.06707550],
+        "orientation": [5.27982625, -0.63635512, 0.00167013],
+        "description": "The robotic Sojourner rover reached Mars on July 4, 1997 as part of the Mars Pathfinder mission. Sojourner was operational on Mars for 92 sols (95 Earth days), and was the first wheeled vehicle to operate on an astronomical object other than the Earth or Moon. The landing site was in the Ares Vallis channel in the Chryse Planitia region of the Oxia Palus quadrangle.",
+        "sourceURL": "https://en.wikipedia.org/wiki/Sojourner_(rover)",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Sojourner_on_Mars_PIA01122.jpg"
+      },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [-33.22, 19.13]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Gusev Crater (Spirit)",
+        "destination": [-3318104.44189717, 143085.57854143, -986175.00294181],
+        "orientation": [5.53211415, -0.38597730, 0.00036546],
+        "description": "Spirit, also known as MER-A (Mars Exploration Rover - A) or MER-2, is a Mars robotic rover, active from 2004 to 2010. Spirit was operational on Mars for 2208 sols or 3.3 Martian years (2269 days; 6 years, 77 days). It was one of two rovers of NASA's Mars Exploration Rover Mission managed by the Jet Propulsion Laboratory (JPL). Spirit landed successfully within the impact crater Gusev on Mars at 04:35 Ground UTC on January 4, 2004, three weeks before its twin, Opportunity (MER-B), which landed on the other side of the planet. Its name was chosen through a NASA-sponsored student essay competition. The rover got stuck in a \"sand trap\" in late 2009 at an angle that hampered recharging of its batteries; its last communication with Earth was on March 22, 2010.",
+        "sourceURL": "https://en.wikipedia.org/wiki/Spirit_(rover)",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/thumb/f/f8/KSC-03PD-0786.jpg/2880px-KSC-03PD-0786.jpg"
+      },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [175.472636, -14.5684]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Terra Meridiani",
+        "destination": [3527603.695520859, -689644.450481964, 483920.0646853684],
+        "orientation": [2.04380225538318, -0.5700974895821371, 6.2830672295985615],
+        "description": "Terra Meridiani is a large plain straddling the equator of Mars. The plain sits on top of an enormous body of sediments that contains bound water. The iron oxide in the spherules is crystalline (grey) hematite (Fe2O3). The Meridiani Planum is one of the most thoroughly investigated regions of Mars. Many studies were carried out by the scientists involved with NASA's Mars Exploration Rover (MER) Opportunity.",
+        "sourceURL": "https://en.wikipedia.org/wiki/Terra_Meridiani",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/6/6b/Sol322B.Smooth.Sheet.bedforms.close.to.heat.shield.crp.jpg"
+        },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [-4.8900000000000006, 4.6100000000000003]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "\"The Hab\"",
+        "destination": [2482963.8874656125, -1390493.34713116, 2003606.997020314],
+        "orientation": [2.9706346891645325, -0.39288074608352463, 0.00013399155612248137],
+        "description": "(Spoilers!) In the novel and movie The Martian, \"The Hab\" is a habitat on Mars, in Acidalia Planitia, where astronaut Mark Watney lives and works after being stranded there alone following a dust storm on Sol 18 of the Ares III mission.",
+        "sourceURL": "https://en.wikipedia.org/wiki/The_Martian_(film)",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/a/a7/PIA19913-MarsLandingSite-Ares3Mission-TheMartian-2015Film-20150517.jpg"
+        },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [-28.57, 31.27]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "Valles Marineris",
+        "destination": [1962773.9022, -2712650.0794, -1111175.4271],
+        "orientation": [5.4566, -0.4563, 0.0],
+        "description": "Valles Marineris (Latin for Mariner Valleys, named after the Mariner 9 Mars orbiter of 1971-72 which discovered it) is a system of canyons that runs along the Martian surface east of the Tharsis region. At more than 4,000 km (2,500 mi) long, 200 km (120 mi) wide and up to 7 km (23,000 ft) deep, Valles Marineris is the largest canyon in the Solar System.",
+        "sourceURL": "https://en.wikipedia.org/wiki/Valles_Marineris",
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/thumb/5/56/Mars_Valles_Marineris.jpeg/1200px-Mars_Valles_Marineris.jpeg"
+      },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [-59.2, -13.9]
+      }
+    },
+    {
+      "type": "Feature",
+      "properties": { 
+        "text": "\"Watney Triangle\"",
+        "destination": [3286701.2244228586, -654675.1932169931, 1071261.3465401786],
+        "orientation": [2.215118283105494, -0.4393789184089627, 6.283005739536628],
+        "description": "(Spoilers!) In the novel and movie The Martian, the \"Watney Triangle\" is a region of treacherous craters (Trouvelot, Becquerel, and Marth) that astronaut Mark Watney must traverse on his way to the Ares 4 landing site at Schiaparelli Crater.",
+        "sourceURL": "https://en.wikipedia.org/wiki/The_Martian_(film)", 
+        "source": "Wikipedia",
+        "imageURL": "https://upload.wikimedia.org/wikipedia/commons/9/99/TrouvelotMartianCrater.jpg"
+        },
+      "geometry": {
+        "type": "Point",
+        "coordinates": [-7.6717428056727446, 15.243062604535314]
+      }
+    }
+  ]
+}

Apps/Sandcastle/CesiumSandcastle.css

@@ -49,6 +49,15 @@ body {
   float: right;
 }
 
+#banner {
+  text-align: center;
+  background: #daf6ff;
+
+  a {
+    color: blue;
+  }
+}
+
 #codeContainer {
   width: 40%;
 }
@@ -186,25 +195,6 @@ a.linkButton:hover {
   overflow: auto !important;
 }
 
-.feedback {
-  width: 250px;
-
-  .future-banner {
-    display: flex;
-    justify-content: center;
-    align-items: stretch;
-    text-align: center;
-    flex-direction: column;
-
-    h3 {
-      margin: 0 1em;
-    }
-    p {
-      margin: 1em 1.5em;
-    }
-  }
-}
-
 .claro .dijitTabContainerTop-tabs .dijitTabChecked .dijitTabContent {
   background-position: 0 -103px;
 }

Apps/Sandcastle/gallery/3D Tiles Compare.html

@@ -39,9 +39,30 @@
       #slider:hover {
         cursor: ew-resize;
       }
+
+      .split-label {
+        position: absolute;
+        top: 50%;
+        transform: translateY(-50%);
+        background: rgba(42, 42, 42, 0.8);
+        padding: 8px;
+        border-radius: 4px;
+        z-index: 9999;
+        font-size: large;
+        font-weight: bold;
+        text-align: center;
+      }
+      .split-label.left {
+        left: 0;
+      }
+      .split-label.right {
+        right: 0;
+      }
     </style>
     <div id="cesiumContainer" class="fullSize">
       <div id="slider"></div>
+      <div class="split-label left">3D Tiles<br />Mesh</div>
+      <div class="split-label right">3D Tiles<br />OSM buildings</div>
     </div>
     <div id="loadingOverlay"><h1>Loading...</h1></div>
     <div id="toolbar"></div>

Apps/Sandcastle/gallery/3D Tiles Gaussian Splatting Comparison.html

@@ -0,0 +1,145 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1" />
+    <!-- Use Chrome Frame in IE -->
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no"
+    />
+    <meta
+      name="description"
+      content="View the same 3D Tiles power station dataset with Gaussian splatting (or Gaussian splats) rendering versus triangle-based mesh rendering."
+    />
+    <meta name="cesium-sandcastle-labels" content="Showcases, 3D Tiles" />
+    <title>Cesium Demo</title>
+    <script type="text/javascript" src="../Sandcastle-header.js"></script>
+    <script
+      type="text/javascript"
+      src="../../../Build/CesiumUnminified/Cesium.js"
+      nomodule
+    ></script>
+    <script type="module" src="../load-cesium-es6.js"></script>
+  </head>
+  <body class="sandcastle-loading" data-sandcastle-bucket="bucket-requirejs.html">
+    <style>
+      @import url(../templates/bucket.css);
+
+      #slider {
+        position: absolute;
+        left: 50%;
+        top: 0px;
+        background-color: #d3d3d3;
+        width: 5px;
+        height: 100%;
+        z-index: 9999;
+      }
+
+      #slider:hover {
+        cursor: ew-resize;
+      }
+      .split-label {
+        position: absolute;
+        top: 50%;
+        transform: translateY(-50%);
+        background: rgba(42, 42, 42, 0.8);
+        padding: 8px;
+        border-radius: 4px;
+        z-index: 9999;
+        font-size: large;
+        font-weight: bold;
+        text-align: center;
+      }
+      .split-label.left {
+        left: 0;
+      }
+      .split-label.right {
+        right: 0;
+      }
+    </style>
+    <div id="cesiumContainer" class="fullSize">
+      <div id="slider"></div>
+      <div class="split-label left">3D Tiles<br />Gaussian splats</div>
+      <div class="split-label right">3D Tiles<br />Mesh</div>
+    </div>
+    <div id="loadingOverlay"><h1>Loading...</h1></div>
+    <div id="toolbar"></div>
+    <script id="cesium_sandcastle_script">
+      window.startup = async function (Cesium) {
+        "use strict";
+        //Sandcastle_Begin
+        const viewer = new Cesium.Viewer("cesiumContainer", {
+          terrain: Cesium.Terrain.fromWorldTerrain(),
+        });
+
+        try {
+          const left = await Cesium.Cesium3DTileset.fromIonAssetId(3667784);
+          viewer.scene.primitives.add(left);
+          left.splitDirection = Cesium.SplitDirection.LEFT;
+
+          viewer.zoomTo(
+            left,
+            new Cesium.HeadingPitchRange(
+              Cesium.Math.toRadians(-50),
+              Cesium.Math.toRadians(-20),
+              100.0,
+            ),
+          );
+
+          const right = await Cesium.Cesium3DTileset.fromIonAssetId(3443919);
+          viewer.scene.primitives.add(right);
+          right.splitDirection = Cesium.SplitDirection.RIGHT;
+        } catch (error) {
+          console.log(`Error loading tileset: ${error}`);
+        }
+
+        // Sync the position of the slider with the split position
+        const slider = document.getElementById("slider");
+        viewer.scene.splitPosition = slider.offsetLeft / slider.parentElement.offsetWidth;
+
+        const handler = new Cesium.ScreenSpaceEventHandler(slider);
+
+        let moveActive = false;
+
+        function move(movement) {
+          if (!moveActive) {
+            return;
+          }
+
+          const relativeOffset = movement.endPosition.x;
+          const splitPosition =
+            (slider.offsetLeft + relativeOffset) / slider.parentElement.offsetWidth;
+          slider.style.left = `${100.0 * splitPosition}%`;
+          viewer.scene.splitPosition = splitPosition;
+        }
+
+        handler.setInputAction(function () {
+          moveActive = true;
+        }, Cesium.ScreenSpaceEventType.LEFT_DOWN);
+        handler.setInputAction(function () {
+          moveActive = true;
+        }, Cesium.ScreenSpaceEventType.PINCH_START);
+
+        handler.setInputAction(move, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
+        handler.setInputAction(move, Cesium.ScreenSpaceEventType.PINCH_MOVE);
+
+        handler.setInputAction(function () {
+          moveActive = false;
+        }, Cesium.ScreenSpaceEventType.LEFT_UP);
+        handler.setInputAction(function () {
+          moveActive = false;
+        }, Cesium.ScreenSpaceEventType.PINCH_END);
+        //Sandcastle_End
+      };
+      if (typeof Cesium !== "undefined") {
+        window.startupCalled = true;
+        window.startup(Cesium).catch((error) => {
+          "use strict";
+          console.error(error);
+        });
+        Sandcastle.finishedLoading();
+      }
+    </script>
+  </body>
+</html>

Apps/Sandcastle/gallery/3D Tiles Gaussian Splatting.html

@@ -10,7 +10,7 @@
     />
     <meta
       name="description"
-      content="View the same 3D Tiles power station dataset as a 3D Gaussian splatting tileset and a mesh tileset."
+      content="A 3D Gaussian splatting (or Gaussian splats) dataset rendered with 3D Tiles."
     />
     <meta name="cesium-sandcastle-labels" content="Showcases, 3D Tiles" />
     <title>Cesium Demo</title>
@@ -25,91 +25,30 @@
   <body class="sandcastle-loading" data-sandcastle-bucket="bucket-requirejs.html">
     <style>
       @import url(../templates/bucket.css);
-
-      #slider {
-        position: absolute;
-        left: 50%;
-        top: 0px;
-        background-color: #d3d3d3;
-        width: 5px;
-        height: 100%;
-        z-index: 9999;
-      }
-
-      #slider:hover {
-        cursor: ew-resize;
-      }
     </style>
-    <div id="cesiumContainer" class="fullSize">
-      <div id="slider"></div>
-    </div>
+    <div id="cesiumContainer" class="fullSize"></div>
     <div id="loadingOverlay"><h1>Loading...</h1></div>
     <div id="toolbar"></div>
     <script id="cesium_sandcastle_script">
       window.startup = async function (Cesium) {
         "use strict";
         //Sandcastle_Begin
-        const viewer = new Cesium.Viewer("cesiumContainer", {
-          terrain: Cesium.Terrain.fromWorldTerrain(),
-        });
+        const viewer = new Cesium.Viewer("cesiumContainer");
 
         try {
-          const left = await Cesium.Cesium3DTileset.fromIonAssetId(3443920);
-          viewer.scene.primitives.add(left);
-          left.splitDirection = Cesium.SplitDirection.LEFT;
-
+          const tileset = await Cesium.Cesium3DTileset.fromIonAssetId(3667783);
+          viewer.scene.primitives.add(tileset);
           viewer.zoomTo(
-            left,
+            tileset,
             new Cesium.HeadingPitchRange(
-              Cesium.Math.toRadians(-50),
-              Cesium.Math.toRadians(-20),
-              100.0,
+              Cesium.Math.toRadians(0.0),
+              Cesium.Math.toRadians(-15.0),
+              200.0,
             ),
           );
-
-          const right = await Cesium.Cesium3DTileset.fromIonAssetId(3443919);
-          viewer.scene.primitives.add(right);
-          right.splitDirection = Cesium.SplitDirection.RIGHT;
         } catch (error) {
           console.log(`Error loading tileset: ${error}`);
         }
-
-        // Sync the position of the slider with the split position
-        const slider = document.getElementById("slider");
-        viewer.scene.splitPosition = slider.offsetLeft / slider.parentElement.offsetWidth;
-
-        const handler = new Cesium.ScreenSpaceEventHandler(slider);
-
-        let moveActive = false;
-
-        function move(movement) {
-          if (!moveActive) {
-            return;
-          }
-
-          const relativeOffset = movement.endPosition.x;
-          const splitPosition =
-            (slider.offsetLeft + relativeOffset) / slider.parentElement.offsetWidth;
-          slider.style.left = `${100.0 * splitPosition}%`;
-          viewer.scene.splitPosition = splitPosition;
-        }
-
-        handler.setInputAction(function () {
-          moveActive = true;
-        }, Cesium.ScreenSpaceEventType.LEFT_DOWN);
-        handler.setInputAction(function () {
-          moveActive = true;
-        }, Cesium.ScreenSpaceEventType.PINCH_START);
-
-        handler.setInputAction(move, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
-        handler.setInputAction(move, Cesium.ScreenSpaceEventType.PINCH_MOVE);
-
-        handler.setInputAction(function () {
-          moveActive = false;
-        }, Cesium.ScreenSpaceEventType.LEFT_UP);
-        handler.setInputAction(function () {
-          moveActive = false;
-        }, Cesium.ScreenSpaceEventType.PINCH_END);
         //Sandcastle_End
       };
       if (typeof Cesium !== "undefined") {

Apps/Sandcastle/gallery/Azure 2D Tiles.html

@@ -0,0 +1,69 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no"
+    />
+    <meta name="description" content="Global imagery data from Azure Maps." />
+    <meta name="cesium-sandcastle-labels" content="Beginner, Showcases" />
+    <title>Cesium Demo</title>
+    <script type="text/javascript" src="../Sandcastle-header.js"></script>
+    <script type="module" src="../load-cesium-es6.js"></script>
+  </head>
+  <body class="sandcastle-loading" data-sandcastle-bucket="bucket-requirejs.html">
+    <style>
+      @import url(../templates/bucket.css);
+    </style>
+    <div id="cesiumContainer" class="fullSize"></div>
+    <div id="loadingOverlay"><h1>Loading...</h1></div>
+    <div id="toolbar"></div>
+    <script id="cesium_sandcastle_script">
+      window.startup = async function (Cesium) {
+        "use strict";
+        //Sandcastle_Begin
+        const assetId = 3891169;
+
+        const azure = Cesium.ImageryLayer.fromProviderAsync(
+          Cesium.IonImageryProvider.fromAssetId(assetId),
+        );
+
+        const viewer = new Cesium.Viewer("cesiumContainer", {
+          animation: false,
+          baseLayer: false,
+          baseLayerPicker: false,
+          geocoder: Cesium.IonGeocodeProviderType.GOOGLE,
+          timeline: false,
+          sceneModePicker: false,
+          navigationHelpButton: false,
+          homeButton: false,
+          terrainProvider: await Cesium.CesiumTerrainProvider.fromIonAssetId(1),
+        });
+        viewer.geocoder.viewModel.keepExpanded = true;
+
+        viewer.imageryLayers.add(azure);
+
+        viewer.scene.camera.flyTo({
+          duration: 0,
+          destination: new Cesium.Rectangle.fromDegrees(
+            //Philly
+            -75.280266,
+            39.867004,
+            -74.955763,
+            40.137992,
+          ),
+        }); //Sandcastle_End
+        Sandcastle.finishedLoading();
+      };
+      if (typeof Cesium !== "undefined") {
+        window.startupCalled = true;
+        window.startup(Cesium).catch((error) => {
+          "use strict";
+          console.error(error);
+        });
+      }
+    </script>
+  </body>
+</html>

Apps/Sandcastle/gallery/Bing Maps Labels Only.html

@@ -38,10 +38,36 @@
       #slider:hover {
         cursor: ew-resize;
       }
+
+      .split-label {
+        position: absolute;
+        top: 50%;
+        transform: translateY(-50%);
+        background: rgba(42, 42, 42, 0.8);
+        padding: 8px;
+        border-radius: 4px;
+        z-index: 9999;
+        font-size: large;
+        font-weight: bold;
+        text-align: center;
+      }
+      .split-label.left {
+        left: 0;
+      }
+      .split-label.right {
+        right: 0;
+      }
     </style>
 
     <div id="cesiumContainer" class="fullSize">
       <div id="slider"></div>
+      <div class="split-label left">
+        Bing Maps (labeled)<br />+<br />Washington Imagery
+      </div>
+      <div class="split-label right">
+        Bing Maps (unlabeled)<br />+<br />Washington Imagery<br />+<br />Bing Maps (labels
+        only)
+      </div>
     </div>
     <div id="loadingOverlay"><h1>Loading...</h1></div>
     <div id="toolbar"></div>
@@ -105,6 +131,13 @@
         // Add a button to toggle the display of the Bing Maps Labels Only layer
         Sandcastle.addToggleButton("Show Bing Maps Labels Only", true, (checked) => {
           bingMapsLabelsOnly.show = checked;
+          const rightLabel = document.querySelector(".split-label.right");
+          if (checked) {
+            rightLabel.innerHTML =
+              "Bing Maps (unlabeled)<br />+<br />Washington Imagery<br />+<br />Bing Maps (labels only)";
+          } else {
+            rightLabel.innerHTML = "Bing Maps (unlabeled)<br />+<br />Washington Imagery";
+          }
         });
 
         // The remaining code synchronizes the position of the slider with the split position

Apps/Sandcastle/gallery/Custom DataSource.html

@@ -64,7 +64,7 @@
           /**
            * Gets a human-readable name for this instance.
            * @memberof WebGLGlobeDataSource.prototype
-           * @type {String}
+           * @type {string}
            */
           name: {
             get: function () {
@@ -93,7 +93,7 @@
           /**
            * Gets a value indicating if the data source is currently loading data.
            * @memberof WebGLGlobeDataSource.prototype
-           * @type {Boolean}
+           * @type {boolean}
            */
           isLoading: {
             get: function () {
@@ -150,7 +150,7 @@
            * so that only one series is viewed at a time.  Valid values are defined
            * in the seriesNames property.
            * @memberof WebGLGlobeDataSource.prototype
-           * @type {String}
+           * @type {string}
            */
           seriesToDisplay: {
             get: function () {
@@ -174,7 +174,7 @@
           /**
            * Gets or sets the scale factor applied to the height of each line.
            * @memberof WebGLGlobeDataSource.prototype
-           * @type {Number}
+           * @type {number}
            */
           heightScale: {
             get: function () {
@@ -190,7 +190,7 @@
           /**
            * Gets whether or not this data source should be displayed.
            * @memberof WebGLGlobeDataSource.prototype
-           * @type {Boolean}
+           * @type {boolean}
            */
           show: {
             get: function () {

Apps/Sandcastle/gallery/Custom Shaders 3D Tiles.html

@@ -21,11 +21,13 @@
   <body class="sandcastle-loading" data-sandcastle-bucket="bucket-requirejs.html">
     <style>
       @import url(../templates/bucket.css);
+
       #toolbar {
         background: rgba(42, 42, 42, 0.8);
         padding: 4px;
         border-radius: 4px;
       }
+
       #toolbar input {
         vertical-align: middle;
         padding-top: 2px;
@@ -41,19 +43,21 @@
         //Sandcastle_Begin
         const viewer = new Cesium.Viewer("cesiumContainer");
 
+        const colorShader = new Cesium.CustomShader({
+          lightingModel: Cesium.LightingModel.UNLIT,
+          fragmentShaderText: `
+            // Color tiles by distance to the camera
+            void fragmentMain(FragmentInput fsInput, inout czm_modelMaterial material)
+            {
+                material.diffuse = vec3(0.0, 0.0, 1.0);
+                material.diffuse.g = -fsInput.attributes.positionEC.z / 1.0e4;
+            }`,
+        });
+
+        let tileset = null;
         try {
-          const tileset = await Cesium.Cesium3DTileset.fromIonAssetId(75343, {
-            customShader: new Cesium.CustomShader({
-              lightingModel: Cesium.LightingModel.UNLIT,
-              fragmentShaderText: `
-                // Color tiles by distance to the camera
-                void fragmentMain(FragmentInput fsInput, inout czm_modelMaterial material)
-                {
-                    material.diffuse = vec3(0.0, 0.0, 1.0);
-                    material.diffuse.g = -fsInput.attributes.positionEC.z / 1.0e4;
-                }
-                `,
-            }),
+          tileset = await Cesium.Cesium3DTileset.fromIonAssetId(75343, {
+            customShader: colorShader,
           });
           viewer.scene.primitives.add(tileset);
         } catch (error) {
@@ -76,6 +80,52 @@
           endTransform: Cesium.Matrix4.IDENTITY,
         });
 
+        const options = [
+          {
+            text: "Color",
+            onselect: function () {
+              tileset.customShader = colorShader;
+            },
+          },
+          {
+            text: "Stripes",
+            onselect: function () {
+              tileset.customShader = new Cesium.CustomShader({
+                uniforms: {
+                  // elapsed time in seconds for animation
+                  u_time: {
+                    type: Cesium.UniformType.FLOAT,
+                    value: 0,
+                  },
+                  // user-defined texture
+                  u_stripes: {
+                    type: Cesium.UniformType.SAMPLER_2D,
+                    value: new Cesium.TextureUniform({
+                      url: "../../SampleData/cesium_stripes.png",
+                    }),
+                  },
+                },
+                // Apply the texture to the model, but move the texture coordinates
+                // a bit over time so it's animated.
+                fragmentShaderText: `
+                  void fragmentMain(FragmentInput fsInput, inout czm_modelMaterial material)
+                  {
+                      vec2 texCoord = vec2(fsInput.attributes.positionMC.y / 100., 0.) + 0.01 * vec2(czm_frameNumber, 0.0);
+                      material.diffuse = texture(u_stripes, texCoord).rgb;
+                  }`,
+              });
+            },
+          },
+          {
+            text: "None",
+            onselect: function () {
+              tileset.customShader = null;
+            },
+          },
+        ];
+
+        Sandcastle.addToolbarMenu(options);
+
         //Sandcastle_End
       };
       if (typeof Cesium !== "undefined") {

Apps/Sandcastle/gallery/Drape Imagery on 3D Tiles.html

@@ -40,12 +40,10 @@
         });
         viewer.scene.skyAtmosphere.show = true;
 
-        const iTwinId = "535a24a3-9b29-4e23-bb5d-9cedb524c743";
-        const realityMeshId = "85897090-3bcc-470b-bec7-20bb639cc1b9";
-        const tileset = await Cesium.ITwinData.createTilesetForRealityDataId(
-          iTwinId,
-          realityMeshId,
-        );
+        const tileset = await Cesium.ITwinData.createTilesetForRealityDataId({
+          iTwinId: "535a24a3-9b29-4e23-bb5d-9cedb524c743",
+          realityDataId: "85897090-3bcc-470b-bec7-20bb639cc1b9",
+        });
         viewer.scene.primitives.add(tileset);
         tileset.maximumScreenSpaceError = 2;
 

Apps/Sandcastle/gallery/Globe Materials – 3D Tiles Terrain.html

@@ -0,0 +1,139 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no"
+    />
+    <meta name="description" content="Apply materials to the globe." />
+    <meta name="cesium-sandcastle-labels" content="Showcases" />
+    <title>Cesium Demo</title>
+    <script type="text/javascript" src="../Sandcastle-header.js"></script>
+    <script
+      type="text/javascript"
+      src="../../../Build/CesiumUnminified/Cesium.js"
+      nomodule
+    ></script>
+    <script type="module" src="../load-cesium-es6.js"></script>
+  </head>
+  <body class="sandcastle-loading" data-sandcastle-bucket="bucket-requirejs.html">
+    <style>
+      @import url(../templates/bucket.css);
+    </style>
+    <div id="cesiumContainer" class="fullSize"></div>
+    <div id="loadingOverlay"><h1>Loading...</h1></div>
+    <div id="toolbar">
+      <div id="zoomButtons"></div>
+    </div>
+    <script id="cesium_sandcastle_script">
+      window.startup = async function (Cesium) {
+        "use strict";
+        //Sandcastle_Begin
+        const terrainProvider = await Cesium.Cesium3DTilesTerrainProvider.fromIonAssetId(
+          3923568,
+          {
+            requestVertexNormals: true, // Needed for hillshade lighting
+            requestWaterMask: true, // Needed to distinguish land from water
+          },
+        );
+
+        const viewer = new Cesium.Viewer("cesiumContainer", {
+          terrainProvider: terrainProvider,
+          scene3DOnly: true,
+          sceneModePicker: false,
+          navigationHelpButton: false,
+        });
+
+        // Create a globe material for shading elevation only on land
+        const customElevationMaterial = new Cesium.Material({
+          fabric: {
+            type: "ElevationLand",
+            materials: {
+              waterMaskMaterial: {
+                type: "WaterMask",
+              },
+              elevationRampMaterial: {
+                type: "ElevationRamp",
+              },
+            },
+            components: {
+              diffuse: "elevationRampMaterial.diffuse",
+              alpha: "1.0 - waterMaskMaterial.alpha", // We'll need the inverse of the watermask to shade land
+            },
+          },
+          translucent: false,
+        });
+
+        const minHeight = -414.0; // approximate dead sea elevation
+        const maxHeight = 8777.0; // approximate everest elevation
+        const elevationRamp = [0.0, 0.045, 0.45, 0.5, 0.55, 1.0];
+        function getColorRamp() {
+          const ramp = document.createElement("canvas");
+          ramp.width = 100;
+          ramp.height = 1;
+          const ctx = ramp.getContext("2d");
+
+          const values = elevationRamp;
+
+          const grd = ctx.createLinearGradient(0, 0, 100, 0);
+
+          // See https://gis.stackexchange.com/questions/25099/choosing-colour-ramp-to-use-for-elevation
+          grd.addColorStop(values[0], "#344f31");
+          grd.addColorStop(values[1], "#5b8742");
+          grd.addColorStop(values[2], "#e6daa5");
+          grd.addColorStop(values[3], "#fdc771");
+          grd.addColorStop(values[4], "#b99d89");
+          grd.addColorStop(values[5], "#f0f0f0");
+
+          ctx.fillStyle = grd;
+          ctx.fillRect(0, 0, 100, 1);
+
+          return ramp;
+        }
+
+        const globe = viewer.scene.globe;
+        const material = customElevationMaterial;
+        const shadingUniforms = material.materials.elevationRampMaterial.uniforms;
+
+        globe.showWaterEffect = false;
+        globe.enableLighting = true;
+
+        shadingUniforms.minimumHeight = minHeight;
+        shadingUniforms.maximumHeight = maxHeight;
+        shadingUniforms.image = getColorRamp();
+        globe.material = material;
+
+        // Light the scene with a hillshade effect similar to https://pro.arcgis.com/en/pro-app/latest/tool-reference/3d-analyst/how-hillshade-works.htm
+        const scene = viewer.scene;
+        scene.light = new Cesium.DirectionalLight({
+          direction: new Cesium.Cartesian3(1, 0, 0), // Updated every frame
+        });
+
+        // Update the light position base on the camera
+        const scratchNormal = new Cesium.Cartesian3();
+        scene.preRender.addEventListener(function (scene, time) {
+          const surfaceNormal = Cesium.Ellipsoid.WGS84.geodeticSurfaceNormal(
+            scene.camera.positionWC,
+            scratchNormal,
+          );
+          const negativeNormal = Cesium.Cartesian3.negate(surfaceNormal, surfaceNormal);
+          scene.light.direction = Cesium.Cartesian3.normalize(
+            Cesium.Cartesian3.add(negativeNormal, scene.camera.rightWC, surfaceNormal),
+            scene.light.direction,
+          );
+        });
+        //Sandcastle_End
+      };
+      if (typeof Cesium !== "undefined") {
+        window.startupCalled = true;
+        window.startup(Cesium).catch((error) => {
+          "use strict";
+          console.error(error);
+        });
+        Sandcastle.finishedLoading();
+      }
+    </script>
+  </body>
+</html>

Apps/Sandcastle/gallery/Google 2D Tiles with Custom Styles.html

@@ -0,0 +1,94 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no"
+    />
+    <meta
+      name="description"
+      content="Imagery tiles from Google Maps with additional parameters to create overlays and custom styles."
+    />
+    <meta name="cesium-sandcastle-labels" content="Beginner, Showcases" />
+    <title>Cesium Demo</title>
+    <script type="text/javascript" src="../Sandcastle-header.js"></script>
+    <script type="module" src="../load-cesium-es6.js"></script>
+  </head>
+  <body class="sandcastle-loading" data-sandcastle-bucket="bucket-requirejs.html">
+    <style>
+      @import url(../templates/bucket.css);
+    </style>
+    <div id="cesiumContainer" class="fullSize"></div>
+    <div id="loadingOverlay"><h1>Loading...</h1></div>
+    <div id="toolbar"></div>
+    <script id="cesium_sandcastle_script">
+      window.startup = async function (Cesium) {
+        "use strict";
+        //Sandcastle_Begin
+        const assetId = 3830184;
+
+        const base = Cesium.ImageryLayer.fromProviderAsync(
+          Cesium.Google2DImageryProvider.fromIonAssetId({
+            assetId,
+            mapType: "satellite",
+          }),
+        );
+
+        const overlay = Cesium.ImageryLayer.fromProviderAsync(
+          Cesium.Google2DImageryProvider.fromIonAssetId({
+            assetId,
+            overlayLayerType: "layerRoadmap",
+            styles: [
+              {
+                stylers: [{ hue: "#00ffe6" }, { saturation: -20 }],
+              },
+              {
+                featureType: "road",
+                elementType: "geometry",
+                stylers: [{ lightness: 100 }, { visibility: "simplified" }],
+              },
+            ],
+          }),
+        );
+
+        const viewer = new Cesium.Viewer("cesiumContainer", {
+          animation: false,
+          baseLayer: false,
+          baseLayerPicker: false,
+          geocoder: Cesium.IonGeocodeProviderType.GOOGLE,
+          timeline: false,
+          sceneModePicker: false,
+          navigationHelpButton: false,
+          homeButton: false,
+          terrainProvider: await Cesium.CesiumTerrainProvider.fromIonAssetId(1),
+        });
+        viewer.geocoder.viewModel.keepExpanded = true;
+
+        viewer.imageryLayers.add(base);
+        viewer.imageryLayers.add(overlay);
+
+        viewer.scene.camera.flyTo({
+          duration: 0,
+          destination: new Cesium.Rectangle.fromDegrees(
+            //Philly
+            -75.280266,
+            39.867004,
+            -74.955763,
+            40.137992,
+          ),
+        });
+        //Sandcastle_End
+        Sandcastle.finishedLoading();
+      };
+      if (typeof Cesium !== "undefined") {
+        window.startupCalled = true;
+        window.startup(Cesium).catch((error) => {
+          "use strict";
+          console.error(error);
+        });
+      }
+    </script>
+  </body>
+</html>

Apps/Sandcastle/gallery/Google 2D Tiles.html

@@ -0,0 +1,69 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no"
+    />
+    <meta name="description" content="Global imagery data from Google Maps." />
+    <meta name="cesium-sandcastle-labels" content="Beginner, Showcases" />
+    <title>Cesium Demo</title>
+    <script type="text/javascript" src="../Sandcastle-header.js"></script>
+    <script type="module" src="../load-cesium-es6.js"></script>
+  </head>
+  <body class="sandcastle-loading" data-sandcastle-bucket="bucket-requirejs.html">
+    <style>
+      @import url(../templates/bucket.css);
+    </style>
+    <div id="cesiumContainer" class="fullSize"></div>
+    <div id="loadingOverlay"><h1>Loading...</h1></div>
+    <div id="toolbar"></div>
+    <script id="cesium_sandcastle_script">
+      window.startup = async function (Cesium) {
+        "use strict";
+        //Sandcastle_Begin
+        const assetId = 3830184;
+
+        const google = Cesium.ImageryLayer.fromProviderAsync(
+          Cesium.IonImageryProvider.fromAssetId(assetId),
+        );
+
+        const viewer = new Cesium.Viewer("cesiumContainer", {
+          animation: false,
+          baseLayer: false,
+          baseLayerPicker: false,
+          geocoder: Cesium.IonGeocodeProviderType.GOOGLE,
+          timeline: false,
+          sceneModePicker: false,
+          navigationHelpButton: false,
+          homeButton: false,
+          terrainProvider: await Cesium.CesiumTerrainProvider.fromIonAssetId(1),
+        });
+        viewer.geocoder.viewModel.keepExpanded = true;
+
+        viewer.imageryLayers.add(google);
+
+        viewer.scene.camera.flyTo({
+          duration: 0,
+          destination: new Cesium.Rectangle.fromDegrees(
+            //Philly
+            -75.280266,
+            39.867004,
+            -74.955763,
+            40.137992,
+          ),
+        }); //Sandcastle_End
+        Sandcastle.finishedLoading();
+      };
+      if (typeof Cesium !== "undefined") {
+        window.startupCalled = true;
+        window.startup(Cesium).catch((error) => {
+          "use strict";
+          console.error(error);
+        });
+      }
+    </script>
+  </body>
+</html>

Apps/Sandcastle/gallery/Imagery Assets available from ion.html

@@ -0,0 +1,97 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no"
+    />
+    <meta name="description" content="Global imagery assets available from Cesium ion." />
+    <meta name="cesium-sandcastle-labels" content="Beginner, Showcases" />
+    <title>Cesium Demo</title>
+    <script type="text/javascript" src="../Sandcastle-header.js"></script>
+    <script type="module" src="../load-cesium-es6.js"></script>
+  </head>
+  <body class="sandcastle-loading" data-sandcastle-bucket="bucket-requirejs.html">
+    <style>
+      @import url(../templates/bucket.css);
+    </style>
+    <div id="cesiumContainer" class="fullSize"></div>
+    <div id="loadingOverlay"><h1>Loading...</h1></div>
+    <div id="toolbar"></div>
+    <script id="cesium_sandcastle_script">
+      window.startup = async function (Cesium) {
+        "use strict";
+        //Sandcastle_Begin
+        const viewer = new Cesium.Viewer("cesiumContainer", {
+          animation: false,
+          baseLayer: false,
+          baseLayerPicker: false,
+          geocoder: Cesium.IonGeocodeProviderType.GOOGLE,
+          timeline: false,
+          sceneModePicker: false,
+          navigationHelpButton: false,
+          homeButton: false,
+          terrainProvider: await Cesium.CesiumTerrainProvider.fromIonAssetId(1),
+        });
+        viewer.geocoder.viewModel.keepExpanded = true;
+
+        const menuOptions = [];
+
+        const dropdownOptions = [
+          { label: "Google Maps 2D Contour", assetId: 3830186 },
+          { label: "Google Maps 2D Labels Only", assetId: 3830185 },
+          { label: "Google Maps 2D Roadmap", assetId: 3830184 },
+          { label: "Google Maps 2D Satellite", assetId: 3830182 },
+          { label: "Google Maps 2D Satellite with Labels", assetId: 3830183 },
+          { label: "Azure Maps Aerial", assetId: 3891168 },
+          { label: "Azure Maps Roads", assetId: 3891169 },
+          { label: "Azure Maps Labels Only", assetId: 3891170 },
+          { label: "Sentinel-2", assetId: 3954 },
+        ];
+
+        function showLayer(assetId) {
+          viewer.imageryLayers.removeAll(true);
+          const layer = Cesium.ImageryLayer.fromProviderAsync(
+            Cesium.IonImageryProvider.fromAssetId(assetId),
+          );
+          viewer.imageryLayers.add(layer);
+        }
+
+        dropdownOptions.forEach((opt) => {
+          const option = {
+            text: opt.label,
+            onselect: function () {
+              showLayer(opt.assetId);
+            },
+          };
+          menuOptions.push(option);
+        });
+
+        Sandcastle.addToolbarMenu(menuOptions);
+
+        showLayer(3830186);
+
+        viewer.scene.camera.flyTo({
+          duration: 0,
+          destination: new Cesium.Rectangle.fromDegrees(
+            //Philly
+            -75.280266,
+            39.867004,
+            -74.955763,
+            40.137992,
+          ),
+        }); //Sandcastle_End
+        Sandcastle.finishedLoading();
+      };
+      if (typeof Cesium !== "undefined") {
+        window.startupCalled = true;
+        window.startup(Cesium).catch((error) => {
+          "use strict";
+          console.error(error);
+        });
+      }
+    </script>
+  </body>
+</html>

Apps/Sandcastle/gallery/Imagery Layers Split.html

@@ -38,10 +38,31 @@
       #slider:hover {
         cursor: ew-resize;
       }
+
+      .split-label {
+        position: absolute;
+        top: 50%;
+        transform: translateY(-50%);
+        background: rgba(42, 42, 42, 0.8);
+        padding: 8px;
+        border-radius: 4px;
+        z-index: 9999;
+        font-size: large;
+        font-weight: bold;
+        text-align: center;
+      }
+      .split-label.left {
+        left: 0;
+      }
+      .split-label.right {
+        right: 0;
+      }
     </style>
 
     <div id="cesiumContainer" class="fullSize">
       <div id="slider"></div>
+      <div class="split-label left">Earth at Night</div>
+      <div class="split-label right">Arc GIS World<br />Street Map</div>
     </div>
     <div id="loadingOverlay"><h1>Loading...</h1></div>
     <div id="toolbar"></div>

Apps/Sandcastle/gallery/Imagery Layers Texture Filters.html

@@ -38,10 +38,31 @@
       #slider:hover {
         cursor: ew-resize;
       }
+
+      .split-label {
+        position: absolute;
+        top: 50%;
+        transform: translateY(-50%);
+        background: rgba(42, 42, 42, 0.8);
+        padding: 8px;
+        border-radius: 4px;
+        z-index: 9999;
+        font-size: large;
+        font-weight: bold;
+        text-align: center;
+      }
+      .split-label.left {
+        left: 0;
+      }
+      .split-label.right {
+        right: 0;
+      }
     </style>
 
     <div id="cesiumContainer" class="fullSize">
       <div id="slider"></div>
+      <div class="split-label left">Magnification<br />Linear</div>
+      <div class="split-label right">Magnification<br />Nearest</div>
     </div>
     <div id="loadingOverlay"><h1>Loading...</h1></div>
     <div id="toolbar"></div>

Apps/Sandcastle/gallery/Imagery Layers.html

@@ -30,9 +30,9 @@
         "use strict";
         //Sandcastle_Begin
         const viewer = new Cesium.Viewer("cesiumContainer", {
-          baseLayer: Cesium.ImageryLayer.fromWorldImagery({
-            style: Cesium.IonWorldImageryStyle.AERIAL_WITH_LABELS,
-          }),
+          baseLayer: Cesium.ImageryLayer.fromProviderAsync(
+            Cesium.IonImageryProvider.fromAssetId(3830183),
+          ),
           baseLayerPicker: false,
         });
         const layers = viewer.scene.imageryLayers;

Apps/Sandcastle/gallery/Mars.html

@@ -0,0 +1,555 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no"
+    />
+    <meta
+      name="description"
+      content="Mars terrain visualized using 3D Tiles, tiled and hosted by Cesium ion, and shown with points of interest and additional data layers."
+    />
+    <meta name="cesium-sandcastle-labels" content="Showcases, ion Assets, 3D Tiles" />
+    <title>Cesium Mars</title>
+    <script type="text/javascript" src="../Sandcastle-header.js"></script>
+    <script
+      type="text/javascript"
+      src="../../../Build/CesiumUnminified/Cesium.js"
+      nomodule
+    ></script>
+    <script type="module" src="../load-cesium-es6.js"></script>
+  </head>
+  <body class="sandcastle-loading" data-sandcastle-bucket="bucket-requirejs.html">
+    <style>
+      @import url(../templates/bucket.css);
+      #toolbar {
+        background: rgba(42, 42, 42, 0.8);
+        padding: 4px;
+        border-radius: 4px;
+      }
+      #toolbar input {
+        vertical-align: middle;
+        padding-top: 2px;
+        padding-bottom: 2px;
+      }
+      #toolbar .header {
+        font-weight: bold;
+      }
+
+      /* Styles for indicating to the user to press the play button */
+      .cesium-animation-rectButton.highlight-animation .cesium-animation-buttonGlow {
+        display: block;
+        fill: #fff;
+        /* keep the built-in blur and add extra glow layers */
+        filter: url(#animation_blurred) drop-shadow(0 0 3px #aef)
+          drop-shadow(0 0 3px #fff);
+        animation: highlight-animation-button 1.2s ease-in-out infinite;
+      }
+      .cesium-animation-rectButton.highlight-animation .cesium-animation-buttonMain {
+        stroke: #fff;
+        stroke-width: 3;
+      }
+      .cesium-animation-rectButton.highlight-animation .cesium-animation-buttonPath {
+        fill: #fff;
+      }
+
+      .cesium-animation-shuttleRingG.highlight-animation
+        .cesium-animation-shuttleRingBack {
+        stroke: #fff;
+        stroke-width: 6;
+        filter: drop-shadow(0 0 3px #aef) drop-shadow(0 0 3px rgba(174, 238, 255, 0.95));
+        animation: highlight-animation-ring 1.2s ease-in-out infinite;
+      }
+      .cesium-animation-shuttleRingG.highlight-animation
+        .cesium-animation-shuttleRingSwoosh
+        line {
+        stroke: #fff;
+        stroke-opacity: 0.8;
+      }
+
+      @keyframes highlight-animation-button {
+        0% {
+          opacity: 0.3;
+          stroke-width: 0;
+        }
+        50% {
+          opacity: 1;
+          stroke-width: 4;
+        }
+        100% {
+          opacity: 0.3;
+          stroke-width: 0;
+        }
+      }
+      @keyframes highlight-animation-ring {
+        0% {
+          stroke-opacity: 0.25;
+          stroke: #333;
+        }
+        50% {
+          stroke-opacity: 1;
+          stroke: #fff;
+        }
+        100% {
+          stroke-opacity: 0.25;
+          stroke: #333;
+        }
+      }
+    </style>
+    <div id="cesiumContainer" class="fullSize"></div>
+    <div id="loadingOverlay"><h1>Loading...</h1></div>
+    <div id="toolbar"></div>
+    <template id="roverHelpRowTemplate1">
+      <tr>
+        <td>
+          <img
+            data-src="Widgets/Images/NavigationHelp/MouseLeft.svg"
+            style="height: 48px; width: 48px"
+            alt="Left mouse button"
+          />
+        </td>
+        <td>
+          <div class="cesium-navigation-help-pan">Track Rover</div>
+          <div class="cesium-navigation-help-detail">
+            Double click on a rover to track it
+          </div>
+        </td>
+      </tr>
+    </template>
+    <template id="roverHelpRowTemplate2">
+      <tr>
+        <td>
+          <svg width="48" height="48" viewBox="0 0 32 32" aria-label="Play" role="img">
+            <path
+              transform="translate(32,32) scale(0.85) translate(-32,-32)"
+              d="M6.684,25.682L24.316,15.5L6.684,5.318V25.682z"
+              fill="#ffffff"
+            />
+          </svg>
+        </td>
+        <td>
+          <div class="cesium-navigation-help-zoom">Play Animation</div>
+          <div class="cesium-navigation-help-detail">
+            Press play on the timeline to watch the rover move
+          </div>
+        </td>
+      </tr>
+    </template>
+    <script id="cesium_sandcastle_script">
+      window.startup = async function (Cesium) {
+        "use strict";
+        //Sandcastle_Begin
+
+        Cesium.Ellipsoid.default = Cesium.Ellipsoid.MARS;
+        const viewer = new Cesium.Viewer("cesiumContainer", {
+          terrainProvider: false,
+          baseLayer: false,
+          baseLayerPicker: false,
+          geocoder: false,
+          shadows: false,
+          globe: new Cesium.Globe(Cesium.Ellipsoid.MARS),
+          skyBox: Cesium.SkyBox.createEarthSkyBox(),
+          skyAtmosphere: new Cesium.SkyAtmosphere(Cesium.Ellipsoid.MARS),
+        });
+        viewer.scene.globe.show = false;
+        const scene = viewer.scene;
+        const clock = viewer.clock;
+        const navHelp = viewer.navigationHelpButton;
+
+        // Adjust the default atmosphere coefficients to be more Mars-like
+        scene.skyAtmosphere.atmosphereMieCoefficient = new Cesium.Cartesian3(
+          9.0e-5,
+          2.0e-5,
+          1.0e-5,
+        );
+        scene.skyAtmosphere.atmosphereRayleighCoefficient = new Cesium.Cartesian3(
+          9.0e-6,
+          2.0e-6,
+          1.0e-6,
+        );
+        scene.skyAtmosphere.atmosphereRayleighScaleHeight = 9000;
+        scene.skyAtmosphere.atmosphereMieScaleHeight = 2700.0;
+        scene.skyAtmosphere.saturationShift = -0.1;
+        scene.skyAtmosphere.perFragmentAtmosphere = true;
+
+        // Adjust postprocess settings for brighter and richer features
+        const bloom = viewer.scene.postProcessStages.bloom;
+        bloom.enabled = true;
+        bloom.uniforms.brightness = -0.5;
+        bloom.uniforms.stepSize = 1.0;
+        bloom.uniforms.sigma = 3.0;
+        bloom.uniforms.delta = 1.5;
+        scene.highDynamicRange = true;
+        viewer.scene.postProcessStages.exposure = 1.5;
+
+        // Load Mars tileset
+        try {
+          const tileset = await Cesium.Cesium3DTileset.fromIonAssetId(3644333, {
+            enableCollision: true,
+          });
+          viewer.scene.primitives.add(tileset);
+        } catch (error) {
+          console.log(error);
+        }
+
+        // Load the rovers and path from The Martian (by Andy Weir), from CZML data source.
+        let curiosity, perseverance, ingenuity, theMartianJourney;
+        try {
+          const dataSource = await Cesium.CzmlDataSource.load(
+            "../../SampleData/Mars.czml",
+          );
+          viewer.dataSources.add(dataSource);
+
+          const roverMenuEntries = [
+            {
+              text: "Fly to rover...",
+              onselect: () => {},
+            },
+          ];
+
+          const onSelectRover = (rover) => {
+            reset();
+            const roverAnimStartIso = rover.properties.animationStartTime.getValue(
+              Cesium.JulianDate.now(),
+            );
+            clock.multiplier = 604800;
+            clock.currentTime = new Cesium.JulianDate.fromIso8601(roverAnimStartIso);
+            viewer.timeline.zoomTo(rover.availability.start, rover.availability.stop);
+
+            const boundingSphere = new Cesium.BoundingSphere(
+              rover.position.getValue(clock.currentTime),
+              5000.0,
+            );
+
+            scene.camera.flyToBoundingSphere(boundingSphere, {
+              offset: new Cesium.HeadingPitchRoll(4.9791, -0.5294, 0.0),
+              easingFunction: Cesium.EasingFunction.CUBIC_IN_OUT,
+              maximumHeight: 5e6,
+              pitchAdjustHeight: 2.5e6,
+              duration: 3.0,
+              complete: function () {
+                highlightAnimationViewModel(); // Draw attention to the play button
+                navHelp.viewModel.showInstructions = true;
+              },
+            });
+          };
+
+          const setupRover = function (entityId, startSol, outRover) {
+            outRover = dataSource.entities.getById(entityId);
+
+            const julianDateToSol = createJulianDateToSolConverter(
+              outRover.availability.start,
+              startSol,
+            );
+            outRover.label.text = new Cesium.CallbackProperty(function (time) {
+              return julianDateToSol(time);
+            }, false);
+
+            const roverPath = dataSource.entities.getById(`${entityId}Path`);
+            roverPath.polyline.width = createWidthCallbackProperty(
+              new Cesium.NearFarScalar(0.0, 15.0, 1.0e5, 0.0),
+            );
+
+            roverMenuEntries.push({
+              text: entityId,
+              onselect: () => onSelectRover(outRover),
+            });
+
+            return outRover;
+          };
+
+          curiosity = setupRover("Curiosity", 3, curiosity);
+          perseverance = setupRover("Perseverance", 13, perseverance);
+          ingenuity = dataSource.entities.getById("Ingenuity"); // Only for viewing - no data for flight paths
+          theMartianJourney = dataSource.entities.getById("TheMartianJourney");
+          theMartianJourney.polyline.width = createWidthCallbackProperty(
+            new Cesium.NearFarScalar(0.0, 10.0, 1.0e7, 0.0),
+          );
+          theMartianJourney.rectangle.material = new Cesium.ImageMaterialProperty({
+            image: createCanvasAsTexture('Mark Watney\'s Journey in "The Martian"'),
+            transparent: true,
+          });
+
+          roverMenuEntries.push({
+            text: '"The Martian" Journey',
+            onselect: () => {
+              reset();
+              viewer.zoomTo(theMartianJourney);
+            },
+          });
+
+          Sandcastle.addToolbarMenu(roverMenuEntries);
+        } catch (error) {
+          console.log(`Error loading CZML: ${error}`);
+        }
+
+        // For changing the width of polylines based on distance from the camera
+        function createWidthCallbackProperty(nearFarScalar) {
+          return new Cesium.CallbackProperty(function () {
+            const distance = viewer.camera.positionCartographic.height;
+            let t =
+              (distance - nearFarScalar.near) / (nearFarScalar.far - nearFarScalar.near);
+            t = Cesium.Math.clamp(t, 0.0, 1.0);
+            return Cesium.Math.lerp(nearFarScalar.nearValue, nearFarScalar.farValue, t);
+          }, false);
+        }
+
+        // Converts a Julian date to a Mars Sol number, given a start date / sol number
+        function createJulianDateToSolConverter(startJulianDate, startSol) {
+          return function (julianDate) {
+            const secondsPerSol = 24 * 60 * 60 + 39 * 60 + 35;
+            const differenceInSeconds = Cesium.JulianDate.secondsDifference(
+              julianDate,
+              startJulianDate,
+            );
+            const solNumber = Math.floor(differenceInSeconds / secondsPerSol) + startSol;
+            return `Sol ${solNumber}`;
+          };
+        }
+
+        // Load points of interest from GeoJSON data source
+        try {
+          const dataSource = await Cesium.GeoJsonDataSource.load(
+            "../../SampleData/MarsPointsOfInterest.geojson",
+          );
+          viewer.dataSources.add(dataSource);
+
+          const onSelectLandmark = (landmark) => {
+            reset();
+            scene.camera.flyTo(landmark);
+          };
+
+          const landmarkMenuEntries = [
+            {
+              text: "Fly to landmark...",
+              onselect: () => {},
+            },
+          ];
+
+          const entities = dataSource.entities.values;
+          entities.forEach((entity) => {
+            entity.label = new Cesium.LabelGraphics({
+              text: entity.properties.text,
+              font: "18pt Verdana",
+              outlineColor: Cesium.Color.DARKSLATEGREY,
+              outlineWidth: 2,
+              style: Cesium.LabelStyle.FILL_AND_OUTLINE,
+              pixelOffset: new Cesium.Cartesian2(0, -22),
+              scaleByDistance: new Cesium.NearFarScalar(1.5e2, 1.0, 1.5e7, 0.5),
+              translucencyByDistance: new Cesium.NearFarScalar(2.5e7, 1.0, 4.0e7, 0.0),
+              heightReference: Cesium.HeightReference.CLAMP_TO_GROUND,
+              disableDepthTestDistance: new Cesium.CallbackProperty(() => {
+                return Cesium.Cartesian3.magnitude(scene.camera.positionWC);
+              }, false),
+            });
+
+            entity.point = new Cesium.PointGraphics({
+              pixelSize: 10,
+              color: Cesium.Color.fromBytes(243, 242, 99),
+              outlineColor: Cesium.Color.fromBytes(219, 218, 111),
+              outlineWidth: 2,
+              scaleByDistance: new Cesium.NearFarScalar(1.5e3, 1.0, 4.0e7, 0.1),
+              heightReference: Cesium.HeightReference.CLAMP_TO_GROUND,
+              disableDepthTestDistance: new Cesium.CallbackProperty(() => {
+                return Cesium.Cartesian3.magnitude(scene.camera.positionWC);
+              }, false),
+            });
+
+            entity.name = entity.properties.text.getValue();
+            entity.description = createPickedFeatureDescription(entity);
+
+            const flyToDestination = new Cesium.Cartesian3.fromArray(
+              entity.properties.destination.getValue(),
+            );
+            const orientationArray = entity.properties.orientation.getValue();
+            const flyToOrientation = new Cesium.HeadingPitchRoll(
+              orientationArray[0],
+              orientationArray[1],
+              orientationArray[2],
+            );
+
+            landmarkMenuEntries.push({
+              text: entity.properties.text.getValue(),
+              onselect: () =>
+                onSelectLandmark({
+                  destination: flyToDestination,
+                  orientation: flyToOrientation,
+                  easingFunction: Cesium.EasingFunction.CUBIC_IN_OUT,
+                  maximumHeight: 5e6,
+                  pitchAdjustHeight: 2.5e6,
+                  duration: 3.0,
+                  complete: function () {
+                    viewer.selectedEntity = entity;
+                    viewer.infoBox.viewModel.showInfo = true;
+                  },
+                }),
+            });
+          });
+
+          Sandcastle.addToolbarMenu(landmarkMenuEntries);
+        } catch (error) {
+          console.log(`Error loading GeoJSON: ${error}`);
+        }
+
+        // Spin Mars on first load but disable the spinning upon any input
+        const rotationSpeed = Cesium.Math.toRadians(0.1);
+        const removeRotation = viewer.scene.postRender.addEventListener(
+          function (scene, time) {
+            viewer.scene.camera.rotateRight(rotationSpeed);
+          },
+        );
+
+        const handler = new Cesium.ScreenSpaceEventHandler(viewer.scene.canvas);
+        handler.setInputAction(
+          () => removeRotation(),
+          Cesium.ScreenSpaceEventType.LEFT_DOWN,
+        );
+        handler.setInputAction(
+          () => removeRotation(),
+          Cesium.ScreenSpaceEventType.RIGHT_DOWN,
+        );
+        handler.setInputAction(
+          () => removeRotation(),
+          Cesium.ScreenSpaceEventType.MIDDLE_DOWN,
+        );
+        handler.setInputAction(() => removeRotation(), Cesium.ScreenSpaceEventType.WHEEL);
+
+        // For drawing attention to the play button in the animation view model
+        function highlightAnimationViewModel() {
+          if (clock.shouldAnimate) {
+            // Animation already playing
+            return;
+          }
+
+          const playPath =
+            viewer.animation.container.querySelector("#animation_pathPlay");
+          const playButton = playPath.closest("g.cesium-animation-rectButton");
+          const ringG = viewer.animation.container.querySelector(
+            ".cesium-animation-shuttleRingG",
+          );
+          playButton.classList.add("highlight-animation");
+          ringG.classList.add("highlight-animation");
+
+          playButton.addEventListener("click", removeHighlight, { once: true });
+          setTimeout(removeHighlight, 30000); // Remove after 30 seconds if not clicked
+        }
+
+        function removeHighlight() {
+          const playPath =
+            viewer.animation.container.querySelector("#animation_pathPlay");
+          const playButton = playPath.closest("g.cesium-animation-rectButton");
+          const ringG = viewer.animation.container.querySelector(
+            ".cesium-animation-shuttleRingG",
+          );
+          playButton.classList.remove("highlight-animation");
+          ringG.classList.remove("highlight-animation");
+        }
+
+        function reset() {
+          clock.multiplier = 1;
+          viewer.selectedEntity = undefined;
+          viewer.trackedEntity = undefined;
+          viewer.timeline.zoomTo(clock.startTime, clock.stopTime);
+          removeRotation();
+          removeHighlight();
+        }
+
+        // Add a listener for when the home button is clicked.
+        viewer.homeButton.viewModel.command.beforeExecute.addEventListener(
+          function (commandInfo) {
+            reset();
+          },
+        );
+
+        // When animating, if the multiplier is very high (which is necessary to see rover movement),
+        // model lighting flickers distractingly, so disable it
+        const entitiesToDisableLightingFor = [curiosity, perseverance, ingenuity];
+        Cesium.knockout
+          .getObservable(viewer.clockViewModel, "shouldAnimate")
+          .subscribe(function (shouldAnimate) {
+            if (shouldAnimate && clock.multiplier >= 100000) {
+              entitiesToDisableLightingFor.forEach(function (entity) {
+                entity.model.lightColor = new Cesium.Color(0, 0, 0);
+              });
+            } else {
+              entitiesToDisableLightingFor.forEach(function (entity) {
+                entity.model.lightColor = new Cesium.Color(1, 1, 1);
+              });
+            }
+          });
+
+        // To create a rectangle with text that conforms to the terrain, we can create a canvas
+        // with text and use it as a texture on a rectangle entity.
+        function createCanvasAsTexture(text) {
+          const canvas = document.createElement("canvas");
+          canvas.width = 1024;
+          canvas.height = 256;
+
+          const ctx = canvas.getContext("2d");
+          // Background
+          ctx.fillStyle = "rgba(0, 0, 0, 0)";
+          ctx.fillRect(0, 0, canvas.width, canvas.height);
+
+          // Text
+          ctx.font = "36px sans-serif";
+          ctx.textAlign = "center";
+          ctx.textBaseline = "middle";
+          ctx.strokeStyle = "rgba(0,0,0,0.1)";
+          ctx.lineWidth = 1;
+          ctx.fillStyle = "#ffffff";
+
+          ctx.strokeText(text, canvas.width / 2, canvas.height / 2);
+          ctx.fillText(text, canvas.width / 2, canvas.height / 2);
+
+          return canvas;
+        }
+
+        // Create the HTML that will be put into the info box that shows
+        // information about the currently selected feature
+        function createPickedFeatureDescription(entity) {
+          return `<img\
+              width="50%"\
+              style="float:left; margin: 0 1em 1em 0;"\
+              src=${entity.properties.imageURL}>\
+            <p>${entity.properties.description}</p>\
+            <p>\
+              Source: \
+              <a style="color: WHITE"\
+                target="_blank"\
+                href="${entity.properties.sourceURL}">${entity.properties.source}</a>\
+            </p>`;
+        }
+
+        // Inject instructions for interacting with the rovers into the navigation help menu
+        function addRoverInstructionsToNavMenu() {
+          const div = document.querySelector(
+            ".cesium-click-navigation-help.cesium-navigation-help-instructions",
+          );
+          const table = div.querySelector("table");
+
+          const instructions1 = document.getElementById("roverHelpRowTemplate1");
+          const instructions1Clone = instructions1.content.cloneNode(true);
+          const img = instructions1Clone.querySelector("img[data-src]");
+          img.src = Cesium.buildModuleUrl(img.dataset.src);
+          table.tBodies[0].appendChild(instructions1Clone);
+
+          const instructions2 = document.getElementById("roverHelpRowTemplate2");
+          const instructions2Clone = instructions2.content.cloneNode(true);
+          table.tBodies[0].appendChild(instructions2Clone);
+        }
+        addRoverInstructionsToNavMenu();
+        //Sandcastle_End
+      };
+      if (typeof Cesium !== "undefined") {
+        window.startupCalled = true;
+        window.startup(Cesium).catch((error) => {
+          "use strict";
+          console.error(error);
+        });
+        Sandcastle.finishedLoading();
+      }
+    </script>
+  </body>
+</html>

Apps/Sandcastle/gallery/VolumeCloud.html

@@ -11,7 +11,7 @@
       name="description"
       content="Rendering Volume Cloud with Texture3D and Custom GLSL. Transplanted from Three.js"
     />
-    <meta name="cesium-sandcastle-labels" content="Development" />
+    <meta name="cesium-sandcastle-labels" content="Tutorials,Showcases" />
     <title>Cesium Demo</title>
     <script type="text/javascript" src="../Sandcastle-header.js"></script>
     <script

Apps/Sandcastle/gallery/Voxel Picking.html

@@ -80,15 +80,17 @@
           this.names = ["color"];
           this.types = [Cesium.MetadataType.VEC4];
           this.componentTypes = [Cesium.MetadataComponentType.FLOAT32];
-          this._levelCount = 3;
+          this.availableLevels = 3;
           this.globalTransform = globalTransform;
         }
 
         ProceduralMultiTileVoxelProvider.prototype.requestData = function (options) {
           const { tileLevel, tileX, tileY, tileZ } = options;
 
-          if (tileLevel >= this._levelCount) {
-            return Promise.reject(`No tiles available beyond level ${this._levelCount}`);
+          if (tileLevel >= this.availableLevels) {
+            return Promise.reject(
+              `No tiles available beyond level ${this.availableLevels - 1}`,
+            );
           }
 
           const dimensions = this.dimensions;
@@ -174,6 +176,7 @@
             customShader: customShader,
           });
           voxelPrimitive.nearestSampling = true;
+          voxelPrimitive.stepSize = 0.7;
 
           viewer.scene.primitives.add(voxelPrimitive);
           camera.flyToBoundingSphere(voxelPrimitive.boundingSphere, {

Apps/Sandcastle/gallery/Voxels.html

@@ -123,14 +123,14 @@
           this.componentTypes = [Cesium.MetadataComponentType.FLOAT32];
           this.globalTransform = globalTransform;
 
-          this._levelCount = 2;
-          this._allVoxelData = new Array(this._levelCount);
+          this.availableLevels = 2;
+          this._allVoxelData = new Array(this.availableLevels);
 
           const allVoxelData = this._allVoxelData;
           const channelCount = Cesium.MetadataType.getComponentCount(this.types[0]);
           const { dimensions } = this;
 
-          for (let level = 0; level < this._levelCount; level++) {
+          for (let level = 0; level < this.availableLevels; level++) {
             const dimAtLevel = Math.pow(2, level);
             const voxelCountX = dimensions.x * dimAtLevel;
             const voxelCountY = dimensions.y * dimAtLevel;
@@ -158,9 +158,9 @@
         ProceduralMultiTileVoxelProvider.prototype.requestData = function (options) {
           const { tileLevel, tileX, tileY, tileZ } = options;
 
-          if (tileLevel >= this._levelCount) {
+          if (tileLevel >= this.availableLevels) {
             return Promise.reject(
-              `No tiles available beyond level ${this._levelCount - 1}`,
+              `No tiles available beyond level ${this.availableLevels - 1}`,
             );
           }
 

Apps/Sandcastle/gallery/development/Shared Context.html

@@ -0,0 +1,123 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no"
+    />
+    <meta name="description" content="Multiple views synced across time and space." />
+    <meta name="cesium-sandcastle-labels" content="Beginner, Showcases,New in 1.129" />
+    <title>Cesium Demo</title>
+    <script type="text/javascript" src="../Sandcastle-header.js"></script>
+    <script type="module" src="../load-cesium-es6.js"></script>
+  </head>
+  <body class="sandcastle-loading" data-sandcastle-bucket="bucket-requirejs.html">
+    <style>
+      @import url(../templates/bucket.css);
+      #cesiumContainer {
+        display: flex;
+        width: 100%;
+        height: 100%;
+      }
+      #view3D {
+        display: inline-block;
+        width: 100%;
+      }
+      #view2D {
+        display: inline-block;
+        width: 100%;
+      }
+    </style>
+    <div id="cesiumContainer" class="fullSize">
+      <div id="view3D"></div>
+      <div id="view2D"></div>
+    </div>
+    <div id="loadingOverlay"><h1>Loading...</h1></div>
+    <div id="toolbar"></div>
+    <script id="cesium_sandcastle_script">
+      window.startup = async function (Cesium) {
+        "use strict";
+        //Sandcastle_Begin
+        const contextOptions = new Cesium.SharedContext();
+        // const contextOptions = undefined;
+        // Uncomment the line above and comment out the one preceding it to illustrate how primitives cannot be shared between scenes by default.
+
+        const options = {
+          contextOptions,
+          fullscreenButton: false,
+          sceneModePicker: false,
+        };
+
+        const view1 = new Cesium.Viewer("view3D", options);
+        const view2 = new Cesium.Viewer("view2D", options);
+
+        // Add the same entity to both viewers. Each viewer will create separate WebGL resources to draw it.
+        const greenCylinder = {
+          name: "Green cylinder with black outline",
+          position: Cesium.Cartesian3.fromDegrees(-100.0, 40.0, 200000.0),
+          cylinder: {
+            length: 400000.0,
+            topRadius: 200000.0,
+            bottomRadius: 200000.0,
+            material: Cesium.Color.GREEN.withAlpha(0.5),
+            outline: true,
+            outlineColor: Cesium.Color.BLACK,
+          },
+        };
+
+        view1.entities.add(greenCylinder);
+        view2.entities.add(greenCylinder);
+
+        // Add the same cylinder primitive to both viewers. Each will use the same WebGL resources to draw it.
+        const cylinder = new Cesium.CylinderGeometry({
+          length: 400000.0,
+          topRadius: 200000.0,
+          bottomRadius: 200000.0,
+        });
+        const geometry = Cesium.CylinderGeometry.createGeometry(cylinder);
+        const primitive = new Cesium.Primitive({
+          geometryInstances: new Cesium.GeometryInstance({
+            geometry,
+            modelMatrix: Cesium.Matrix4.multiplyByTranslation(
+              Cesium.Transforms.eastNorthUpToFixedFrame(
+                Cesium.Cartesian3.fromDegrees(-95.59777, 40.03883),
+              ),
+              new Cesium.Cartesian3(0.0, 0.0, 500000.0),
+              new Cesium.Matrix4(),
+            ),
+            id: "red cylinder",
+            attributes: {
+              color: Cesium.ColorGeometryInstanceAttribute.fromColor(Cesium.Color.RED),
+            },
+          }),
+          appearance: new Cesium.PerInstanceColorAppearance(),
+          asynchronous: false,
+        });
+
+        view1.scene.primitives.add(primitive);
+        view2.scene.primitives.add(primitive);
+
+        // Add the same tileset to both viewers. Each viewer will use the same WebGL resources to draw it.
+        const tileset = await Cesium.Cesium3DTileset.fromIonAssetId(2464651);
+        for (const view of [view1, view2]) {
+          view.scene.primitives.add(tileset);
+          view.zoomTo(
+            tileset,
+            new Cesium.HeadingPitchRange(0.5, -0.2, tileset.boundingSphere.radius * 4.0),
+          );
+        }
+        //Sandcastle_End
+        Sandcastle.finishedLoading();
+      };
+      if (typeof Cesium !== "undefined") {
+        window.startupCalled = true;
+        window.startup(Cesium).catch((error) => {
+          "use strict";
+          console.error(error);
+        });
+      }
+    </script>
+  </body>
+</html>

Apps/Sandcastle/gallery/iModel Mesh Export Service.html

@@ -110,12 +110,12 @@
         }
 
         // Create tilesets using the iModel ids
-        const surroundingArea = await Cesium.ITwinData.createTilesetFromIModelId(
-          "f856f57d-3d28-4265-9c4f-5e60c0662c15",
-        );
-        const station = await Cesium.ITwinData.createTilesetFromIModelId(
-          "669dde67-eb69-4e0b-bcf2-f722eee94746",
-        );
+        const surroundingArea = await Cesium.ITwinData.createTilesetFromIModelId({
+          iModelId: "f856f57d-3d28-4265-9c4f-5e60c0662c15",
+        });
+        const station = await Cesium.ITwinData.createTilesetFromIModelId({
+          iModelId: "669dde67-eb69-4e0b-bcf2-f722eee94746",
+        });
         // Change how highlighting with the feature selection changes the color
         surroundingArea.colorBlendMode = Cesium.Cesium3DTileColorBlendMode.REPLACE;
         station.colorBlendMode = Cesium.Cesium3DTileColorBlendMode.REPLACE;
@@ -124,12 +124,10 @@
         scene.primitives.add(station);
 
         // Create tileset of the reality data mesh
-        const iTwinId = "535a24a3-9b29-4e23-bb5d-9cedb524c743";
-        const realityMeshId = "85897090-3bcc-470b-bec7-20bb639cc1b9";
-        const realityMesh = await Cesium.ITwinData.createTilesetForRealityDataId(
-          iTwinId,
-          realityMeshId,
-        );
+        const realityMesh = await Cesium.ITwinData.createTilesetForRealityDataId({
+          iTwinId: "535a24a3-9b29-4e23-bb5d-9cedb524c743",
+          realityDataId: "85897090-3bcc-470b-bec7-20bb639cc1b9",
+        });
         scene.primitives.add(realityMesh);
 
         Sandcastle.addToolbarButton(

Apps/Sandcastle/gallery/iTwin Feature Service.html

@@ -66,18 +66,18 @@
         viewer.scene.camera.flyTo(birdsEyeView);
 
         // Load feature service geojson files
-        const points = await Cesium.ITwinData.loadGeospatialFeatures(
-          iTwinId,
-          "2380dc1b-1dac-4709-aa5c-f6cb38c4e9f5",
-        );
-        const lines = await Cesium.ITwinData.loadGeospatialFeatures(
-          iTwinId,
-          "613d2310-4d01-43b7-bc92-873a2ca4a4a0",
-        );
-        const areas = await Cesium.ITwinData.loadGeospatialFeatures(
-          iTwinId,
-          "93e7ef51-5210-49f2-92a3-c7f6685e102f",
-        );
+        const points = await Cesium.ITwinData.loadGeospatialFeatures({
+          iTwinId: iTwinId,
+          collectionId: "2380dc1b-1dac-4709-aa5c-f6cb38c4e9f5",
+        });
+        const lines = await Cesium.ITwinData.loadGeospatialFeatures({
+          iTwinId: iTwinId,
+          collectionId: "613d2310-4d01-43b7-bc92-873a2ca4a4a0",
+        });
+        const areas = await Cesium.ITwinData.loadGeospatialFeatures({
+          iTwinId: iTwinId,
+          collectionId: "93e7ef51-5210-49f2-92a3-c7f6685e102f",
+        });
 
         // Add some styling to the lines and points to differentiate types
         const pinBuilder = new Cesium.PinBuilder();
@@ -118,17 +118,15 @@
         viewer.dataSources.add(areas);
 
         // Create tileset of the reality data mesh and pointcloud
-        const realityMeshId = "62e4432d-621d-489a-87ff-1fc56a2b5369";
-        const realityMesh = await Cesium.ITwinData.createTilesetForRealityDataId(
-          iTwinId,
-          realityMeshId,
-        );
+        const realityMesh = await Cesium.ITwinData.createTilesetForRealityDataId({
+          iTwinId: iTwinId,
+          realityDataId: "62e4432d-621d-489a-87ff-1fc56a2b5369",
+        });
         viewer.scene.primitives.add(realityMesh);
-        const pointcloudId = "ebf2ee74-f0de-4cd6-a311-19a169c55fdc";
-        const pointcloud = await Cesium.ITwinData.createTilesetForRealityDataId(
-          iTwinId,
-          pointcloudId,
-        );
+        const pointcloud = await Cesium.ITwinData.createTilesetForRealityDataId({
+          iTwinId: iTwinId,
+          realityDataId: "ebf2ee74-f0de-4cd6-a311-19a169c55fdc",
+        });
         // increase the size of the pointcloud points and turn on attenuation to
         // make them more visible in the viewer
         pointcloud.maximumScreenSpaceError = 1;

Apps/Sandcastle/index.html

@@ -76,6 +76,15 @@
       data-dojo-type="dijit.layout.BorderContainer"
       data-dojo-props="design: 'headline', gutters: true, liveSplitters: true"
     >
+      <div
+        id="banner"
+        data-dojo-type="dijit.layout.ContentPane"
+        data-dojo-props="region: 'top'"
+      >
+        <a href="https://sandcastle.cesium.com"
+          >Try the new version of Sandcastle today!</a
+        >
+      </div>
       <div
         id="toolbar"
         data-dojo-type="dijit.Toolbar"
@@ -341,36 +350,8 @@
             </div>
           </div>
         </div>
-        <div
-          class="feedback"
-          data-dojo-type="dijit.layout.TabContainer"
-          data-dojo-props="region: 'right'"
-        >
-          <div
-            class="future-banner"
-            data-dojo-type="dijit.layout.ContentPane"
-            data-dojo-props="title: 'Feedback'"
-          >
-            <h3>Help needed</h3>
-            <p>
-              We're currently gathering user feedback to make Sandcastle even
-              better.
-            </p>
-            <button data-dojo-type="dijit/form/Button" type="button">
-              Please share your thoughts!
-              <script
-                type="dojo/on"
-                data-dojo-event="click"
-                data-dojo-args="evt"
-              >
-                window.open("https://community.cesium.com/t/upgrading-sandcastle-we-need-your-input/39715/", "_blank")
-              </script>
-            </button>
-          </div>
-        </div>
       </div>
     </div>
-
     <div class="dijitTooltip dijitTooltipBelow" id="docPopup">
       <div
         class="dijitTooltipContainer dijitTooltipContents"

CHANGES.md

@@ -1,21 +1,146 @@
 # Change Log
 
-## 1.131.1-ion.1 - 2025-07-22
+## 1.136 - 2025-12-01
 
 ### @cesium/engine
 
 #### Fixes :wrench:
 
-- Fixes Gaussian splats incorrectly rendering when `Cesium3DTileset.show` is `false`. [#12748](https://github.com/CesiumGS/cesium/pull/12748)
+- Fixed depth testing bug with billboards and labels clipping through models [#13012](https://github.com/CesiumGS/cesium/issues/13012)
+- Billboards using `imageSubRegion` now render as expected. [#12585](https://github.com/CesiumGS/cesium/issues/12585)
+- Improved scaling of SVGs in billboards [#13020](https://github.com/CesiumGS/cesium/issues/13020)
+- Fixed unexpected outline artifacts around billboards [#13038](https://github.com/CesiumGS/cesium/issues/13038)
 
-## 1.131.1-ion.0 - 2025-07-17
+#### Additions :tada:
+
+- Added `scene.pickAsync` for non GPU blocking picking using WebGL2 [#12983](https://github.com/CesiumGS/cesium/pull/12983)
+- Improves performance of terrain picks via new terrain picking quadtrees [#8481](https://github.com/CesiumGS/cesium/issues/8481)
+
+## 1.135 - 2025-11-03
+
+### @cesium/engine
+
+#### Breaking Changes :mega:
+
+- Removed support for the `KHR_spz_gaussian_splats_compression` extension in favor of the latest 3D Gaussian splatting extensions for glTF, `KHR_gaussian_splatting` and `KHR_gaussian_splatting_compression_spz_2`. Please re-tile existing Gaussian splatting 3D Tiles [#12837](https://github.com/CesiumGS/cesium/issues/12837)
+- `scene.drillPick` now uses a breadth-first search strategy instead of depth-first. This may change which entities are picked when using large values of `width` and `height` when providing a `limit`, prioritizing entities closer to the camera. [#12916](https://github.com/CesiumGS/cesium/pull/12916)
+
+#### Additions :tada:
+
+- Added experimental support for loading 3D Tiles as terrain, via `Cesium3DTilesTerrainProvider`. See [the PR](https://github.com/CesiumGS/cesium/pull/12963) for limitations on the types of 3D Tiles that can be used. [#12296](https://github.com/CesiumGS/cesium/issues/12296)
+- Added support for [EXT_mesh_primitive_edge_visibility](https://github.com/KhronosGroup/glTF/pull/2479) glTF extension. [#12765](https://github.com/CesiumGS/cesium/issues/12765)
+
+#### Fixes :wrench:
+
+- Improved performance of `scene.drillPick`. [#12916](https://github.com/CesiumGS/cesium/pull/12916)
+- Improved performance when removing primitives. [#3018](https://github.com/CesiumGS/cesium/pull/3018)
+- Improved performance of terrain Quadtree handling of custom data [#12907](https://github.com/CesiumGS/cesium/pull/12907)
+- Fixed vertical exaggeration of ellipsoid-shaped voxels. [#12811](https://github.com/CesiumGS/cesium/issues/12811)
+- Fixed parsing content bounding volumes contained in 3D Tiles 1.1 subtree files. [#12972](https://github.com/CesiumGS/cesium/pull/12972)
+- Fixes an event bug following recent changes, where adding a new listener during an event callback caused an infinite loop. [#12955](https://github.com/CesiumGS/cesium/pull/12955)
+- Fix issues with label background when updating properties while `label.show` is `false`. [#12138](https://github.com/CesiumGS/cesium/issues/12138)
+- Fixed picking of `GroundPrimitive` with multiple `PolygonGeometry` instances selecting the wrong instance. [#12978](https://github.com/CesiumGS/cesium/pull/12978)
+- Fixed a bug where the removal of draped imagery layers did not update the rendered state [#12923](https://github.com/CesiumGS/cesium/issues/12923)
+- Fixed precision issues with Gaussian splat tilesets where the root tile does not have a world transform. [#12925](https://github.com/CesiumGS/cesium/issues/12925)
+- Fixed infinite recursion that would happen if user append post-render callbacks within existing callbacks [#12983](https://github.com/CesiumGS/cesium/pull/12983)
+
+## 1.134.1 - 2025-10-10
 
 ### @cesium/engine
 
 #### Fixes :wrench:
 
+- Fixed an event bug following recent changes, where adding a new listener during an event callback caused an infinite loop. [#12955](https://github.com/CesiumGS/cesium/pull/12955)
+
+## 1.134 - 2025-10-01
+
+- [Sandcastle](https://sandcastle.cesium.com/) has been updated at `https://sandcastle.cesium.com`! The [legacy Sandcastle app](https://cesium.com/downloads/cesiumjs/releases/1.134/Apps/Sandcastle/index.html) will remain available through November 3, 2025.
+
+### @cesium/engine
+
+#### Breaking Changes :mega:
+
+- Voxel rendering now requires a WebGL2 context, which is [enabled by default since 1.101](https://github.com/CesiumGS/cesium/pull/10894). Make sure the `requestWebGl1` flag in `contextOptions` is NOT set to true.
+- The `defaultValue` function has been removed. Instead, use the [nullish coalescing (`??`)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing) operator. See the [Coding Guide](https://github.com/CesiumGS/cesium/tree/main/Documentation/Contributors/CodingGuide#default-parameter-values) for usage information and examples.
+- `defaultValue.EMPTY_OBJECT` has been removed. Instead, use `Frozen.EMPTY_OBJECT`. See the [Coding Guide](https://github.com/CesiumGS/cesium/tree/main/Documentation/Contributors/CodingGuide#default-parameter-values) for usage information and examples.
+
+#### Additions :tada:
+
+- Added Google2DImageryProvider to load imagery from [Google Maps](https://developers.google.com/maps/documentation/tile/2d-tiles-overview) [#12913](https://github.com/CesiumGS/cesium/pull/12913)
+- Added an async factory method for the Material class that allows callers to wait on resource loading. [#10566](https://github.com/CesiumGS/cesium/issues/10566)
+
+#### Fixes :wrench:
+
+- Fixed vertical misalignment of glyphs in labels with small fonts [#8474](https://github.com/CesiumGS/cesium/issues/8474)
+- Converted voxel raymarching to eye coordinates to fix precision issues in large datasets. [#12061](https://github.com/CesiumGS/cesium/issues/12061)
+- Fixed flickering artifact in Gaussian splat models caused by incorrect sorting results. [#12662](https://github.com/CesiumGS/cesium/issues/12662)
+- Fixed issue where multiple instances of a Gaussian splat tileset would transform tile positions incorrectly and render out of position. [#12795](https://github.com/CesiumGS/cesium/issues/12795)
+- Fixed rendering for geometry entities when `requestRenderMode` is enabled. [#12841](https://github.com/CesiumGS/cesium/pull/12841)
+- Improved performance and reduced memory usage of `Event` class. [#12896](https://github.com/CesiumGS/cesium/pull/12896)
+- Improved performance of clamped labels. [#12905](https://github.com/CesiumGS/cesium/pull/12905)
+- Materials loaded from type now respect submaterials present in the referenced material type. [#10566](https://github.com/CesiumGS/cesium/issues/10566)
+- Prevent runtime errors for certain forms of invalid PNTS files [#12872](https://github.com/CesiumGS/cesium/issues/12872)
+- Revert `createImageBitmap` options update to continue support for older browsers [#12846](https://github.com/CesiumGS/cesium/issues/12846)
+
+## 1.133.1 - 2025-09-08
+
+This is an npm-only release to fix a dependency issue published in 1.133.0
+
+## 1.133 - 2025-09-02
+
+- Give the [new version of Sandcastle](https://dev-sandcastle.cesium.com/) a try today!
+
+### @cesium/engine
+
+#### Breaking Changes :mega:
+
+- Removed the argument fallback in `ITwinData.*` functions. Instead, use the new options argument signature. [#12778](https://github.com/CesiumGS/cesium/issues/12778)
+
+#### Additions :tada:
+
+- Added support for the [EXT_mesh_primitive_restart](https://github.com/KhronosGroup/glTF/pull/2478) glTF extension. [#12764](https://github.com/CesiumGS/cesium/issues/12764)
+- Added spherical harmonics support for Gaussian splats, supported with the SPZ compression format. [#12790](https://github.com/CesiumGS/cesium/pull/12790)
+- Added `Ellipsoid.MARS` for use with Mars terrain and imagery. [#12828](https://github.com/CesiumGS/cesium/pull/12828)
+- Allow passing `Cesium3DTileset` constructor options to the tileset that is created with `ITwinData.createTilesetForRealityDataId`. [#12709](https://github.com/CesiumGS/cesium/issues/12709)
+
+#### Fixes :wrench:
+
+- Fixed issue where a Gaussian splat tileset would be rendered even if out of current camera view. [#12840](https://github.com/CesiumGS/cesium/pull/12840)
+- Removes the minimum tile threshold of four for WMTS. [#4372](https://github.com/CesiumGS/cesium/issues/4372)
+- Fixed a crash when loading PNTS (point cloud) data that contained a batch table without a binary part. [#11166](https://github.com/CesiumGS/cesium/issues/11166)
+- Fixed an error picking an area hidden by a `ClippingPolygon`. [#12725](https://github.com/CesiumGS/cesium/issues/12725)
+
+#### Deprecated :hourglass_flowing_sand:
+
+- Deprecated support for the `KHR_spz_gaussian_splats_compression` extension in favor of the latest 3D Gaussian splatting extensions for glTF, `KHR_gaussian_splatting` and `KHR_gaussian_splatting_compression_spz_2`. The deprecated extension will be removed in version 1.135. To ensure support in CesiumJS 1.135 and beyond, Please re-tile existing Gaussian splatting 3D Tiles before November 1, 2025. [#12837](https://github.com/CesiumGS/cesium/issues/12837)
+
+## 1.132 - 2025-08-01
+
+### @cesium/engine
+
+#### Fixes :wrench:
+
+- Fixes incorrect polygon culling in 2D scene mode. [#1552](https://github.com/CesiumGS/cesium/issues/1552)
+- Fixes material flashing when changing properties. [#1640](https://github.com/CesiumGS/cesium/issues/1640), [#12716](https://github.com/CesiumGS/cesium/issues/12716)
+- Fixed an issue where draped imagery on tilesets was not updated based on the visibility of the imagery layer. [#12742](https://github.com/CesiumGS/cesium/issues/12742)
 - Fixes an exception when removing a Gaussian splat tileset from the scene primitives when it has more than one tile. [#12726](https://github.com/CesiumGS/cesium/pull/12726)
 - Fixes rendering of Gaussian splats when they are scaled by the glTF transform, tileset transform, or model matrix. [#12721](https://github.com/CesiumGS/cesium/issues/12721), [#12718](https://github.com/CesiumGS/cesium/issues/12718)
+- Fixes label background translucency issue. [#12673](https://github.com/CesiumGS/cesium/issues/12673)
+- Updated the type of many properties and functions of `Scene` to clarify that they may be `undefined`. For the full list check PR: [#12736](https://github.com/CesiumGS/cesium/pull/12736)
+- Fixes Gaussian splats incorrectly rendering when `Cesium3DTileset.show` is `false`. [#12748](https://github.com/CesiumGS/cesium/pull/12748)
+- Fixed the PointCloudShading.normalShading parameter, to disable normal shading when set to false, even if the point cloud contains normals. [#11196](https://github.com/CesiumGS/cesium/issues/11196)
+- Updated GPU vertex transformations to reduce precision errors. [#4250](https://github.com/CesiumGS/cesium/issues/4250)
+- Fixes Gaussian splats orientation with respect to glTF up-axis by updating `spz-loader` to version `0.3.0`. [#12737](https://github.com/CesiumGS/cesium/issues/12737), [#12749](https://github.com/CesiumGS/cesium/issues/12749)
+
+#### Additions :tada:
+
+- Expand the CustomShader Sample to support real-time modification of CustomShader. [#12702](https://github.com/CesiumGS/cesium/pull/12702)
+- Add wrapR property to Sampler and Texture3D, to support the newly added third dimension wrap.[#12701](https://github.com/CesiumGS/cesium/pull/12701)
+- Added the ability to load a specific changeset for iTwin Mesh Exports using `ITwinData.createTilesetFromIModelId` [#12778](https://github.com/CesiumGS/cesium/issues/12778)
+
+#### Deprecated :hourglass_flowing_sand:
+
+- Updated all of the `ITwinData.*` functions to accept an `options` parameter instead of individual arguments to avoid confusion with multiple optional arguments. There is a fallback to the old signature that will be removed in 1.133 [#12778](https://github.com/CesiumGS/cesium/issues/12778)
 
 ## 1.131 - 2025-07-01
 
@@ -2437,11 +2562,13 @@ _This is an npm-only release to fix a publishing issue_.
 
 - Clipping planes on tilesets now use the root tile's transform, or the root tile's bounding sphere if a transform is not defined. [#7034](https://github.com/CesiumGS/cesium/pull/7034)
   - This is to make clipping planes' coordinates always relative to the object they're attached to. So if you were positioning the clipping planes as in the example below, this is no longer necessary:
+
   ```javascript
   clippingPlanes.modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(
     tileset.boundingSphere.center,
   );
   ```
+
   - This also fixes several issues with clipping planes not using the correct transform for tilesets with children.
 
 ### Additions :tada:
@@ -4287,6 +4414,7 @@ _This is an npm-only release to fix a publishing issue_.
                 isStopIncluded : true,
                 data : data
             });
+
     - `TimeInterval.fromIso8601` now takes a single options parameter. Code that looked like:
 
             TimeInterval.fromIso8601(intervalString, true, true, data);
@@ -4299,6 +4427,7 @@ _This is an npm-only release to fix a publishing issue_.
                 isStopIncluded : true,
                 data : data
             });
+
     - `interval.intersect(otherInterval)` -> `TimeInterval.intersect(interval, otherInterval)`
     - `interval.contains(date)` -> `TimeInterval.contains(interval, date)`
 

CONTRIBUTORS.md

@@ -101,6 +101,11 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute to Cesiu
 - [Bentley Systems, Inc.](https://www.bentley.com)
   - [Paul Connelly](https://github.com/pmconne)
   - [Jason Crow](https://github.com/jason-crow)
+  - [Erin Ingram](https://github.com/eringram)
+  - [Daniel Zhong](https://github.com/danielzhong)
+  - [Mark Schlosser](https://github.com/markschlosseratbentley)
+  - [Adam Larkeryd](https://github.com/alarkbentley)
+  - [Don McCurdy](https://github.com/donmccurdy)
 - [Flightradar24 AB](https://www.flightradar24.com)
   - [Aleksei Kalmykov](https://github.com/kalmykov)
 - [BIT Systems](http://www.caci.com/bit-systems)
@@ -415,6 +420,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute to Cesiu
 - [Kirn Kim](https://github.com/squrki)
 - [Emanuele Mastaglia](https://github.com/Masty88)
 - [Connor Manning](https://github.com/connormanning)
+- [Gajanan Gourshettiwar](https://github.com/GGajanan1)
 - [Isaac Young](https://github.com/ibreathebsb)
 - [Nick Crews](https://github.com/NickCrews)
 - [胡文康](https://github.com/XiaoHu1994)
@@ -423,4 +429,11 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute to Cesiu
 - [Andrew Dassonville](https://github.com/andrewda)
 - [Cody Butler](https://github.com/CodyBu)
 - [Hiwen](https://github.com/Hiwen)
+- [Ayush Das](https://github.com/ayushd150)
 - [Matt Schwartz](https://github.com/mzschwartz5)
+- [Easy Mahaffey](https://github.com/easymaahffey)
+- [Pamela Augustine](https://github.com/pamelaAugustine)
+- [宋时旺](https://github.com/BlockCnFuture)
+- [Marco Zhan](https://github.com/marcoYxz)
+- [Mikhail Porotkin](https://github.com/porotkin)
+- [Adam Beili](https://github.com/Beilinson)

Documentation/Contributors/BuildGuide/README.md

@@ -1,15 +1,11 @@
 # Build Guide
 
-- [Build Guide](#build-guide)
-  - [Quickstart](#quickstart)
-  - [Get the Code](#get-the-code)
-  - [Build the Code](#build-the-code)
-    - [Development Server](#development-server)
-    - [Build Output](#build-output)
-  - [Build Scripts](#build-scripts)
-  - [Continuous Integration](#continuous-integration)
-    - [Configure a Different S3 Bucket](#configure-a-different-s3-bucket)
-    - [Configure S3 Credentials](#configure-s3-credentials)
+- [Quickstart](#quickstart)
+- [Get the Code](#get-the-code)
+- [Build the Code](#build-the-code)
+  - [Development Server](#development-server)
+  - [Build Output](#build-output)
+- [Build Scripts](#build-scripts)
 
 ## Quickstart
 
@@ -35,8 +31,6 @@
 
 5. Navigate to : [`http://localhost:8080/`](http://localhost:8080)
 
----
-
 ## Get the Code
 
 - [Setup Git](https://help.github.com/articles/set-up-git/#platform-all) if it isn't already.
@@ -45,6 +39,7 @@
   - Double-check your settings for name and email: `git config --get-regexp user.*`.
   - Recommended Git settings:
     - `git config --global fetch.prune true` - when fetching remote changes, remove any remote branches that no longer exist on the remote.
+    - `git config blame.ignoreRevsFile .git-blame-ignore-revs` - uses the ignore file to skip certain noisy revisions (like formatting) when running git blame. Alternatively, for VSCode users, install the GitLens extension, which will automatically use the ignore file.
 - Have [commit access](https://github.com/CesiumGS/cesium/blob/main/Documentation/Contributors/CommittersGuide/README.md) to CesiumJS?
   - No
     - Fork [cesium](https://github.com/CesiumGS/cesium).
@@ -82,7 +77,7 @@ npm start
 Then browse to [http://localhost:8080/](http://localhost:8080/). The landing page includes apps and tools commonly used during development, including:
 
 - **Hello World** : an example for how to create a 3D globe. [Tutorial here](https://cesium.com/learn/cesiumjs-learn/cesiumjs-quickstart/)
-- **Sandcastle** : an app for viewing and creating [code examples](https://sandcastle.cesium.com?src=Hello%20World.html&label=Showcases), complete with a live preview
+- **Sandcastle** : an app for viewing and creating [code examples](https://sandcastle.cesium.com), complete with a live preview
 - **Test Suites** : tests using [Jasmine](https://jasmine.github.io/). [Testing guide here.](https://github.com/CesiumGS/cesium/blob/main/Documentation/Contributors/TestingGuide/README.md#testing-guide)
 - **Documentation** : reference documentation built from source. [Documentation guide here.](https://github.com/CesiumGS/cesium/blob/main/Documentation/Contributors/DocumentationGuide/README.md#documentation-guide)
 
@@ -161,52 +156,3 @@ Here's the full set of scripts and what they do.
 - **Deployment scripts**
   - `deploy-status` - Sets the deployment statuses in GitHub, for use in CI
   - `deploy-set-version` - Sets the version of `package.json`, for use in CI
-
-## Continuous Integration
-
-Cesium uses [GitHub Actions](https://docs.github.com/en/actions) for continuous integration. Reusable actions are defined in `/.github/actions/` and workflows in `.github/workflows/`.
-
-(Although outdated, the blog post [Cesium Continuous Integration](http://cesium.com/blog/2016/04/07/Cesium-Continuous-Integration/) contains background on the CesiumJS CI process.)
-
-A workflow is triggered whenever someone pushes code to the Cesium repository, or an external contributor opens a pull request. After the build has completed, at the bottom of the pull request page the status of the build is shown. In the dropdown menu, individual checks are displayed. Logs and deployed artifacts can be accessed by clicking the "Details" link.
-
-![GitHub Action Checks](github_action_checks.png)
-
-The build of any branch of CesiumJS can be accessed under the [Branches](https://github.com/CesiumGS/cesium/branches/all) page, and clicking the icon next to the branch name.
-
-![GitHub Branches](github_branches.png)
-
-Additional set up is required for deployment if you do not have commit access to Cesium.
-
-### Configure a Different S3 Bucket
-
-It is possible to configure your development branch of CesiumJS to deploy build artifacts to a different [AWS S3 Bucket](http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html). If you are using the cesium-public-builds bucket and have valid credentials, skip to [Configure S3 Credentials](#configure-s3-credentials)
-
-- In `.gtihub/workflows/dev.yml`, in the following lines, replace "cesium-public-builds" with the name of your S3 bucket.
-
-```yml
-aws s3 sync ./Build/Coverage s3://cesium-public-builds/cesium/$BRANCH/Build/Coverage --delete --color on
-```
-
-```yml
-aws s3 sync Build/unzipped/ s3://cesium-public-builds/cesium/$BRANCH/Build/ --cache-control "no-cache" --delete
-```
-
-- In `gulpfile.js`, edit the following line:
-
-```javascript
-const devDeployUrl = "https://ci-builds.cesium.com/cesium/";
-```
-
-- Edit the URL to match the URL hosting the S3 bucket specified in the previous step.
-
-### Configure S3 Credentials
-
-To configure CI for deployment for a fork of Cesium, you must have valid credentials to an S3 bucket.
-
-- Go to your fork of Cesium
-- Click the **Setting** tab
-- In the left sidebar, under the **Security** section, click **Secrets and Variables** > **Actions**
-- Under **Repository secrets** add two environment variables, `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY`, with your access key and secret key
-
-![GitHub Environment Variables](github_environment_variables.png)

Documentation/Contributors/ContinuousIntegration/README.md

@@ -0,0 +1,76 @@
+# Continuous Integration
+
+- [Background](#background)
+- [Actions and workflows](#actions-and-workflows)
+- [Continuous deployment](#continuous-deployment)
+- [Configuration](#configuration)
+  - [Configure a different S3 bucket](#configure-a-different-s3-bucket)
+  - [Configure S3 credentials](#configure-s3-credentials)
+
+## Background
+
+CesiumJS uses [GitHub Actions](https://docs.github.com/en/actions) for continuous integration (CI).
+
+- [**CI for CesiumJS: A Deep Dive into Our GitHub Actions Workflow** (2024)](https://cesium.com/blog/2024/08/12/ci-for-cesiumjs-github-actions-workflow/)
+- [**Cesium Continuous Integration** (2016)](https://cesium.com/blog/2016/04/07/cesium-continuous-integration/)
+
+## Actions and workflows
+
+Reusable actions are defined in `/.github/actions/` and workflows in `.github/workflows/`.
+
+A workflow is triggered whenever someone pushes code to the CesiumJS repository, or an external contributor opens a pull request. After the build has completed, at the bottom of the pull request page the status of the build is shown. In the dropdown menu, individual checks are displayed. Logs and deployed artifacts can be accessed by clicking the "Details" link.
+
+![GitHub Action Checks](github_action_checks.png)
+
+The workflow checks for any CesiumJS branch are accessible under the [Branches](https://github.com/CesiumGS/cesium/branches/all) page by clicking the icon next to the branch name.
+
+![GitHub Branches](github_branches.png)
+
+## Continuous deployment
+
+Automated deployments make recent code changes available for testing and review without needing to fetch and build locally. We deploy each of the following on a per-branch basis.
+
+| Artifact         | Link (`main` branch)                                                                                                                                                       |
+| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Sandcastle       | [`https://ci-builds.cesium.com/cesium/main/Apps/Sandcastle/index.html`](https://ci-builds.cesium.com/cesium/main/Apps/Sandcastle/index.html)                               |
+| Documentation    | [`https://ci-builds.cesium.com/cesium/main/Build/Documentation/index.html`](https://ci-builds.cesium.com/cesium/main/Build/Documentation/index.html)                       |
+| Coverage results | [`https://ci-builds.cesium.com/cesium/main/Build/Coverage/index.html`](https://ci-builds.cesium.com/cesium/main/Build/Coverage/index.html)                                 |
+| Release zip      | [`https://ci-builds.cesium.com/cesium/main/<github-ref-name>.<github-run-number>.zip`](https://ci-builds.cesium.com/cesium/main/<github-ref-name>.<github-run-number>.zip) |
+| npm package      | [`https://ci-builds.cesium.com/cesium/main/<github-ref-name>.<github-run-number>.tgz`](https://ci-builds.cesium.com/cesium/main/<github-ref-name>.<github-run-number>.tgz) |
+
+## Configuration
+
+Additional set up is required for deployment if you do not have commit access to CesiumJS.
+
+### Configure a different S3 bucket
+
+It is possible to configure your development branch of CesiumJS to deploy build artifacts to a different [AWS S3 Bucket](http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html). If you are using the cesium-public-builds bucket and have valid credentials, skip to [Configure S3 Credentials](#configure-s3-credentials)
+
+- In `.gtihub/workflows/dev.yml`, in the following lines, replace "cesium-public-builds" with the name of your S3 bucket.
+
+```sh
+aws s3 sync ./Build/Coverage s3://cesium-public-builds/cesium/$BRANCH/Build/Coverage --delete --color on
+```
+
+```sh
+aws s3 sync Build/unzipped/ s3://cesium-public-builds/cesium/$BRANCH/Build/ --cache-control "no-cache" --delete
+```
+
+- In `gulpfile.js`, edit the following line:
+
+```javascript
+const devDeployUrl = "https://ci-builds.cesium.com/cesium/";
+```
+
+- Edit the URL to match the URL hosting the S3 bucket specified in the previous step.
+
+### Configure S3 credentials
+
+To configure CI for deployment for a fork of CesiumJS, you must have valid credentials to an S3 bucket.
+
+- Go to your fork of CesiumJS
+- Click the **Setting** tab
+- In the left sidebar, under the **Security** section, click **Secrets and Variables** > **Actions**
+- Under **Repository secrets** add two environment variables, `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY`, with your access key and secret key
+
+![GitHub Environment Variables](github_environment_variables.png)

Documentation/Contributors/README.md

@@ -2,6 +2,7 @@
 
 - [CONTRIBUTING.md](../../CONTRIBUTING.md) - Start here. How to find something to work on, submit issues, and open pull requests.
 - [Build Guide](BuildGuide/README.md) - How to build and run CesiumJS locally.
+- [Continuous Integration Guide](ContinuousIntegration/README.md) - How we use GitHub Actions for continuous integration (CI) and continuous deployment (CD).
 - **IDEs** - use any IDE you want for CesiumJS development. Most contributors use WebStorm (commercial) or VSCode (open source).
   - [VSCode Guide](VSCodeGuide/README.md) - How to set up VSCode.
 - [Coding Guide](CodingGuide/README.md) - JavaScript and GLSL coding conventions and best practices for design, maintainability, and performance.
@@ -12,3 +13,5 @@
 - [Presenter's Guide](PresentersGuide/README.md) - Tips for giving talks.
 - [Committer's Guide](CommittersGuide/README.md) - What to do with commit access to the main CesiumJS repo.
 - [Release Guide](ReleaseGuide/README.md) - How to ship a CesiumJS release.
+  - [Release Schedule](ReleaseGuide//ReleaseSchedule.md) - The upcoming monthly release schedule and the developer responsible for managing each release
+  - [Prelease Guide](ReleaseGuide/Prereleases/README.md) - If and how to publish a prerelease version ahead of the typical monthly release

Documentation/Contributors/ReleaseGuide/PatchReleases/README.md

@@ -0,0 +1,131 @@
+# Patch Releases
+
+Occasionally, we need to release versions of CesiumJS prior to our typical [monthly train releases](../README.md). This can arise because of a critical regression or compatibility issue with the published dependency versions. When this is necessary, we publish a **patch** release[^1]. Tools like npm which use Semantic Versioning will usually use this new version of the package the next time a user runs `npm install` without the user needing to opt-in.
+
+[^1]: See ["About semantic versioning" on docs.npmjs.com](https://docs.npmjs.com/about-semantic-versioning)
+
+## Publishing a patch version
+
+This process is based on an abbreviated version of the [monthly release guide](../README.md). Familiarity with our typical release process is recommended, but not required.
+
+### 1. Create a new branch from the base tag
+
+If no additional commits (besides the intended patch fix) have been merged into `main` since the monthly release, you may create a new branch from `main` and skip step 2. Otherwise, proceed with the steps below.
+
+- Checkout a git tag for the base branch– i.e., use `1.123` in place of `<git-tag>` for the previous monthly release, or `1.123.1` for a subsequent patches applied in the same month.
+- From this branch, create a new branch with any unique `<branch-name>`.
+
+#### Commands
+
+```sh
+git checkout <git-tag>
+git checkout -b <branch-name>
+```
+
+### 2. Cherry pick relevant commits
+
+- Use [`git-cherry-pick`](https://git-scm.com/docs/git-cherry-pick) one or more times to apply select commits to the current branch
+- As necessary, resolve any merge conflicts, add, and continue.
+
+#### Commands
+
+```sh
+git cherry-pick <commit-hash>
+```
+
+### 3. Bump the release version
+
+Use [npm `version` with the `patch` command](https://docs.npmjs.com/cli/v11/commands/npm-version) to bump the version of each workspace and the root package– e.g., `npm version patch --no-git-tag-version`
+
+#### Commands
+
+```sh
+npm version patch --ws --no-git-tag-version
+npm version patch --no-git-tag-version
+```
+
+### 4. Update `CHANGES.md`
+
+- In [`CHANGES.md`](../../../CHANGES.md), create a new header with the version string of root package from the previous step and the date of the release— e.g., if the version string from the previous step is `1.123.1`, `CHANGES.md` should read:
+
+```md
+# Change Log
+
+## 1.123.1 - 2025-07-15
+
+### @cesium/engine
+
+...
+```
+
+- Move any relevant items in the list to the new header in `CHANGES.md`.
+- Delete any empty headers.
+- Ensure each change is nested in the section for the relevant workspace.
+- Commit any staged changes and push to your branch.
+
+### 5. Release build and sanity test
+
+While the full extent of typical release testing is not required, at minimum, create a release build and run the release tests.
+
+- Make sure the repository is clean `git clean -d -x -f --exclude="/Specs/e2e/*-snapshots/"`. **This will delete all files not already in the repository, excluding end to end testing snapshots.**
+- Run `npm install`.
+- Make sure `ThirdParty.json` is up to date by running `npm run build-third-party`. If there are any changes, verify and commit them.
+- Create the release zip `npm run make-zip`.
+- Run tests against the release `npm run test -- --failTaskOnError --release`.
+- Run [Sandcastle](http://localhost:8080/Apps/Sandcastle/index.html) and verify functionality from the patch is working as expected.
+
+### 6. Push and tag the release commit
+
+- Push your commits to the _current_ branch.
+- Create and push a [tag](https://git-scm.com/book/en/v2/Git-Basics-Tagging), e.g., if the version string from previous steps is `1.123.1`, run:
+  - `git tag -a 1.123.1 -m "1.123.1 release"`
+  - `git push origin 1.123.1` (this assumes origin is the primary cesium repository; do not use `git push --tags` as it pushes all tags from all remotes you have on your system)
+
+#### Commands
+
+```sh
+git push
+git tag -a <version-tag> -m "<release-description>"
+git push origin <version-tag>
+```
+
+### 7. Publish
+
+#### a. Publish to npm
+
+Continue with the normal `publish` command; There is no need to tag this differently than a typical release version.
+
+- Use `npm publish --ws` in the repository root to publish the workspaces.
+- Use `npm publish` to publish the root package.
+
+#### b. Publish to the website
+
+**_Often, as is the case with issues arising from published dependency versions, a patch release only needs to be published to npm and does not need to be deployed to cesium.com. If that is the case, skip step 7b and proceed to step 8._**
+
+- Check out the `cesium.com` branch.
+- Merge the new release tag into the `cesium.com` branch with `git merge origin <tag-name> --ff-only`.
+- Push the branch with `git push`. CI will deploy the hosted release, Sandcastle, and the updated doc.
+
+### 8. Port the updates back to `main`
+
+It's important that the latest version info goes back into the `main` branch to streamline future releases.
+
+- Checkout `main` and pull the latest updates:
+  - `git checkout main`
+  - `git pull`
+- Checkout your patch release branch:
+  - `git checkout <release-branch>`
+- [Optional] Create a new branch to perform the merge:
+  - `git checkout -b <branch-name>`
+- Merge `main`, resolving any conflicts, particularly in `CHANGES.md`. Ensure the patch release _is_ included in the release notes, and ensure the specific patch fix descriptions are only listed once under the patch release.
+  - `git merge main`
+  - `git add .`
+  - `git diff main`
+- Commit and push your changes:
+  - `git commit -m "sync version info"`
+  - `git push --set-upstream origin <branch-name>`
+- Open a new PR with the **priority - next release** label
+
+### 9. Announce the release
+
+Once the packages have been successfully published to npm, notify the interested developers that the release has been completed. This may include adding a comment to relevant GitHub issues that a fix has been published.

Documentation/Contributors/ReleaseGuide/Prereleases/README.md

@@ -0,0 +1,146 @@
+# Prereleases
+
+Occasionally, we need to release incremental, opt-in versions of CesiumJS to npm prior to our typical [monthly train releases](../README.md) for early testing or internal use. When this is necessary, we publish a tagged **prerelease**[^1]. Prereleases are not guaranteed as stable and may not be compatable with official numbered releases.
+
+[^1]: See ["Adding dist-tags to packages" on docs.npmjs.com](https://docs.npmjs.com/adding-dist-tags-to-packages)
+
+## Installing a prerelease
+
+Use a prerelease tag—e.g. `ion`—to install a published prerelease.
+
+```sh
+npm install cesium@<tag>
+npm install @cesium/engine@<tag>
+npm install @cesium/widgets@<tag>
+```
+
+For example, if the prerelease tag is `ion`, run the following command to install the latest ion prerelease of the top-level `cesium` npm package.
+
+```sh
+npm install cesium@ion
+```
+
+## Do we need a prelease?
+
+A prerelease of CesiumJS typically _will not have the level of validation_ that the official monthly numbered release receives. Additionally, [cherry picking commits](https://www.atlassian.com/git/tutorials/cherry-pick) for hot fixes can _complicate commit history and introduce bugs_. Consider if a prerelease is the ideal solution or if [continuous deployment artifacts](../../ContinuousIntegration/README.md#continuous-deployment) will suffice.
+
+## Publishing a prelease
+
+This process is based on an abbreviated version of the [monthly release guide](../README.md). Familiarity with our typical release process is recommended, but not required.
+
+### 1. Create a new branch from the base tag
+
+- Checkout a git tag for the base branch– i.e., use `1.123` in place of `<git-tag>` for the previous monthly release, or `1.123.1-ion.0` for a subsequent prerelease.
+- From this branch, create a new branch with any unique `<branch-name>`.
+
+#### Commands
+
+```sh
+git checkout <git-tag>
+git checkout -b <branch-name>
+```
+
+### 2. Cherry pick relevant commits
+
+- Use [`git-cherry-pick`](https://git-scm.com/docs/git-cherry-pick) one or more times to apply select commits to the current branch.
+- As necessary, resolve any merge conflicts, add, and continue.
+
+#### Commands
+
+```sh
+git cherry-pick <commit-hash>
+```
+
+### 3. Bump the prerelease version
+
+Use [npm `version` with the `preid` argument](https://docs.npmjs.com/cli/v11/commands/npm-version#preid) to bump the version of each workspace and the root package– e.g., `npm version prerelease --preid ion --no-git-tag-version`
+
+#### Commands
+
+```sh
+npm version prerelease --preid <tag> --ws --no-git-tag-version
+npm version prerelease --preid <tag> --no-git-tag-version
+```
+
+### 4. Update `CHANGES.md`
+
+- In [`CHANGES.md`](../../../CHANGES.md), create a new header with the version string of root package from the previous step and the date of the release— e.g., if the version string from the previous step is `1.123.1-ion.0`, `CHANGES.md` should read:
+
+```md
+# Change Log
+
+## 1.123.1-ion.0 - 2025-07-15
+
+### @cesium/engine
+
+...
+```
+
+- Move any relevant items in the list to the new header in `CHANGES.md`.
+- Delete any empty headers.
+- Ensure each change is nested in the section for the relevant workspace.
+- Commit any staged changes and push to your branch.
+
+### 5. Release build and sanity test
+
+While the full extent of typical release testing is not required, at minimum, create a release build and run the release tests.
+
+- Make sure the repository is clean `git clean -d -x -f --exclude="/Specs/e2e/*-snapshots/"`. **This will delete all files not already in the repository, excluding end to end testing snapshots.**
+- Run `npm install`.
+- Make sure `ThirdParty.json` is up to date by running `npm run build-third-party`. If there are any changes, verify and commit them.
+- Create the release zip `npm run make-zip`.
+- Run tests against the release `npm run test -- --failTaskOnError --release`.
+- Run [Sandcastle](http://localhost:8080/Apps/Sandcastle/index.html) and verify functionality from this prerelease is working as expected.
+
+### 6. Push and tag the release commit
+
+- Push your commits to the _current_ branch.
+- Create and push a [tag](https://git-scm.com/book/en/v2/Git-Basics-Tagging), e.g., if the version string from previous steps is `1.123.1-ion.0`, run:
+  - `git tag -a 1.123.1-ion.0 -m "1.123.1 ion prerelease"`
+  - `git push origin 1.123.1-ion.0` (this assumes origin is the primary cesium repository; do not use `git push --tags` as it pushes all tags from all remotes you have on your system)
+
+#### Commands
+
+```sh
+git push
+git tag -a <version-tag> -m "<prerelease-description>"
+git push origin <version-tag>
+```
+
+### 7. Publish to npm
+
+Ensure the prerelease version of each package is not tagged as the `latest` version by [including the `tag` flag](https://docs.npmjs.com/cli/v11/commands/npm-publish#tag)— Ideally the `<tag>` specified here should match the prerelease tag from the version info. For instance, if the version is `1.123.1-ion.0`, use the `ion` tag.
+
+- Use `npm publish --ws --tag <tag>` in the repository root to publish the workspaces.
+- Use `npm publish --tag <tag>` to publish the root package.
+
+#### Commands
+
+```sh
+npm publish --ws --tag <tag>
+npm publish --tag <tag>
+```
+
+### 8. Port the updates back to `main`
+
+It's important that the latest version info goes back into the `main` branch to streamline future releases.
+
+- Checkout `main` and pull the latest updates:
+  - `git checkout main`
+  - `git pull`
+- Checkout your prerelease branch:
+  - `git checkout <prerelease-branch>`
+- [Optional] Create a new branch to perform the merge:
+  - `git checkout -b <branch-name>`
+- Merge `main`, resolving any conflicts, particularly in `CHANGES.md`. The prerelease section can be removed, and relevant changes moved to the next monthly release. To confirm the merge, do a diff against main. Ideally, only the version info should show as updated.
+  - `git merge main`
+  - `git add .`
+  - `git diff main`
+- Commit and push your changes:
+  - `git commit -m "sync version info"`
+  - `git push --set-upstream origin <branch-name>`
+- Open a new PR with the **priority - next release** label
+
+### 9. Announce the prerelease
+
+Once the packages have been successfully published to npm, notify the interested developers that the release has been completed.

Documentation/Contributors/ReleaseGuide/README.md

@@ -1,8 +1,18 @@
 # Release Guide
 
-We release Cesium on the first work day of every month. The [Release Schedule](./ReleaseSchedule.md) outlines the release schedule and the developer responsible for each month's release.
+We release CesiumJS on the first work day of every month.
 
-There is no release manager; instead, our community shares the responsibility. Any committer can create the release for a given month, and at any point, they can pass the responsibility to someone else, or someone else can ask for it. This spreads knowledge, avoids stratification, avoids a single point of failure, and is beautifully unstructured ([more info](https://community.cesium.com/t/cesium-releases/45)).
+- [**Release Schedule**](./ReleaseSchedule.md): The upcoming monthly release schedule and the developer responsible for managing each release
+- [**Patch Release Guide**](./PatchReleases/README.md): If and how to publish a patch release[^1] ahead of the regular monthly release, typically used in the case of a significant regression or an issue with published dependency versions.
+- [**Prerelease Guide**](./Prereleases/README.md): If and how to publish a tagged prerelease[^2] ahead of the regular monthly release, typically used for internal testing.
+
+[^1]: See ["About semantic versioning" on docs.npmjs.com](https://docs.npmjs.com/about-semantic-versioning)
+
+[^2]: See ["Adding dist-tags to packages" on docs.npmjs.com](https://docs.npmjs.com/adding-dist-tags-to-packages)
+
+## Motivation
+
+There is no one release manager; instead, [our community shares the responsibility](https://community.cesium.com/t/cesium-releases/45). Any committer can create the release for a given month, and at any point, they can pass the responsibility to someone else, or someone else can ask for it. This spreads knowledge, avoids stratification, avoids a single point of failure, and is beautifully unstructured.
 
 ## One week before release
 
@@ -10,8 +20,10 @@ There is no release manager; instead, our community shares the responsibility. A
 2. If one or more dependencies are outdated, checkout a new branch and run `npm install <packagename>@latest` for each package to increment the version.
    - If `prettier` needs updated you _should_ still update it but keep the version pinned. If you run `npm install prettier@latest` you must remove the `^` in `package.json`. If the number of changes when running `npm run prettier` is large it may be worth opening a separate PR for only those.
 3. Verify each update. If an update can be resolved, open a PR with your changes. If an update is incompatible, open an issue. Check the [`dependencies` label](https://github.com/CesiumGS/cesium/issues?q=is%3Aissue+is%3Aopen+label%3Adependencies) for any open issues pinning versions.
-4. Check the [`priority - next release` issues and PRs](https://github.com/CesiumGS/cesium/labels/priority%20-%20next%20release). If there are any outstanding items, post a message to the `#cesiumjs` channel in Slack to figure out what needs to be addressed before we can release.
-5. Ensure you've generated valid [end to end testing snapshots](../TestingGuide/README.md) against a previous release tag with `npm run test-e2e-update`.
+4. Check the [`priority - next release` issues and PRs](https://github.com/CesiumGS/cesium/labels/priority%20-%20next%20release). If there are any outstanding items, post a message to the `CesiumJS` channel in Teams to figure out what needs to be addressed before we can release.
+5. Check the [`remove in [this version number]` issues](https://github.com/CesiumGS/cesium/labels?q=remove) and open PRs to address any deprecations.
+6. Ensure you've generated valid [end to end testing snapshots](../TestingGuide/README.md) against a previous release tag with `npm run test-e2e-update`.
+7. Start thinking ahead for a good image for the release blog post in case you need to prepare any data, assets or examples.
 
 ## Release testing and packaging
 
@@ -22,9 +34,9 @@ There is no release manager; instead, our community shares the responsibility. A
 3. Make sure you are using the latest drivers for your video card.
 4. Ensure you've generated valid [end to end testing snapshots](../TestingGuide/README.md) against a previous release tag with `npm run test-e2e-update`.
 5. Pull down the latest `main` branch and run `npm install`.
-6. Update the Cesium ion demo token in `Ion.js` with a new token from the CesiumJS ion team account with read and geocode permissions. These tokens are named like this: `1.85 Release - Delete on November 1st, 2021`. Delete the token from 2 releases ago.
+6. Update the Cesium ion demo token in `Ion.js` with a new token from the CesiumJS ion team account with `read` and `geocode` permissions. These tokens are named like this: `1.85 Release - Delete on November 1st, 2021`. Delete the token from 2 releases ago.
 7. Update the ArcGIS Developer API key in `ArcGisMapService.js` with a new API key from the [CesiumJS ArcGIS Developer](https://links.esri.com/agol-sign-in) account. These API keys are named like this: `1.85 Release - Delete on November 1st, 2021`. Delete the API key from the last release.
-   1. Sign in with LastPass
+   1. Sign in with Bitwarden
    2. Go to Content at the top
    3. Click "New Item" -> Developer Credentials -> API Key credentials
    4. Set the expiration date to the day after the next release (no referrer URLs)
@@ -49,7 +61,7 @@ There is no release manager; instead, our community shares the responsibility. A
 20. Verify that the [documentation](http://localhost:8080/Build/Documentation/index.html) built correctly
 21. Make sure [Hello World](http://localhost:8080/Apps/HelloWorld.html) loads.
 22. Make sure [Cesium Viewer](http://localhost:8080/Apps/CesiumViewer/index.html) loads.
-23. Run [Sandcastle](http://localhost:8080/Apps/Sandcastle/index.html) on the browser of your choice (or multiple browsers if you are up for it). Switch to the `All` tab and spot test more complicated demos. Actually play with each of the buttons and sliders on each demo to ensure everything works as expected.
+23. Run [Sandcastle](http://localhost:8080/Apps/Sandcastle2/index.html) on the browser of your choice (or multiple browsers if you are up for it). Remove the `Showcases` filter and spot test the more complicated demos. Actually play with each of the buttons and sliders on each demo to ensure everything works as expected.
 24. If any of the above steps fail, post a message to the `CesiumJS` channel in Teams to figure out what needs to be fixed before we can release. **Do NOT proceed to the next step until issues are resolved.**
 25. Push your commits to main
     - `git push`
@@ -68,7 +80,7 @@ There is no release manager; instead, our community shares the responsibility. A
     - `npm publish -w @cesium/engine`
     - `npm publish -w @cesium/widgets`
 29. Publish the top-level `cesium` package to npm by running `npm publish` in the repository root (not the unzipped file directory) (the first time you do this, you will need to authorize the machine using `npm adduser`).
-30. Check out the `cesium.com` branch. Merge the new release tag into the `cesium.com` branch `git merge origin <tag-name>`. CI will deploy the hosted release, Sandcastle, and the updated doc when you push the branch up.
-31. After the `cesium.com` branch is live on cesium.com, comment in the `#comms-chat` slack channel to notify comms that the release is done so they can add these highlights and publish the monthly blog post
+30. Check out the `cesium.com` branch. Merge the new release tag into the `cesium.com` branch `git merge origin <tag-name> --ff-only`. CI will deploy the hosted release, Sandcastle, and the updated doc when you push the branch up.
+31. After the `cesium.com` branch is live on cesium.com, comment in the `Communications` channel in Teams to notify comms that the release is done so they can add these highlights and publish the monthly blog post
     - Note, it may take a little while for the new version of CesiumJS to be live on cesium.com (~30 minutes after the branch builds). You can check the version of Cesium in [sandcastle](https://sandcastle.cesium.com/) by looking at the tab above the cesium pane.
 32. Continue to the [Cesium Analytics release](https://github.com/CesiumGS/cesium-analytics/tree/main/Documentation/ReleaseGuide)

Documentation/Contributors/ReleaseGuide/ReleaseSchedule.md

@@ -2,15 +2,17 @@
 
 | Date      | User             |
 | --------- | ---------------- |
-| 1/2/2025  | `@ggetz`         |
-| 2/3/2025  | `@jjhembd`       |
-| 3/3/2025  | `@lukemckinstry` |
-| 4/1/2025  | `@ggetz`         |
-| 5/1/2025  | `@jjspace`       |
-| 6/2/2025  | `@jjhembd`       |
-| 7/1/2025  | `@jjspace`       |
-| 8/1/2025  | `@lukemckinstry` |
-| 9/1/2025  | `@ggetz`         |
-| 10/1/2025 | `@jjhembd`       |
-| 11/3/2025 | `@lukemckinstry` |
-| 12/1/2025 | `@jjspace`       |
+| 11/3/2025 | `@jjspace`       |
+| 12/1/2025 | `@mzschwartz5`   |
+| 1/2/2026  | `@lukemckinstry` |
+| 2/2/2026  | `@ggetz`         |
+| 3/2/2026  | `@jjhembd`       |
+| 4/1/2026  | `@jjspace`       |
+| 5/1/2026  | `@mzschwartz5`   |
+| 6/1/2026  | `@lukemckinstry` |
+| 7/2/2026  | `@ggetz`         |
+| 8/3/2026  | `@jjhembd`       |
+| 9/1/2026  | `@jjspace`       |
+| 10/1/2026 | `@mzschwartz5`   |
+| 11/2/2026 | `@lukemckinstry` |
+| 12/1/2026 | `@ggetz`         |

Documentation/Contributors/TestingGuide/README.md

@@ -16,7 +16,7 @@ All new code should have 100% code coverage and should pass all tests. Always ru
       - [Run Only Non-WebGL Tests](#run-only-non-webgl-tests)
       - [Run All Tests Against the Minified Release Version of CesiumJS](#run-all-tests-against-the-minified-release-version-of-cesiumjs)
       - [Run a Single Test or Suite](#run-a-single-test-or-suite)
-      - [Using Browser Debugging Tools](#using-browser-debugging-tools)
+      - [Debugging Tests in the Browser or IDE](#debugging-tests-in-the-browser-or-ide)
     - [Running the Tests in the Browser](#running-the-tests-in-the-browser)
       - [Run All Tests](#run-all-tests)
       - [Run with WebGL validation](#run-with-webgl-validation)
@@ -122,13 +122,13 @@ Alternatively, test suites can be run from the command line with the `includeNam
 
 `npm run test -- --includeName Cartesian2`
 
-#### Using Browser Debugging Tools
+#### Debugging Tests in the Browser or IDE
 
-If it is helpful to step through a unit test in a browser debugger, run the tests with the `debug` flag:
+If it is helpful to step through a unit test in a browser debugger or your IDE, run the tests with the `debug` flag:
 
 `npm run test -- --debug`
 
-The `--debug` flag will prevent the Karma browser from closing after running the tests, and clicking the "Debug" button will open a new tab that can be used for placing breakpoints and stepping through the code.
+The `--debug` flag will prevent the Karma browser from closing after running the tests, and clicking the "Debug" button will open a new tab that can be used for placing breakpoints and stepping through the code. Alternatively, run the "Launch Test Suite and Debug in VSCode" launch configuration (which opens chrome, attaches VSCode, and prepares the test suite of the current file), set breakpoints directly in the Spec file, and then click "Debug" in Chrome to run the tests. Similar behavior may be possible in other IDEs by attaching to port 9333 (Karma's configured remote debugging port) after running the npm test command above.
 
 ![Karma](8.jpg)
 

Documentation/Contributors/VSCodeGuide/README.md

@@ -77,3 +77,5 @@ you quit VSCode, so should be restarted manually on next launch.
 ## Debugging CesiumJS
 
 To debug CesiumJS using the VSCode Chrome debugger, run the `"Launch Server"` configuration. If the server was already started in the terminal using `npm start`, use the `"Launch in Chrome"` configuration.
+
+To debug a specific unit test suite, run the "Launch Test Suite and Debug in VSCode" configuration. This will start the server, launch chrome, and prepare to run the tests in the currently open file. Set one or more breakpoints in VSCode and then click "Debug" in the browser. If the server is already started, use the "Attach to Karma" configuration and then continue setting breakpoints.

LICENSE.md

@@ -331,35 +331,43 @@ https://gist.github.com/banksean/300494
 >
 > THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
-### NVIDIA GameWorks Graphics Samples
+### NVIDIA GameWorks FXAA Shader
 
-https://github.com/NVIDIAGameWorks/GraphicsSamples
+Original source (archived): https://archive.org/details/nvidiagame-works-graphics-samples-master
+Fork: https://github.com/lyntel/GraphicsSamples/blob/3d30817ebeeade64fe6a4fc3aa1fe4265c29b6fd/samples/es3-kepler/FXAA/FXAA3_11.h
 
-> Copyright 2016 NVIDIA Corporation
+> ----------------------------------------------------------------------------------
+> File:        es3-kepler\FXAA/FXAA3_11.h
+> SDK Version: v3.00 
+> Email:       gameworks@nvidia.com
+> Site:        http://developer.nvidia.com/
 >
-> BY DOWNLOADING THE SOFTWARE AND OTHER AVAILABLE MATERIALS, YOU ("DEVELOPER") AGREE TO BE BOUND BY THE FOLLOWING TERMS AND CONDITIONS
+> Copyright (c) 2014-2015, NVIDIA CORPORATION. All rights reserved.
 >
-> The materials available for download to Developers may include software in both sample source ("Source Code") and object code ("Object Code") versions, documentation ("Documentation"), certain art work ("Art Assets") and other materials (collectively, these materials referred to herein as "Materials"). Except as expressly indicated herein, all terms and conditions of this Agreement apply to all of the Materials.
+> Redistribution and use in source and binary forms, with or without
+> modification, are permitted provided that the following conditions
+> are met:
+>  * Redistributions of source code must retain the above copyright
+>    notice, this list of conditions and the following disclaimer.
+>  * Redistributions in binary form must reproduce the above copyright
+>    notice, this list of conditions and the following disclaimer in the
+>    documentation and/or other materials provided with the distribution.
+>  * Neither the name of NVIDIA CORPORATION nor the names of its
+>    contributors may be used to endorse or promote products derived
+>    from this software without specific prior written permission.
 >
-> Except as expressly set forth herein, NVIDIA owns all of the Materials and makes them available to Developer only under the terms and conditions set forth in this Agreement.
->
-> License: Subject to the terms of this Agreement, NVIDIA hereby grants to Developer a royalty-free, non-exclusive license to possess and to use the Materials. The following terms apply to the specified type of Material:
->
-> Source Code: Developer shall have the right to modify and create derivative works with the Source Code. Developer shall own any derivative works ("Derivatives") it creates to the Source Code, provided that Developer uses the Materials in accordance with the terms of this Agreement. Developer may distribute the Derivatives, provided that all NVIDIA copyright notices and trademarks are used properly and the Derivatives include the following statement: "This software contains source code provided by NVIDIA Corporation."
->
-> Object Code: Developer agrees not to disassemble, decompile or reverse engineer the Object Code versions of any of the Materials. Developer acknowledges that certain of the Materials provided in Object Code version may contain third party components that may be subject to restrictions, and expressly agrees not to attempt to modify or distribute such Materials without first receiving consent from NVIDIA.
->
-> Art Assets: Developer shall have the right to modify and create Derivatives of the Art Assets, but may not distribute any of the Art Assets or Derivatives created therefrom without NVIDIA's prior written consent.
->
-> Government End Users: If you are acquiring the Software on behalf of any unit or agency of the United States Government, the following provisions apply. The Government agrees the Software and documentation were developed at private expense and are provided with "RESTRICTED RIGHTS". Use, duplication, or disclosure by the Government is subject to restrictions as set forth in DFARS 227.7202-1(a) and 227.7202-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (Oct 1988), FAR 12.212(a)(1995), FAR 52.227-19, (June 1987) or FAR 52.227-14(ALT III) (June 1987),as amended from time to time. In the event that this License, or any part thereof, is deemed inconsistent with the minimum rights identified in the Restricted Rights provisions, the minimum rights shall prevail.
-> No Other License. No rights or licenses are granted by NVIDIA under this License, expressly or by implication, with respect to any proprietary information or patent, copyright, trade secret or other intellectual property right owned or controlled by NVIDIA, except as expressly provided in this License.
-> Term: This License is effective until terminated. NVIDIA may terminate this Agreement (and with it, all of Developer's right to the Materials) immediately upon written notice (which may include email) to Developer, with or without cause.
->
-> Support: NVIDIA has no obligation to support or to continue providing or updating any of the Materials.
->
-> No Warranty: THE SOFTWARE AND ANY OTHER MATERIALS PROVIDED BY NVIDIA TO DEVELOPER HEREUNDER ARE PROVIDED "AS IS." NVIDIA DISCLAIMS ALL WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
->
-> LIMITATION OF LIABILITY: NVIDIA SHALL NOT BE LIABLE TO DEVELOPER, DEVELOPER'S CUSTOMERS, OR ANY OTHER PERSON OR ENTITY CLAIMING THROUGH OR UNDER DEVELOPER FOR ANY LOSS OF PROFITS, INCOME, SAVINGS, OR ANY OTHER CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE, DIRECT OR INDIRECT DAMAGES (WHETHER IN AN ACTION IN CONTRACT, TORT OR BASED ON A WARRANTY), EVEN IF NVIDIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS SHALL APPLY NOTWITHSTANDING ANY FAILURE OF THE ESSENTIAL PURPOSE OF ANY LIMITED REMEDY. IN NO EVENT SHALL NVIDIA'S AGGREGATE LIABILITY TO DEVELOPER OR ANY OTHER PERSON OR ENTITY CLAIMING THROUGH OR UNDER DEVELOPER EXCEED THE AMOUNT OF MONEY ACTUALLY PAID BY DEVELOPER TO NVIDIA FOR THE SOFTWARE OR ANY OTHER MATERIALS.
+> THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS'' AND ANY
+> EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+> IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+> PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+> CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+> EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+> PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+> PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+> OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+> (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+> OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
 
 ### NoSleep.js
 

Specs/Data/Cesium3DTiles/GaussianSplats/sh_unit_cube/tileset.json

@@ -0,0 +1 @@
+{"asset":{"extras":{"ion":{"georeferenced":false,"movable":true}},"version":"1.1"},"extensions":{"3DTILES_content_gltf":{"extensionsRequired":["KHR_gaussian_splatting","KHR_gaussian_splatting_compression_spz_2"],"extensionsUsed":["KHR_gaussian_splatting","KHR_gaussian_splatting_compression_spz_2"]}},"extensionsUsed":["3DTILES_content_gltf"],"geometricError":173.20508075688772,"root":{"boundingVolume":{"box":[50.0,-50.0,-50.0,50.0,0.0,0.0,0.0,50.0,0.0,0.0,0.0,50.0]},"content":{"uri":"0/0.glb"},"geometricError":0.0,"refine":"REPLACE"}}

Specs/Data/Cesium3DTiles/GaussianSplats/tower/tileset.json

@@ -1,66 +1,68 @@
 {
-    "asset": {
-        "extras": {
-            "ion": {
-                "georeferenced": true,
-                "movable": true
-            }
-        },
-        "version": "1.1"
+  "asset": {
+    "extras": {
+      "ion": {
+        "georeferenced": true,
+        "movable": true
+      }
     },
-    "extensions": {
-        "3DTILES_content_gltf": {
-            "extensionsRequired": [
-                "KHR_spz_gaussian_splats_compression"
-            ],
-            "extensionsUsed": [
-                "KHR_spz_gaussian_splats_compression"
-            ]
-        }
-    },
-    "extensionsUsed": [
-        "3DTILES_content_gltf"
-    ],
-    "geometricError": 14.76778488662848,
-    "root": {
-        "boundingVolume": {
-            "box": [
-                1.2307894825935364,
-                -0.6764951944351196,
-                186.9346923828125,
-                2.405353009700775,
-                0.0,
-                0.0,
-                0.0,
-                2.5862385034561157,
-                0.0,
-                0.0,
-                0.0,
-                6.484405517578125
-            ]
-        },
-        "content": {
-            "uri": "0/0.glb"
-        },
-        "geometricError": 0.0,
-        "refine": "REPLACE",
-        "transform": [
-            -0.14382095244935905,
-            0.9896037255571338,
-            0.0,
-            0.0,
-            -0.7120020847592599,
-            -0.1034765889935951,
-            0.6945110703428119,
-            0.0,
-            0.6872907426519194,
-            0.09988524362332703,
-            0.7194820172674795,
-            0.0,
-            4391456.686631473,
-            638218.5788113032,
-            4566368.395700517,
-            1.0
-        ]
+    "version": "1.1"
+  },
+  "extensions": {
+    "3DTILES_content_gltf": {
+      "extensionsRequired": [
+        "KHR_gaussian_splatting",
+        "KHR_gaussian_splatting_compression_spz_2"
+      ],
+      "extensionsUsed": [
+        "KHR_gaussian_splatting",
+        "KHR_gaussian_splatting_compression_spz_2"
+      ]
     }
+  },
+  "extensionsUsed": [
+    "3DTILES_content_gltf"
+  ],
+  "geometricError": 76.94345372195917,
+  "root": {
+    "boundingVolume": {
+      "box": [
+        0.759602474620948,
+        -1.6211592734702087,
+        2566.3544788548998,
+        8.432663940269968,
+        0.0,
+        0.0,
+        0.0,
+        8.127358416707006,
+        0.0,
+        0.0,
+        0.0,
+        36.64573633729674
+      ]
+    },
+    "content": {
+      "uri": "0/0.glb"
+    },
+    "geometricError": 0.0,
+    "refine": "REPLACE",
+    "transform": [
+      0.9984683783609064,
+      -0.0553253776610889,
+      0.0,
+      0.0,
+      0.038789672094630565,
+      0.7000451263203326,
+      0.7130443060946077,
+      0.0,
+      -0.03944944552377324,
+      -0.7119521920057605,
+      0.7011189753145034,
+      0.0,
+      -252040.29496225834,
+      -4548622.6254820945,
+      4449422.940203034,
+      1.0
+    ]
+  }
 }

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentBoundingVolumeSemantics/subtrees/1.0/0.0.0.0.json

@@ -1,36 +0,0 @@
-{
-  "buffers": [
-    {
-      "uri": "../metadata.bin",
-      "byteLength": 2336
-    }
-  ],
-  "bufferViews": [
-    {
-      "buffer": 0,
-      "byteOffset": 0,
-      "byteLength": 2336
-    }
-  ],
-  "tileAvailability": {
-    "constant": 1
-  },
-  "contentAvailability": [
-    {
-      "constant": 1
-    }
-  ],
-  "childSubtreeAvailability": {
-    "constant": 0
-  },
-  "extensions": {
-    "3DTILES_metadata": {
-      "class": "tile",
-      "properties": {
-        "contentBounds": {
-          "bufferView": 0
-        }
-      }
-    }
-  }
-}

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentBoundingVolumeSemantics/subtrees/1.1/0.0.0.0.json

@@ -25,7 +25,7 @@
   },
   "propertyTables": [
     {
-      "class": "tile",
+      "class": "content",
       "count": 73,
       "properties": {
         "contentBounds": {
@@ -34,5 +34,5 @@
       }
     }
   ],
-  "tileMetadata": 0
+  "contentMetadata": [0]
 }

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentBoundingVolumeSemantics/tileset_1.0.json

@@ -1,76 +0,0 @@
-{
-  "asset": {
-    "version": "1.0"
-  },
-  "extensionsUsed": [
-    "3DTILES_implicit_tiling",
-    "3DTILES_metadata"
-  ],
-  "extensionsRequired": [
-    "3DTILES_implicit_tiling"
-  ],
-  "extensions": {
-    "3DTILES_metadata": {
-      "schema": {
-        "id": "ImplicitContentBoundingVolumeSemanticsMetadataSchemaId",
-        "classes": {
-          "tile": {
-            "properties": {
-              "contentBounds": {
-                "type": "SCALAR",
-                "componentType": "FLOAT64",
-                "array": true,
-                "count": 4,
-                "semantic": "CONTENT_BOUNDING_SPHERE"
-              }
-            }
-          }
-        }
-      }
-    }
-  },
-  "geometricError": 4096.0,
-  "root": {
-    "transform": [
-      2048, 0, 0, 0,
-      0, 2048, 0, 0,
-      0, 0, 2048, 0,
-      6500000, 0, 0, 1
-    ],
-    "geometricError": 2048.0,
-    "boundingVolume": {
-      "box": [
-        0, 0, 0,
-        1, 0, 0,
-        0, 1, 0,
-        0, 0, 1
-      ]
-    },
-    "children": [
-      {
-        "geometricError": 2048.0,
-        "boundingVolume": {
-          "box": [
-            0, 0, 0,
-            1, 0, 0,
-            0, 1, 0,
-            0, 0, 1
-          ]
-        },
-        "content": {
-          "uri": "empty.gltf"
-        },
-        "extensions": {
-          "3DTILES_implicit_tiling": {
-            "subdivisionScheme": "OCTREE",
-            "subtreeLevels": 3,
-            "availableLevels": 3,
-            "subtrees": {
-              "uri": "subtrees/1.0/{level}.{x}.{y}.{z}.json"
-            }
-          }
-        }
-      }
-    ]
-  }
-}

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentBoundingVolumeSemantics/tileset_1.1.json

@@ -5,7 +5,7 @@
   "schema": {
     "id": "ImplicitContentBoundingVolumeSemanticsMetadataSchemaId",
     "classes": {
-      "tile": {
+      "content": {
         "properties": {
           "contentBounds": {
             "type": "SCALAR",

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentHeightAndRegionSemantics/subtrees/1.0/0.0.0.json

@@ -1,52 +0,0 @@
-{
-    "buffers": [
-        {
-        "uri": "../metadata.bin",
-        "byteLength": 1344
-        }
-    ],
-    "bufferViews": [
-        {
-            "buffer": 0,
-            "byteOffset": 0,
-            "byteLength": 168
-        },
-        {
-            "buffer": 0,
-            "byteOffset": 168,
-            "byteLength": 168
-        },
-        {
-            "buffer": 0,
-            "byteOffset": 336,
-            "byteLength": 1008
-        }
-    ],
-    "tileAvailability": {
-        "constant": 1
-    },
-    "contentAvailability": [
-        {
-            "constant": 1
-        }
-    ],
-    "childSubtreeAvailability": {
-        "constant": 0
-    },
-    "extensions": {
-        "3DTILES_metadata": {
-            "class": "tile",
-            "properties": {
-                "minimumHeight": {
-                    "bufferView": 0
-                },
-                "maximumHeight": {
-                    "bufferView": 1
-                },
-                "boundingRegion": {
-                    "bufferView": 2
-                }
-            }
-        }
-    }
-}

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentHeightAndRegionSemantics/subtrees/1.1/0.0.0.json

@@ -1,6 +1,6 @@
 {
     "buffers": [
-        {  
+        {
             "uri": "../metadata.bin",
             "byteLength": 1344
         }
@@ -35,7 +35,7 @@
     },
     "propertyTables": [
         {
-            "class": "tile",
+            "class": "content",
             "count": 21,
             "properties": {
                 "minimumHeight": {
@@ -50,5 +50,5 @@
             }
         }
     ],
-    "tileMetadata": 0
-}
+    "contentMetadata": [0]
+}

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentHeightAndRegionSemantics/tileset_1.0.json

@@ -1,69 +0,0 @@
-{
-  "asset": {
-    "version": "1.0"
-  },
-  "extensionsUsed": [
-    "3DTILES_implicit_tiling",
-    "3DTILES_metadata"
-  ],
-  "extensionsRequired": [
-    "3DTILES_implicit_tiling"
-  ],
-  "extensions": {
-    "3DTILES_metadata": {
-      "schema": {
-        "id": "ImplicitContentHeightAndRegionSemanticsMetadataSchemaId",
-        "classes": {
-          "tile": {
-            "properties": {
-              "minimumHeight": {
-                "type": "SCALAR",
-                "componentType": "FLOAT64",
-                "semantic": "CONTENT_MINIMUM_HEIGHT"
-              },
-              "maximumHeight": {
-                "type": "SCALAR",
-                "componentType": "FLOAT64",
-                "semantic": "CONTENT_MAXIMUM_HEIGHT"
-              },
-              "boundingRegion": {
-                "type": "SCALAR",
-                "componentType": "FLOAT64",
-                "array": true,
-                "count": 6,
-                "semantic": "CONTENT_BOUNDING_REGION"
-              }
-            }
-          }
-        }
-      }
-    }
-  },
-  "geometricError": 4096.0,
-  "root": {
-    "geometricError": 2048.0,
-    "boundingVolume": {
-      "region": [
-        0,
-        0,
-        0.00314,
-        0.00314,
-        0,
-        10000
-      ]
-    },
-    "content": {
-      "uri": "empty.gltf"
-    },
-    "extensions": {
-      "3DTILES_implicit_tiling": {
-        "subdivisionScheme": "QUADTREE",
-        "subtreeLevels": 3,
-        "availableLevels": 3,
-        "subtrees": {
-          "uri": "subtrees/1.0/{level}.{x}.{y}.json"
-        }
-      }
-    }
-  }
-}

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentHeightAndRegionSemantics/tileset_1.1.json

@@ -5,7 +5,7 @@
   "schema": {
     "id": "ImplicitContentHeightAndRegionSemanticsMetadataSchemaId",
     "classes": {
-      "tile": {
+      "content": {
         "properties": {
           "minimumHeight": {
             "type": "SCALAR",

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentHeightSemantics/subtrees/1.0/0.0.0.json

@@ -1,44 +0,0 @@
-{
-    "buffers": [
-        {
-            "uri": "../metadata.bin",
-            "byteLength": 336
-        }
-    ],
-    "bufferViews": [
-        {
-            "buffer": 0,
-            "byteOffset": 0,
-            "byteLength": 168
-        },
-        {
-            "buffer": 0,
-            "byteOffset": 168,
-            "byteLength": 168
-        }
-    ],
-    "tileAvailability": {
-        "constant": 1
-    },
-    "contentAvailability": [
-        {
-            "constant": 1
-        }
-    ],
-    "childSubtreeAvailability": {
-        "constant": 0
-    },
-    "extensions": {
-        "3DTILES_metadata": {
-            "class": "tile",
-            "properties": {
-                "minimumHeight": {
-                    "bufferView": 0
-                },
-                "maximumHeight": {
-                    "bufferView": 1
-                }
-            }
-        }
-    }
-}

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentHeightSemantics/subtrees/1.1/0.0.0.json

@@ -30,7 +30,7 @@
     },
     "propertyTables": [
         {
-            "class": "tile",
+            "class": "content",
             "count": 21,
             "properties": {
                 "minimumHeight": {
@@ -42,5 +42,5 @@
             }
         }
     ],
-    "tileMetadata": 0
-}
+    "contentMetadata": [0]
+}

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentHeightSemantics/tileset_1.0.json

@@ -1,62 +0,0 @@
-{
-  "asset": {
-    "version": "1.0"
-  },
-  "extensionsUsed": [
-    "3DTILES_implicit_tiling",
-    "3DTILES_metadata"
-  ],
-  "extensionsRequired": [
-    "3DTILES_implicit_tiling"
-  ],
-  "extensions": {
-    "3DTILES_metadata": {
-      "schema": {
-        "id": "ImplicitContentHeightSemanticsMetadataSchemaId",
-        "classes": {
-          "tile": {
-            "properties": {
-              "minimumHeight": {
-                "type": "SCALAR",
-                "componentType": "FLOAT64",
-                "semantic": "CONTENT_MINIMUM_HEIGHT"
-              },
-              "maximumHeight": {
-                "type": "SCALAR",
-                "componentType": "FLOAT64",
-                "semantic": "CONTENT_MAXIMUM_HEIGHT"
-              }
-            }
-          }
-        }
-      }
-    }
-  },
-  "geometricError": 4096.0,
-  "root": {
-    "geometricError": 2048.0,
-    "boundingVolume": {
-      "region": [
-        0,
-        0,
-        0.00314,
-        0.00314,
-        0,
-        10000
-      ]
-    },
-    "content": {
-      "uri": "empty.gltf"
-    },
-    "extensions": {
-      "3DTILES_implicit_tiling": {
-        "subdivisionScheme": "QUADTREE",
-        "subtreeLevels": 3,
-        "availableLevels": 3,
-        "subtrees": {
-          "uri": "subtrees/1.0/{level}.{x}.{y}.json"
-        }
-      }
-    }
-  }
-}

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentHeightSemantics/tileset_1.1.json

@@ -5,7 +5,7 @@
   "schema": {
     "id": "ImplicitContentHeightSemanticsMetadataSchemaId",
     "classes": {
-      "tile": {
+      "content": {
         "properties": {
           "minimumHeight": {
             "type": "SCALAR",

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentMetadata/subtrees/1.0/0.0.0.json

@@ -1,79 +0,0 @@
-{
-  "buffers": [
-    {
-      "byteLength": 32,
-      "uri": "../buffers/shared.bin"
-    },
-    {
-      "byteLength": 24,
-      "uri": "../buffers/contentMetadata.bin"
-    }
-  ],
-  "bufferViews": [
-    {
-      "buffer": 0,
-      "byteOffset": 0,
-      "byteLength": 1
-    },
-    {
-      "buffer": 0,
-      "byteOffset": 8,
-      "byteLength": 5
-    },
-    {
-      "buffer": 0,
-      "byteOffset": 16,
-      "byteLength": 12
-    },
-    {
-      "buffer": 1,
-      "byteOffset": 0,
-      "byteLength": 8
-    },
-    {
-      "buffer": 1,
-      "byteOffset": 8,
-      "byteLength": 12
-    }
-  ],
-  "tileAvailability": {
-    "bitstream": 0,
-    "availableCount": 4
-  },
-  "contentAvailability": [
-    {
-      "bitstream": 0,
-      "availableCount": 4
-    }
-  ],
-  "childSubtreeAvailability": {
-    "constant": 0
-  },
-  "propertyTables": [
-    {
-      "class": "building",
-      "properties": {
-        "height": {
-          "values": 3
-        },
-        "color": {
-          "values": 4
-        }
-      }
-    }
-  ],
-  "contentMetadata": [0],
-  "extensions": {
-    "3DTILES_metadata": {
-      "class": "tile",
-      "properties": {
-        "quadrant": {
-          "values": 1
-        },
-        "color": {
-          "values": 2
-        }
-      }
-    }
-  }
-}

Specs/Data/Cesium3DTiles/Metadata/ImplicitContentMetadata/tileset_1.0.json

@@ -1,101 +0,0 @@
-{
-  "asset": {
-    "version": "1.0"
-  },
-  "extensionsUsed": [
-    "3DTILES_implicit_tiling",
-    "3DTILES_metadata"
-  ],
-  "extensionsRequired": [
-    "3DTILES_implicit_tiling"
-  ],
-  "extensions": {
-    "3DTILES_metadata": {
-      "schema": {
-        "id": "ImplicitContentMetadataSchemaId",
-        "classes": {
-          "tile": {
-            "properties": {
-              "quadrant": {
-                "type": "ENUM",
-                "enumType": "quadrantType"
-              },
-              "color": {
-                "type": "VEC3",
-                "componentType": "UINT8"
-              }
-            }
-          },
-          "building": {
-            "properties": {
-              "height": {
-                "type": "SCALAR",
-                "componentType": "UINT16",
-                "semantic": "_BUILDING_HEIGHT"
-              },
-              "color" : {
-                "type": "VEC3",
-                "componentType": "UINT8"
-              }
-            }
-          }
-        },
-        "enums": {
-          "quadrantType": {
-            "valueType": "UINT8",
-            "values": [
-              {
-                "name": "Southwest",
-                "value": 0
-              },
-              {
-                "name": "Southeast",
-                "value": 1
-              },
-              {
-                "name": "Northwest",
-                "value": 2
-              },
-              {
-                "name": "Northeast",
-                "value": 3
-              },
-              {
-                "name": "None",
-                "value": 4
-              }
-            ]
-          }
-        }
-      }
-    }
-  },
-  "geometricError": 240,
-  "root": {
-    "boundingVolume": {
-      "region": [
-        -1.3197209591796106,
-        0.6988424218,
-        -1.3196390408203893,
-        0.6989055782,
-        0,
-        88
-      ]
-    },
-    "content": {
-      "uri": "content/{level}/{x}/{y}.b3dm"
-    },
-    "extensions": {
-      "3DTILES_implicit_tiling": {
-        "subdivisionScheme": "QUADTREE",
-        "subtreeLevels": 2,
-        "availableLevels": 2,
-        "subtrees": {
-          "uri": "subtrees/1.0/{level}.{x}.{y}.json"
-        }
-      }
-    },
-    "geometricError": 70,
-    "refine": "ADD"
-  }
-}

Specs/Data/Cesium3DTiles/Metadata/ImplicitMultipleContentsWithMetadata/tileset_1.0.json

@@ -1,81 +0,0 @@
-{
-  "asset": {
-    "version": "1.0"
-  },
-  "extensionsUsed": [
-    "3DTILES_implicit_tiling",
-    "3DTILES_multiple_contents",
-    "3DTILES_metadata"
-  ],
-  "extensionsRequired": [
-    "3DTILES_implicit_tiling"
-  ],
-  "extras": {
-    "name": "Sample Implicit Tileset"
-  },
-  "extensions": {
-    "3DTILES_metadata": {
-      "schema": {
-        "id": "ImplicitMultipleContentsWithMetadataSchemaId",
-        "classes": {
-          "building": {
-            "properties": {
-              "height": {
-                "type": "SCALAR",
-                "componentType": "UINT16",
-                "semantic": "_BUILDING_HEIGHT"
-              },
-              "color" : {
-                "type": "VEC3",
-                "componentType": "UINT8"
-              }
-            }
-          },
-          "tree": {
-            "properties": {
-              "age": {
-                "type": "SCALAR",
-                "componentType": "UINT16"
-              }
-            }
-          }
-        }
-      }
-    }
-  },
-  "geometricError": 240,
-  "root": {
-    "boundingVolume": {
-      "region": [
-        -1.3197309591796106,
-        0.6988324218,
-        -1.3196290408203893,
-        0.6989155782,
-        0,
-        88
-      ]
-    },
-    "extensions": {
-      "3DTILES_implicit_tiling": {
-        "subdivisionScheme": "QUADTREE",
-        "subtreeLevels": 2,
-        "availableLevels": 2,
-        "subtrees": {
-          "uri": "subtrees/{level}.{x}.{y}.json"
-        }
-      },
-      "3DTILES_multiple_contents": {
-        "content": [
-          {
-            "uri": "ground/{level}/{x}/{y}.b3dm"
-          },
-          {
-            "uri": "sky/{level}/{x}/{y}.b3dm"
-          }
-        ]
-      }
-    },
-    "geometricError": 70,
-    "refine": "ADD"
-  }
-}

Specs/Data/Cesium3DTiles/PointCloud/PointCloudBatchedJsonOnly/README.md

@@ -0,0 +1,5 @@
+# PointCloudBatchedJsonOnly
+
+A regression test for https://github.com/CesiumGS/cesium/issues/11166,
+created from `PointCloudBatched` by omitting the binary part of the
+batch table.

Specs/Data/Cesium3DTiles/PointCloud/PointCloudBatchedJsonOnly/tileset.json

@@ -0,0 +1,21 @@
+{
+  "asset": {
+    "version": "1.0"
+  },
+  "geometricError": 17.32,
+  "root": {
+    "refine": "ADD",
+    "boundingVolume": {
+      "sphere": [
+        1215012.8828876738,
+        -4736313.051199594,
+        4081605.22126042,
+        5
+      ]
+    },
+    "geometricError": 0,
+    "content": {
+      "uri": "pointCloudBatchedJsonOnly.pnts"
+    }
+  }
+}

Specs/Data/Cesium3DTiles/PointCloud/PointCloudDracoInvalid/README.md

@@ -0,0 +1,14 @@
+# PointCloudDracoInvalid
+
+A test related to https://github.com/CesiumGS/cesium/issues/12872 :
+
+For a certain period of time (2 years), and under certain conditions, the
+point cloud tiler generated invalid PNTS files when draco compression
+was enabled. The batch table could define certain properties as binary
+body references, without a batch table binary being present, and without
+the `3DTILES_draco_point_compression` extension object being present
+in the batch table JSON.
+
+The PNTS file here is one PNTS file from the data set that was linked
+in the issue (with details in the issue description). This is to
+ensure that CesiumJS gracefully handles this case, without crashing.

Specs/Data/Cesium3DTiles/PointCloud/PointCloudDracoInvalid/tileset.json

@@ -0,0 +1,16 @@
+{
+  "asset": {
+    "version": "1.0"
+  },
+  "extensionsRequired": ["3DTILES_draco_point_compression"],
+  "extensionsUsed": ["3DTILES_draco_point_compression"],
+  "geometricError": 1.7320508075688772,
+  "root": {
+    "boundingVolume": {
+      "box": [0.5, 0.5, 0.5, 0.5, 0.0, 0.0, 0.0, 0.5, 0.0, 0.0, 0.0, 0.5]
+    },
+    "content": { "uri": "pointCloudDracoInvalid.pnts" },
+    "geometricError": 0.0,
+    "refine": "ADD"
+  }
+}