1个不稳定版本

0.1.0	2020年9月20日

#5 在 #mipmap

MIT 许可证

86KB
2K SLoC

wgpu-mipmap

为 wgpu 纹理生成Mipmap。

用法

将此添加到您的 Cargo.toml

[dependencies]
wgpu-mipmap = "0.1"

示例用法

use wgpu_mipmap::*;
fn example(device: &wgpu::Device, queue: &wgpu::Queue) -> Result<(), Error> {
    // create a recommended generator
    let generator = RecommendedMipmapGenerator::new(&device);
    // create and upload data to a texture
    let texture_descriptor = wgpu::TextureDescriptor {
        size: wgpu::Extent3d {
            width: 512,
            height: 512,
            depth: 1,
        },
        mip_level_count: 10, // 1 + log2(512)
        sample_count: 1,
        format: wgpu::TextureFormat::Rgba8Unorm,
        dimension: wgpu::TextureDimension::D2,
        usage: wgpu::TextureUsage::STORAGE,
        label: None,
    };
    let texture = device.create_texture(&texture_descriptor);
    // upload_data_to_texture(&texture);
    // create an encoder and generate mipmaps for the texture
    let mut encoder = device.create_command_encoder(&Default::default());
    generator.generate(&device, &mut encoder, &texture, &texture_descriptor)?;
    queue.submit(std::iter::once(encoder.finish()));
    Ok(())
}

功能

wgpu-mipmap 目前处于早期开发阶段，只能为2D浮点格式纹理生成Mipmap。该库实现了几个后端，以支持各种纹理使用模式

ComputeMipmapGenerator：用于具有 TextureUsage::STORAGE 使用的2的幂次方纹理。使用计算管线生成Mipmap。
RenderMipmapGenerator：用于具有 TextureUsage::OUTPUT_ATTACHMENT 使用的纹理。使用渲染管线生成Mipmap。
CopyMipmapGenerator：用于具有 TextureUsage::SAMPLED 使用的纹理。分配一个新的纹理，使用渲染管线在新的纹理中生成Mipmap，然后将结果复制回原始纹理。
RecommendedMipmapGenerator：根据纹理使用情况使用上述实现之一（优先使用计算后端，其次是渲染后端，最后是复制后端）。

开发

运行示例

示例测试各种用例并生成图像供人工检查和比较。

$ cargo run --example cat
$ cargo run --example checkerboard

运行测试

$ cargo test

如何编译着色器

$ make build-shaders

有关依赖项和更多信息，请参阅 src/shaders/README.md。

基准测试

待办事项

资源

依赖项

~3.5–9MB
~164K SLoC