Skip to content

Render device unavailability

Generated from engine/render/device_unavailable.h at f525bc6. The text under each declaration is the header's own comment, word for word. About the reference says how these pages are made.

Browse the render module

Audience: game code.

#include "engine/render/device_unavailable.h" · namespace labrador

class RenderDeviceUnavailable : public std::runtime_error

The selected renderer cannot meet its device or context requirements at startup. This does not establish that the machine physically lacks a GPU. The message retains the backend's reason and any native error details.

Catch this category to choose a startup refusal message or an optional graphics policy. It remains a std::runtime_error for existing handlers. Content, shaders, invalid arguments/state, unrelated API failures, audio and runtime device-loss recovery are outside this category. No fallback backend is selected by throwing or catching it.

explicit RenderDeviceUnavailable(const std::string& reason);

Stores reason in the runtime_error base; what() preserves its text.

The files that include this header directly. A file can also reach it through another header.

No guide or concept page links to this header yet.

Documentation for Labrador v0.4.0. Built from Labrador f525bc6 of 2026-11-17.

All documentation versions