Camera Settings Section: Difference between revisions

From OpenMW Wiki
Jump to navigation Jump to search
(First draft)
 
(Deleted content and added link to new documentation.)
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This page documents the settings in the Camera section of the [[Settings]] configuration file.
<b>Settings documentation moved to external source</b>


==near clip==
The current version can be found at: https://openmw.readthedocs.io/en/master/reference/modding/settings/camera.html
 
This floating point setting controls the distance to the near [https://en.wikipedia.org/wiki/Clipping_%28computer_graphics%29 clipping] plane.  The value must be greater than zero.  Values greater than approximately 18.0 will occasionally clip objects in the world in front of the character.  Values greater than approximately 8.0 will clip the character's hands in first person view and/or the back of their head in third person view. 
 
The default value is 5.0.  This setting can not be configured except by editing the settings configuration file.  The value must be greater
 
==small feature culling==
 
This boolean setting determines whether objects that render to a few pixels or smaller will be culled (not drawn).  It generally improves performance to enable this feature, and by definition the culled objects will be very small on screen.  It appears that the default definition of "small" in OpenSceneGraph is 2x2 pixels.
 
The default value is true.
 
==viewing distance==
 
This floating point values controls the maximum visible distance (also called the far [https://en.wikipedia.org/wiki/Clipping_%28computer_graphics%29 clipping] plane).  Larger values significantly improve rendering in exterior spaces, but also increase the amount rendered geometry and significantly reduce the frame rate.  This value interacts with the "exterior cell load distance" setting in that it's probably undesired for this value to provide visibility into cells that have not yet been loaded.  When cells are visible before loading, the geometry will "pop-in" suddenly, creating a jarring visual effect.  To prevent this effect, this value must be less than:
 
  8192 * exterior cell load distance - 1024
 
The constant 8192 is the size of a cell, and 1024 is the threshold distance for loading a new cell.  Additionally, the "field of view" setting also interacts with this setting because the view frustrum end is a plane, so you can see further at the edges of the screen than you should be able to.  This can be observed in game by looking at distant objects and rotating the camera so the object are near the edge of the screen.  As a result, the "viewing distance" setting should further be reduced by a factor that depends on the "field of view" setting.  In the default configuration this reduction is 7%. Using this factor, approximate values recommended for other "exterior cell load distance" settings are: 14285 for 2 cells, 21903 for 3 cells, 29522 for 4 cells, and 35924 for 5 cells.
 
Reductions of up 25% or more can be required to completely eliminate pop-in for wide fields of view and long viewing distances near the edges of the screen, but such situations are unusual and probably not worth the performance penalty introduced by loading geometry obscured by fog in the center of the screen. See RenderingManager::configureFog for the relevant source code.
 
The default value is 6666.0. This setting can be adjusted in game from the ridiculously low value of 2000 to a maximum of 6666, using the "View Distance" slider in the Detail tab of the Video panel of the Options menu.

Latest revision as of 14:02, 23 October 2017

Settings documentation moved to external source

The current version can be found at: https://openmw.readthedocs.io/en/master/reference/modding/settings/camera.html