The Controller Actor ‐ Changing Scene and Rendering Settings - Dechetmew/Aquaray-Raytracing-Renderer-for-Unreal-5.2.1 GitHub Wiki
How to Use the Controller actor
- Currently the Raytracer is controlled using a Blueprint actor that must be placed in the scene
- You can find the Actor inside the Example Project
- It uses Material Parameter Collections to send values to the Shader (In the future, some of these settings will be upgraded to use proper CVars)
- NOTE: Settings have lower and Upper Bounds hardcoded in the Shader as Needed, Modify at your own Risk
Buttons
Apply Settings - Sets all Changes and values to the Shader Recompile Shaders - Forces the Editor to Recompile all Shaders that were edited, Usefull for Shader Development Enable Aquaray - Replaces the Default Shading Pipeline with AquaRay Disable Aquaray - Switches back to Vannila Rendering
Settings
POST - Modifies Settings Related to the Post Process Material
- Exposure - Adjusts Exposure
WORLD - Modifies Settings Related to the Scene
- Sky Texture - Sets an HDR Backdrop
- Sky Texture Rotation - Rotates the Sky Texture
- Disable Built-In Skylight - Disables the Skylight Actor Attached to the Controller
- Primary Light Exponent - Sun/Moon Intensity Multiplier
- Primary Light Color - Sets the Sun/Moon Light Color (in Kilolux)
- Primary Light Direction/Height - Sets the Sun/Moon Direction
- Ambient Light Color - Color used in Shadowed Areas (in Kilolux)
- Fog Density - Overall Density of Height Fog. Zero Disables Fog Evaluation
- Fog Color - Color of Fog
- Fog Top/Bottom Height - Height Range where Density Changes by Height (in Centimeters)
- Fog Amount Top/Bottom - Fog Density at Top and Bottom Cutoffs (in Centimeters)
- Water Density - These settings are related to Absorbtion effects when Underwater, zero Density disables the Effect. Note that this does not Disable Water Materials
- Water Level - Height of the World Water Plane in Centimeters
- Water Color - Water Absorbtion Color
RT - Settings Related to the Shader Itself
- MAX STEPS - Maximum Amount of Raypath Steps per Pixel
- Sky Visual Brightness - Adjust HDRI Sky Brightness
- Detail Lighting Mode - Currently the Raytracer uses a Silly 5 Ray Kernel Sampler for Short Range Lighting. Will be replaced with proper Lighting Soon hopefully. 0=DISABLED, 1=AMBIENT OCCLUSION, 2=AMBIENT OCCLUSION + EMISSIVE GLOW
- Debug Viewmode - Switches between Various Debug Visualisations. Refer to AquarayMain.usf (at the bottom of the file) for All Available modes
- Render Distance - Defines Main Ray Lenght in Meters, Works as Render Distance or Far Clipping Distance, in Centimeters
- Shadow Trace Dist - Defines Shadow Ray Lenght, any Meshes too far dont cast shadows
ENGINE - Quick Engine Settings
Max Framerate - Caps out at 120fps, should be Set slightly above Vsync Target Enable Vsync - Vertical Sync, Removes Screen Tearing and Locks at Monitor Refresh Rate