rusty_dds 0.2.0

Memory-safe DDS texture toolkit — container, decode, encode (BC1-BC7, BC6H HDR), rate-distortion optimization, GPU upload plans (Remade With Rust)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145

[package]
name = "rusty_dds"
version = "0.2.0"
authors = [
    "Mike Dilger <mike@optcomp.nz>",
    "Remade With Rust / Mata Network",
]
description = "Memory-safe DDS texture toolkit — container, decode, encode (BC1-BC7, BC6H HDR), rate-distortion optimization, GPU upload plans (Remade With Rust)"
repository = "https://github.com/Remade-With-Rust/rusty_dds"
homepage = "https://github.com/Remade-With-Rust/rusty_dds"
documentation = "https://docs.rs/rusty_dds"
license = "MIT"
keywords = ["dds", "texture", "directx", "bc7", "compression"]
categories = ["encoding", "graphics", "parsing"]
readme = "README.md"
edition = "2021"
rust-version = "1.73"
exclude = [
    "third_party/*",
    "tools/*",
    "corpus/raw/*",
    "corpus/raw_crytif/*",
    "corpus/raw_tif/*",
    "corpus/raw_hdr/*",
    "corpus/manifest.json",
    "bench/preserved/*",
    "docs/artifacts/*.json",
    "target/*",
]

[package.metadata.docs.rs]
all-features = true
rustdoc-args = ["--cfg", "docsrs"]

[features]
default = ["decode", "encode", "simd"]
# CPU BCn/RGBA decode via bcdec_rs (pure Rust).
decode = ["dep:bcdec_rs"]
# CPU RGBA → DDS encode (pure Rust; no extra deps).
encode = []
# AVX2 twins of the hot encode kernels (runtime-detected, scalar fallback,
# byte-identical output either way). Off => zero `unsafe` in the crate.
simd = []

[dependencies]
bitflags = "2.4"
byteorder = "1.5"
enum-primitive-derive = "0.2"
num-traits = "0.2"
bcdec_rs = { version = "0.2", optional = true }

[dev-dependencies]
criterion = { version = "0.5", default-features = false, features = ["cargo_bench_support"] }
# Off-the-shelf container baseline for parse A/B (not used by the library itself).
ddsfile = "0.5.2"
serde_json = "1"
tiff = { version = "0.9", default-features = true }
# BC6H decode-oracle for tests (same crate/version the decode feature uses).
bcdec_rs = "0.2"
# Pure-Rust deflate for the RDO rate harness (rate metric = zip/p4k channel).
miniz_oxide = "0.8"
png = "0.17"
eframe = { version = "0.29", default-features = false, features = ["default_fonts", "glow", "wayland", "x11"] }
rfd = "0.15"

[[bin]]
name = "rusty-dds"
path = "src/bin/rusty_dds.rs"
required-features = ["decode", "encode"]

[[bin]]
name = "ddsinfo"
path = "src/bin/ddsinfo.rs"

[[bin]]
name = "retag"
path = "src/bin/retag.rs"

[[bench]]
name = "parse_ab"
harness = false

[[bench]]
name = "decode_ab"
harness = false
required-features = ["decode"]

[[example]]
name = "gen_fixtures"

[[example]]
name = "bench_vs_directxtex"
required-features = ["decode"]

[[example]]
name = "bench_baselines"
required-features = ["decode", "encode"]

[[example]]
name = "harvest_encode_quality"
required-features = ["decode", "encode"]

[[example]]
name = "harvest_encode_quality_vs_dxtex"
required-features = ["decode", "encode"]

[[example]]
name = "harvest_corpus_vs_dxtex"
required-features = ["decode", "encode"]

[[example]]
name = "harvest_corpus_decode_vs_dxtex"
required-features = ["decode", "encode"]

[[example]]
name = "demo_tiff_side_by_side"
required-features = ["decode", "encode"]

[[example]]
name = "bench_encode_corpus"
required-features = ["decode", "encode"]

[[example]]
name = "harvest_rdo"
required-features = ["decode", "encode"]

[[example]]
name = "probe_rdo_exact"
required-features = ["decode", "encode"]

[[test]]
name = "decode_matrix"
required-features = ["decode"]

[[test]]
name = "bc6h_decode"
required-features = ["decode", "encode"]

[[test]]
name = "bc6h_encode"
required-features = ["decode", "encode"]

[[test]]
name = "encode_matrix"
required-features = ["encode", "decode"]