mirror of
				https://github.com/OpenMW/openmw.git
				synced 2025-11-04 04:56:39 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			132 lines
		
	
	
	
		
			5.1 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
			
		
		
	
	
			132 lines
		
	
	
	
		
			5.1 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
Water Settings
 | 
						|
##############
 | 
						|
 | 
						|
.. note::
 | 
						|
	The settings for the water shader are difficult to describe,
 | 
						|
	but can be seen immediately in the Water tab of the Video panel in the Options menu.
 | 
						|
	Changes there will be saved to these settings.
 | 
						|
	It is suggested to stand on the shore of a moderately broad body of water with trees or other objects
 | 
						|
	on the far shore to test reflection textures,
 | 
						|
	underwater plants in shallow water near by to test refraction textures,
 | 
						|
	and some deep water visible from your location to test deep water visibility.
 | 
						|
 | 
						|
shader
 | 
						|
------
 | 
						|
 | 
						|
:Type:		boolean
 | 
						|
:Range:		True/False
 | 
						|
:Default:	False
 | 
						|
 | 
						|
This setting enables or disables the water shader, which results in much more realistic looking water surfaces,
 | 
						|
including reflected objects and a more detailed wavy surface.
 | 
						|
 | 
						|
This setting can be toggled with the Shader button in the Water tab of the Video panel of the Options menu.
 | 
						|
 | 
						|
rtt size
 | 
						|
--------
 | 
						|
 | 
						|
:Type:		integer
 | 
						|
:Range:		> 0
 | 
						|
:Default:	512
 | 
						|
 | 
						|
The setting determines the size of the texture used for reflection and refraction (if enabled).
 | 
						|
For reflection, the texture size determines the detail of reflected images on the surface of the water.
 | 
						|
For refraction, the texture size determines the detail of the objects on the other side of the plane of water
 | 
						|
(which have a wavy appearance caused by the refraction).
 | 
						|
RTT is an acronym for Render To Texture which allows rendering of the scene to be saved as a texture.
 | 
						|
Higher values produces better visuals and result in a marginally lower frame rate depending on your graphics hardware.
 | 
						|
 | 
						|
In the Water tab of the Video panel of the Options menu, the choices are Low (512), Medium (1024) and High (2048).
 | 
						|
This setting has no effect if the shader setting is false.
 | 
						|
It is recommended to use values that are a power of two because this results in more efficient use of video hardware.
 | 
						|
 | 
						|
This setting has no effect if the shader setting is false.
 | 
						|
 | 
						|
refraction
 | 
						|
----------
 | 
						|
 | 
						|
:Type:		boolean
 | 
						|
:Range:		True/False
 | 
						|
:Default:	False
 | 
						|
 | 
						|
This setting enables the refraction rendering feature of the water shader.
 | 
						|
Refraction causes deep water to be more opaque
 | 
						|
and objects seen through the plane of the water to have a wavy appearance.
 | 
						|
Enabling this feature results in better visuals, and a marginally lower frame rate depending on your graphics hardware.
 | 
						|
 | 
						|
This setting has no effect if the shader setting is false.
 | 
						|
 | 
						|
This setting can be toggled with the 'Refraction' button in the Water tab of the Video panel of the Options menu.
 | 
						|
 | 
						|
reflection detail
 | 
						|
-----------------
 | 
						|
 | 
						|
:Type:		integer
 | 
						|
:Range:		0, 1, 2, 3, 4, 5
 | 
						|
:Default:	2
 | 
						|
 | 
						|
Controls what kinds of things are rendered in water reflections.
 | 
						|
 | 
						|
0: only sky is reflected
 | 
						|
1: terrain is also reflected
 | 
						|
2: statics, activators, and doors are also reflected
 | 
						|
3: items, containers, and particles are also reflected
 | 
						|
4: actors are also reflected
 | 
						|
5: groundcover objects are also reflected
 | 
						|
 | 
						|
In interiors the lowest level is 2.
 | 
						|
This setting can be changed ingame with the "Reflection shader detail" dropdown under the Water tab of the Video panel in the Options menu.
 | 
						|
 | 
						|
rain ripple detail
 | 
						|
------------------
 | 
						|
 | 
						|
:Type:		integer
 | 
						|
:Range:		0, 1, 2
 | 
						|
:Default:	1
 | 
						|
 | 
						|
Controls how detailed the raindrop ripples on water are.
 | 
						|
 | 
						|
0: single, non-normal-mapped ring per raindrop
 | 
						|
1: normal-mapped raindrops, with multiple rings
 | 
						|
2: same as 1, but with a greater number of raindrops
 | 
						|
 | 
						|
This setting can be changed ingame with the "Rain ripple detail/density" dropdown under the Water tab of the Video panel in the Options menu.
 | 
						|
 | 
						|
small feature culling pixel size
 | 
						|
--------------------------------
 | 
						|
 | 
						|
:Type:		floating point
 | 
						|
:Range:		> 0
 | 
						|
:Default:	20.0
 | 
						|
 | 
						|
Controls the cutoff in pixels for small feature culling - see the 'Camera' section for more details,
 | 
						|
however this setting in the 'Water' section applies specifically to objects rendered in water reflection
 | 
						|
and refraction textures.
 | 
						|
 | 
						|
The setting 'rtt size' interacts with this setting
 | 
						|
because it controls how large a pixel on the water texture (technically called a texel) is in pixels on the screen.
 | 
						|
 | 
						|
This setting will have no effect if the shader setting is false,
 | 
						|
or the 'small feature culling' (in the 'Camera' section) is disabled.
 | 
						|
 | 
						|
This setting can only be configured by editing the settings configuration file.
 | 
						|
 | 
						|
refraction scale
 | 
						|
----------------
 | 
						|
 | 
						|
:Type:		floating point
 | 
						|
:Range:		0 to 1
 | 
						|
:Default:	1.0
 | 
						|
 | 
						|
Simulates light rays refracting when transitioning from air to water, which causes the space under water look scaled down
 | 
						|
in height when viewed from above the water surface. Though adding realism, the setting can cause distortion which can
 | 
						|
make for example aiming at enemies in water more challenging, so it is off by default (i.e. set to 1.0). To get a realistic
 | 
						|
look of real-life water, set the value to 0.75.
 | 
						|
 | 
						|
This setting only applies if water shader is on and refractions are enabled. Note that if refractions are enabled and this
 | 
						|
setting if off, there will still be small refractions caused by the water waves, which however do not cause such significant
 | 
						|
distortion.
 | 
						|
 | 
						|
.. warning::
 | 
						|
    The `refraction scale` is currently mutually exclusive to underwater shadows. Setting this to any value except 1.0
 | 
						|
    will cause underwater shadows to be disabled. This will be addressed in issue https://gitlab.com/OpenMW/openmw/-/issues/5709
 |