> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rageon.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Rendering quality

> Trade image quality for speed with presets, render scale, shadows, and display options.

**Configure the view** → **Rendering** controls how the map looks and how fast it runs. Choices apply live, so you see the result behind the dialog.

![Map settings dialog on the Rendering tab showing Quality presets, Antialiasing, Display, Scene, and Graphics API sections](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/map/map-rendering-quality.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=0011829ab647fd555eda744a3a47ce76)

Map settings, Rendering tab, with the Ultra preset.

## Pick a preset

**Preset** in **Quality** sets resolution, shadows, textures, waves, glow, and light count together. **Render scale** is in **Antialiasing**.

| Preset | Render scale | Shadows | Reduced textures | Ocean waves | Blown-out glow | Lights per frame |
| - | - | - | - | - | - | - |
| **Ultra** | 100% | On, 2048 | Off | On | On | 128 |
| **High** | 100% | On, 1024 | Off | On | On | 128 |
| **Medium** | 85% | On, 1024 | Off | On | Off | 64 |
| **Low** | 70% | Off, 512 | On | Off | Off | 16 |

**Low** also turns antialiasing off. The other presets keep your antialiasing choice. Presets do not touch **Detail distance**, **Time of day**, **Weather**, **VSync**, or **Frame cap**.

On computers with an integrated GPU, Rageon starts on **Medium** with a lower **Detail distance**.

Change **Render scale**, **Shadows**, **Shadow resolution**, **Reduced textures**, **Ocean waves**, **Blown-out glow**, or **Lights per frame** and the footer reads **Custom · applied live**, with **Custom — the controls below don't match any step.** shown above. That is not an error.

![Map settings with the Low preset selected, shadows off, and antialiasing Method set to Off](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/map/map-rendering-low.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=9a48b0d913fcde4727b3ef89516af481)

Low preset: lower scale, no shadows, and Method set to Off.

> [!TIP]
>
> If the map is slow, move to **Medium**, then **Low**. If only the sea or the night is slow, turn off **Ocean waves** or lower **Lights per frame** first.

## Display and scene options

![Map settings showing VSync, Frame cap, Shadows, Shadow resolution, Detail distance, Reduced textures, Ocean waves, Blown-out glow, and Lights per frame](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/map/map-rendering-scene.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=11db387352cf70dba08a7f1313dbd5de)

Display and Scene options.

| Option | What it does | Default |
| - | - | - |
| **VSync** | Matches presentation to your display. Off can allow tearing. On some computers it is forced on and cannot be changed. | Off |
| **Frame cap** | Target frames per second, from **30** up to **1000 (maximum)**. With **VSync** on, a cap above your display's refresh rate does not make the picture smoother. | The option marked **(default)** |
| **Shadows** | Directional shadows. The scene stays lit when they are off. | On |
| **Shadow resolution** | Shadow detail: **512**, **1024**, **2048**, or **4096**. Disabled when **Shadows** is off. | **1024** |
| **Detail distance** | How far the detailed world is drawn, 50 to 150%. Lower values drop distant detail first. Independent of the preset. | 100% |
| **Reduced textures** | Lowers large-texture detail and video-memory use. Textures already on screen can take a moment to change. | Off |
| **Ocean waves** | Animates the sea. Off freezes the wave shape. | On |
| **Blown-out glow** | Adds a halo around bright areas. | On |
| **Lights per frame** | How many local lamps light the scene at once: **8**, **16**, **32**, **64**, or **128**. The farthest lamps drop first. You see it most at night and inside interiors. | **128** |

## Graphics API

**Backend** chooses **Automatic**, **DX12**, or **Vulkan**. **In use:** shows the option, GPU, and driver in effect. Changing it reloads the world briefly. **Automatic** uses DX12 when your computer has a DX12 GPU, and Vulkan otherwise. If the map opens black after you choose **Vulkan**, switch back to **DX12**.

## Check the effect

Click **Performance** in the dock to compare frame rate (**fps**), time per frame (**ms**), the worst recent frame, and hitches per two seconds while you fly the same route. It also shows how many entities are active or incoming and how many cells are loaded at each detail level.

Turn on **Renderer overlay** under **Diagnostics** for on-screen frame and resolution text. **F1** toggles the same overlay. It resets each time you open the map.

## Restore defaults

**Restore defaults** puts every setting on this tab back to its default, and also resets **Time of day**, **Real-time clock**, **Clock speed**, **Weather** and the **Technical view** options. It does not change **Add-ons**. The footer shows **Session defaults** when nothing differs.

## Troubleshooting

> **Couldn't apply: …**
>
> The setting was not accepted. Choose a different value or method.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.