856f865cf98d
proxy.rs
//! Downsampled proxy documents for fast interactive previews (e.g. dragging an adjustment slider on
//! a 36 MP image). Built once per document revision; only adjustment parameters change while the
//! slider moves, so the proxy's pixels stay valid and each preview frame composites ~1/k² pixels.
use craft::imaging::ui::live_preview::ProxyPlan;
use photocraft_doc::Document;
/// Target pixel count for previews (fast enough to composite every frame on CPU).
pub const PREVIEW_PIXELS: u64 = 2_500_000;
/// Downscale factor for a document, or 1 when it's already small.
pub fn factor(doc: &Document) -> u32 {
let px = doc.size.area();
if px <= PREVIEW_PIXELS * 2 {
return 1;
}
((px as f64 / PREVIEW_PIXELS as f64).sqrt().ceil() as u32).max(2)
}
/// Whether live previews may run on a reduced copy (Preferences › Performance › Low Resolution
/// Previews, on by default). Off, every live preview renders at full resolution.
pub fn reduced_previews(app: &crate::PhotocraftApp) -> bool {
app.session.prefs().performance.low_resolution_previews
}
/// Downscale factor of a live preview of `doc`: [`factor`], or 1 when reduced previews are off.
pub fn preview_factor(doc: &Document, reduced: bool) -> u32 {
if reduced { factor(doc) } else { 1 }
}
/// A live preview's factor `k` capped for a view at `zoom` (physical screen pixels per document
/// pixel) of a document of `document_pixels`: never coarser than the screen
/// ([`ProxyPlan::factor`]), so a view at 100 % shows full resolution instead of k-pixel blocks while
/// a control moves (#5764).
pub fn view_factor(k: u32, zoom: f32, document_pixels: u64) -> u32 {
k.min(ProxyPlan::factor(zoom, document_pixels, true)).max(1)
}
pub use photocraft_compose::proxy::{downsample, proxy_document};
#[cfg(test)]
mod tests {
use super::*;
use photocraft_color::{Color, ColorMode, SampleType};
use photocraft_doc::Size;
#[test]
fn factor_scales_with_size() {
let small = Document::new("s", Size::new(1000, 1000), ColorMode::Rgb, SampleType::U8);
assert_eq!(factor(&small), 1);
let big = Document::new("b", Size::new(6016, 6016), ColorMode::Rgb, SampleType::U8);
let k = factor(&big);
assert!((3..=5).contains(&k), "{k}");
assert!(big.size.area() / (k as u64 * k as u64) <= PREVIEW_PIXELS);
assert_eq!(preview_factor(&big, true), k);
assert_eq!(preview_factor(&big, false), 1);
assert_eq!(preview_factor(&small, true), 1);
}
/// #5764: dragging a Curves point on a large document showed the canvas in k-pixel blocks at
/// any zoom. The proxy may only be as coarse as the screen.
#[test]
fn view_factor_never_coarser_than_the_screen() {
let big = Document::new("b", Size::new(6016, 6016), ColorMode::Rgb, SampleType::U8);
let k = preview_factor(&big, true);
assert!(k > 2, "{k}");
let area = big.size.area();
assert_eq!(view_factor(k, 1.0, area), 1, "100 %: full resolution");
assert_eq!(view_factor(k, 2.0, area), 1, "zoomed in: full resolution");
assert_eq!(view_factor(k, 0.6, area), 1);
assert_eq!(view_factor(k, 0.5, area), 2);
assert_eq!(view_factor(k, 0.1, area), k, "far out: the document's proxy");
assert_eq!(view_factor(1, 0.1, area), 1, "small documents stay full size");
assert_eq!(view_factor(k, f32::NAN, area), 1);
assert_eq!(view_factor(0, 0.1, area), 1);
}
#[test]
fn proxy_keeps_structure_and_ids() {
let doc = Document::with_background("d", Size::new(4000, 3000), ColorMode::Rgb, SampleType::U8, Color::WHITE);
let p = proxy_document(&doc, 4);
assert_eq!((p.size.width, p.size.height), (1000, 750));
assert_eq!(p.layers[0].id, doc.layers[0].id);
assert_eq!(p.layers[0].surface().unwrap().pixel(999, 749), vec![1.0; 4]);
}
}
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.