Global Water

Global Water is an infinitely spread mesh with auto-tessellation that represents a boundless ocean (the wireframe of the water is not scaled; regardless of the camera position it always stays the same). It is optimized so the GPU is not overloaded.Global Water 是一个无限扩展的网格，具有自动细分，代表无边的海洋（水的线框未缩放；无论相机位置如何，它始终保持不变）。它经过优化，因此 GPU 不会过载。

The object has support for the underwater mode. However, it cannot have a body assigned, and thus does not provide proper physical interaction with scene objects. If you need to simulate the physics of buoyancy, you should use Physical Water. Also it is limited to a single water level. It means that the filling level of water always remains the same. So, if you need to create, for example, mountain lakes or water flows with height difference, you should use Water Mesh.该对象支持水下模式。但是，它不能分配一个身体，因此不能提供与场景对象的适当物理交互。如果你需要模拟浮力的物理特性，你应该使用 Physical Water。它也仅限于单一水位。这意味着水的填充水平始终保持不变。因此，如果您需要创建，例如，高差的高山湖泊或水流，您应该使用 Water Mesh。

With Global Water you can create waves using wave layers, Beaufort scale or manually and ensure smooth transitions between various states of the sea.使用 Global Water，您可以使用波浪层、Beaufort 比例或手动创建波浪，并确保海洋的各种状态之间的平滑过渡。

The Global Water object provides full control of the wave spectrum through the API.Global Water 对象提供对波谱的完全控制通过 API .

注意

As the water object uses the screenspace projected grid for the water surface of the infinite size, it is recommended to use only one (1) water object in the scene.由于水对象使用屏幕空间投影网格用于无限大小的水面，因此建议在场景中仅使用一个（1）水对象。

Ocean created with the Global Water object使用 Global Water 对象创建的海洋

See also也可以看看#

To add infinite water to the scene via UnigineEditor:通过 UnigineEditor 向场景中添加无限水：

1. On the Menu bar, click Create -> Water -> Global:在菜单栏上，单击 Create -> Water -> Global：

   

2. Place the water object in the scene:将水对象放置在场景中：

   

Infinite water will be added to the scene and you will be able to edit it via the Parameters window.无限的水将添加到场景中，您将能够通过 Parameters 窗口对其进行编辑。

Water settings can be adjusted via the Parameters window:水设置可以通过 Parameters 窗口进行调整：

• On the Node tab, water surfaces that determine optical and dynamic behaviour of water can be adjusted.在 Node 选项卡上，水面可以调整确定水的光学和动态行为。

There are three options for creating waves:创建波浪有三个选项：

• Layers mode — you create layers on which waves will be randomly generated in a given range of wave parameters. All the layers are added together.图层模式——您创建的图层将在给定的波浪参数范围内随机生成波浪。所有层都加在一起。

  注意

  Wave layers are usually created through UnigineEditor, but you can also create and edit them via code.Wave 图层通常通过 UnigineEditor 创建，但您也可以创建和编辑它们通过代码.
• Beauforts mode — waves are generated based on the presets reproducing the state of the sea according to the Beaufort wind force scale (0 — Calm, 12 — Hurricane). In this mode, the parameters that define the main wave geometry will not be available for editing. Beauforts 模式— 波浪是根据根据 Beaufort 风力等级（0 — 平静，12 — 飓风）再现海况的预设生成的。在此模式下，定义主波几何的参数将不可编辑。

• Manual mode — you create your own individual waves and have full control over them.手动模式——您可以创建自己的个人波浪并完全控制它们。

  注意

  This mode can only be set via code, you cannot do this in UnigineEditor.此模式只能设置通过代码，您无法在 UnigineEditor 中执行此操作。

When you enable the Manual mode, the list of generated waves is cleared and you can set up your own waves.当您启用手动模式时，生成的波形列表将被清除，您可以设置自己的波形。

When you save the world, the layers will be saved, but the user-defined waves will not, since they are created via code.保存世界时，图层将被保存，但用户定义的波浪不会，因为它们是创建的通过代码.

Wave parameters window in UnigineEditor is available on the Node tab and contains the following parts:UnigineEditor 中的 Wave 参数窗口位于 Node 选项卡上，包含以下部分：

CommonCommon#

Parameters common for all wave layers:所有波层通用的参数：

Water Mode	Wave generation mode. Two options are available:波浪生成模式。有两种选择： Layers modeLayers时尚 Beauforts modeBeauforts时尚
Beauforts	Beaufort value from 0 (Calm) to 12 (Hurricane).Beaufort 值从 0（平静）到 12（飓风）。 注意 Available only in Beauforts mode.仅在 Beauforts 模式下可用。
Wind Direction	Angle that determines the wind direction, in degrees.确定风向的角度，以度为单位。
Wind Affect	Determines how much the wind direction affects the waves. The values are within the [0;1] range. If you set it to 1, all the waves will be directed along the wind direction.确定风向对波浪的影响程度。这些值在 [0;1] 范围内。如果将其设置为 1，则所有波浪都将沿风向定向。
Waves Speed Scale	Scale value that affects the speed of all the waves.影响所有波浪速度的比例值。

Waves LayersWaves Layers#

注意

Available when the Layers mode is selected.选择图层模式时可用。

Waves Count

Total number of waves on all layers. 注意 We recommend keeping this value below 100 and use the minimum possible number. The maximum total number of waves is 256, but large numbers significantly affect performance.We recommend keeping this value below 100 and use the minimum possible number. The maximum total number of waves is 256, but large numbers significantly affect performance. We recommend keeping this value below 100 and use the minimum possible number. The maximum total number of waves is 256, but large numbers significantly affect performance.所有层上的波总数。 注意 We recommend keeping this value below 100 and use the minimum possible number. The maximum total number of waves is 256, but large numbers significantly affect performance.我们建议将此值保持在100以下并使用可能的最小值。 Wave 的最大总数为 256，但较大的数字会显着影响性能。

Parameters defined for each layer:为每一层定义的参数：

Layer Weight	Weight of the wave layer determines how much the given layer affects the final wave form.波形层的权重决定了给定层对最终波形的影响程度。
Waves Num	Number of waves on the layer.图层上的波数。
Length Min	Lower limit of the wavelength range for the layer.层的波长范围的下限。
Length Max	Upper limit of the wavelength range for the layer.层的波长范围上限。
Amplitude Min	Lower limit of the wave amplitude range for the layer.层的波幅范围的下限。
Amplitude Max	Upper limit of the wave amplitude range for the layer.图层的波幅范围上限。
Steepness Scale	The sharpness of the wave crests. To make waves look more plausible, the engine moves the vertices near the wave crest closer to the crest and recalculates their normals. This parameter specifies the force of the described contraction. Available range: [0; 1], default: 1. Lower Steepness ScaleLower Steepness Scale Higher Steepness ScaleHigher Steepness Scale Lower Steepness ScaleHigher Steepness ScaleThe sharpness of the wave crests. To make waves look more plausible, the engine moves the vertices near the wave crest closer to the crest and recalculates their normals. This parameter specifies the force of the described contraction. Available range: [0; 1], default: 1. Lower Steepness Scale低陡度量表 Higher Steepness Scale更高的陡峭程度
Direction Angle Variance	Variance of the wave direction angle for the layer. If you set it to 90, the angles will be random between -90 and 90 relative to the wind direction.层的波方向角的变化。如果将其设置为 90，则相对于风向的角度将在 -90 和 90 之间随机变化。

Fields InteractionFields Interaction#

Parameters defining interaction with Field objects:定义与 Field 对象交互的参数：

Field Spacer Enabled	Enables the effect of FieldSpacer object on the Global Water object.启用 FieldSpacer 对象对 Global Water 对象的效果。
Field Height Enabled	Enables the effect of FieldHeight object on the Global Water object.启用 FieldHeight 对象对 Global Water 对象的效果。
Field Shoreline Enabled	Enables the effect of FieldShoreline object on the Global Water object.启用 FieldShoreline 对象对 Global Water 对象的效果。

NormalNormal#

Parameters defining wave normals:定义波法线的参数：

Geometry Normal Intensity	Intensity of normals of the waves.波的法线强度。
Texture Normal Blur	Blurring ratio for the procedurally generated normals. This parameter enables you to reduce pixelation of the normal map, and make it less pronounced. It is recommended to use small values for correction, when necessary. This affects the normals generated for Field Height and Field Shoreline.程序生成的法线的模糊率。此参数使您能够减少法线贴图的像素化，并使其不那么明显。如有必要，建议使用较小的值进行校正。这会影响为场高和外地海岸线.
Texture Normal Intensity	Intensity of procedurally generated normals. This affects the normals generated for Field Height and Field Shoreline.程序生成的法线的强度。这会影响为场高和外地海岸线.

DetailDetail#

Parameters defining normal detail texture:定义法线细节纹理的参数：

Normal Map	The Normal Detail map stores normal information required to achieve an additional (detail) effect of Normal Mapping. Normal map helps to create ripples (cat's-paw effect) on the water surface.法线细节贴图存储实现法线贴图的附加（细节）效果所需的法线信息。法线贴图有助于在水面上创建波纹（猫爪效果）。 The texture is 2-channeled:纹理是 2 通道的： RG values store two components of a surface normal.RG 值存储表面法线的两个分量。 B value is calculated based on the R and G values in run-time.B 值是根据运行时的 R 和 G 值计算得出的。 With absolutely white normal map带有绝对白色的法线贴图 With ripple-simulated normal map使用波纹模拟法线贴图
Detail 0 UV Transform	Specifies the UV transform for the first sample of the normal detail texture. The first two values are the scale texture coordinates along the X and Y axes. The third and forth specify the wind force and direction for the U and V axes.指定法线细节纹理的第一个样本的 UV 变换。前两个值是沿 X 和 Y 轴的缩放纹理坐标。第三个和第四个指定 U 轴和 V 轴的风力和方向。
Detail 0 Intensity	Intensity of the first sample of the normal detail texture.法线细节纹理的第一个样本的强度。 注意 Available only in Layers mode.仅在图层模式下可用。
Detail 1 UV Transform	Specifies the UV transform for the second sample of the normal detail texture. The first two values are the scale texture coordinates along the X and Y axes. The third and forth specify the wind force and direction for the U and V axes.指定法线细节纹理的第二个样本的 UV 变换。前两个值是沿 X 和 Y 轴的缩放纹理坐标。第三个和第四个指定 U 轴和 V 轴的风力和方向。
Detail 1 Intensity	Intensity of the second sample of the normal detail texture.法线细节纹理的第二个样本的强度。 注意 Available only in Layers mode.仅在图层模式下可用。

Distant WavesDistant Waves#

Global Water has two parts: the waves on the inner part, which is close to the camera, are generated based on the wave spectrum, and all the rest — distant waves (simplified waves rendered starting at a certain distance from the camera to save performance), that are created by using a Normal map. The two parts are blended at a certain distance to ensure a smooth transition between them.Global Water 有两部分：内部的波，靠近相机，是根据波谱生成的，其余的 - 远波（从相机一定距离开始渲染的简化波以节省性能） ，通过使用法线贴图创建。两个部分以一定的距离混合，以确保它们之间的平滑过渡。

Parameters defining distant waves:定义远波的参数：

Normal Map	The Normal Map texture is used to create ripples on the water surface for distant waves.法线贴图纹理用于在水面上为远处的波浪创建波纹。 The texture is 2-channeled:纹理是 2 通道的： RG — normal components.RG — 普通组件。
UV Transform	UV transform for the distant waves normal map. The first two values (x,y) — represent the scale for texture coordinates along the X and Y axes, while the third and forth (z, w) — specify the speed of movement animation.远波法线贴图的UV变换。前两个值 (x,y) — 表示纹理坐标沿 X 和 Y 轴的比例，而第三个和第四个值 (z, w) — 指定移动动画的速度。
Intensity	Intensity value for the normal map of the distant waves. 注意 Unavailable for modes with Beaufort levels blending.Unavailable for modes with Beaufort levels blending. Unavailable for modes with Beaufort levels blending.远处波的法线贴图的强度值。 注意 Unavailable for modes with Beaufort levels blending.不适用于具有 Beaufort 级别混合的模式。
Blend Min	Minimum amount of distant waves in the crossfade zone where the main geometry waves fade out and distant waves fade in (Blend Distance). The value is normalized in the [0, 1] range.交叉淡入淡出区域中远处波的最小数量，其中主要几何波淡出，远处波淡入 (Blend Distance)。该值在 [0, 1] 范围内标准化。
Blend Max	Maximum amount of distant waves in the crossfade zone where the main geometry waves fade out and distant waves fade in (Blend Distance). The value is normalized in the [0, 1] range.交叉淡入淡出区域中远处波的最大数量，其中主要几何波淡出，远处波淡入 (Blend Distance)。该值在 [0, 1] 范围内标准化。
Blend Distance Start	Fade-in start distance for distant waves.远波的淡入开始距离。
Blend Distance End	Fade-in end distance for distant waves.远处波的淡入结束距离。

FoamFoam#

Parameters defining the foam:定义泡沫的参数：

Texture	This texture specifies foam on water. The engine samples the foam texture twice to create plausibility of the real world foam behavior.此纹理指定了水面上的泡沫。引擎对泡沫纹理进行两次采样，以创建真实世界泡沫行为的合理性。 The texture is 3-channeled:纹理是 3 通道的： RGB values store the color.RGB 值存储颜色。
Texture Affect	Visibility of the foam texture. It can be used to create additional effects, e.g., foam bubbles.泡沫纹理的可见性。它可用于创建附加效果，例如泡沫。
Patch 0 UV Size	Size of the first foam texture patch.第一个泡沫纹理贴片的大小。
Patch 0 UV Speed	Speed of the first foam patch.第一个泡沫贴片的速度。
Patch 1 UV Size	Size of the second foam texture patch.第二个泡沫纹理贴片的大小。
Patch 1 UV Speed	Speed of the second foam patch.第二个泡沫贴片的速度。
Peak Contrast	Foam contrast on the wave peaks.波峰上的泡沫对比。 注意 Available only in Layers mode.仅在图层模式下可用。
Peak Intensity	Foam intensity on the wave peaks.波峰上的泡沫强度。 注意 Available only in Layers mode.仅在图层模式下可用。
Whitecap Contrast	Foam contrast on the white caps.白色瓶盖上的泡沫对比。 注意 Available only in Layers mode.仅在图层模式下可用。
Whitecap Intensity	Foam intensity on the white caps.白色瓶盖上的泡沫强度。 注意 Available only in Layers mode.仅在图层模式下可用。
Wind Contrast	Contrast of the foam generated based on the wind direction.基于风向生成的泡沫对比。 注意 Available only in Layers mode.仅在图层模式下可用。
Wind Intensity	Intensity of the foam generated based on the wind direction.根据风向产生的泡沫强度。 注意 Available only in Layers mode.仅在图层模式下可用。
Contact Intensity	Foam intensity near shores or different objects in water.海岸附近或水中不同物体的泡沫强度。

Subsurface ScatteringSubsurface Scattering#

Parameters defining the subsurface scattering:定义次表面散射的参数：

Color	Water subsurface scattering (SSS) color.水次表面散射 ( SSS ) 颜色。
Ambient Intensity	Intensity of subsurface scattering for ambient lighting. The lower the value, the faster the light rays dissipate in water.环境照明的次表面散射强度。该值越低，光线在水中消散得越快。
Intensity Through Waves	Intensity of light rays passing through waves. The lower the value, the faster the light rays dissipate in water.穿过波的光线强度。该值越低，光线在水中消散得越快。
Intensity Around Foam	Intensity of subsurface scattering near the foam areas.泡沫区域附近的次表面散射强度。
Diffuse Intensity	Intensity of subsurface scattering for diffuse lighting.漫射照明的次表面散射强度。

UnderwaterUnderwater#

The Underwater parameters adjust the underwater part of the Water Global object.Underwater 参数调整 Water Global 对象的水下部分。

The final color of underwater is calculated using the following formula:水下的最终颜色使用以下公式计算：

Final Color Formula

FinalColor = FogColor * SunLighting^(1/FogSunLighting) + FogColor * EnvLighting^(1/FogEnvLighting)

FogColor, FogSunLighting, and FogEnvLighting are specified in the Underwater section. The other parameters (Sun and Environment lighting) are calculated according to the sun lighting and environment lighting of the scene. In fact, this formula defines how the sun and the environment lights affect the final underwater color.FogColor, FogSunLighting 和 FogEnvLighting 在 Underwater 部分中指定。其他参数（Sun和Environment lighting）根据场景的太阳光照和环境光照计算。事实上，这个公式定义了太阳和环境光如何影响最终的水下颜色。

Underwater DOF	Adds an additional blur effect for underwater and overwater splice to make the waterline look more plausible.为水下和水上拼接添加额外的模糊效果，使水线看起来更合理。 注意 You may need to adjust the quality of waterline calculation in case of medium and high Beaufort values, or if the camera is to be submerged underwater (to see the waterline).您可能需要调整吃水线质量计算在中等和高 Beaufort 值的情况下，或者如果相机被淹没在水下（查看水线）。 Underwater DOF disabled水下自由度禁用 Underwater DOF enabled启用水下自由度
Underwater DOF Distance	Focal distance for the underwater DOF effect.水下自由度效果的焦距。
Depth LUT	LUT texture that shows the color of the bottom. Depending on the depth, the engine chooses the color of the water and multiplies it by the depth LUT texture. This generated LUT shows how deep the photon goes through water until completely scattered.显示底部颜色的 LUT 纹理。根据深度，引擎选择水的颜色并将其与深度 LUT 纹理相乘。这个生成的 LUT 显示了光子穿过水的深度，直到完全散射。 The texture is 4-channeled:纹理是 4 通道的： RGB values store color.RGB 值存储颜色。 A value is used to create "transparent" water near the shore. In other words, it defines the fog density.A 值用于在海岸附近创建“透明”水。换句话说，它定义了雾密度。
Fog Color	Underwater fog color. The Sun and Environment lighting affect this parameter to create the final underwater fog color.水下雾色。太阳和环境照明会影响此参数以创建最终的水下雾色。
Fog Transparency	Transparency of the underwater fog. The higher the value, the more transparent the underwater fog is.水下雾的透明度。值越高，水下雾越透明。
Fog Lighting Depth	Distance from the water surface, in units, up to which the light affects the underwater color.与水面的距离，以单位为单位，灯光影响水下颜色的距离。
Lighting Offset	Height offset for lighting.照明的高度偏移。
Fog Environment Lighting	Degree of impact of the environment lighting on the final underwater color.环境照明对最终水下颜色的影响程度。
Fog Sun Lighting	Degree of impact of the sun lighting on the final underwater color.太阳光照对最终水下颜色的影响程度。
Shafts Intensity	Intensity of the underwater sun shafts.水下太阳轴的强度。
Waterline Size	Size of the borderline between the overwater and underwater environments.水上和水下环境之间边界的大小。 注意 You may need to adjust the quality of waterline calculation in case of medium and high Beaufort values, or if the camera is to be submerged underwater (to see the waterline).您可能需要调整吃水线质量计算在中等和高 Beaufort 值的情况下，或者如果相机被淹没在水下（查看水线）。

Planar ReflectionPlanar Reflection#

Parameters defining planar reflections:定义平面反射的参数：

Planar Reflection	Enables the use of planar reflections on the water surface instead of SSR. It is better to use this option for undisturbed water (0-2 Beaufort).允许在水面上使用平面反射而不是 SSR。最好将此选项用于未受干扰的水（0-2 Beaufort）。
Map Size	Size of the planar reflection map. The higher the value, the better the quality.平面反射贴图的大小。值越高，质量越好。
Viewport Mask	The viewport mask of the reflection camera. A surface has its reflection rendered, if its viewport mask and its material's viewport mask match this mask.这视口遮罩的反射相机。如果表面的视口蒙版和材质的视口蒙版与此蒙版匹配，则表面会渲染其反射。
Distance	Distance from the reflection viewport camera to the reflected object. This distance sums up to the distance from the camera to the reflective surface plus the distance from object to reflective surface.从反射视口相机到反射对象的距离。这个距离等于从相机到反射面的距离加上从物体到反射面的距离。
Pivot Offset	Position of the reflection pivot point.反射轴点的位置。

ReflectionReflection#

Parameters defining environment reflections:定义环境反射的参数：

Roughness	Environment reflection roughness of the water surface. This parameter helps to tweak reflections on the water surface relative to the environment.水面的环境反射粗糙度。此参数有助于调整相对于环境的水面反射。
Occlusion	The occlusion factor for environment reflections on parts of the water surface with negative normals. Using this parameter enables simulation of reflection of waves on the water surface removing too bright areas on waves close to the horizon.The occlusion factor for environment reflections on parts of the water surface with negative normals. Using this parameter enables simulation of reflection of waves on the water surface removing too bright areas on waves close to the horizon. By the minimum value of 0, no occlusion is performed for reflections of waves, no matter what normals the water surface has.By the minimum value of 0, no occlusion is performed for reflections of waves, no matter what normals the water surface has. By the higher values, occlusion is performed for reflections on parts of the water surface with negative normals that have a certain slope. The higher the value, the less intensive reflections are on the surface parts with negative normals. By the higher values, occlusion is performed for reflections on parts of the water surface with negative normals that have a certain slope. The higher the value, the less intensive reflections are on the surface parts with negative normals. The occlusion factor for environment reflections on parts of the water surface with negative normals. Using this parameter enables simulation of reflection of waves on the water surface removing too bright areas on waves close to the horizon.By the minimum value of 0, no occlusion is performed for reflections of waves, no matter what normals the water surface has.By the higher values, occlusion is performed for reflections on parts of the water surface with negative normals that have a certain slope. The higher the value, the less intensive reflections are on the surface parts with negative normals. The occlusion factor for environment reflections on parts of the water surface with negative normals. Using this parameter enables simulation of reflection of waves on the water surface removing too bright areas on waves close to the horizon.具有负法线的部分水面上环境反射的遮挡因子。使用此参数可以模拟海浪在水面上的反射，从而消除靠近地平线的海浪上过于明亮的区域。 By the minimum value of 0, no occlusion is performed for reflections of waves, no matter what normals the water surface has.通过 0 的最小值，无论水面的法线如何，都不会对波的反射执行遮挡。 By the higher values, occlusion is performed for reflections on parts of the water surface with negative normals that have a certain slope. The higher the value, the less intensive reflections are on the surface parts with negative normals. 通过较高的值，对具有一定负法线的水面部分反射执行遮挡坡.该值越高，具有负法线的表面部分上的反射强度越小。
Occlusion Slope	Slope of negative normals of the water surface, at which occlusion is performed for wave reflections.水面负法线的斜率，在该处对波反射执行遮挡。