Editing Orulex

Jump to navigation Jump to search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
 
{{Addon|
 
{{Addon|
 
1=http://orbides.1gb.ru|
 
1=http://orbides.1gb.ru|
−
2=Artyom "Artlav" Litvinovich
+
2=Artlav
 
}}
 
}}
 
[[Image:Oru-080401-1.jpg|200px|thumb|right|Earth in Orulex 1.0]]
 
[[Image:Oru-080401-1.jpg|200px|thumb|right|Earth in Orulex 1.0]]
−
[[Image:Oru-080401-2.jpg|200px|thumb|right|Brighton Beach Crater on the Moon in Orulex 1.0]]
 
−
[[Image:Oru-080401-3.jpg|200px|thumb|right|Venus in Orulex 1.0]]
 
−
[[Image:Oru-080401-7.jpg|200px|thumb|right|Nereid in Orulex 1.0]]
 
  
−
'''Orulex''' is a dynamic landscape generator add-on for Orbiter which allows users to add a global landable mesh to planets.
+
'''Orulex''' is a dynamic landscape generator add-on for Orbiter which allows you to add a global landable meshes to the planets.
−
Simply said, it turns flat planets into mountainous planets.
 
  
−
Latest stable version is 1.0
+
==Basic features (0.7.1)==
−
Latest development version is 1.2_080527
+
* Run-time generation of planet-wide meshes based on given mathematical expression.
 +
* Supported functions are perlin noise, ridged perlin, sine and cosine terrain, i/o curve, crater, auxiliarys.
 +
* Global and local heightmaps
 +
* Automatic carving of surface bases into craters.
 +
* Partially compatible with Visosad collision detection system.
 +
 
 +
==Known bugs/issues (0.7.1)==
 +
* Static textures all over the planet.
 +
* Blinking of the texture at night and with clouds.
 +
* No mesh visible in windowed mode on some GPUs.
  
 
==Basic features (1.0)==
 
==Basic features (1.0)==
Line 18: Line 23:
 
* Easily downloadable textures and heightmaps data for Earth, and other planets.
 
* Easily downloadable textures and heightmaps data for Earth, and other planets.
 
* Lv11 global Orbiter and Lv6-Lv22 local downloaded textures (LandSat, USGS) support.
 
* Lv11 global Orbiter and Lv6-Lv22 local downloaded textures (LandSat, USGS) support.
−
* Collision detection support possibilities and SDK interface
+
 
 +
==Known bugs/issues (1.0)==
 +
* Windows Vista random CTD.
 +
* Dislocated patches when flying with multithreaded mode on.
 +
* Textures getting colorfully random on some machines (probably Orbiter/DirectX bug on older systems).
  
 
==System Requirements:==
 
==System Requirements:==
Line 29: Line 38:
 
* 2-3Ghz CPU, ~1Gb of disk space, Fast Cheap internet (Lv9 heightmap is 466Mb download).
 
* 2-3Ghz CPU, ~1Gb of disk space, Fast Cheap internet (Lv9 heightmap is 466Mb download).
  
−
==Performance Guidelines (1.0)==
+
==Configuration==
−
* If you got a multi-core CPU, it is almost always better to keep multithread mode on.
+
'''Syntax for all config files:'''
−
* If you got single-core CPU and Orulex feels slow on response or pre-computation takes longer than 10-15 seconds, try turning multithread mode off.
+
* parameter = value
−
* Reducing polygon count may help if you got an old video card.
+
* Any amount of tabs or spaces around = sign.
−
* Reducing LevLimit may give a more stable-looking landscape, but dropping quality exponentially.
+
* // means star of line-comment (all of the line after it is ignored)
−
* If you got FPS jerks on older/single-core PC's, look on texture timings.
+
* { opens the large comment, } closes the large comment, everything between them is ignored.
−
TexGen-H defines time slice allocated when there is a lot to generate, TexGen-L defines time slice allocated when there are only small changes, like when you are flying around. Reducing them make Orbiter more responsive and terrain less responsive. Timings are not defined in multithread mode.
+
* 1 denotes TRUE/ON, 0 denotes FALSE/OFF.
 +
* All other numbers are in metres (unless specified otherwise), in real number format (±1.23±45).
  
−
==Known bugs/issues (1.0)==
 
−
* Windows Vista random CTD.
 
−
* Dislocated patches when flying with multithreaded mode on.
 
−
* Textures getting colorfully random on some machines (probably Orbiter/DirectX bug on older systems).
 
  
−
==Data download Servers List==
+
'''Main configuration''' can be found in visosad\orulex.cfg
−
'''Earth'''
 
−
* SRTM global Earth terrain
 
−
* NASA derived global 30 meters per pixel satellite image mosaic
 
−
* NASA derived global 15 meters per pixel satellite image mosaic, donated and processed by I-Cubed using equipment from Isilon Systems.
 
−
* USGS Digital Ortho
 
−
* USGS Urban Area Ortho
 
−
* Pseudo color 15m Landsat mosaic provided by MDA Federal, scenes comprised from early 2000s
 
  
−
'''Moon'''
+
All pathes are relative to the Orbiter directory.
−
* Clementine global Moon terrain
 
−
* Clementine 40xx
 
−
* Clementine 30xx
 
  
−
'''Mars'''
+
Global features:
−
* MOLA global Mars terrain
 
−
* Mars THEMIS Color
 
  
−
'''Venus'''
+
* '''Enabled''' - Enable/disable the system
−
* Magellan Imaging Radar (Color)
+
* '''Debug''' - Enable/disable the debug string
−
* Magellan Imaging Radar (Grey)
+
* '''Collisions''' - Collision support on/off
 +
* '''Multithread''' - Multithreaded mode on/off
 +
* '''Reflection''' - Reflection model
  
−
==World Studio==
+
Default values for all planets (used if not specified in planet cfg):
−
World Studio is both the Orulex terrain config system and the versatile planet editor. It was first released on April 1, 2008 same with Orulex 1.0.
+
* '''MaxPolyCount''' - Maximum polygon count in the terrain should be in 20000-100000 range.
 +
* '''Altlimit''' - Upper limit for terrain drawing.
 +
* '''Blendlimit''' - Lower limit of terrain vanishing (starts at Altlimit-Blendlimit)
 +
* '''Levlimit''' - Terrain level limit
 +
* '''GlobalHMapLimit''' - Global heightmap level limit
 +
* '''PriT''' - Preprocess timeslice
 +
* '''SecT''' - Split/Merge timeslice
 +
* '''TriT''' - TexGen-L timeslice
 +
* '''QuaT''' - TexGen-H timeslice
 +
* '''Configs''' - Configuration path
 +
* '''Textures''' - Textures path
 +
* '''Heightmaps''' - Heightmap path
  
−
==Generator ideas and function description==
 
−
===Configuration===
 
  
−
Orulex system configuration are done by World Studio program and config files editing, with options ranging from terrain polygon count to shapes of the worlds.
+
Planet textures are loaded from Orbiter textures directories, with Orbiter's default prioritites.
−
2 PDF's with full description of world studio and file configuration can be found in the release package.
 
  
 +
Planets configuration can be found in config/terrain/planet_name.cfg
  
  
 +
'''In planet_name.cfg'''
 +
The MaxPolyCount, Altlimit, Blendlimit have the same meaning as in name config, but for this planet only.
  
−
===Basic ideas===
+
Terrain settings:
 +
* '''seed''' - The Number, that defines the planet.
 +
* '''radius''' - Radius of mesh. Better be near radius of planet.
 +
* '''function''' - Planet terrain function. Described below.
 +
* '''sbcrater''' - Surface base craters ridge height
 +
* '''microtexture''' - Microtexturing
 +
* '''belowsphere''' - Below sphere terrain
 +
* '''glhmaplevel''' - Max global heightmap level
  
−
Function string in config\terrain\planet_name.cfg
 
  
−
* Planet functions is written in postfix notation.
+
'''Heightmaps:'''
−
* In postfix, the sign of operation goes after the operands, so a+b will be ab+.
+
Defined by adding following string to the planet_name.cfg
−
* It have a significant comprehensive advantage, since there is no ()'s.
 
−
* a+((b+f)*c+d/e) will be written as a b f+c*d e/++.
 
−
* Functions specified the same way - f(x,y,z+w) is x y z w + f.
 
  
−
===Terrain function===
+
'''heightmap=Name|Lon of start|Lon of end|Lat of start|Lat of end|Scale|Function|Flag|Use'''
  
−
The terrain is represented by a 3 to 1 function with arguments being the position on the planet and output being the altitude at this position. The concept is similar to the plotting of 1D functions, like sine and cosine - the X axis represents the position, and Y axis represents the altitude:
+
'''height8map=Name|Lon of start|Lon of end|Lat of start|Lat of end|Scale|Function|Flag|Use'''
  
−
[[Image:Functions in Orulex 1.jpg|800px|thumb|center|Imagine the same thing in 4D, and that's how it is done in Orulex.]]
+
'''heightmaphei=Name|Lon of start|Lon of end|Lat of start|Lat of end|Scale|Function|Flag|Use'''
  
−
===List of terrain functions===
+
All fields have fixed widths - 40|10|10|10|10|8|1|1|1
  
−
====Perlin noise====
+
First is filename relative to Heightmaps directory, then longitude of start, longitude of end, latitude of start, latitude of end, vertical scale, function, flag, use flag
−
[[Image:Terrain Functions.jpg|100px|thumb|left|Classic perlin noise ground function.]]
+
* '''heightmap''' - Heightmap file is a grayscale BMP with black as 0 and white as vertical scale altitude.
−
;Syntax:<nowiki>perlin(xd,yd,zd,band,scale)</nowiki>
+
* '''height8map''' - Heightmap file is a grayscale BMP with altitude asn sint8.
−
;xd,yd,zd:Distortion values for x,y,and z coordinates respectively.
+
* '''heightmaphei''' - Heightmap file is a Orulex HEI.
−
;band: The amount of noise bands to be used - the more of them the more detailed terrain is, but slower.
 
−
;scale: The horizontal scale of the thing. It is roughly equivalent to the size of the pattern shown in viewer on the actual planet, i.e. if scale is 10000 then the pattern will be spread across 10 kilometers.
 
  
−
Output is in -1..1 range.
 
  
−
====Ridge noise====
+
'''Heightmap functions are:'''
−
[[Image:Terrain Functions 2.jpg|100px|thumb|left|Ridged perlin noise ground function. ]]
+
* '''0''' - addition (height-map)
 +
* '''1''' - multiplication (mask-map).
 +
* '''2''' - replacation (plain height-map)
 +
* '''3''' - replacation-truncation (plain height-map with ocean truncated)
  
−
;Syntax:<nowiki>ridge(xd,yd,zd,band,scale)</nowiki>
 
  
−
;Syntax:<nowiki>perlin(xd,yd,zd,band,scale)</nowiki>
+
'''Colormaps:'''
−
;xd,yd,zd:Distortion values for x,y,and z coordinates respectively.
+
Defined by adding following string to the planet_name.cfg
−
;band: The amount of noise bands to be used - the more of them the more detailed terrain is, but slower.
+
'''colormap=Name|Lon of start|Lon of end|Lat of start|Lat of end|Scale|Function'''
−
;scale: The horizontal scale of the thing. It is roughly equivalent to the size of the pattern shown in viewer on the actual planet, i.e. if scale is 10000 then the pattern will be spread across 10 kilometers.
+
All fields have fixed widths - 40|10|10|10|10|8|1|1|1
 +
First is filename relative to Textures or Textures2 directory, then longitude of start, longitude of end, latitude of start, latitude of end, vertical scale, function
 +
Colormap file is either BMP or DDS.
  
−
Output is in -1..1 range.
 
  
−
====Sea level====
+
'''Flat spaces:'''
−
[[Image:Terrain Functions 3.jpg|100px|thumb|left|Sea level function with Perlin noise]]
+
Defined by adding following string to the planet_name.cfg
 +
'''flat=Lon of start Lon of end Lat of start Lat of end'''
  
−
;Syntax:<nowiki>sealevel(f,min)</nowiki>
 
  
−
Same as <nowiki>min2(min,f)</nowiki>. Returns <math>f</math> if <math>f>=min</math> and <math>min</math> if <math>f<min</math>.
+
'''SURFTILES:'''
 +
Just paste the
 +
BEGIN_SURFTILELIST
 +
END_SURFTILELIST
 +
part of the Orbiter base cfg into Orulex planet cfg, '''removing empty lines'''.
 +
See earth.cfg for example.
  
−
Useful to truncate below the sphere part of the terrain function into flat valleys. Almost always should be removed if planet have ocean. If your planet have an ocean, make sure thet the underwater part of the function is not truncated!
 
  
−
====Sinusoidal terrain====
+
'''Predefined terrain functions for randomator:'''
−
[[Image:Terrain Functions 4.jpg|100px|thumb|left|Sinusoidal terrain]]
+
* '''1 1 1 3 6000 perlin''' = dense selenic world
 +
* '''1 1 1 3 10000 perlin''' = selenic world
 +
* '''1 1 1 4 15000 perlin''' = sparse selenic world
 +
* '''1 1 1 3 20000 1000 1 1 1 4 10000 ridge sin * + ridge''' = tightly-ridged world
 +
* '''1 1 1 3 100000 10000 1 1 1 3 100000 ridge sin * + ridge''' = ridge-cratered world
 +
* '''1 1 1 1 10000 ridge cos 0.6- 5*''' = channel-cracked world
 +
* '''1.1 1.1 1.1 3 10000 ridge 1 0 1 1 1 0.4 0 0.2 0 0 1 0.2 1 1 1 3 100000 ridge trim 0.2-2* 9 curv trim*''' = ridged-valleys world
  
−
;Syntax:
+
==Planet functions==
−
<nowiki>sintf(xd,yd,zd,scale)</nowiki>
+
'''Function=... in visosad\orulex\planet_name.cfg'''
  
−
;xd,yd,zd:Distortion values for x,y,and z coordinates respectively.
+
Planet function, written in postfix notation. Better not to edit if you don't know what postfix notation is.
−
;scale: The horizontal scale of the thing. It is roughly equivalent to the size of the pattern shown in viewer on the actual planet, i.e. if scale is 10000 then the pattern will be spread across 10 kilometers.
 
  
−
Output is in -1..1 range.
+
'''Visosad\funcdrw program''' can display functions 3D graph. Requires OpenGL.
  
−
====Cosinusoidal terrain====
 
−
[[Image:Terrain Functions 5.jpg|100px|thumb|left|Cosinusoidal terrain]]
 
  
−
;Syntax:<nowiki>costf(xd,yd,zd,scale)</nowiki>
+
'''Operators:'''
 +
* sbcrater(scl) - defines surface base craters with scl height.
 +
* perlin(xd,yd,zd,band,scale) - perlin noise ground function
 +
* ridge(xd,yd,zd,band,scale) - ridged perlin noise ground function
 +
* curv(n,f,x1,y1,x2,y2,...,x(n-1)/2,y(n-1)/2) - Input/Output curve for f by points of xi,yi, lagrange interpolated.
 +
* sealevel(level) -sphere level cutoff function
 +
* +, -, --, *, /, sin, cos, max2, max3, min2, min3 - arithmetics.
 +
* ax,ay,az - world coordinates.
 +
* trim(f,min,max) - trims f into min<f<max.
  
−
;xd,yd,zd:Distortion values for x,y,and z coordinates respectively.
+
'''Heightmaps'''
−
;scale: The horizontal scale of the thing. It is roughly equivalent to the size of the pattern shown in viewer on the actual planet, i.e. if scale is 10000 then the pattern will be spread across 10 kilometers.
 
  
−
Output is in -1..1 range.
+
heightmap=Testmapmoon        |000041.025|000041.225|-0033.8375|-0033.6375|00002000|0
  
−
====Curve function====
+
Heightmap definition. Can be several of them.
−
;Syntax:<nowiki>curv(n,f,x1,y1,x2,y2,...,x(n-1)/2,y(n-1)/2)</nowiki>
 
  
 +
All fields have fixed widths - 20|10|10|10|10|8|1
  
−
Input/Output curve for f by points of xi,yi, lagrange interpolated. It is a very powerful tool, allowing to map the inputs to according to specific curve to the output, changing gradients and similar things. The I/O curve is too big a topic for this manual.
+
First is filename relative to visosad\orulex\hmap, then longitude of start, longitude of end, latitude of start, latitude of end, vertical scale, function
−
For example: Callisto
 
  
  
−
====Other operators/functions====
+
Where function is:
−
;ax,ay,az:world coordinates
+
* 0 - addition (height-map)
−
;+, -, --, *, /, sin, cos, tan, ln, pow, round, trunc, sqr, sqrt max2, max3, min2, min3: Arithmetics and basic math
+
* 1 - multiplication (mask-map).
−
;trim(f,min,max): trims f into <math>min<f<max</math>
+
* 2 - replacation (plain height-map)
  
−
==See Also==
+
Heightmap file is a grayscale BMP with black as 0 and white as vertical scale altitude. 8bit BMP's seems to give errors.
−
[[Meshland]]
 
  
−
==Download Links==
 
−
[http://orbides.1gb.ru/orulex.php Orulex's Homepage by Artlav]
 
  
−
[http://www.orbiter-forum.com/showthread.php?t=2007 Development version Orbiter forum thread]
+
'''Run-time configuration''', found on page 2 of Orulex 3D Surface MFD:
 +
* Enabled - Enable/disable the drawing of the mesh.
 +
* Debug - Enable/disable the debug string
 +
* Collisions - Collision support on/off
  
−
[https://www.orbiter-forum.com/resources/orulex_land_gen-v1-2.2390/ Orulex_Land_Gen-v1.2] Orbiter Forum/Resources.
+
==Links==
−
 
+
[http://orbides.1gb.ru/orulex.php Orulex's Homepage by Artlav]
−
[http://www.orbiter-forum.com/showthread.php?t=999 1.0 Orbiter forum thread]
 
−
 
 
−
==Additional links==
 
−
 
 
−
'''Extensions'''
 
−
 
 
−
[http://orbides.1gb.ru/orbf/MLVS-WIP-080327.zip WIP MeshLand 2, Collision Detection support for Orulex, Unstable]
 
−
 
 
−
[http://orbides.1gb.ru/orbf/OrulexSDK-allvers.zip Interface SDK (Delta-Glider samples included)]
 
−
 
 
−
'''Pre-composed heightmaps'''
 
−
 
 
−
[http://orbides.1gb.ru/orbf/earth-hmap-lv8.zip Earth Lv8 heightmap (84Mb)]
 
−
 
 
−
[http://orbides.1gb.ru/orbf/mars-hmap-lv8.zip Mars Lv8 heightmap (82Mb)]
 
−
 
 
−
[http://orbides.1gb.ru/orbf/moon-hmap-lv8.zip Moon Lv8 heightmap (81Mb)]
 
−
 
 
−
[http://orbides.1gb.ru/orbf/everest_lv11.zip Everest Lv11 textures and heightmaps (5.3Mb)]
 
−
 
 
−
[http://orbides.1gb.ru/orbf/grand_canyon_lv13.zip Grand Canyon Lv13 textures and heightmaps (9Mb)]
 
−
 
 
−
'''Demonstaration video'''
 
  
−
[http://orbides.1gb.ru/orbf/oru-flight-080321-x264.avi China flying in Gregburch's Swift1 (x264, 21 MB)]
+
[http://www.orbithangar.com/searchid.php?ID=2686 Download at OrbiterHangar]
  
−
[http://orbides.1gb.ru/orbf/oru-flight-080321-xvid.avi China flying in Gregburch's Swift1 (xVid, 31 MB)]
+
[http://www.orbitersim.com/Forum/default.aspx?g=posts&t=15133 Orbiter forum thread]
  
−
[[Category: Articles]]
 
 
[[Category:Add-ons]]
 
[[Category:Add-ons]]
 +
[[Category:Celestial body add-ons]]

Please note that all contributions to OrbiterWiki are considered to be released under the GNU Free Documentation License 1.2 (see OrbiterWiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following hCaptcha:

Cancel Editing help (opens in new window)

Template used on this page:

Retrieved from "https://www.orbiterwiki.org/wiki/Orulex"