use crate::wire::Field;
const PNG_SIGNATURE: &[u8] = b"\x89PNG\r\n\x1a\n";
const JPEG_SIGNATURE: &[u8] = &[0xff, 0xd8, 0xff];
const PNG_HEADER: &[u8] = b"IHDR";
const CHUNK_LENGTH_BYTES: usize = 4;
const MAX_FILE_NAME_BYTES: usize = 255;
const CANONICAL_ENTRY_FIELDS: usize = 2;
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
#[non_exhaustive]
pub enum ValueKind {
Png,
Jpeg,
Mp3,
FileName,
Unknown,
}
impl ValueKind {
pub fn sniff(value: &[u8]) -> Self {
if value.starts_with(PNG_SIGNATURE) {
Self::Png
} else if value.starts_with(JPEG_SIGNATURE) {
Self::Jpeg
} else if is_mp3(value) {
Self::Mp3
} else if is_file_name(value) {
Self::FileName
} else {
Self::Unknown
}
}
}
fn is_mp3(value: &[u8]) -> bool {
match value {
[b'I', b'D', b'3', ..] => true,
[0xff, second, ..] => second & 0xe0 == 0xe0,
_ => false,
}
}
fn is_file_name(value: &[u8]) -> bool {
!value.is_empty()
&& value.len() <= MAX_FILE_NAME_BYTES
&& std::str::from_utf8(value).is_ok_and(|name| !name.chars().any(char::is_control))
}
pub fn png_dimensions(png: &[u8]) -> Option<(u32, u32)> {
let header = png.strip_prefix(PNG_SIGNATURE)?.get(CHUNK_LENGTH_BYTES..)?;
let (width, rest) = header.strip_prefix(PNG_HEADER)?.split_first_chunk::<4>()?;
let (height, _) = rest.split_first_chunk::<4>()?;
Some((u32::from_be_bytes(*width), u32::from_be_bytes(*height)))
}
pub fn is_animated_png(png: &[u8]) -> bool {
if !png.starts_with(PNG_SIGNATURE) {
return false;
}
let mut offset = PNG_SIGNATURE.len();
while let Some(header) = offset.checked_add(8).and_then(|end| png.get(offset..end)) {
let Some((length, kind)) = header.split_first_chunk::<4>() else {
return false;
};
match kind {
b"acTL" => return true,
b"IDAT" | b"IEND" => return false,
_ => {}
}
let next = usize::try_from(u32::from_be_bytes(*length))
.ok()
.and_then(|length| length.checked_add(12))
.and_then(|size| offset.checked_add(size));
let Some(next) = next else { return false };
offset = next;
}
false
}
#[derive(Debug, Clone, Copy)]
pub struct ImageEntry<'a> {
pub(super) key: &'a [u8],
pub(super) value: &'a [u8],
pub(super) field: Field<'a>,
pub(super) numbers: &'a [u32],
}
impl<'a> ImageEntry<'a> {
pub fn key(&self) -> Option<&'a str> {
std::str::from_utf8(self.key).ok()
}
pub fn key_bytes(&self) -> &'a [u8] {
self.key
}
pub fn value(&self) -> &'a [u8] {
self.value
}
pub fn kind(&self) -> ValueKind {
ValueKind::sniff(self.value)
}
pub fn field(&self) -> Field<'a> {
self.field
}
pub fn field_numbers(&self) -> &'a [u32] {
self.numbers
}
pub fn is_canonical(&self) -> bool {
self.numbers.len() == CANONICAL_ENTRY_FIELDS
&& self.numbers.contains(&1)
&& self.numbers.contains(&2)
}
}