Strolle 开源项目使用教程

Strolle 开源项目使用教程

strolleExperimental real-time renderer with support for dynamic global illumination项目地址:https://gitcode.com/gh_mirrors/st/strolle

1. 项目介绍

Strolle 是一个实验性的实时渲染器，支持动态全局光照。它的目标是探索现代实时照明技术，如 ReSTIR，并测试这些技术在消费级硬件上的表现，尤其是那些没有专用光线追踪核心的硬件。Strolle 与 Bevy 引擎集成，但也可以通过 wgpu 独立使用。

主要特性

• 支持动态全局光照
• 集成 Bevy 引擎
• 支持 ReSTIR DI 和 ReSTIR GI 算法
• 支持 SVGF 算法

2. 项目快速启动

环境准备

确保你已经安装了 Rust 和 Cargo。如果没有安装，可以通过以下命令安装：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

克隆项目

git clone https://github.com/Patryk27/strolle.git
cd strolle

运行示例

cargo run --release --example demo

示例代码

以下是一个简单的示例代码，展示如何在 Bevy 项目中使用 Strolle：

use bevy::prelude::*;
use bevy_strolle::prelude::*;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_plugins(StrollePlugin)
        .add_systems(Startup, setup)
        .run();
}

fn setup(mut commands: Commands) {
    commands.spawn(Camera3dBundle {
        camera_render_graph: CameraRenderGraph::new(bevy_strolle::graph::NAME),
        camera: Camera {
            hdr: true,
            ..default()
        },
        ..default()
    });
}

3. 应用案例和最佳实践

应用案例

Strolle 可以用于开发需要实时全局光照效果的游戏和应用，特别是在需要高质量光照效果但硬件性能有限的情况下。例如，可以使用 Strolle 来创建一个具有动态光照效果的地下城场景。

最佳实践

• 分辨率优化：在非高端 GPU 上，建议使用较低的分辨率（如 800x600）并进行上采样，以提高性能。
• 避免混合使用：由于 Strolle 完全覆盖了 Bevy 的相机图，因此不能与 Bevy 的特效（如 Bloom 或 TAA）一起使用。
• 调试模式：在开发过程中，可以使用 Strolle 提供的调试模式来查看不同的光照组件，如直接漫反射光照、直接镜面反射光照等。

4. 典型生态项目

Bevy 引擎

Strolle 与 Bevy 引擎紧密集成，Bevy 是一个简单、模块化和可扩展的游戏引擎，非常适合用于开发 2D 和 3D 游戏。

wgpu

wgpu 是一个基于 WebGPU API 的图形库，Strolle 可以通过 wgpu 独立使用，适用于需要自定义图形管线的项目。

ReSTIR

ReSTIR 是一种实时采样技术，用于提高全局光照的质量和效率，Strolle 实现了 ReSTIR DI 和 ReSTIR GI 算法。

SVGF

SVGF 是一种可扩展的体积全局光照技术，Strolle 也支持 SVGF 算法，用于提高全局光照的质量。

通过以上模块的介绍，你可以快速上手并深入了解 Strolle 项目。

strolleExperimental real-time renderer with support for dynamic global illumination项目地址:https://gitcode.com/gh_mirrors/st/strolle