Skip to content

Latest commit

 

History

History
161 lines (105 loc) · 4.08 KB

README.md

File metadata and controls

161 lines (105 loc) · 4.08 KB
Raw

gamlenorge

Norwegian landscape rendering.

Alt text

Usage

  • Build code:
    cargo build release
  
    cd /my/geodata/maps
    for z in *.zip; do
      (...)/gamlenorge/target/release/index --maps . z
    done
  • Create a configuration (use ./gamlenorge.ini as template)
  • Render landscape:
    ./target/release/gamlenorge -c mylandscape.ini

Utilities

Gamlenorge

The main program for rendering the beautiful old Norwegian mountain landscapes. E.g.:

gamlenorge -c mylandscape.ini --output mylandscape.tif

Index

Used for creating atlas-files from a zipped package of geotiff maps, or a directory of geotiff files.

index --maps <mapdir> <zipfile>
index --maps <mapdir> <tiffdir>

Sun

Shows the angles of the sun (altitude and azimuth) for a given position and a given time. Useful for adjusting the time parameter in order to get optimal lightning for a landscape.

sun <position> <time>

Configuration parameters

Configuration parameters can be specified in the configuration file ./gamlenorge.ini, or a custom configuration specified on command line with the -c / --config parameter.

The parameters in the configuration file can be overridden on command line prefixing the parameter with a '--', e.g:

gamlenorge -c custom.ini --haziness=1.5

maps

Path to the maps directory. The directory is expected to contain atlas.json files which contain references to tiff-files or zip-files containing tiff-files, typically stored in the same directory. The atlas-files are created using the command: index -m map_dir mapdata.zip

observer

Coordinate of the observer. Some location names are accepted. Otherwise, EU89 UTM33 coordinates must be used, the format is N<northing>>E<easting>. The observer height is the terrain level plus observer_height_offset. Defaults to 'Nordre Trolltind'.

target

Coordinate of the target. Some location names are accepted. Otherwise, EU89 UTM33 coordinates must be used, the format is N<northing>E<easting>. The target height is the terrain level plus target_height_offset. Defaults to 'Store Vengetind'.

observer_height_offset

Relative adjustment of observer position height level. Defaults to 10.

target_height_offset

Relative adjustment of target position height level. Defaults to 10.

width

Pixel width of the rendered image. Defaults to 1600.

height

Pixel height of the rendered image. Defaults to 400.

width_angle

Horizontal angle of view (radians) from center to edge of the picture. efaults to 0.6.

min_depth

Minimum depth (meters) at which to start rendering. The parameter is typically used to increase performance if it is known that the area between observer and min_depth is free from obstacles. It can also be used to 'see through' a landscape in order to render the terrain behind it. Defauls to 0.

max_depth

Maximum depth (meters) to follow each ray. Defaults to 150.

haziness

Degree of atmospheric haziness. Defaults to 1.

green_limit

Maximum height level of green landscape. Defaults to 800.

snow_limit

Minimum height level of snow. Defaults to 10000.

sky_lum

Degree of luminance on the sky towards the horizon. 0 is constant blue sky, higher values give more light. Defaults to 1.

water_shininess

Ratio of reflection vs constant blue sea color. 1 is only reflections, 0 is only sea color. Defaults to 0.5.

water_ripples

Amount of ripples on the water surface. The parameter adds fuzz to the reflection angles. Defaults to 1.

water_reflection_iterations

The number of reflection angles to trace in order to determine reflection light. Defaults to 10.

time

Time of the rendering. The time is used for calculating the position of the sun. Defaults to 2023-07-01T18:00:00+0200

output

Output filename of tiff image.