Files
Dylan M. Taylor 5c0b0a3632 Deduplicate raster codecs via shared image implementations (successor to #1198) (#1331)
* Share small raster format implementations

(cherry picked from commit 7aedc1de73)

* Preserve raster facade encode contracts

(cherry picked from commit 2db7c82705)

* Allow alpha in IFF compatibility encoder

(cherry picked from commit 80b55dee5a)

* Test shared raster facade contracts and refresh lockfile
2026-11-14 20:46:22 -05:00

76 lines
2.9 KiB
Rust

//! DDS compatibility facade; implementation and BC block codecs live in craft-image-codecs.
use crate::{CodecError, Image, Limits, SampleType, bridge};
use craft_image_codecs::Format;
pub fn looks_like_dds(bytes: &[u8]) -> bool {
craft_image_codecs::detect(bytes) == Some(Format::Dds)
}
pub fn has_additional_images(bytes: &[u8]) -> Result<bool, CodecError> {
craft_image_codecs::has_unretained_source_data(bytes).map_err(bridge::from_shared_error)
}
pub fn decode(bytes: &[u8], limits: &Limits) -> Result<Image, CodecError> {
bridge::format(Format::Dds, bytes, limits)
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum DdsCompression {
#[default]
None,
Bc1,
Bc2,
Bc3,
}
impl DdsCompression {
pub const ALL: [Self; 4] = [Self::None, Self::Bc1, Self::Bc2, Self::Bc3];
pub fn name(self) -> &'static str {
match self {
Self::None => "none",
Self::Bc1 => "bc1",
Self::Bc2 => "bc2",
Self::Bc3 => "bc3",
}
}
pub fn from_name(name: &str) -> Option<Self> {
match name.to_ascii_lowercase().as_str() {
"none" => Some(Self::None),
"bc1" | "dxt1" => Some(Self::Bc1),
"bc2" | "dxt3" => Some(Self::Bc2),
"bc3" | "dxt5" => Some(Self::Bc3),
_ => None,
}
}
pub fn is_block(self) -> bool {
self != Self::None
}
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub struct DdsOptions {
pub compression: DdsCompression,
pub mipmaps: bool,
}
pub fn encode(image: &Image, options: DdsOptions) -> Result<Vec<u8>, CodecError> {
if image.sample_type() != SampleType::U8 {
return Err(CodecError::encode("DDS", "DDS is written at 8 bits per channel"));
}
// BC storage encodes RGBA blocks. The generic image API can plan a
// conversion from other layouts, but this compatibility facade accepts
// only layouts its former writer stored directly.
let allowed = if options.compression.is_block() {
image.layout() == crate::ChannelLayout::Rgba
} else {
matches!(image.layout(), crate::ChannelLayout::Gray | crate::ChannelLayout::GrayA | crate::ChannelLayout::Rgb | crate::ChannelLayout::Rgba)
};
if !allowed {
return Err(CodecError::encode("DDS", format!("{:?} pixels can't be written as `{}`", image.layout(), options.compression.name())));
}
let compression = match options.compression {
DdsCompression::None => craft_image_codecs::DdsCompression::None,
DdsCompression::Bc1 => craft_image_codecs::DdsCompression::Bc1,
DdsCompression::Bc2 => craft_image_codecs::DdsCompression::Bc2,
DdsCompression::Bc3 => craft_image_codecs::DdsCompression::Bc3,
};
let opts =
craft_image_codecs::EncodeOptions { dds: craft_image_codecs::DdsOptions { compression, mipmaps: options.mipmaps }, ..Default::default() };
bridge::encode(image, Format::Dds, &opts)
}