Merge pull request #688 from cjakeman/menu-options07d

adds Help Icons to Video tab

Author: cjakeman

Source/Documentation/Manual/images/options-experimental.png

@@ -144,6 +144,57 @@ Video Options
 
 .. image:: images/options-video.png
 
+
+Viewing distance
+----------------
+
+This option defines the maximum distance at which terrain and objects are displayed. 
+Where the content provides "Distant Mountains", these are displayed independently (see below).
+
+Note: When the option to tune settings automatically is applied, then this 
+value will be overridden and dynamically changed to maintain a target frame rate.
+
+Note: Some routes are optimized for a viewing distance of 2km as this is the maximum provided by MSTS.
+
+The default distance is 2km.
+
+
+Distant mountains
+-----------------
+
+This option defines the maximum distance at which "Distant Mountains" are displayed. 
+
+Note: "Distant Mountains" are present in the route if it has a folder called LO_TILE. 
+
+The default setting is checked.
+
+The default distance is 40km.
+
+.. image:: images/options-mountains.png
+
+
+Extend object maximum viewing distance to horizon
+-------------------------------------------------
+
+With this option selected, all objects viewable up to the viewing distance
+(as defined above) are displayed, even if they have a level of detail (LOD) that is less distant. 
+
+Without this option, ORTS only displays objects up to their peak distance set by their level of detail (LOD) 
+or the viewing distance, whichever is less. 
+
+Selecting this option shows all the objects that should be in view but it may reduce the frame rate.
+MSTS limits the viewing distance to just 2km and the peak LOD distances are usually 2km, so this option
+is especially useful for viewing routes created for MSTS at distances above 2km.
+
+However, for routes that make good use of LOD settings, showing the objects that should be in view can be 
+achieved at higher frame rates by unchecking this option.
+For example, if the viewing distance is 10km and the content has been created with some large objects having 
+peak distance LODs set at 5km and smaller objects having LODs which are much shorter, then this strategy
+will show all the objects that should be in view without reducing the frame rate.
+
+The default setting is checked.
+
+
 Dynamic shadows
 ---------------
 
@@ -165,16 +216,6 @@ Note: This may reduce the frame rate.
 Note: Static objects provided with shadows (in the World files) 
 will cast shadows anyway. This option adds shadows for other static objects.
 
-Model instancing
-----------------
-
-When the option is checked, in cases where multiple instances of the same 
-object have to be drawn, only a single draw call is sent to the GPU. 
-Uncheck this option to avoid the graphical glitches which appear on some 
-hardware, but this may reduce the frame rate.
-
-The default setting is checked.
-
 
 Overhead wire
 -------------
@@ -191,6 +232,36 @@ MSTS uses a single wire for electrified routes; you may check this box so
 that ORTS will show the two overhead wires that are more common.
 
 
+Signal light glow
+-----------------
+
+When this option is set, a glowing effect is added to signal semaphores
+when seen at distance, so that they are visible at a greater distance.
+There are routes where this effect has already been natively introduced;
+for these, this option is not recommended.
+
+
+Ambient daylight brightness
+---------------------------
+
+With this slider you can set the daylight brightness.
+
+
+Note: The controls on the right side of the tab are more subtle and the 
+changes they make may be less easy to detect.
+
+
+Model instancing
+----------------
+
+When the option is checked, in cases where multiple instances of the same 
+object have to be drawn, only a single draw call is sent to the GPU. 
+Uncheck this option to avoid the graphical glitches which appear on some 
+hardware, but this may reduce the frame rate.
+
+The default setting is checked.
+
+
 .. _options-vsync:
 
 Vertical sync
@@ -210,54 +281,50 @@ distance, anti-aliasing, or world object density.
 The default setting is checked.
 
 
-Viewing distance
-----------------
-
-This option defines the maximum distance at which terrain and objects are displayed. 
-Where the content provides "Distant Mountains", these are displayed independently (see below).
-
-Note: When the option to tune settings automatically is applied, then this 
-value will be overridden and dynamically changed to maintain a target frame rate.
-
-Note: Some routes are optimized for a viewing distance of 2km as this is the maximum provided by MSTS.
-
-The default distance is 2km.
-
+Anti-aliasing
+-------------
 
-Distant mountains
------------------
+Controls the anti-aliasing method used by Open Rails. Anti-aliasing is a
+computer graphics technique that smooths any harsh edges, otherwise known as
+"jaggies," present in the video image. Currently, Open Rails only supports the
+multisample anti-aliasing (MSAA) method. Higher applications of anti-aliasing
+will require exponentially more graphics computing power.
 
-This option defines the maximum distance at which "Distant Mountains" are displayed. 
+The default setting is MSAA with 2x sampling.
 
-Note: "Distant Mountains" are present in the route if it has a folder called LO_TILE. 
 
-The default setting is checked.
+World object density
+--------------------
 
-The default distance is 40km.
+This value can be set from 0 to 99 and the default value is 49.
+When 49 is selected, all content defined in the route files and intended for the player to see is visible. 
+Lower values will hide some categories of objects which tends to increase frame rates.
 
-.. image:: images/options-mountains.png
+In legacy routes, all the content was assigned to categories 0-10.
+In more modern routes, content may be assigned to categories between 0 and 49.
+Content builders are advised to reserve values 50 to 99 for objects used in building the route.
 
 
-Extend object maximum viewing distance to horizon
--------------------------------------------------
+Level of detail bias
+--------------------
 
-With this option selected, all objects viewable up to the viewing distance
-(as defined above) are displayed, even if they have a level of detail (LOD) that is less distant. 
+Many visual objects are modelled at more than one level of detail (LOD) so, 
+when they are seen at a distance, Open Rails can switch to the lesser level 
+of detail without compromising the view. This use of multiple LODs reduces 
+the processing load and so may increase frame rates.
 
-Without this option, ORTS only displays objects up to their peak distance set by their level of detail (LOD) 
-or the viewing distance, whichever is less. 
+Lowering the LOD Bias setting below 0 reduces the distance at which a lower 
+level of detail comes into view, and so boosts frame rates but there may be 
+some loss of sharpness.
 
-Selecting this option shows all the objects that should be in view but it may reduce the frame rate.
-MSTS limits the viewing distance to just 2km and the peak LOD distances are usually 2km, so this option
-is especially useful for viewing routes created for MSTS at distances above 2km.
+Raising the LOD Bias setting above 0 increases the distance at which a lower 
+level of detail comes into view. This may be useful to sharpen distant content 
+that was created for a smaller screen or a wider field of view than you are 
+currently using.
 
-However, for routes that make good use of LOD settings, showing the objects that should be in view can be 
-achieved at higher frame rates by unchecking this option.
-For example, if the viewing distance is 10km and the content has been created with some large objects having 
-peak distance LODs set at 5km and smaller objects having LODs which are much shorter, then this strategy
-will show all the objects that should be in view without reducing the frame rate.
+The default setting is 0.
 
-The default setting is checked.
+Note: If your content does not use multiple LODs, then this option will have no effect.
 
 
 Viewing vertical FOV
@@ -266,33 +333,7 @@ Viewing vertical FOV
 This value defines the vertical angle of the world that is shown. Higher
 values correspond roughly to a zoom out effect. The default is 45 degrees.
 
-World object density
---------------------
 
-This value can be set from 0 to 99 and the default value is 49.
-When 49 is selected, all content defined in the route files and intended for the player to see is visible. 
-Lower values will hide some categories of objects which tends to increase frame rates.
-
-In legacy routes, all the content was assigned to categories 0-10.
-In more modern routes, content may be assigned to categories between 0 and 49.
-Content builders are advised to reserve values 50 to 99 for objects used in building the route.
-
-
-Ambient daylight brightness
----------------------------
-
-With this slider you can set the daylight brightness.
-
-Anti-aliasing
--------------
-
-Controls the anti-aliasing method used by Open Rails. Anti-aliasing is a
-computer graphics technique that smooths any harsh edges, otherwise known as
-"jaggies," present in the video image. Currently, Open Rails only supports the
-multisample anti-aliasing (MSAA) method. Higher applications of anti-aliasing
-will require exponentially more graphics computing power.
-
-The default setting is MSAA with 2x sampling.
 
 .. _options-simulation:
 
@@ -677,13 +718,6 @@ When this option is selected, when ORTS is loading the shape (.s) files it
 will report errors in syntax and structure (even if these don't cause
 runtime errors) in the :ref:`Log file <driving-logfile>` ``OpenRailsLog.txt`` on the desktop.
 
-Signal light glow
------------------
-
-When this option is set, a glowing effect is added to signal semaphores
-when seen at distance, so that they are visible at a greater distance.
-There are routes where this effect has already been natively introduced;
-for these, this option is not recommended.
 
 Correct questionable braking parameters
 ---------------------------------------
@@ -753,28 +787,6 @@ includes support of Kosmos environments, even if the final effect may be
 different from the current MSTS one.
 
 
-Level of detail bias
---------------------
-
-Many visual objects are modelled at more than one level of detail (LOD) so, 
-when they are seen at a distance, Open Rails can switch to the lesser level 
-of detail without compromising the view. This use of multiple LODs reduces 
-the processing load and so may increase frame rates.
-
-Lowering the LOD Bias setting below 0 reduces the distance at which a lower 
-level of detail comes into view, and so boosts frame rates but there may be 
-some loss of sharpness.
-
-Raising the LOD Bias setting above 0 increases the distance at which a lower 
-level of detail comes into view. This may be useful to sharpen distant content 
-that was created for a smaller screen or a wider field of view than you are 
-currently using.
-
-The default setting is 0.
-
-Note: If your content does not use multiple LODs, then this option will have no effect.
-
-
 Adhesion proportional to rain/snow/fog
 --------------------------------------