use crate::encode::QrCode;
#[derive(Clone, Debug, PartialEq, Eq)]
pub struct SvgOptions {
pub margin: usize,
pub dark: String,
pub light: Option<String>,
pub title: String,
}
impl Default for SvgOptions {
fn default() -> Self {
SvgOptions { margin: 4, dark: "#000".to_string(), light: Some("#fff".to_string()), title: String::new() }
}
}
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum Ink {
Light,
Dark,
}
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub struct TerminalOptions {
pub margin: usize,
pub ink: Ink,
}
impl Default for TerminalOptions {
fn default() -> Self {
TerminalOptions { margin: 4, ink: Ink::Light }
}
}
pub fn to_svg(qr: &QrCode, options: &SvgOptions) -> String {
let margin = options.margin;
let side = render_side(qr.size, margin);
let dark = escape(&options.dark);
let mut path = String::new();
for y in 0..qr.size {
let row = &qr.modules[y * qr.size..(y + 1) * qr.size];
let mut x = 0;
while x < qr.size {
if row[x] != 1 {
x += 1;
continue;
}
let start = x;
while x < qr.size && row[x] == 1 {
x += 1;
}
path.push_str(&format!("M{} {}h{}v1h-{}z", start + margin, y + margin, x - start, x - start));
}
}
let title = if options.title.is_empty() { String::new() } else { format!("<title>{}</title>", escape(&options.title)) };
let background = match &options.light {
None => String::new(),
Some(light) => format!("<rect width=\"{side}\" height=\"{side}\" fill=\"{}\"/>", escape(light)),
};
let role = if options.title.is_empty() { "" } else { " role=\"img\"" };
format!(
"<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 {side} {side}\" shape-rendering=\"crispEdges\"{role}>{title}{background}<path fill=\"{dark}\" d=\"{path}\"/></svg>"
)
}
fn escape(text: &str) -> String {
let mut out = String::with_capacity(text.len());
for c in text.chars() {
match c {
'&' | '<' | '>' | '"' | '\'' => {
out.push_str("&#");
out.push_str(&(c as u32).to_string());
out.push(';');
}
'\0'..='\x08' | '\x0B' | '\x0C' | '\x0E'..='\x1F' | '\u{FFFE}' | '\u{FFFF}' => out.push('\u{FFFD}'),
_ => out.push(c),
}
}
out
}
const BLOCKS: [char; 4] = [' ', '\u{2580}', '\u{2584}', '\u{2588}'];
pub fn to_terminal(qr: &QrCode, options: &TerminalOptions) -> String {
let margin = options.margin;
let ink_is_light = options.ink == Ink::Light;
let side = render_side(qr.size, margin);
let inked = |x: usize, y: usize| -> bool {
let dark = x >= margin && y >= margin && x - margin < qr.size && y - margin < qr.size && qr.modules[(y - margin) * qr.size + (x - margin)] == 1;
dark != ink_is_light
};
let mut lines: Vec<String> = Vec::with_capacity(side.div_ceil(2));
let mut y = 0;
while y < side {
let mut line = String::new();
for x in 0..side {
let lower = y + 1 < side && inked(x, y + 1);
line.push(BLOCKS[(inked(x, y) as usize) | ((lower as usize) << 1)]);
}
lines.push(line);
y += 2;
}
lines.join("\n")
}
fn render_side(size: usize, margin: usize) -> usize {
margin.checked_mul(2).and_then(|quiet| size.checked_add(quiet))
.expect("QR render dimensions overflow usize")
}
#[cfg(test)]
mod tests {
use super::*;
use crate::encode::{encode, Options};
#[test]
fn checked_side_accepts_the_last_representable_dimension() {
assert_eq!(render_side(21, 4), 29);
assert_eq!(render_side(21, (usize::MAX - 21) / 2), usize::MAX);
}
#[test]
fn both_renderers_reject_multiplication_and_addition_overflow() {
let qr = encode("A", &Options::default()).unwrap();
for margin in [usize::MAX, (usize::MAX - qr.size) / 2 + 1] {
assert!(std::panic::catch_unwind(|| to_svg(&qr, &SvgOptions { margin, ..Default::default() })).is_err());
assert!(std::panic::catch_unwind(|| to_terminal(&qr, &TerminalOptions { margin, ..Default::default() })).is_err());
}
}
}