Struct RenderSurface 

pub struct RenderSurface { /* private fields */ }

渲染表面

管理窗口表面、交换链配置和帧缓冲，提供渲染目标管理功能。

设计理念

• 自适应配置: 根据设备能力自动配置表面参数
• 动态调整: 支持窗口大小变化时的动态重配置
• 格式选择: 自动选择最佳的纹理格式和呈现模式
• 错误恢复: 处理表面丢失等异常情况

示例

use anvilkit_render::renderer::{RenderDevice, RenderSurface};
use std::sync::Arc;
use winit::window::Window;
 
// 创建设备和表面
// let window = Arc::new(window);
// let device = RenderDevice::new(&window).await?;
// let surface = RenderSurface::new(&device, &window)?;
 
// 获取当前帧
// let frame = surface.get_current_frame()?;

Implementations

impl RenderSurface

pub fn new(device: &RenderDevice, window: &Arc<Window>) -> Result<Self>

创建新的渲染表面

参数

• device: 渲染设备
• window: 窗口实例

返回

成功时返回 RenderSurface 实例，失败时返回错误

示例

use anvilkit_render::renderer::{RenderDevice, RenderSurface};
use std::sync::Arc;
use winit::window::Window;
 
// let window = Arc::new(window);
// let device = RenderDevice::new(&window).await?;
// let surface = RenderSurface::new(&device, &window)?;

pub fn new_with_vsync( device: &RenderDevice, window: &Arc<Window>, vsync: bool, ) -> Result<Self>

创建新的渲染表面（指定 vsync 模式）

• vsync = true: 使用 PresentMode::Fifo（垂直同步）
• vsync = false: 优先使用 PresentMode::Mailbox（三重缓冲，低延迟）

pub fn resize( &mut self, device: &RenderDevice, width: u32, height: u32, ) -> Result<()>

调整表面大小

参数

• device: 渲染设备
• width: 新的宽度
• height: 新的高度

返回

成功时返回 Ok(())，失败时返回错误

示例

surface.resize(device, 1920, 1080)?;

pub fn get_current_frame(&self) -> Result<SurfaceTexture>

获取当前帧纹理

返回

成功时返回 SurfaceTexture，失败时返回错误

示例

let frame = surface.get_current_frame()?;
let view = frame.texture.create_view(&Default::default());
// 使用纹理视图进行渲染
frame.present();

pub fn reconfigure(&self, device: &RenderDevice)

重新配置表面（用于 Lost/Outdated 恢复）

pub fn get_current_frame_with_recovery( &self, device: &RenderDevice, ) -> Result<SurfaceTexture>

获取当前帧，自动恢复 Lost/Outdated 错误

如果首次获取失败（Lost 或 Outdated），自动 reconfigure 后重试一次。

pub fn config(&self) -> &SurfaceConfiguration

获取表面配置

返回

返回当前的表面配置

示例

let config = surface.config();
println!("表面大小: {}x{}", config.width, config.height);

pub fn format(&self) -> TextureFormat

获取纹理格式

返回

返回当前的纹理格式

示例

let format = surface.format();
println!("纹理格式: {:?}", format);

pub fn size(&self) -> (u32, u32)

获取表面大小

返回

返回 (宽度, 高度) 元组

示例

let (width, height) = surface.size();
println!("表面大小: {}x{}", width, height);

pub fn surface(&self) -> &Surface<'static>

获取表面引用

返回

返回 wgpu 表面的引用

示例

let wgpu_surface = surface.surface();
// 使用原始表面进行高级操作