18. Frequently Asked Questions#
18.1. Why does the ocean not update smoothly in edit mode?#
By default, the update speed is intentionally throttled by Unity to save power when in edit mode. To enable real-time update, enable Animated Materials in the Scene View toggles:
See the Unity Documentation for more information.
18.2. Why aren’t my prefab mode edits not reflected in the scene view?#
Crest does not support running in prefab mode which means dirty state in prefab mode will not be reflected in the scene view. Save the prefab to see the changes.
18.3. Is Crest well suited for medium-to-low powered mobile devices?#
Crest is built to be performant by design and has numerous quality/performance levers. However it is also built to be very flexible and powerful and as such can not compete with a minimal, mobile-centric ocean renderer such as the one in the BoatAttack project. Therefore we target Crest at PC/console platforms.
18.4. Which platforms does Crest support?#
Testing occurs primarily on MacOS/Windows.
Firstly, make sure your target platform adheres to the Requirements.
We have users targeting the following platforms:
Windows
MacOS
Linux *
Playstation *
Xbox *
Switch * **
iOS * **
Android/Quest * **
Crest also supports VR/XR Multi-Pass and Single Pass Instanced rendering.
For additional platform notes, see Platform Support.
18.5. Is Crest well suited for localised bodies of water such as lakes?#
Yes, see Oceans, Rivers and Lakes for documentation.
18.6. Can Crest work with multiplayer?#
Yes, the animated waves are deterministic and can be synchronised across the network. For more information see Network Synchronisation.
Note however that the dynamic wave sim is not synchronized over the network and should not be relied upon in networked situations.
18.7. Errors are present in the log that report Kernel ‘xxx.yyy’ not found#
Unity sometimes gets confused and needs assets reimported. This can be done by clicking the Crest root folder in the Project window and clicking Reimport. Alternatively the Library folder can be removed from the project root which will force all assets to reimport.
18.9. Does Crest support multiple viewpoints?#
Currently only a single ocean instance can be created, and only one viewpoint is supported at a time. We hope to support multiple simultaneous views in the future.
18.10. Can I sample the water height at a position from C#?#
Yes, see usages of SampleHeightHelper class in SamplingHelpers.cs. The OceanRenderer uses this helper to get the height of the viewer above the water, and makes this viewer height available via the ViewerHeightAboveWater property.
18.11. Can I trigger something when an object is above or under the ocean surface without any scripting knowledge?#
Yes. Please see Detecting Above or Below Water.
18.12. Does Crest support orthographic projection?#
Yes. Please see Orthographic Projection.
18.13. How do I disable underwater fog rendering in the scene view?#
You can enable/disable rendering in the scene view by toggling fog in the scene view control bar.
18.14. Can the density of the fog in the water be reduced?#
The density of the fog underwater can be controlled using the Fog Density parameter on the ocean material. This applies to both above water and underwater. The Depth Fog Density Factor on the Underwater Renderer can reduce the density of the fog for the underwater effect.
18.15. Does Crest support third party sky assets? BIRP URP#
We have heard of Crest users using TrueSky, AzureSky. These may require some code to be inserted into the ocean shader - there is a comment referring to this, search Ocean.shader for ‘Azure’.
Please see the Community Contributions section in our Wiki for some integration solutions.
18.16. Can I remove water from inside my boat?#
Yes, this is referred to as ‘clipping’ and is covered in section Clip Surface.
18.17. How to implement a swimming character?#
As far as we know, existing character controller assets which support swimming do not support waves (they require a volume for the water or physics mesh for the water surface). We have an efficient API to provide water heights, which the character controller could use instead of a physics volume. Please request support for custom water height providers to your favourite character controller asset dev.