Module mip_generation

Downsampling of textures to produce mipmap levels.

Currently, this module only supports generation of hierarchical Z buffers for occlusion culling. It’s marked experimental because the shader is designed only for power-of-two texture sizes and is slightly incorrect for non-power-of-two depth buffer sizes.

Structs

DepthPyramidDummyTexture

Stores a placeholder texture that can be bound to a depth pyramid binding if no depth pyramid is needed.

DownsampleDepthNode

The nodes that produce a hierarchical Z-buffer, also known as a depth pyramid.

DownsampleDepthPipeline

A single depth downsample pipeline.

DownsampleDepthPipelineKey

Uniquely identifies a configuration of the downsample depth shader.

DownsampleDepthPipelines

Stores all depth buffer downsampling pipelines.

MipGenerationPlugin

A plugin that allows Bevy to repeatedly downsample textures to create mipmaps.

ViewDepthPyramid

Stores a hierarchical Z-buffer for a view, which is a series of mipmaps useful for efficient occlusion culling.

ViewDownsampleDepthBindGroup

The bind group that we use to attach the depth buffer and depth pyramid for a view to the downsample_depth.wgsl shader.

Constants

DEPTH_PYRAMID_MIP_COUNT

The maximum number of mip levels that we can produce.

DOWNSAMPLE_DEPTH_SHADER_HANDLE

Identifies the downsample_depth.wgsl shader.

Functions

create_depth_pyramid_dummy_texture

Creates a placeholder texture that can be bound to a depth pyramid binding if no depth pyramid is needed.

prepare_view_depth_pyramids

Creates depth pyramids for views that have occlusion culling enabled.