5a24289898fd
proof.rs
//! Soft proofing against an output-device ICC profile (a printer and paper): loads the profile,
//! builds its proof table through the CMS and registers it with the pipeline, which a
//! [`Proof`](lightcraft_pipeline::Proof) then names by id.
use lightcraft_codecs::display::MAX_PROFILE_BYTES;
pub use lightcraft_codecs::proof::ProofIntent;
/// A device profile ready to proof against.
#[derive(Clone, Debug, PartialEq)]
pub struct ProofProfile {
/// Pass as [`Proof::profile`](lightcraft_pipeline::Proof::profile).
pub id: u64,
/// The profile's description, else the file name.
pub name: String,
}
/// Load the profile at `path` for proofing with `intent`, simulating paper and ink or not.
pub fn load(path: &str, intent: ProofIntent, paper_ink: bool) -> Result<ProofProfile, String> {
let path = path.trim();
let meta = std::fs::metadata(path).map_err(|e| format!("{path}: {e}"))?;
if meta.len() > MAX_PROFILE_BYTES as u64 {
return Err(format!("{path}: too large for an ICC profile"));
}
let bytes = std::fs::read(path).map_err(|e| format!("{path}: {e}"))?;
let fallback = std::path::Path::new(path).file_stem().map(|s| s.to_string_lossy().into_owned()).unwrap_or_default();
from_bytes(&bytes, intent, paper_ink, &fallback).map_err(|e| format!("{path}: {e}"))
}
/// [`load`] from the profile's bytes; `fallback_name` names a profile without a description.
pub fn from_bytes(bytes: &[u8], intent: ProofIntent, paper_ink: bool, fallback_name: &str) -> Result<ProofProfile, String> {
let table = lightcraft_codecs::proof::proof_table(bytes, intent, paper_ink)?;
let lut = lightcraft_pipeline::ProofLut::new(table.n, table.data).ok_or("the profile's tables give no usable colours")?;
let id = {
use std::hash::{Hash, Hasher};
let mut h = std::collections::hash_map::DefaultHasher::new();
(bytes, intent, paper_ink).hash(&mut h);
h.finish()
};
let id = lightcraft_pipeline::register_proof_profile(id, lut);
Ok(ProofProfile { id, name: table.description.unwrap_or_else(|| fallback_name.to_string()) })
}
#[cfg(test)]
mod tests {
use super::*;
use lightcraft_codecs::space::NamedSpace;
#[test]
fn profiles_register_by_content_and_options() {
let p3 = lightcraft_codecs::icc::write_named(NamedSpace::DisplayP3);
let a = from_bytes(&p3, ProofIntent::Perceptual, false, "x").unwrap();
let b = from_bytes(&p3, ProofIntent::Perceptual, true, "x").unwrap();
assert_ne!(a.id, b.id);
assert_eq!(a, from_bytes(&p3, ProofIntent::Perceptual, false, "x").unwrap());
assert!(lightcraft_pipeline::proof_profile(a.id).is_some());
assert!(!a.name.is_empty());
assert!(from_bytes(b"nope", ProofIntent::Relative, false, "x").is_err());
assert!(load("/nonexistent/printer.icc", ProofIntent::Relative, false).is_err());
assert_eq!(ProofIntent::parse("Relative"), Some(ProofIntent::Relative));
assert_eq!(ProofIntent::parse("saturation"), None);
}
}
No file is open. Choose one in the tree, or press Ctrl+O (⌘O on a Mac) to find one by name.
Syntax highlighting could not load. The unmodified read-only text remains available above.