Skip to main content

khora_agents/skybox_agent/
mod.rs

1// Copyright 2025 eraflo
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15//! SkyboxAgent — owns the environment-background render pass.
16//!
17//! Runs in the OUTPUT phase after `RenderAgent`, like `OverlayAgent`, and
18//! contributes a single [`SkyboxPass`](khora_data::render::SkyboxPassSlot) to
19//! the FrameGraph (`writes(Color).reads(Depth)`). Its one lane
20//! ([`SkyboxLane`](khora_lanes::render_lane::SkyboxLane)) draws the IBL
21//! environment cube behind the scene geometry (depth-tested, no depth write),
22//! so the visible sky matches what surfaces reflect.
23//!
24//! It is **not** GORNA-negotiated (there is one fixed background pass), but it
25//! is `AgentImportance::Important` — the sky is not debug viz, so it is not
26//! dropped under budget pressure the way the optional overlays are.
27
28mod agent;
29
30pub use agent::*;