Expand description
The main entry point for this library is the Dds type.
§Features
| Feature | Default | Provides |
|---|---|---|
decode | yes | Dds::decode_rgba8, bcdec_rs BCn kernels |
encode | yes | Dds::encode_from_rgba8, EncodeLayout |
Container parse/compose, surfaces, content classification, and GPU upload
plans are always available. Use default-features = false, features = ["decode"]
for loaders / WASM that never encode.
Modules§
- reference
decode - Bit-exact reference tiling using
bcdec_rsdirectly (tests + benches).
Structs§
- Caps
- Caps2
- DdsBase
- This is the main DirectDraw Surface file structure, generic over how the payload is stored.
- Encode
Layout encode - How to lay out encoded subresources — mirrors decode matrix contexts.
- FourCC
- GpuFormat
- Recommended GPU texture format name (stringly typed — no graphics API crate).
- Header
- Header10
- Header
Flags - Image
Rgba8 - Tightly packed RGBA8 image (row-major).
- Image
Rgba F32 - Tightly packed RGBA f32 pixels (HDR decode output).
- Misc
Flag - NewD3d
Params - Parameters for Dds::new_d3d()
- NewDxgi
Params - Parameters for Dds::new_dxgi()
- Pixel
Format - Pixel
Format Flags - Subresource
Id - Identifies one mip / layer / face subresource inside [
Dds::data]. - Surface
View - Borrowed view of one subresource’s bytes and mip dimensions.
- Surface
View Mut - Mutable borrowed view of one subresource.
- Upload
Plan - One mip/layer/face ready for
write_texture/ buffer→image copy.
Enums§
- Alpha
Mode - Cubemap
Face - DirectX cubemap face order (face index 0..5).
- D3D10
Resource Dimension - D3DFormat
- Decode
Content - Public LDR format classification (decode + encode matrix).
- Dxgi
Format - Encode
Quality encode - Encode effort vs speed. Default
EncodeQuality::Qualityis the corpus bake-off path. - Error
- HdrDecode
Content - HDR (float-output) content set — separate from
DecodeContentso the LDR matrix (ALL_LDR,decode_rgba8, encode) is untouched. - Rdo
encode - Rate-distortion optimization strength for the BC1 and BC7 encoders.
- Upload
Path - How to feed one subresource to a GPU copy.
Traits§
Functions§
- max_
abs_ diff encode - Max absolute per-byte error.
- psnr_
rgba8 encode - Peak signal-to-noise ratio for two equal-length RGBA8 buffers (dB).