wedesoft / sfsim

Space flight simulator (under development)

sfsim

This is a work in progress. Aim is to simulate take off, space station docking, and moon landing with a futuristic space plane. Requires OpenGL 4.5.

Installation

• Tested on Debian 12 and Windows 11
• Install Java: sudo apt-get install openjdk-17-jre
• Install Clojure 1.11
• Download Packr Jar file for creating Windows executable
• Install NSIS for building Windows installer

Build

• Build Worley noise: clj -T:build worley
• Build Perlin noise: clj -T:build perlin
• Build blue noise: clj -T:build bluenoise
• Build cloud cover: clj -T:build cloud-cover
• Download NASA Bluemarble data: clj -T:build download-bluemarble
• Download NASA Blackmarble data: clj -T:build download-Blackmarble
• Download NOAA elevation data: clj -T:build download-elevation
• Download NASA JPL ephemeris data: clj -T:build download-ephemeris
• Extract elevation data: clj -T:build extract-elevation
• Convert day map sectors into pyramid of tiles: clj -T:build map-sectors-day
• Convert night map sectors into pyramid of tiles: clj -T:build map-sectors-night
• Convert elevation sectors into pyramid of tiles: clj -T:build elevation-sectors
• Convert tile pyramids into pyramid of cube maps: clj -T:build cube-maps
• Build atmosphere lookup tables: clj -T:build atmosphere-lut
• Perform all build steps above: clj -T:build all
• Enable integration tests (requiring results of above build steps): touch .integration
• Build JAR file: clj -T:build uber
• Create Windows executable: java -jar packr-all-4.0.0.jar packr-config.json (delete out-windows folder first)
• Create Windows installer: makensis nsis-config.nsi

Lint

• Install clj-kondo
• Run clj-kondo --lint src/sfsim

Run

• Run tests: clj -M:test
• Run test for specific module (rendering for example): clj -M:test sfsim.t-render
• Run the global cloud cover prototype: clj -M etc/cover.clj
• Run main program displaying black window: clj -M -m sfsim.core

External Links

• Simulators
  • Orbiter 2016
  • Rogue System
  • Flight of Nova
  • Kerbal Space Program
  • Reentry
• Engines
  • Skybolt Engine (article)
  • Oreon Engine
  • Emulating double precision in Godot
• LWJGL
  • LWJGL
  • LWJGL Wiki
  • LWJGL key table
• Publications
  • Bruneton: Precomputed Atmospheric Scattering
  • Yuksel et al.: Deep Opacity Maps
  • Bouthors: Interactive multiple anisotropic scattering in clouds
  • Pettersson: Real-time rendering and dynamics of sparse voxel octree clouds
  • Nubis: Authoring Real-Time Volumetric Cloudscapes with the Decima Engine
• Webpages
  • NVidia article on atmospheric scattering
  • Cascaded Shadow Maps
  • [Shadow mapping improvements] http://www.opengl-tutorial.org/intermediate-tutorials/tutorial-16-shadow-mapping/)
  • improved Perlin noise
  • Normal vectors of ellipsoid
  • Clojure performance flame graphs
  • How to calculate your horizon distance
  • Java native interface example
  • Earth explorer data
  • Wedesoft blog
• Videos
  • Coding Adventure: Atmosphere

sfsim's Issues

powder sugar effect

https://progmdong.github.io/2019-03-04/Volumetric_Rendering/

update article with no clamping

night lights

https://earthobservatory.nasa.gov/features/NightLights/page3.php

offscreen render and offscreen context

improved Perlin noise

https://adrianb.io/2014/08/09/perlinnoise.html

Random seed for noise

use make-array for n-dimensional arrays

render structure with bones

https://ogldev.org/www/tutorial38/tutorial38.html

investigate fluid flow

https://www.karlsims.com/fluid-flow.html

use tools.build

https://betweentwoparens.com/blog/what-are-the-clojure-tools/

check whether opacity map lookup is out of x- or y-bounds

lod of shadow

Schemas for main render function keywords

test on Debian 12.1

add link to deep opacity map publication

methods to create empty textures

also rename conversions from image to texture

Improve codox documentation

See https://weavejester.github.io/compojure/compojure.core.html for example.

inspiration for space plane

http://www.ioaircraft.com/hypersonic/ranger.php

http://www.ioaircraft.com/hypersonic/raven.php

https://www.russianspaceweb.com/spiral_orbiter_design.html

try github actions

Namespacing of keywords

add dimensions to texture

Integration tests for main render stuff

check correctness of oriented-matrix

blender skeletons

implement shadow maps

https://developer.nvidia.com/gpugems/gpugems3/part-ii-light-and-shadows/chapter-10-parallel-split-shadow-maps-programmable-gpus

render cloud at lower resolution and scale up

calculate tangent vectors

https://stackoverflow.com/questions/22276206/why-does-assimp-fail-to-generate-tangents

cloud layer radius check for shadow loop

try libgdx/packr

include current project into build

See nextjournal/clerk for example including current project.

:build {:deps {io.github.nextjournal/clerk {:local/root "."}
                          io.github.clojure/tools.build {:git/tag "v0.6.1" :git/sha "515b334"}
                          io.github.slipset/deps-deploy {:git/sha "b4359c5d67ca002d9ed0c4b41b710d7e5a82e3bf"}
                          io.github.nextjournal/cas {:git/url "[email protected]:nextjournal/cas"
                                                     :git/sha "5e8079b720e347b9466db9c2282ce79a125a011c"}}
                   :extra-paths ["bb" "src" "resources"] ;; for loading lookup-url in build
                   :ns-default build}}}

use GMTED2010 or STRM90 elevation data

https://topotools.cr.usgs.gov/gmted_viewer/viewer.htm

implement identity cubemap

use Earth explorer data

See Earth explorer.

bake animations

bake gear animation and name actions the same

use mipmapping

use level-of-detail rendering when rendering clouds and opacity maps

glTextureStorage2D levels correct for mipmaps?

use glGetProgrami and glGetProgramInfoLog

use global cloud map

http://www.shadedrelief.com/natural3/pages/clouds.html

grow/shrink coordinates for shadow maps

investigate use of dtype-next

Use dtype-next for native arrays

interpolate matrices instead of quaternions

add opacity map to prototype

skip if cover is low enough

glDisableVertexAttribArray only called for index 0

Call glDisableVertexAttribArray for all indices when destroying vertex array object

better shadows

http://www.opengl-tutorial.org/intermediate-tutorials/tutorial-16-shadow-mapping/

use steps2 instead of 10

dted elevation data

https://gdal.org/drivers/raster/dted.html

add origin at z-near to vertex shader

interpolate_3d

revert changes to shadow matrices and implement interpolate_3d. use same for sampling, rename interpolation functions (clamp, wrap). separate index computation to be used in sampling.

use analytical transmittance for cloud scatter step