# What Kind of Output Does the Gods-Eye-View Project Produce? Interactive 3D Globe Visualizations Explained

> Discover the Gods-Eye-View project's output: an interactive 3D globe in your browser with real-time data and unique camera views. Explore and share visualizations.

- Repository: [Bilawal Sidhu/gods-eye-view](https://github.com/bilawalsidhu/gods-eye-view)
- Tags: getting-started
- Published: 2026-08-30

---

**The gods-eye-view project produces an interactive, photorealistic 3D globe rendered directly in the browser, featuring real-time data layers, specialized camera views like cockpit mode, and shareable visual states.**

The `bilawalsidhu/gods-eye-view` repository generates a continuously updating, animated visualization rather than static files or console logs. Users explore a globe that renders live data streams—from aircraft and ships to earthquakes and traffic—through an interface built on Cesium.js and WebGL. The output responds to mouse, keyboard shortcuts, and voice commands, allowing operators to track objects, apply military-style sensor filters, and export camera tours.

## Primary Output: A Real-Time 3D Globe

At its core, the application outputs a **photorealistic 3D globe** that serves as a canvas for thirteen distinct live data layers. According to [`docs/CURRENT-STATE.md`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/CURRENT-STATE.md), these layers include flights, ships, satellites, earthquakes, traffic, CCTV cameras, radio signals, bikeshare systems, fires, space missions, and mapped installations. Each layer pulls from public APIs such as OpenSky, AISStream, and CelesTrak, rendering entities as interactive glyphs or 3D models on the globe surface.

The entry point [`tools/cesium-render.html`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/tools/cesium-render.html) initializes the Cesium-based viewport, binding the WebGL globe to the application's UI controls. Unlike static map tiles, this output updates continuously to reflect real-world positions.

## Specialized Visual Modes

The project extends beyond a standard map view with several specialized rendering modes that simulate military and cinematic visualization systems.

### Cockpit View

The **cockpit view** locks the camera inside a tracked aircraft, displaying terrain beneath the cockpit while allowing users to swap between sensor modes. According to [`src/cockpitTracking.js`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/src/cockpitTracking.js), this mode supports NVG (night vision), FLIR (thermal), and CRT visual styles. When zooming in on flights, the system replaces standard glyphs with real-time 3D aircraft models—such as the Boeing 787 or MQ-9 Reaper—rendered in a virtual hangar environment.

### Contacts Roster

A **contacts roster** generates a list of all live objects within a 250 km radius of the camera position. Users can step through nearby flights, ships, and satellites, selecting any contact to enter cockpit mode or initiate tracking.

## Interactive Tracking and Annotation Systems

### Click-to-Track Functionality

The [`src/worldFocus.js`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/src/worldFocus.js) file implements **click-to-track** behavior that locks the camera onto selected objects. When activated, the system draws fading trail lines behind moving targets and displays full metadata panels. The view can hand off to the nearest public camera with a single click, transitioning from satellite imagery to ground-level CCTV feeds.

### Voice Commands and Control

The output responds to natural language instructions through an integrated voice agent. With an OpenAI API key configured, users can speak commands such as:

> "Take me to LAX and select the nearest airborne aircraft."

The voice agent moves the camera to Los Angeles, identifies the closest live flight, and automatically enters cockpit view mode.

### Voice Whiteboard

The system supports **spoken annotations** that render as persistent drawings on the map. Users create polygons, routes, and distance measurements through voice commands. These graphical annotations persist on the globe until manually cleared, creating a collaborative tactical picture.

## Stylistic Filters and HUD Overlays

### Sensor Style Reskinning

The globe supports complete visual reskins through **GLSL shaders** that emulate tactical sensor systems. Available styles include:

- **CRT** – Scanline and phosphor glow effects
- **NVG** – Green-tinted night vision goggles
- **FLIR** – Thermal imaging heat maps
- **Noir** – High-contrast black and white
- **Snow** – Winter camouflage visualization

These shaders re-render the entire globe and all active layers in the chosen style.

### Detection Overlays and Military HUD

The output includes **screen-space bounding boxes** and identification tags that appear on every visible entity. A **military HUD** (heads-up display) overlays tactical telemetry for selected contacts, including speed, altitude, heading, and threat assessment data derived from live API feeds.

## Exportable and Shareable Outputs

### Shareable URLs

The [`src/camera.js`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/src/camera.js) implementation enables view-state serialization. The system encodes camera position, active visual style, enabled layers, and tracked targets into shareable URLs:

```javascript
const shareLink = GEV.get_shareable_url();
console.log('Share this link:', shareLink);

```

Recipients opening these links recreate the exact scene, including the same tracked aircraft or ship.

### Scene Director

The **scene director** mode records camera movements through 3D space, allowing users to export cinematic clips. These tours capture complex camera movements—from global overviews down to cockpit-level detail—for documentation or presentation purposes.

## Programmatic Control of Visual Output

Developers manipulate the visualization output through the global `GEV` API exposed in the browser context.

### Enabling Data Layers

To toggle specific data streams programmatically:

```javascript
// Activate the traffic layer showing per-vehicle congestion flow
GEV.set_layer_visibility('traffic', true);

```

### Switching Visual Styles

Change the entire visualization aesthetic through the API:

```javascript
// Apply thermal camera look to the globe
GEV.set_visual_style('FLIR');

```

### Development Server Output

To generate the live 3D UI locally:

```bash
npm install
npm run dev -- --host localhost --port 4173

# Open http://localhost:4173 in a browser

```

The Vite-powered development server launches the interactive globe interface at `http://localhost:4173`.

## Key Implementation Files

The following source files control specific aspects of the visual output:

- **[`src/worldFocus.js`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/src/worldFocus.js)** – Core logic for camera focusing and click-to-track behavior.
- **[`src/cockpitTracking.js`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/src/cockpitTracking.js)** – Cockpit view implementation, sensor swaps, and 3D model handling.
- **[`src/camera.js`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/src/camera.js)** – Camera utilities, keyboard shortcuts, and view-state serialization for URLs.
- **[`tools/cesium-render.html`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/tools/cesium-render.html)** – HTML entry point loading the Cesium-based 3D globe.
- **[`docs/CURRENT-STATE.md`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/CURRENT-STATE.md)** – Enumeration of live data layers and API sources.

## Summary

- **The gods-eye-view project** produces an interactive 3D globe in the browser, not static files or console logs.
- **Specialized visual modes** include cockpit view, 3D hangar, contacts roster, and global context switching.
- **Thirteen live data layers** cover flights, ships, satellites, traffic, and more from public APIs like OpenSky and AISStream.
- **Interactive features** enable click-to-track, voice annotations, and one-click handoffs to CCTV cameras.
- **Stylistic controls** apply GLSL shaders for NVG, FLIR, CRT, and thermal visual effects.
- **Shareable outputs** include URL-encoded view states via [`src/camera.js`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/src/camera.js) and recordable camera tours.

## Frequently Asked Questions

### Does gods-eye-view produce static images or interactive content?

gods-eye-view generates **interactive content** rather than static outputs. The application renders a continuously updating WebGL scene using Cesium.js, allowing real-time manipulation of the camera, data layers, and visual styles. While users can capture screenshots or record video through the scene director, the primary output is a live, explorable 3D environment.

### How many data layers can be displayed simultaneously?

The system supports **thirteen distinct live layers** ranging from flights and ships to earthquakes and bikeshare locations. According to [`docs/CURRENT-STATE.md`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/CURRENT-STATE.md), each layer can be toggled independently, and multiple layers can be active simultaneously. Rendering performance depends on browser WebGL capabilities and the density of visible entities.

### Can I export the current view to share with other users?

Yes. The `GEV.get_shareable_url()` method encodes the current camera position, active layers, tracked targets, and visual style into a URL string. When another user opens this link, the application restores the exact view state, including the same tracked aircraft or geographic location, as implemented in [`src/camera.js`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/src/camera.js).

### What enables the 3D globe visualization technology?

The 3D output relies on **CesiumJS** for geospatial visualization and **GLSL shaders** for sensor-style post-processing effects. The entry point in [`tools/cesium-render.html`](https://github.com/bilawalsidhu/gods-eye-view/blob/main/tools/cesium-render.html) initializes the WebGL context, while custom shaders in the codebase handle the NVG, FLIR, and CRT visual filters that re-render the globe in tactical display modes.