use std::io::Cursor;
use base64::Engine as _;
use image::{DynamicImage, ImageFormat};
pub fn encode(image: &DynamicImage, cols: u16, rows: u16, source: &str) -> Option<String> {
let mut png = Vec::new();
image
.write_to(&mut Cursor::new(&mut png), ImageFormat::Png)
.ok()?;
Some(encode_bytes(&png, cols, rows, source))
}
pub fn encode_bytes(bytes: &[u8], cols: u16, rows: u16, source: &str) -> String {
let engine = base64::engine::general_purpose::STANDARD;
let payload = engine.encode(bytes);
let name = engine.encode(png_name(source));
format!(
"\x1b]1337;File=name={name};size={};inline=1;width={cols};height={rows};preserveAspectRatio=1:{payload}\x07",
bytes.len()
)
}
fn png_name(source: &str) -> String {
let base = source
.split(['?', '#'])
.next()
.unwrap_or(source)
.rsplit(['/', '\\'])
.next()
.unwrap_or("image");
let stem = base
.rsplit_once('.')
.map(|(name, _)| name)
.unwrap_or(base)
.trim();
if stem.is_empty() {
"image.png".to_string()
} else {
format!("{stem}.png")
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn builds_a_well_formed_sequence() {
let seq = encode_bytes(b"hello", 12, 6, "logo.png");
assert!(seq.starts_with("\x1b]1337;File="));
assert!(seq.ends_with('\x07'), "BEL terminator, as imgcat uses");
assert!(seq.contains("inline=1"));
assert!(seq.contains("width=12"));
assert!(seq.contains("height=6"));
assert!(seq.contains("preserveAspectRatio=1"));
assert!(
seq.contains("size=5"),
"size is the byte count, not the base64 length"
);
}
#[test]
fn payload_round_trips() {
let data = b"\x89PNG\r\n\x1a\narbitrary";
let seq = encode_bytes(data, 1, 1, "x.png");
let payload = seq.split(':').next_back().unwrap().trim_end_matches('\x07');
assert_eq!(
base64::engine::general_purpose::STANDARD
.decode(payload)
.unwrap(),
data
);
}
#[test]
fn carries_a_png_filename() {
let seq = encode_bytes(b"x", 1, 1, "https://example.com/assets/badge.svg?v=2");
let name = seq
.split("name=")
.nth(1)
.unwrap()
.split(';')
.next()
.unwrap();
let decoded = base64::engine::general_purpose::STANDARD
.decode(name)
.unwrap();
assert_eq!(String::from_utf8(decoded).unwrap(), "badge.png");
}
#[test]
fn names_awkward_sources_sensibly() {
assert_eq!(png_name("logo.png"), "logo.png");
assert_eq!(png_name("/a/b/diagram.jpeg"), "diagram.png");
assert_eq!(png_name("no-extension"), "no-extension.png");
assert_eq!(png_name(""), "image.png");
assert_eq!(png_name("dir/"), "image.png");
}
#[test]
fn encodes_a_real_image() {
let img = DynamicImage::ImageRgba8(image::RgbaImage::new(4, 4));
assert!(encode(&img, 1, 1, "x.png").unwrap().contains("File="));
}
}