pub struct Surface { /* private fields */ }Expand description
Stateful renderer.
Implementations§
Source§impl Surface
impl Surface
Sourcepub fn new(mode: SurfaceMode, lens: LicenseLens) -> Self
pub fn new(mode: SurfaceMode, lens: LicenseLens) -> Self
Construct (compact 5×7 default appearance).
Examples found in repository?
examples/scroll_resize.rs (line 35)
14fn main() -> Result<(), Box<dyn std::error::Error>> {
15 let mut rows = Vec::new();
16 for i in 0..40u32 {
17 rows.push(Row::new(
18 i,
19 vec![
20 CellValue::text(format!("SKU-{i:03}")),
21 CellValue::float(10.0 + f64::from(i), 2),
22 CellValue::int(i64::from(i) * 3),
23 ],
24 ));
25 }
26 let grid = Grid::try_new(
27 vec![
28 Column::new(0, "sku"),
29 Column::new(1, "price"),
30 Column::new(2, "qty"),
31 ],
32 rows,
33 )?;
34
35 let surface = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
36 let metrics = surface.metrics(&grid);
37 let dir = renders_dir();
38 fs::create_dir_all(&dir)?;
39
40 let window = Viewport::window(420, 140);
41 let frames = [
42 ("scroll_y0.png", window.clamp_to(&metrics), None),
43 ("scroll_y90.png", window.scroll_by(0, 90, &metrics), None),
44 (
45 "scroll_clamped.png",
46 window.scroll_by(0, 9_999, &metrics),
47 None,
48 ),
49 (
50 "resize_sku200.png",
51 window,
52 Some(metrics.resize_column(0, 200)),
53 ),
54 ];
55
56 for (name, vp, widths) in frames {
57 let mut req = FrameRequest::full(vp);
58 if let Some(w) = widths {
59 req = req.column_widths(w);
60 }
61 let frame = surface.render(&grid, &req)?;
62 let path = dir.join(name);
63 fs::write(&path, &frame.png)?;
64 println!(
65 "{name}: origin_y={} visible {}..{} bytes={} -> {}",
66 vp.origin_y,
67 frame.visible_row_start,
68 frame.visible_row_end,
69 frame.png.len(),
70 path.display()
71 );
72 }
73 Ok(())
74}More examples
examples/scatter.rs (line 35)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let mut a = Vec::new();
17 let mut b = Vec::new();
18 for i in 0..28u32 {
19 let t = f64::from(i);
20 a.push(SeriesPoint::new(
21 6.0 + (t * 0.37).sin() * 5.0 + t * 0.12,
22 22.0 + (t * 0.51).cos() * 8.0,
23 ));
24 b.push(SeriesPoint::new(
25 18.0 + (t * 0.29).cos() * 6.0,
26 12.0 + (t * 0.41).sin() * 7.0 + t * 0.15,
27 ));
28 }
29 a[10] = SeriesPoint::new(12.0, 49.37);
30
31 let layout = SeriesLayout::try_new(vec![Series::new(0, "a", a), Series::new(1, "b", b)])?;
32 let dir = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
33 fs::create_dir_all(&dir)?;
34
35 let mut sealed = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
36 let vp = Viewport::window(520, 240);
37 let rest = FrameRequest::full(vp).caption("scatter");
38 let idle = sealed.render_scatter(&layout, &rest)?;
39 fs::write(dir.join("sc_sealed.png"), &idle.png)?;
40 fs::write(dir.join("readme_scatter.png"), &idle.png)?;
41
42 let hit = sealed.render_scatter(&layout, &rest.clone().pointer(Pointer::new(240, 110)))?;
43 fs::write(dir.join("sc_crosshair.png"), &hit.png)?;
44 if let Some(tip) = &hit.tooltip_png {
45 fs::write(dir.join("sc_tooltip.png"), tip)?;
46 }
47 println!(
48 "sealed scatter audit={:?} tooltip={}",
49 hit.host.audit_text(),
50 hit.tooltip_png.as_ref().map_or(0, Vec::len)
51 );
52
53 sealed.set_mode(SurfaceMode::Copyable);
54 let copy = sealed.render_scatter(&layout, &rest)?;
55 fs::write(dir.join("sc_copyable.png"), ©.png)?;
56
57 let trial = Surface::new(
58 SurfaceMode::Sealed,
59 LicenseLens::from_tier(AccessTier::Trial),
60 );
61 let t = trial.render_scatter(&layout, &rest)?;
62 fs::write(dir.join("sc_trial_lens.png"), &t.png)?;
63 println!(
64 "wrote scatter renders; trial viewed rows={}",
65 t.viewed.rows.len()
66 );
67 Ok(())
68}examples/host_contract.rs (line 50)
37fn main() -> Result<(), Box<dyn std::error::Error>> {
38 let mut rows = Vec::new();
39 for i in 0..80u32 {
40 rows.push(Row::new(
41 i,
42 vec![
43 CellValue::text(format!("ACME-SKU-{i}")),
44 CellValue::float(10.0 + f64::from(i), 2),
45 ],
46 ));
47 }
48 let grid = Grid::try_new(vec![Column::new(0, "sku"), Column::new(1, "price")], rows)?;
49
50 let surface = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
51 let metrics = surface.metrics(&grid);
52
53 // Host scrollbar: window 480×160, content from metrics.
54 let window = Viewport {
55 origin_x: 0,
56 origin_y: 0,
57 width: 480,
58 height: 160,
59 };
60 println!(
61 "host scrollbar: content {}x{} window {}x{} max_origin_y={}",
62 metrics.content_width,
63 metrics.content_height,
64 window.width,
65 window.height,
66 metrics.content_height.saturating_sub(window.height)
67 );
68
69 let dir = std::env::temp_dir().join("sealed-surface-examples");
70 fs::create_dir_all(&dir)?;
71
72 for (name, origin_y) in [("y0", 0u32), ("y180", 180), ("y360", 360)] {
73 let mut req = FrameRequest::full(Viewport {
74 origin_x: 0,
75 origin_y,
76 width: window.width,
77 height: window.height,
78 });
79 req.pointer = Some(Pointer { x: 24, y: 40 });
80 let frame = surface.render(&grid, &req)?;
81 let path = dir.join(format!("host_{name}.png"));
82 fs::write(&path, &frame.png)?;
83 assert!(
84 frame.host.audit_text().is_empty(),
85 "sealed host leaked: {:?}",
86 frame.host.audit_text()
87 );
88 println!(
89 "{name}: rows {}..{} png={} tooltip={} file={}",
90 frame.visible_row_start,
91 frame.visible_row_end,
92 frame.png.len(),
93 frame.tooltip_png.as_ref().map_or(0, Vec::len),
94 path.display()
95 );
96 }
97
98 println!("forbidden: interpolating cell values, tooltip JSON, CSS blur over live rows");
99 println!("allowed: <img alt=\"\"> + tooltip PNG + metrics-driven origin");
100 Ok(())
101}examples/treemap.rs (line 44)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let layout = TreeLayout::try_new(TreeNode::branch(
17 0,
18 "catalog",
19 vec![
20 TreeNode::branch(
21 1,
22 "apparel",
23 vec![
24 TreeNode::leaf(2, "shirts", 42.0),
25 TreeNode::leaf(3, "pants", 18.0),
26 TreeNode::leaf(4, "hats", 9.0),
27 ],
28 ),
29 TreeNode::branch(
30 5,
31 "home",
32 vec![
33 TreeNode::leaf(6, "lamps", 21.0),
34 TreeNode::leaf(7, "rugs", 14.0),
35 ],
36 ),
37 TreeNode::leaf(8, "other", 7.0),
38 ],
39 ))?;
40
41 let dir = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
42 fs::create_dir_all(&dir)?;
43
44 let mut sealed = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
45 let vp = Viewport::window(520, 280);
46 let rest = FrameRequest::full(vp).caption("catalog");
47 let idle = sealed.render_tree(&layout, &rest)?;
48 fs::write(dir.join("tm_sealed.png"), &idle.png)?;
49 fs::write(dir.join("readme_tree.png"), &idle.png)?;
50
51 let hit = sealed.render_tree(&layout, &rest.clone().pointer(Pointer::new(80, 90)))?;
52 fs::write(dir.join("tm_hover.png"), &hit.png)?;
53 if let Some(tip) = &hit.tooltip_png {
54 fs::write(dir.join("tm_tooltip.png"), tip)?;
55 }
56 println!(
57 "sealed tree audit={:?} hits={} tooltip={}",
58 hit.host.audit_text(),
59 hit.hits.len(),
60 hit.tooltip_png.as_ref().map_or(0, Vec::len)
61 );
62
63 sealed.set_mode(SurfaceMode::Copyable);
64 let copy = sealed.render_tree(&layout, &rest)?;
65 fs::write(dir.join("tm_copyable.png"), ©.png)?;
66 println!(
67 "copyable TSV (120): {:?}",
68 copy.host.audit_text().chars().take(120).collect::<String>()
69 );
70
71 let trial = Surface::new(
72 SurfaceMode::Sealed,
73 LicenseLens::from_tier(AccessTier::Trial),
74 );
75 let t = trial.render_tree(&layout, &rest)?;
76 fs::write(dir.join("tm_trial_lens.png"), &t.png)?;
77 println!(
78 "wrote treemap renders; trial viewed rows={}",
79 t.viewed.rows.len()
80 );
81 Ok(())
82}examples/timeseries.rs (line 42)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let mut pts = Vec::new();
17 for i in 0..48u32 {
18 let x = f64::from(i);
19 let y = 40.0 + 12.0 * (x * 0.28).sin() + x * 0.35;
20 pts.push(SeriesPoint::new(x, y));
21 }
22 // Distinct sealed-contract values near the middle of the window.
23 pts[20] = SeriesPoint::new(20.0, 49.37);
24
25 let layout = SeriesLayout::try_new(vec![
26 Series::new(0, "px", pts),
27 Series::new(
28 1,
29 "qty",
30 (0..48u32)
31 .map(|i| {
32 let x = f64::from(i);
33 SeriesPoint::new(x, 8.0 + (x * 0.19).cos() * 3.0)
34 })
35 .collect(),
36 ),
37 ])?;
38
39 let dir = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
40 fs::create_dir_all(&dir)?;
41
42 let mut sealed = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
43 let vp = Viewport::window(520, 240);
44 let rest = FrameRequest::full(vp).caption("px / qty");
45 let rest_hit = rest.clone().pointer(Pointer::new(240, 110));
46
47 let idle = sealed.render_series(&layout, &rest)?;
48 fs::write(dir.join("ts_sealed.png"), &idle.png)?;
49 fs::write(dir.join("readme_chart.png"), &idle.png)?;
50 let hit = sealed.render_series(&layout, &rest_hit)?;
51 fs::write(dir.join("ts_crosshair.png"), &hit.png)?;
52 if let Some(tip) = &hit.tooltip_png {
53 fs::write(dir.join("ts_tooltip.png"), tip)?;
54 }
55 println!(
56 "sealed audit (must be empty of values): {:?}",
57 hit.host.audit_text()
58 );
59 println!(
60 "crosshair tooltip_png={} hits={}",
61 hit.tooltip_png.as_ref().map_or(0, Vec::len),
62 hit.hits.len()
63 );
64
65 sealed.set_mode(SurfaceMode::Copyable);
66 let copy = sealed.render_series(&layout, &rest)?;
67 fs::write(dir.join("ts_copyable.png"), ©.png)?;
68 println!("copyable TSV (first 120 chars): {:?}", {
69 let a = copy.host.audit_text();
70 a.chars().take(120).collect::<String>()
71 });
72
73 let trial = Surface::new(
74 SurfaceMode::Sealed,
75 LicenseLens::from_tier(AccessTier::Trial),
76 );
77 let t = trial.render_series(&layout, &rest)?;
78 fs::write(dir.join("ts_trial_lens.png"), &t.png)?;
79 println!(
80 "trial lens viewed rows={} (two sample points per series)",
81 t.viewed.rows.len()
82 );
83
84 println!("wrote {}", dir.display());
85 Ok(())
86}examples/paint_grid.rs (lines 50-53)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let grid = Grid::try_new(
17 vec![
18 Column::new(0, "sku"),
19 Column::new(1, "price"),
20 Column::new(2, "qty"),
21 ],
22 vec![
23 Row::new(
24 0,
25 vec![
26 CellValue::text("ACME-SKU-1"),
27 CellValue::float(49.00, 2),
28 CellValue::int(12),
29 ],
30 ),
31 Row::new(
32 1,
33 vec![
34 CellValue::text("ACME-SKU-2"),
35 CellValue::float(19.50, 2),
36 CellValue::int(3),
37 ],
38 ),
39 Row::new(
40 2,
41 vec![
42 CellValue::text("SECRET-ROW"),
43 CellValue::float(999.00, 2),
44 CellValue::int(1),
45 ],
46 ),
47 ],
48 )?;
49
50 let mut surface = Surface::new(
51 SurfaceMode::Sealed,
52 LicenseLens::from_tier(AccessTier::Trial),
53 );
54 let metrics = surface.metrics(&grid);
55 let mut req = FrameRequest::full(Viewport {
56 origin_x: 0,
57 origin_y: 0,
58 width: metrics.content_width.clamp(320, 960),
59 height: metrics.content_height.clamp(120, 360),
60 });
61 req.pointer = Some(Pointer { x: 24, y: 36 });
62
63 let frame = surface.render(&grid, &req)?;
64 let dir = example_out_dir();
65 fs::create_dir_all(&dir)?;
66 let frame_path = dir.join("frame.png");
67 fs::write(&frame_path, &frame.png)?;
68 if let Some(tip) = &frame.tooltip_png {
69 fs::write(dir.join("tooltip.png"), tip)?;
70 }
71 let renders = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
72 fs::create_dir_all(&renders)?;
73 fs::write(renders.join("readme_table.png"), &frame.png)?;
74 if let Some(tip) = &frame.tooltip_png {
75 fs::write(renders.join("readme_tooltip.png"), tip)?;
76 }
77
78 println!("mode={:?} lens=trial", surface.mode());
79 println!(
80 "content={}x{} visible_rows={}..{} png_bytes={}",
81 frame.content_width,
82 frame.content_height,
83 frame.visible_row_start,
84 frame.visible_row_end,
85 frame.png.len()
86 );
87 println!(
88 "host audit (must not contain prices): {:?}",
89 frame.host.audit_text()
90 );
91 println!("wrote {}", frame_path.display());
92
93 surface.set_mode(SurfaceMode::Copyable);
94 let copyable = surface.render(&grid, &req)?;
95 println!("copyable TSV:\n{}", copyable.host.audit_text());
96
97 write_readme_shots(&renders)?;
98 Ok(())
99}
100
101fn write_readme_shots(renders: &std::path::Path) -> Result<(), Box<dyn std::error::Error>> {
102 let mut rows = Vec::new();
103 for i in 0..8u32 {
104 rows.push(Row::new(
105 i,
106 vec![
107 CellValue::text(format!("SKU-{i:03}")),
108 CellValue::float(12.0 + f64::from(i) * 2.15, 2),
109 CellValue::int(i64::from(i) * 4 + 3),
110 ],
111 ));
112 }
113 let grid = Grid::try_new(
114 vec![
115 Column::new(0, "sku"),
116 Column::new(1, "price"),
117 Column::new(2, "qty"),
118 ],
119 rows,
120 )?;
121 let surface = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
122 let m = surface.metrics(&grid);
123 let frame = surface.render(
124 &grid,
125 &FrameRequest::full(Viewport::window(m.content_width.max(320), 200)),
126 )?;
127 fs::write(renders.join("readme_table.png"), &frame.png)?;
128 Ok(())
129}Additional examples can be found in:
Sourcepub fn set_mode(&mut self, mode: SurfaceMode)
pub fn set_mode(&mut self, mode: SurfaceMode)
Replace mode (same painter).
Examples found in repository?
examples/scatter.rs (line 53)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let mut a = Vec::new();
17 let mut b = Vec::new();
18 for i in 0..28u32 {
19 let t = f64::from(i);
20 a.push(SeriesPoint::new(
21 6.0 + (t * 0.37).sin() * 5.0 + t * 0.12,
22 22.0 + (t * 0.51).cos() * 8.0,
23 ));
24 b.push(SeriesPoint::new(
25 18.0 + (t * 0.29).cos() * 6.0,
26 12.0 + (t * 0.41).sin() * 7.0 + t * 0.15,
27 ));
28 }
29 a[10] = SeriesPoint::new(12.0, 49.37);
30
31 let layout = SeriesLayout::try_new(vec![Series::new(0, "a", a), Series::new(1, "b", b)])?;
32 let dir = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
33 fs::create_dir_all(&dir)?;
34
35 let mut sealed = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
36 let vp = Viewport::window(520, 240);
37 let rest = FrameRequest::full(vp).caption("scatter");
38 let idle = sealed.render_scatter(&layout, &rest)?;
39 fs::write(dir.join("sc_sealed.png"), &idle.png)?;
40 fs::write(dir.join("readme_scatter.png"), &idle.png)?;
41
42 let hit = sealed.render_scatter(&layout, &rest.clone().pointer(Pointer::new(240, 110)))?;
43 fs::write(dir.join("sc_crosshair.png"), &hit.png)?;
44 if let Some(tip) = &hit.tooltip_png {
45 fs::write(dir.join("sc_tooltip.png"), tip)?;
46 }
47 println!(
48 "sealed scatter audit={:?} tooltip={}",
49 hit.host.audit_text(),
50 hit.tooltip_png.as_ref().map_or(0, Vec::len)
51 );
52
53 sealed.set_mode(SurfaceMode::Copyable);
54 let copy = sealed.render_scatter(&layout, &rest)?;
55 fs::write(dir.join("sc_copyable.png"), ©.png)?;
56
57 let trial = Surface::new(
58 SurfaceMode::Sealed,
59 LicenseLens::from_tier(AccessTier::Trial),
60 );
61 let t = trial.render_scatter(&layout, &rest)?;
62 fs::write(dir.join("sc_trial_lens.png"), &t.png)?;
63 println!(
64 "wrote scatter renders; trial viewed rows={}",
65 t.viewed.rows.len()
66 );
67 Ok(())
68}More examples
examples/treemap.rs (line 63)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let layout = TreeLayout::try_new(TreeNode::branch(
17 0,
18 "catalog",
19 vec![
20 TreeNode::branch(
21 1,
22 "apparel",
23 vec![
24 TreeNode::leaf(2, "shirts", 42.0),
25 TreeNode::leaf(3, "pants", 18.0),
26 TreeNode::leaf(4, "hats", 9.0),
27 ],
28 ),
29 TreeNode::branch(
30 5,
31 "home",
32 vec![
33 TreeNode::leaf(6, "lamps", 21.0),
34 TreeNode::leaf(7, "rugs", 14.0),
35 ],
36 ),
37 TreeNode::leaf(8, "other", 7.0),
38 ],
39 ))?;
40
41 let dir = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
42 fs::create_dir_all(&dir)?;
43
44 let mut sealed = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
45 let vp = Viewport::window(520, 280);
46 let rest = FrameRequest::full(vp).caption("catalog");
47 let idle = sealed.render_tree(&layout, &rest)?;
48 fs::write(dir.join("tm_sealed.png"), &idle.png)?;
49 fs::write(dir.join("readme_tree.png"), &idle.png)?;
50
51 let hit = sealed.render_tree(&layout, &rest.clone().pointer(Pointer::new(80, 90)))?;
52 fs::write(dir.join("tm_hover.png"), &hit.png)?;
53 if let Some(tip) = &hit.tooltip_png {
54 fs::write(dir.join("tm_tooltip.png"), tip)?;
55 }
56 println!(
57 "sealed tree audit={:?} hits={} tooltip={}",
58 hit.host.audit_text(),
59 hit.hits.len(),
60 hit.tooltip_png.as_ref().map_or(0, Vec::len)
61 );
62
63 sealed.set_mode(SurfaceMode::Copyable);
64 let copy = sealed.render_tree(&layout, &rest)?;
65 fs::write(dir.join("tm_copyable.png"), ©.png)?;
66 println!(
67 "copyable TSV (120): {:?}",
68 copy.host.audit_text().chars().take(120).collect::<String>()
69 );
70
71 let trial = Surface::new(
72 SurfaceMode::Sealed,
73 LicenseLens::from_tier(AccessTier::Trial),
74 );
75 let t = trial.render_tree(&layout, &rest)?;
76 fs::write(dir.join("tm_trial_lens.png"), &t.png)?;
77 println!(
78 "wrote treemap renders; trial viewed rows={}",
79 t.viewed.rows.len()
80 );
81 Ok(())
82}examples/timeseries.rs (line 65)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let mut pts = Vec::new();
17 for i in 0..48u32 {
18 let x = f64::from(i);
19 let y = 40.0 + 12.0 * (x * 0.28).sin() + x * 0.35;
20 pts.push(SeriesPoint::new(x, y));
21 }
22 // Distinct sealed-contract values near the middle of the window.
23 pts[20] = SeriesPoint::new(20.0, 49.37);
24
25 let layout = SeriesLayout::try_new(vec![
26 Series::new(0, "px", pts),
27 Series::new(
28 1,
29 "qty",
30 (0..48u32)
31 .map(|i| {
32 let x = f64::from(i);
33 SeriesPoint::new(x, 8.0 + (x * 0.19).cos() * 3.0)
34 })
35 .collect(),
36 ),
37 ])?;
38
39 let dir = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
40 fs::create_dir_all(&dir)?;
41
42 let mut sealed = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
43 let vp = Viewport::window(520, 240);
44 let rest = FrameRequest::full(vp).caption("px / qty");
45 let rest_hit = rest.clone().pointer(Pointer::new(240, 110));
46
47 let idle = sealed.render_series(&layout, &rest)?;
48 fs::write(dir.join("ts_sealed.png"), &idle.png)?;
49 fs::write(dir.join("readme_chart.png"), &idle.png)?;
50 let hit = sealed.render_series(&layout, &rest_hit)?;
51 fs::write(dir.join("ts_crosshair.png"), &hit.png)?;
52 if let Some(tip) = &hit.tooltip_png {
53 fs::write(dir.join("ts_tooltip.png"), tip)?;
54 }
55 println!(
56 "sealed audit (must be empty of values): {:?}",
57 hit.host.audit_text()
58 );
59 println!(
60 "crosshair tooltip_png={} hits={}",
61 hit.tooltip_png.as_ref().map_or(0, Vec::len),
62 hit.hits.len()
63 );
64
65 sealed.set_mode(SurfaceMode::Copyable);
66 let copy = sealed.render_series(&layout, &rest)?;
67 fs::write(dir.join("ts_copyable.png"), ©.png)?;
68 println!("copyable TSV (first 120 chars): {:?}", {
69 let a = copy.host.audit_text();
70 a.chars().take(120).collect::<String>()
71 });
72
73 let trial = Surface::new(
74 SurfaceMode::Sealed,
75 LicenseLens::from_tier(AccessTier::Trial),
76 );
77 let t = trial.render_series(&layout, &rest)?;
78 fs::write(dir.join("ts_trial_lens.png"), &t.png)?;
79 println!(
80 "trial lens viewed rows={} (two sample points per series)",
81 t.viewed.rows.len()
82 );
83
84 println!("wrote {}", dir.display());
85 Ok(())
86}examples/paint_grid.rs (line 93)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let grid = Grid::try_new(
17 vec![
18 Column::new(0, "sku"),
19 Column::new(1, "price"),
20 Column::new(2, "qty"),
21 ],
22 vec![
23 Row::new(
24 0,
25 vec![
26 CellValue::text("ACME-SKU-1"),
27 CellValue::float(49.00, 2),
28 CellValue::int(12),
29 ],
30 ),
31 Row::new(
32 1,
33 vec![
34 CellValue::text("ACME-SKU-2"),
35 CellValue::float(19.50, 2),
36 CellValue::int(3),
37 ],
38 ),
39 Row::new(
40 2,
41 vec![
42 CellValue::text("SECRET-ROW"),
43 CellValue::float(999.00, 2),
44 CellValue::int(1),
45 ],
46 ),
47 ],
48 )?;
49
50 let mut surface = Surface::new(
51 SurfaceMode::Sealed,
52 LicenseLens::from_tier(AccessTier::Trial),
53 );
54 let metrics = surface.metrics(&grid);
55 let mut req = FrameRequest::full(Viewport {
56 origin_x: 0,
57 origin_y: 0,
58 width: metrics.content_width.clamp(320, 960),
59 height: metrics.content_height.clamp(120, 360),
60 });
61 req.pointer = Some(Pointer { x: 24, y: 36 });
62
63 let frame = surface.render(&grid, &req)?;
64 let dir = example_out_dir();
65 fs::create_dir_all(&dir)?;
66 let frame_path = dir.join("frame.png");
67 fs::write(&frame_path, &frame.png)?;
68 if let Some(tip) = &frame.tooltip_png {
69 fs::write(dir.join("tooltip.png"), tip)?;
70 }
71 let renders = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
72 fs::create_dir_all(&renders)?;
73 fs::write(renders.join("readme_table.png"), &frame.png)?;
74 if let Some(tip) = &frame.tooltip_png {
75 fs::write(renders.join("readme_tooltip.png"), tip)?;
76 }
77
78 println!("mode={:?} lens=trial", surface.mode());
79 println!(
80 "content={}x{} visible_rows={}..{} png_bytes={}",
81 frame.content_width,
82 frame.content_height,
83 frame.visible_row_start,
84 frame.visible_row_end,
85 frame.png.len()
86 );
87 println!(
88 "host audit (must not contain prices): {:?}",
89 frame.host.audit_text()
90 );
91 println!("wrote {}", frame_path.display());
92
93 surface.set_mode(SurfaceMode::Copyable);
94 let copyable = surface.render(&grid, &req)?;
95 println!("copyable TSV:\n{}", copyable.host.audit_text());
96
97 write_readme_shots(&renders)?;
98 Ok(())
99}Sourcepub const fn mode(&self) -> SurfaceMode
pub const fn mode(&self) -> SurfaceMode
Current mode.
Examples found in repository?
examples/paint_grid.rs (line 78)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let grid = Grid::try_new(
17 vec![
18 Column::new(0, "sku"),
19 Column::new(1, "price"),
20 Column::new(2, "qty"),
21 ],
22 vec![
23 Row::new(
24 0,
25 vec![
26 CellValue::text("ACME-SKU-1"),
27 CellValue::float(49.00, 2),
28 CellValue::int(12),
29 ],
30 ),
31 Row::new(
32 1,
33 vec![
34 CellValue::text("ACME-SKU-2"),
35 CellValue::float(19.50, 2),
36 CellValue::int(3),
37 ],
38 ),
39 Row::new(
40 2,
41 vec![
42 CellValue::text("SECRET-ROW"),
43 CellValue::float(999.00, 2),
44 CellValue::int(1),
45 ],
46 ),
47 ],
48 )?;
49
50 let mut surface = Surface::new(
51 SurfaceMode::Sealed,
52 LicenseLens::from_tier(AccessTier::Trial),
53 );
54 let metrics = surface.metrics(&grid);
55 let mut req = FrameRequest::full(Viewport {
56 origin_x: 0,
57 origin_y: 0,
58 width: metrics.content_width.clamp(320, 960),
59 height: metrics.content_height.clamp(120, 360),
60 });
61 req.pointer = Some(Pointer { x: 24, y: 36 });
62
63 let frame = surface.render(&grid, &req)?;
64 let dir = example_out_dir();
65 fs::create_dir_all(&dir)?;
66 let frame_path = dir.join("frame.png");
67 fs::write(&frame_path, &frame.png)?;
68 if let Some(tip) = &frame.tooltip_png {
69 fs::write(dir.join("tooltip.png"), tip)?;
70 }
71 let renders = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
72 fs::create_dir_all(&renders)?;
73 fs::write(renders.join("readme_table.png"), &frame.png)?;
74 if let Some(tip) = &frame.tooltip_png {
75 fs::write(renders.join("readme_tooltip.png"), tip)?;
76 }
77
78 println!("mode={:?} lens=trial", surface.mode());
79 println!(
80 "content={}x{} visible_rows={}..{} png_bytes={}",
81 frame.content_width,
82 frame.content_height,
83 frame.visible_row_start,
84 frame.visible_row_end,
85 frame.png.len()
86 );
87 println!(
88 "host audit (must not contain prices): {:?}",
89 frame.host.audit_text()
90 );
91 println!("wrote {}", frame_path.display());
92
93 surface.set_mode(SurfaceMode::Copyable);
94 let copyable = surface.render(&grid, &req)?;
95 println!("copyable TSV:\n{}", copyable.host.audit_text());
96
97 write_readme_shots(&renders)?;
98 Ok(())
99}Sourcepub fn set_lens(&mut self, lens: LicenseLens)
pub fn set_lens(&mut self, lens: LicenseLens)
Replace lens.
Sourcepub fn lens(&self) -> &LicenseLens
pub fn lens(&self) -> &LicenseLens
Current lens.
Sourcepub fn set_appearance(&mut self, appearance: Appearance)
pub fn set_appearance(&mut self, appearance: Appearance)
Replace the full look.
Examples found in repository?
examples/gallery.rs (line 325)
241 fn build() -> Result<Self, sealed_surface::Error> {
242 let grid = demo_grid();
243 let series = demo_series()?;
244 let scatter = demo_scatter()?;
245 let tree = demo_tree()?;
246 let vp_table = Viewport::window(520, 220);
247 let vp_chart = Viewport::window(640, 280);
248 let mut specs = BTreeMap::new();
249 let mut add = |id, spec: Spec| {
250 specs.insert(id, spec);
251 };
252
253 add(
254 "table-default",
255 Spec {
256 title: "Table · default (compact)",
257 blurb: "TypeScale::Compact — 5×7, row 18. Hover for PNG tooltip.",
258 kind: Kind::Table,
259 appearance: Appearance::default(),
260 mode: SurfaceMode::Sealed,
261 lens: LicenseLens::open(),
262 viewport: vp_table,
263 caption: None,
264 widths: None,
265 },
266 );
267 add(
268 "table-large",
269 Spec {
270 title: "Table · large (2×)",
271 blurb: "TypeScale::large() — opt-in; bigger bitmap, more strain.",
272 kind: Kind::Table,
273 appearance: Appearance::large(),
274 mode: SurfaceMode::Sealed,
275 lens: LicenseLens::open(),
276 viewport: Viewport::window(640, 280),
277 caption: None,
278 widths: None,
279 },
280 );
281 add(
282 "table-xlarge",
283 Spec {
284 title: "Table · xlarge (3×)",
285 blurb: "TypeScale::xlarge().",
286 kind: Kind::Table,
287 appearance: Appearance::xlarge(),
288 mode: SurfaceMode::Sealed,
289 lens: LicenseLens::open(),
290 viewport: Viewport::window(720, 320),
291 caption: None,
292 widths: None,
293 },
294 );
295 add(
296 "table-light",
297 Spec {
298 title: "Table · light",
299 blurb: "Theme::light(), compact glyphs.",
300 kind: Kind::Table,
301 appearance: Appearance::light(),
302 mode: SurfaceMode::Sealed,
303 lens: LicenseLens::open(),
304 viewport: vp_table,
305 caption: None,
306 widths: None,
307 },
308 );
309 add(
310 "table-hc",
311 Spec {
312 title: "Table · high contrast",
313 blurb: "Near-white text, strong grid.",
314 kind: Kind::Table,
315 appearance: Appearance::high_contrast(),
316 mode: SurfaceMode::Sealed,
317 lens: LicenseLens::open(),
318 viewport: vp_table,
319 caption: None,
320 widths: None,
321 },
322 );
323
324 let mut tmp = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
325 tmp.set_appearance(Appearance::default());
326 let m = tmp.metrics(&grid);
327 add(
328 "table-scroll",
329 Spec {
330 title: "Table · scroll_by",
331 blurb: "Sticky header; body scrolled three rows.",
332 kind: Kind::Table,
333 appearance: Appearance::default(),
334 mode: SurfaceMode::Sealed,
335 lens: LicenseLens::open(),
336 viewport: vp_table.scroll_by(0, (m.row_height * 3) as i32, &m),
337 caption: None,
338 widths: None,
339 },
340 );
341 add(
342 "table-resize",
343 Spec {
344 title: "Table · column resize",
345 blurb: "SKU column forced to 220px.",
346 kind: Kind::Table,
347 appearance: Appearance::default(),
348 mode: SurfaceMode::Sealed,
349 lens: LicenseLens::open(),
350 viewport: vp_table,
351 caption: None,
352 widths: Some(m.resize_column(0, 220)),
353 },
354 );
355 add(
356 "table-copyable",
357 Spec {
358 title: "Table · copyable",
359 blurb: "Same pixels; TSV allowed. Tooltip still PNG.",
360 kind: Kind::Table,
361 appearance: Appearance::default(),
362 mode: SurfaceMode::Copyable,
363 lens: LicenseLens::open(),
364 viewport: vp_table,
365 caption: None,
366 widths: None,
367 },
368 );
369 add(
370 "table-trial",
371 Spec {
372 title: "Table · trial lens",
373 blurb: "Two clear rows; rest redacted before paint.",
374 kind: Kind::Table,
375 appearance: Appearance::default(),
376 mode: SurfaceMode::Sealed,
377 lens: LicenseLens::from_tier(AccessTier::Trial),
378 viewport: vp_table,
379 caption: None,
380 widths: None,
381 },
382 );
383 add(
384 "ts-default",
385 Spec {
386 title: "Timeseries · default",
387 blurb: "AA 2px stroke, area fill, nice ticks. Hover the line.",
388 kind: Kind::Series,
389 appearance: Appearance::default(),
390 mode: SurfaceMode::Sealed,
391 lens: LicenseLens::open(),
392 viewport: vp_chart,
393 caption: Some("px / qty"),
394 widths: None,
395 },
396 );
397 add(
398 "ts-large",
399 Spec {
400 title: "Timeseries · large type",
401 blurb: "Same chart, 2× tick glyphs.",
402 kind: Kind::Series,
403 appearance: Appearance::large(),
404 mode: SurfaceMode::Sealed,
405 lens: LicenseLens::open(),
406 viewport: vp_chart,
407 caption: Some("large"),
408 widths: None,
409 },
410 );
411 add(
412 "ts-light",
413 Spec {
414 title: "Timeseries · light",
415 blurb: "Light theme + derived ChartStyle.",
416 kind: Kind::Series,
417 appearance: Appearance::light(),
418 mode: SurfaceMode::Sealed,
419 lens: LicenseLens::open(),
420 viewport: vp_chart,
421 caption: Some("light"),
422 widths: None,
423 },
424 );
425 add(
426 "ts-hc",
427 Spec {
428 title: "Timeseries · high contrast",
429 blurb: "Strong grid and series colors.",
430 kind: Kind::Series,
431 appearance: Appearance::high_contrast(),
432 mode: SurfaceMode::Sealed,
433 lens: LicenseLens::open(),
434 viewport: vp_chart,
435 caption: Some("HC"),
436 widths: None,
437 },
438 );
439 add(
440 "ts-trial",
441 Spec {
442 title: "Timeseries · trial lens",
443 blurb: "Two samples kept per series.",
444 kind: Kind::Series,
445 appearance: Appearance::default(),
446 mode: SurfaceMode::Sealed,
447 lens: LicenseLens::from_tier(AccessTier::Trial),
448 viewport: vp_chart,
449 caption: Some("trial"),
450 widths: None,
451 },
452 );
453 add(
454 "sc-default",
455 Spec {
456 title: "Scatter · default",
457 blurb: "Unconnected markers. Same Series type, different encoding.",
458 kind: Kind::Scatter,
459 appearance: Appearance::default(),
460 mode: SurfaceMode::Sealed,
461 lens: LicenseLens::open(),
462 viewport: vp_chart,
463 caption: Some("scatter"),
464 widths: None,
465 },
466 );
467 add(
468 "sc-trial",
469 Spec {
470 title: "Scatter · trial lens",
471 blurb: "Two points kept per series.",
472 kind: Kind::Scatter,
473 appearance: Appearance::default(),
474 mode: SurfaceMode::Sealed,
475 lens: LicenseLens::from_tier(AccessTier::Trial),
476 viewport: vp_chart,
477 caption: Some("trial"),
478 widths: None,
479 },
480 );
481 add(
482 "tm-default",
483 Spec {
484 title: "Treemap · default",
485 blurb: "Squarified leaves. Hover a cell for PNG tooltip.",
486 kind: Kind::Tree,
487 appearance: Appearance::default(),
488 mode: SurfaceMode::Sealed,
489 lens: LicenseLens::open(),
490 viewport: Viewport::window(640, 320),
491 caption: Some("catalog"),
492 widths: None,
493 },
494 );
495 add(
496 "tm-trial",
497 Spec {
498 title: "Treemap · trial lens",
499 blurb: "Two leaves kept; areas reflow.",
500 kind: Kind::Tree,
501 appearance: Appearance::default(),
502 mode: SurfaceMode::Sealed,
503 lens: LicenseLens::from_tier(AccessTier::Trial),
504 viewport: Viewport::window(640, 320),
505 caption: Some("trial"),
506 widths: None,
507 },
508 );
509 add(
510 "tm-light",
511 Spec {
512 title: "Treemap · light",
513 blurb: "Same layout, light theme.",
514 kind: Kind::Tree,
515 appearance: Appearance::light(),
516 mode: SurfaceMode::Sealed,
517 lens: LicenseLens::open(),
518 viewport: Viewport::window(640, 320),
519 caption: Some("light"),
520 widths: None,
521 },
522 );
523
524 Ok(Self {
525 grid,
526 series,
527 scatter,
528 tree,
529 specs,
530 })
531 }
532
533 fn surface(&self, spec: &Spec) -> Surface {
534 let mut s = Surface::new(spec.mode, spec.lens.clone());
535 s.set_appearance(spec.appearance);
536 s
537 }Sourcepub const fn appearance(&self) -> Appearance
pub const fn appearance(&self) -> Appearance
Current look.
Sourcepub fn set_type_scale(&mut self, scale: TypeScale)
pub fn set_type_scale(&mut self, scale: TypeScale)
Glyph / cell metrics only.
Sourcepub fn render_series(
&self,
layout: &SeriesLayout,
request: &FrameRequest,
) -> Result<Frame, Error>
pub fn render_series( &self, layout: &SeriesLayout, request: &FrameRequest, ) -> Result<Frame, Error>
Paint a timeseries (crate::SeriesLayout) with the same seal contract.
§Errors
Empty layout or raster failure.
Examples found in repository?
examples/gallery.rs (line 566)
553 fn frame_png(
554 &self,
555 id: &str,
556 pointer: Option<Pointer>,
557 ) -> Result<Vec<u8>, sealed_surface::Error> {
558 let spec = self
559 .specs
560 .get(id)
561 .ok_or(sealed_surface::Error::InvalidGrid("unknown card"))?;
562 let s = self.surface(spec);
563 let req = self.request(spec, pointer);
564 let frame = match spec.kind {
565 Kind::Table => s.render(&self.grid, &req)?,
566 Kind::Series => s.render_series(&self.series, &req)?,
567 Kind::Scatter => s.render_scatter(&self.scatter, &req)?,
568 Kind::Tree => s.render_tree(&self.tree, &req)?,
569 };
570 Ok(frame.png)
571 }
572
573 fn tooltip(
574 &self,
575 id: &str,
576 pointer: Option<Pointer>,
577 ) -> Result<Option<Vec<u8>>, sealed_surface::Error> {
578 let Some(p) = pointer else {
579 return Ok(None);
580 };
581 let spec = self
582 .specs
583 .get(id)
584 .ok_or(sealed_surface::Error::InvalidGrid("unknown card"))?;
585 let s = self.surface(spec);
586 let req = self.request(spec, Some(p));
587 let frame = match spec.kind {
588 Kind::Table => s.render(&self.grid, &req)?,
589 Kind::Series => s.render_series(&self.series, &req)?,
590 Kind::Scatter => s.render_scatter(&self.scatter, &req)?,
591 Kind::Tree => s.render_tree(&self.tree, &req)?,
592 };
593 Ok(frame.tooltip_png)
594 }More examples
examples/timeseries.rs (line 47)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let mut pts = Vec::new();
17 for i in 0..48u32 {
18 let x = f64::from(i);
19 let y = 40.0 + 12.0 * (x * 0.28).sin() + x * 0.35;
20 pts.push(SeriesPoint::new(x, y));
21 }
22 // Distinct sealed-contract values near the middle of the window.
23 pts[20] = SeriesPoint::new(20.0, 49.37);
24
25 let layout = SeriesLayout::try_new(vec![
26 Series::new(0, "px", pts),
27 Series::new(
28 1,
29 "qty",
30 (0..48u32)
31 .map(|i| {
32 let x = f64::from(i);
33 SeriesPoint::new(x, 8.0 + (x * 0.19).cos() * 3.0)
34 })
35 .collect(),
36 ),
37 ])?;
38
39 let dir = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
40 fs::create_dir_all(&dir)?;
41
42 let mut sealed = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
43 let vp = Viewport::window(520, 240);
44 let rest = FrameRequest::full(vp).caption("px / qty");
45 let rest_hit = rest.clone().pointer(Pointer::new(240, 110));
46
47 let idle = sealed.render_series(&layout, &rest)?;
48 fs::write(dir.join("ts_sealed.png"), &idle.png)?;
49 fs::write(dir.join("readme_chart.png"), &idle.png)?;
50 let hit = sealed.render_series(&layout, &rest_hit)?;
51 fs::write(dir.join("ts_crosshair.png"), &hit.png)?;
52 if let Some(tip) = &hit.tooltip_png {
53 fs::write(dir.join("ts_tooltip.png"), tip)?;
54 }
55 println!(
56 "sealed audit (must be empty of values): {:?}",
57 hit.host.audit_text()
58 );
59 println!(
60 "crosshair tooltip_png={} hits={}",
61 hit.tooltip_png.as_ref().map_or(0, Vec::len),
62 hit.hits.len()
63 );
64
65 sealed.set_mode(SurfaceMode::Copyable);
66 let copy = sealed.render_series(&layout, &rest)?;
67 fs::write(dir.join("ts_copyable.png"), ©.png)?;
68 println!("copyable TSV (first 120 chars): {:?}", {
69 let a = copy.host.audit_text();
70 a.chars().take(120).collect::<String>()
71 });
72
73 let trial = Surface::new(
74 SurfaceMode::Sealed,
75 LicenseLens::from_tier(AccessTier::Trial),
76 );
77 let t = trial.render_series(&layout, &rest)?;
78 fs::write(dir.join("ts_trial_lens.png"), &t.png)?;
79 println!(
80 "trial lens viewed rows={} (two sample points per series)",
81 t.viewed.rows.len()
82 );
83
84 println!("wrote {}", dir.display());
85 Ok(())
86}Sourcepub fn render_scatter(
&self,
layout: &SeriesLayout,
request: &FrameRequest,
) -> Result<Frame, Error>
pub fn render_scatter( &self, layout: &SeriesLayout, request: &FrameRequest, ) -> Result<Frame, Error>
Scatter: same samples as Self::render_series, unconnected markers.
§Errors
Empty layout or raster failure.
Examples found in repository?
examples/gallery.rs (line 567)
553 fn frame_png(
554 &self,
555 id: &str,
556 pointer: Option<Pointer>,
557 ) -> Result<Vec<u8>, sealed_surface::Error> {
558 let spec = self
559 .specs
560 .get(id)
561 .ok_or(sealed_surface::Error::InvalidGrid("unknown card"))?;
562 let s = self.surface(spec);
563 let req = self.request(spec, pointer);
564 let frame = match spec.kind {
565 Kind::Table => s.render(&self.grid, &req)?,
566 Kind::Series => s.render_series(&self.series, &req)?,
567 Kind::Scatter => s.render_scatter(&self.scatter, &req)?,
568 Kind::Tree => s.render_tree(&self.tree, &req)?,
569 };
570 Ok(frame.png)
571 }
572
573 fn tooltip(
574 &self,
575 id: &str,
576 pointer: Option<Pointer>,
577 ) -> Result<Option<Vec<u8>>, sealed_surface::Error> {
578 let Some(p) = pointer else {
579 return Ok(None);
580 };
581 let spec = self
582 .specs
583 .get(id)
584 .ok_or(sealed_surface::Error::InvalidGrid("unknown card"))?;
585 let s = self.surface(spec);
586 let req = self.request(spec, Some(p));
587 let frame = match spec.kind {
588 Kind::Table => s.render(&self.grid, &req)?,
589 Kind::Series => s.render_series(&self.series, &req)?,
590 Kind::Scatter => s.render_scatter(&self.scatter, &req)?,
591 Kind::Tree => s.render_tree(&self.tree, &req)?,
592 };
593 Ok(frame.tooltip_png)
594 }More examples
examples/scatter.rs (line 38)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let mut a = Vec::new();
17 let mut b = Vec::new();
18 for i in 0..28u32 {
19 let t = f64::from(i);
20 a.push(SeriesPoint::new(
21 6.0 + (t * 0.37).sin() * 5.0 + t * 0.12,
22 22.0 + (t * 0.51).cos() * 8.0,
23 ));
24 b.push(SeriesPoint::new(
25 18.0 + (t * 0.29).cos() * 6.0,
26 12.0 + (t * 0.41).sin() * 7.0 + t * 0.15,
27 ));
28 }
29 a[10] = SeriesPoint::new(12.0, 49.37);
30
31 let layout = SeriesLayout::try_new(vec![Series::new(0, "a", a), Series::new(1, "b", b)])?;
32 let dir = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
33 fs::create_dir_all(&dir)?;
34
35 let mut sealed = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
36 let vp = Viewport::window(520, 240);
37 let rest = FrameRequest::full(vp).caption("scatter");
38 let idle = sealed.render_scatter(&layout, &rest)?;
39 fs::write(dir.join("sc_sealed.png"), &idle.png)?;
40 fs::write(dir.join("readme_scatter.png"), &idle.png)?;
41
42 let hit = sealed.render_scatter(&layout, &rest.clone().pointer(Pointer::new(240, 110)))?;
43 fs::write(dir.join("sc_crosshair.png"), &hit.png)?;
44 if let Some(tip) = &hit.tooltip_png {
45 fs::write(dir.join("sc_tooltip.png"), tip)?;
46 }
47 println!(
48 "sealed scatter audit={:?} tooltip={}",
49 hit.host.audit_text(),
50 hit.tooltip_png.as_ref().map_or(0, Vec::len)
51 );
52
53 sealed.set_mode(SurfaceMode::Copyable);
54 let copy = sealed.render_scatter(&layout, &rest)?;
55 fs::write(dir.join("sc_copyable.png"), ©.png)?;
56
57 let trial = Surface::new(
58 SurfaceMode::Sealed,
59 LicenseLens::from_tier(AccessTier::Trial),
60 );
61 let t = trial.render_scatter(&layout, &rest)?;
62 fs::write(dir.join("sc_trial_lens.png"), &t.png)?;
63 println!(
64 "wrote scatter renders; trial viewed rows={}",
65 t.viewed.rows.len()
66 );
67 Ok(())
68}Sourcepub fn render_tree(
&self,
layout: &TreeLayout,
request: &FrameRequest,
) -> Result<Frame, Error>
pub fn render_tree( &self, layout: &TreeLayout, request: &FrameRequest, ) -> Result<Frame, Error>
Squarified treemap (crate::TreeLayout).
§Errors
Raster failure or empty mass after the lens (still paints an empty well).
Examples found in repository?
examples/gallery.rs (line 568)
553 fn frame_png(
554 &self,
555 id: &str,
556 pointer: Option<Pointer>,
557 ) -> Result<Vec<u8>, sealed_surface::Error> {
558 let spec = self
559 .specs
560 .get(id)
561 .ok_or(sealed_surface::Error::InvalidGrid("unknown card"))?;
562 let s = self.surface(spec);
563 let req = self.request(spec, pointer);
564 let frame = match spec.kind {
565 Kind::Table => s.render(&self.grid, &req)?,
566 Kind::Series => s.render_series(&self.series, &req)?,
567 Kind::Scatter => s.render_scatter(&self.scatter, &req)?,
568 Kind::Tree => s.render_tree(&self.tree, &req)?,
569 };
570 Ok(frame.png)
571 }
572
573 fn tooltip(
574 &self,
575 id: &str,
576 pointer: Option<Pointer>,
577 ) -> Result<Option<Vec<u8>>, sealed_surface::Error> {
578 let Some(p) = pointer else {
579 return Ok(None);
580 };
581 let spec = self
582 .specs
583 .get(id)
584 .ok_or(sealed_surface::Error::InvalidGrid("unknown card"))?;
585 let s = self.surface(spec);
586 let req = self.request(spec, Some(p));
587 let frame = match spec.kind {
588 Kind::Table => s.render(&self.grid, &req)?,
589 Kind::Series => s.render_series(&self.series, &req)?,
590 Kind::Scatter => s.render_scatter(&self.scatter, &req)?,
591 Kind::Tree => s.render_tree(&self.tree, &req)?,
592 };
593 Ok(frame.tooltip_png)
594 }More examples
examples/treemap.rs (line 47)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let layout = TreeLayout::try_new(TreeNode::branch(
17 0,
18 "catalog",
19 vec![
20 TreeNode::branch(
21 1,
22 "apparel",
23 vec![
24 TreeNode::leaf(2, "shirts", 42.0),
25 TreeNode::leaf(3, "pants", 18.0),
26 TreeNode::leaf(4, "hats", 9.0),
27 ],
28 ),
29 TreeNode::branch(
30 5,
31 "home",
32 vec![
33 TreeNode::leaf(6, "lamps", 21.0),
34 TreeNode::leaf(7, "rugs", 14.0),
35 ],
36 ),
37 TreeNode::leaf(8, "other", 7.0),
38 ],
39 ))?;
40
41 let dir = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
42 fs::create_dir_all(&dir)?;
43
44 let mut sealed = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
45 let vp = Viewport::window(520, 280);
46 let rest = FrameRequest::full(vp).caption("catalog");
47 let idle = sealed.render_tree(&layout, &rest)?;
48 fs::write(dir.join("tm_sealed.png"), &idle.png)?;
49 fs::write(dir.join("readme_tree.png"), &idle.png)?;
50
51 let hit = sealed.render_tree(&layout, &rest.clone().pointer(Pointer::new(80, 90)))?;
52 fs::write(dir.join("tm_hover.png"), &hit.png)?;
53 if let Some(tip) = &hit.tooltip_png {
54 fs::write(dir.join("tm_tooltip.png"), tip)?;
55 }
56 println!(
57 "sealed tree audit={:?} hits={} tooltip={}",
58 hit.host.audit_text(),
59 hit.hits.len(),
60 hit.tooltip_png.as_ref().map_or(0, Vec::len)
61 );
62
63 sealed.set_mode(SurfaceMode::Copyable);
64 let copy = sealed.render_tree(&layout, &rest)?;
65 fs::write(dir.join("tm_copyable.png"), ©.png)?;
66 println!(
67 "copyable TSV (120): {:?}",
68 copy.host.audit_text().chars().take(120).collect::<String>()
69 );
70
71 let trial = Surface::new(
72 SurfaceMode::Sealed,
73 LicenseLens::from_tier(AccessTier::Trial),
74 );
75 let t = trial.render_tree(&layout, &rest)?;
76 fs::write(dir.join("tm_trial_lens.png"), &t.png)?;
77 println!(
78 "wrote treemap renders; trial viewed rows={}",
79 t.viewed.rows.len()
80 );
81 Ok(())
82}Sourcepub fn metrics(&self, grid: &Grid) -> TableMetrics
pub fn metrics(&self, grid: &Grid) -> TableMetrics
Content size and column widths after the lens, without painting.
Examples found in repository?
examples/scroll_resize.rs (line 36)
14fn main() -> Result<(), Box<dyn std::error::Error>> {
15 let mut rows = Vec::new();
16 for i in 0..40u32 {
17 rows.push(Row::new(
18 i,
19 vec![
20 CellValue::text(format!("SKU-{i:03}")),
21 CellValue::float(10.0 + f64::from(i), 2),
22 CellValue::int(i64::from(i) * 3),
23 ],
24 ));
25 }
26 let grid = Grid::try_new(
27 vec![
28 Column::new(0, "sku"),
29 Column::new(1, "price"),
30 Column::new(2, "qty"),
31 ],
32 rows,
33 )?;
34
35 let surface = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
36 let metrics = surface.metrics(&grid);
37 let dir = renders_dir();
38 fs::create_dir_all(&dir)?;
39
40 let window = Viewport::window(420, 140);
41 let frames = [
42 ("scroll_y0.png", window.clamp_to(&metrics), None),
43 ("scroll_y90.png", window.scroll_by(0, 90, &metrics), None),
44 (
45 "scroll_clamped.png",
46 window.scroll_by(0, 9_999, &metrics),
47 None,
48 ),
49 (
50 "resize_sku200.png",
51 window,
52 Some(metrics.resize_column(0, 200)),
53 ),
54 ];
55
56 for (name, vp, widths) in frames {
57 let mut req = FrameRequest::full(vp);
58 if let Some(w) = widths {
59 req = req.column_widths(w);
60 }
61 let frame = surface.render(&grid, &req)?;
62 let path = dir.join(name);
63 fs::write(&path, &frame.png)?;
64 println!(
65 "{name}: origin_y={} visible {}..{} bytes={} -> {}",
66 vp.origin_y,
67 frame.visible_row_start,
68 frame.visible_row_end,
69 frame.png.len(),
70 path.display()
71 );
72 }
73 Ok(())
74}More examples
examples/host_contract.rs (line 51)
37fn main() -> Result<(), Box<dyn std::error::Error>> {
38 let mut rows = Vec::new();
39 for i in 0..80u32 {
40 rows.push(Row::new(
41 i,
42 vec![
43 CellValue::text(format!("ACME-SKU-{i}")),
44 CellValue::float(10.0 + f64::from(i), 2),
45 ],
46 ));
47 }
48 let grid = Grid::try_new(vec![Column::new(0, "sku"), Column::new(1, "price")], rows)?;
49
50 let surface = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
51 let metrics = surface.metrics(&grid);
52
53 // Host scrollbar: window 480×160, content from metrics.
54 let window = Viewport {
55 origin_x: 0,
56 origin_y: 0,
57 width: 480,
58 height: 160,
59 };
60 println!(
61 "host scrollbar: content {}x{} window {}x{} max_origin_y={}",
62 metrics.content_width,
63 metrics.content_height,
64 window.width,
65 window.height,
66 metrics.content_height.saturating_sub(window.height)
67 );
68
69 let dir = std::env::temp_dir().join("sealed-surface-examples");
70 fs::create_dir_all(&dir)?;
71
72 for (name, origin_y) in [("y0", 0u32), ("y180", 180), ("y360", 360)] {
73 let mut req = FrameRequest::full(Viewport {
74 origin_x: 0,
75 origin_y,
76 width: window.width,
77 height: window.height,
78 });
79 req.pointer = Some(Pointer { x: 24, y: 40 });
80 let frame = surface.render(&grid, &req)?;
81 let path = dir.join(format!("host_{name}.png"));
82 fs::write(&path, &frame.png)?;
83 assert!(
84 frame.host.audit_text().is_empty(),
85 "sealed host leaked: {:?}",
86 frame.host.audit_text()
87 );
88 println!(
89 "{name}: rows {}..{} png={} tooltip={} file={}",
90 frame.visible_row_start,
91 frame.visible_row_end,
92 frame.png.len(),
93 frame.tooltip_png.as_ref().map_or(0, Vec::len),
94 path.display()
95 );
96 }
97
98 println!("forbidden: interpolating cell values, tooltip JSON, CSS blur over live rows");
99 println!("allowed: <img alt=\"\"> + tooltip PNG + metrics-driven origin");
100 Ok(())
101}examples/paint_grid.rs (line 54)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let grid = Grid::try_new(
17 vec![
18 Column::new(0, "sku"),
19 Column::new(1, "price"),
20 Column::new(2, "qty"),
21 ],
22 vec![
23 Row::new(
24 0,
25 vec![
26 CellValue::text("ACME-SKU-1"),
27 CellValue::float(49.00, 2),
28 CellValue::int(12),
29 ],
30 ),
31 Row::new(
32 1,
33 vec![
34 CellValue::text("ACME-SKU-2"),
35 CellValue::float(19.50, 2),
36 CellValue::int(3),
37 ],
38 ),
39 Row::new(
40 2,
41 vec![
42 CellValue::text("SECRET-ROW"),
43 CellValue::float(999.00, 2),
44 CellValue::int(1),
45 ],
46 ),
47 ],
48 )?;
49
50 let mut surface = Surface::new(
51 SurfaceMode::Sealed,
52 LicenseLens::from_tier(AccessTier::Trial),
53 );
54 let metrics = surface.metrics(&grid);
55 let mut req = FrameRequest::full(Viewport {
56 origin_x: 0,
57 origin_y: 0,
58 width: metrics.content_width.clamp(320, 960),
59 height: metrics.content_height.clamp(120, 360),
60 });
61 req.pointer = Some(Pointer { x: 24, y: 36 });
62
63 let frame = surface.render(&grid, &req)?;
64 let dir = example_out_dir();
65 fs::create_dir_all(&dir)?;
66 let frame_path = dir.join("frame.png");
67 fs::write(&frame_path, &frame.png)?;
68 if let Some(tip) = &frame.tooltip_png {
69 fs::write(dir.join("tooltip.png"), tip)?;
70 }
71 let renders = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
72 fs::create_dir_all(&renders)?;
73 fs::write(renders.join("readme_table.png"), &frame.png)?;
74 if let Some(tip) = &frame.tooltip_png {
75 fs::write(renders.join("readme_tooltip.png"), tip)?;
76 }
77
78 println!("mode={:?} lens=trial", surface.mode());
79 println!(
80 "content={}x{} visible_rows={}..{} png_bytes={}",
81 frame.content_width,
82 frame.content_height,
83 frame.visible_row_start,
84 frame.visible_row_end,
85 frame.png.len()
86 );
87 println!(
88 "host audit (must not contain prices): {:?}",
89 frame.host.audit_text()
90 );
91 println!("wrote {}", frame_path.display());
92
93 surface.set_mode(SurfaceMode::Copyable);
94 let copyable = surface.render(&grid, &req)?;
95 println!("copyable TSV:\n{}", copyable.host.audit_text());
96
97 write_readme_shots(&renders)?;
98 Ok(())
99}
100
101fn write_readme_shots(renders: &std::path::Path) -> Result<(), Box<dyn std::error::Error>> {
102 let mut rows = Vec::new();
103 for i in 0..8u32 {
104 rows.push(Row::new(
105 i,
106 vec![
107 CellValue::text(format!("SKU-{i:03}")),
108 CellValue::float(12.0 + f64::from(i) * 2.15, 2),
109 CellValue::int(i64::from(i) * 4 + 3),
110 ],
111 ));
112 }
113 let grid = Grid::try_new(
114 vec![
115 Column::new(0, "sku"),
116 Column::new(1, "price"),
117 Column::new(2, "qty"),
118 ],
119 rows,
120 )?;
121 let surface = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
122 let m = surface.metrics(&grid);
123 let frame = surface.render(
124 &grid,
125 &FrameRequest::full(Viewport::window(m.content_width.max(320), 200)),
126 )?;
127 fs::write(renders.join("readme_table.png"), &frame.png)?;
128 Ok(())
129}examples/gallery.rs (line 326)
241 fn build() -> Result<Self, sealed_surface::Error> {
242 let grid = demo_grid();
243 let series = demo_series()?;
244 let scatter = demo_scatter()?;
245 let tree = demo_tree()?;
246 let vp_table = Viewport::window(520, 220);
247 let vp_chart = Viewport::window(640, 280);
248 let mut specs = BTreeMap::new();
249 let mut add = |id, spec: Spec| {
250 specs.insert(id, spec);
251 };
252
253 add(
254 "table-default",
255 Spec {
256 title: "Table · default (compact)",
257 blurb: "TypeScale::Compact — 5×7, row 18. Hover for PNG tooltip.",
258 kind: Kind::Table,
259 appearance: Appearance::default(),
260 mode: SurfaceMode::Sealed,
261 lens: LicenseLens::open(),
262 viewport: vp_table,
263 caption: None,
264 widths: None,
265 },
266 );
267 add(
268 "table-large",
269 Spec {
270 title: "Table · large (2×)",
271 blurb: "TypeScale::large() — opt-in; bigger bitmap, more strain.",
272 kind: Kind::Table,
273 appearance: Appearance::large(),
274 mode: SurfaceMode::Sealed,
275 lens: LicenseLens::open(),
276 viewport: Viewport::window(640, 280),
277 caption: None,
278 widths: None,
279 },
280 );
281 add(
282 "table-xlarge",
283 Spec {
284 title: "Table · xlarge (3×)",
285 blurb: "TypeScale::xlarge().",
286 kind: Kind::Table,
287 appearance: Appearance::xlarge(),
288 mode: SurfaceMode::Sealed,
289 lens: LicenseLens::open(),
290 viewport: Viewport::window(720, 320),
291 caption: None,
292 widths: None,
293 },
294 );
295 add(
296 "table-light",
297 Spec {
298 title: "Table · light",
299 blurb: "Theme::light(), compact glyphs.",
300 kind: Kind::Table,
301 appearance: Appearance::light(),
302 mode: SurfaceMode::Sealed,
303 lens: LicenseLens::open(),
304 viewport: vp_table,
305 caption: None,
306 widths: None,
307 },
308 );
309 add(
310 "table-hc",
311 Spec {
312 title: "Table · high contrast",
313 blurb: "Near-white text, strong grid.",
314 kind: Kind::Table,
315 appearance: Appearance::high_contrast(),
316 mode: SurfaceMode::Sealed,
317 lens: LicenseLens::open(),
318 viewport: vp_table,
319 caption: None,
320 widths: None,
321 },
322 );
323
324 let mut tmp = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
325 tmp.set_appearance(Appearance::default());
326 let m = tmp.metrics(&grid);
327 add(
328 "table-scroll",
329 Spec {
330 title: "Table · scroll_by",
331 blurb: "Sticky header; body scrolled three rows.",
332 kind: Kind::Table,
333 appearance: Appearance::default(),
334 mode: SurfaceMode::Sealed,
335 lens: LicenseLens::open(),
336 viewport: vp_table.scroll_by(0, (m.row_height * 3) as i32, &m),
337 caption: None,
338 widths: None,
339 },
340 );
341 add(
342 "table-resize",
343 Spec {
344 title: "Table · column resize",
345 blurb: "SKU column forced to 220px.",
346 kind: Kind::Table,
347 appearance: Appearance::default(),
348 mode: SurfaceMode::Sealed,
349 lens: LicenseLens::open(),
350 viewport: vp_table,
351 caption: None,
352 widths: Some(m.resize_column(0, 220)),
353 },
354 );
355 add(
356 "table-copyable",
357 Spec {
358 title: "Table · copyable",
359 blurb: "Same pixels; TSV allowed. Tooltip still PNG.",
360 kind: Kind::Table,
361 appearance: Appearance::default(),
362 mode: SurfaceMode::Copyable,
363 lens: LicenseLens::open(),
364 viewport: vp_table,
365 caption: None,
366 widths: None,
367 },
368 );
369 add(
370 "table-trial",
371 Spec {
372 title: "Table · trial lens",
373 blurb: "Two clear rows; rest redacted before paint.",
374 kind: Kind::Table,
375 appearance: Appearance::default(),
376 mode: SurfaceMode::Sealed,
377 lens: LicenseLens::from_tier(AccessTier::Trial),
378 viewport: vp_table,
379 caption: None,
380 widths: None,
381 },
382 );
383 add(
384 "ts-default",
385 Spec {
386 title: "Timeseries · default",
387 blurb: "AA 2px stroke, area fill, nice ticks. Hover the line.",
388 kind: Kind::Series,
389 appearance: Appearance::default(),
390 mode: SurfaceMode::Sealed,
391 lens: LicenseLens::open(),
392 viewport: vp_chart,
393 caption: Some("px / qty"),
394 widths: None,
395 },
396 );
397 add(
398 "ts-large",
399 Spec {
400 title: "Timeseries · large type",
401 blurb: "Same chart, 2× tick glyphs.",
402 kind: Kind::Series,
403 appearance: Appearance::large(),
404 mode: SurfaceMode::Sealed,
405 lens: LicenseLens::open(),
406 viewport: vp_chart,
407 caption: Some("large"),
408 widths: None,
409 },
410 );
411 add(
412 "ts-light",
413 Spec {
414 title: "Timeseries · light",
415 blurb: "Light theme + derived ChartStyle.",
416 kind: Kind::Series,
417 appearance: Appearance::light(),
418 mode: SurfaceMode::Sealed,
419 lens: LicenseLens::open(),
420 viewport: vp_chart,
421 caption: Some("light"),
422 widths: None,
423 },
424 );
425 add(
426 "ts-hc",
427 Spec {
428 title: "Timeseries · high contrast",
429 blurb: "Strong grid and series colors.",
430 kind: Kind::Series,
431 appearance: Appearance::high_contrast(),
432 mode: SurfaceMode::Sealed,
433 lens: LicenseLens::open(),
434 viewport: vp_chart,
435 caption: Some("HC"),
436 widths: None,
437 },
438 );
439 add(
440 "ts-trial",
441 Spec {
442 title: "Timeseries · trial lens",
443 blurb: "Two samples kept per series.",
444 kind: Kind::Series,
445 appearance: Appearance::default(),
446 mode: SurfaceMode::Sealed,
447 lens: LicenseLens::from_tier(AccessTier::Trial),
448 viewport: vp_chart,
449 caption: Some("trial"),
450 widths: None,
451 },
452 );
453 add(
454 "sc-default",
455 Spec {
456 title: "Scatter · default",
457 blurb: "Unconnected markers. Same Series type, different encoding.",
458 kind: Kind::Scatter,
459 appearance: Appearance::default(),
460 mode: SurfaceMode::Sealed,
461 lens: LicenseLens::open(),
462 viewport: vp_chart,
463 caption: Some("scatter"),
464 widths: None,
465 },
466 );
467 add(
468 "sc-trial",
469 Spec {
470 title: "Scatter · trial lens",
471 blurb: "Two points kept per series.",
472 kind: Kind::Scatter,
473 appearance: Appearance::default(),
474 mode: SurfaceMode::Sealed,
475 lens: LicenseLens::from_tier(AccessTier::Trial),
476 viewport: vp_chart,
477 caption: Some("trial"),
478 widths: None,
479 },
480 );
481 add(
482 "tm-default",
483 Spec {
484 title: "Treemap · default",
485 blurb: "Squarified leaves. Hover a cell for PNG tooltip.",
486 kind: Kind::Tree,
487 appearance: Appearance::default(),
488 mode: SurfaceMode::Sealed,
489 lens: LicenseLens::open(),
490 viewport: Viewport::window(640, 320),
491 caption: Some("catalog"),
492 widths: None,
493 },
494 );
495 add(
496 "tm-trial",
497 Spec {
498 title: "Treemap · trial lens",
499 blurb: "Two leaves kept; areas reflow.",
500 kind: Kind::Tree,
501 appearance: Appearance::default(),
502 mode: SurfaceMode::Sealed,
503 lens: LicenseLens::from_tier(AccessTier::Trial),
504 viewport: Viewport::window(640, 320),
505 caption: Some("trial"),
506 widths: None,
507 },
508 );
509 add(
510 "tm-light",
511 Spec {
512 title: "Treemap · light",
513 blurb: "Same layout, light theme.",
514 kind: Kind::Tree,
515 appearance: Appearance::light(),
516 mode: SurfaceMode::Sealed,
517 lens: LicenseLens::open(),
518 viewport: Viewport::window(640, 320),
519 caption: Some("light"),
520 widths: None,
521 },
522 );
523
524 Ok(Self {
525 grid,
526 series,
527 scatter,
528 tree,
529 specs,
530 })
531 }Sourcepub fn render(
&self,
grid: &Grid,
request: &FrameRequest,
) -> Result<Frame, Error>
pub fn render( &self, grid: &Grid, request: &FrameRequest, ) -> Result<Frame, Error>
Apply lens, paint the visible window, encode PNG, build host projection.
§Errors
Invalid grid (via lens output), raster failure, or PNG encode failure.
Examples found in repository?
examples/gallery.rs (line 565)
553 fn frame_png(
554 &self,
555 id: &str,
556 pointer: Option<Pointer>,
557 ) -> Result<Vec<u8>, sealed_surface::Error> {
558 let spec = self
559 .specs
560 .get(id)
561 .ok_or(sealed_surface::Error::InvalidGrid("unknown card"))?;
562 let s = self.surface(spec);
563 let req = self.request(spec, pointer);
564 let frame = match spec.kind {
565 Kind::Table => s.render(&self.grid, &req)?,
566 Kind::Series => s.render_series(&self.series, &req)?,
567 Kind::Scatter => s.render_scatter(&self.scatter, &req)?,
568 Kind::Tree => s.render_tree(&self.tree, &req)?,
569 };
570 Ok(frame.png)
571 }
572
573 fn tooltip(
574 &self,
575 id: &str,
576 pointer: Option<Pointer>,
577 ) -> Result<Option<Vec<u8>>, sealed_surface::Error> {
578 let Some(p) = pointer else {
579 return Ok(None);
580 };
581 let spec = self
582 .specs
583 .get(id)
584 .ok_or(sealed_surface::Error::InvalidGrid("unknown card"))?;
585 let s = self.surface(spec);
586 let req = self.request(spec, Some(p));
587 let frame = match spec.kind {
588 Kind::Table => s.render(&self.grid, &req)?,
589 Kind::Series => s.render_series(&self.series, &req)?,
590 Kind::Scatter => s.render_scatter(&self.scatter, &req)?,
591 Kind::Tree => s.render_tree(&self.tree, &req)?,
592 };
593 Ok(frame.tooltip_png)
594 }More examples
examples/scroll_resize.rs (line 61)
14fn main() -> Result<(), Box<dyn std::error::Error>> {
15 let mut rows = Vec::new();
16 for i in 0..40u32 {
17 rows.push(Row::new(
18 i,
19 vec![
20 CellValue::text(format!("SKU-{i:03}")),
21 CellValue::float(10.0 + f64::from(i), 2),
22 CellValue::int(i64::from(i) * 3),
23 ],
24 ));
25 }
26 let grid = Grid::try_new(
27 vec![
28 Column::new(0, "sku"),
29 Column::new(1, "price"),
30 Column::new(2, "qty"),
31 ],
32 rows,
33 )?;
34
35 let surface = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
36 let metrics = surface.metrics(&grid);
37 let dir = renders_dir();
38 fs::create_dir_all(&dir)?;
39
40 let window = Viewport::window(420, 140);
41 let frames = [
42 ("scroll_y0.png", window.clamp_to(&metrics), None),
43 ("scroll_y90.png", window.scroll_by(0, 90, &metrics), None),
44 (
45 "scroll_clamped.png",
46 window.scroll_by(0, 9_999, &metrics),
47 None,
48 ),
49 (
50 "resize_sku200.png",
51 window,
52 Some(metrics.resize_column(0, 200)),
53 ),
54 ];
55
56 for (name, vp, widths) in frames {
57 let mut req = FrameRequest::full(vp);
58 if let Some(w) = widths {
59 req = req.column_widths(w);
60 }
61 let frame = surface.render(&grid, &req)?;
62 let path = dir.join(name);
63 fs::write(&path, &frame.png)?;
64 println!(
65 "{name}: origin_y={} visible {}..{} bytes={} -> {}",
66 vp.origin_y,
67 frame.visible_row_start,
68 frame.visible_row_end,
69 frame.png.len(),
70 path.display()
71 );
72 }
73 Ok(())
74}examples/host_contract.rs (line 80)
37fn main() -> Result<(), Box<dyn std::error::Error>> {
38 let mut rows = Vec::new();
39 for i in 0..80u32 {
40 rows.push(Row::new(
41 i,
42 vec![
43 CellValue::text(format!("ACME-SKU-{i}")),
44 CellValue::float(10.0 + f64::from(i), 2),
45 ],
46 ));
47 }
48 let grid = Grid::try_new(vec![Column::new(0, "sku"), Column::new(1, "price")], rows)?;
49
50 let surface = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
51 let metrics = surface.metrics(&grid);
52
53 // Host scrollbar: window 480×160, content from metrics.
54 let window = Viewport {
55 origin_x: 0,
56 origin_y: 0,
57 width: 480,
58 height: 160,
59 };
60 println!(
61 "host scrollbar: content {}x{} window {}x{} max_origin_y={}",
62 metrics.content_width,
63 metrics.content_height,
64 window.width,
65 window.height,
66 metrics.content_height.saturating_sub(window.height)
67 );
68
69 let dir = std::env::temp_dir().join("sealed-surface-examples");
70 fs::create_dir_all(&dir)?;
71
72 for (name, origin_y) in [("y0", 0u32), ("y180", 180), ("y360", 360)] {
73 let mut req = FrameRequest::full(Viewport {
74 origin_x: 0,
75 origin_y,
76 width: window.width,
77 height: window.height,
78 });
79 req.pointer = Some(Pointer { x: 24, y: 40 });
80 let frame = surface.render(&grid, &req)?;
81 let path = dir.join(format!("host_{name}.png"));
82 fs::write(&path, &frame.png)?;
83 assert!(
84 frame.host.audit_text().is_empty(),
85 "sealed host leaked: {:?}",
86 frame.host.audit_text()
87 );
88 println!(
89 "{name}: rows {}..{} png={} tooltip={} file={}",
90 frame.visible_row_start,
91 frame.visible_row_end,
92 frame.png.len(),
93 frame.tooltip_png.as_ref().map_or(0, Vec::len),
94 path.display()
95 );
96 }
97
98 println!("forbidden: interpolating cell values, tooltip JSON, CSS blur over live rows");
99 println!("allowed: <img alt=\"\"> + tooltip PNG + metrics-driven origin");
100 Ok(())
101}examples/paint_grid.rs (line 63)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let grid = Grid::try_new(
17 vec![
18 Column::new(0, "sku"),
19 Column::new(1, "price"),
20 Column::new(2, "qty"),
21 ],
22 vec![
23 Row::new(
24 0,
25 vec![
26 CellValue::text("ACME-SKU-1"),
27 CellValue::float(49.00, 2),
28 CellValue::int(12),
29 ],
30 ),
31 Row::new(
32 1,
33 vec![
34 CellValue::text("ACME-SKU-2"),
35 CellValue::float(19.50, 2),
36 CellValue::int(3),
37 ],
38 ),
39 Row::new(
40 2,
41 vec![
42 CellValue::text("SECRET-ROW"),
43 CellValue::float(999.00, 2),
44 CellValue::int(1),
45 ],
46 ),
47 ],
48 )?;
49
50 let mut surface = Surface::new(
51 SurfaceMode::Sealed,
52 LicenseLens::from_tier(AccessTier::Trial),
53 );
54 let metrics = surface.metrics(&grid);
55 let mut req = FrameRequest::full(Viewport {
56 origin_x: 0,
57 origin_y: 0,
58 width: metrics.content_width.clamp(320, 960),
59 height: metrics.content_height.clamp(120, 360),
60 });
61 req.pointer = Some(Pointer { x: 24, y: 36 });
62
63 let frame = surface.render(&grid, &req)?;
64 let dir = example_out_dir();
65 fs::create_dir_all(&dir)?;
66 let frame_path = dir.join("frame.png");
67 fs::write(&frame_path, &frame.png)?;
68 if let Some(tip) = &frame.tooltip_png {
69 fs::write(dir.join("tooltip.png"), tip)?;
70 }
71 let renders = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
72 fs::create_dir_all(&renders)?;
73 fs::write(renders.join("readme_table.png"), &frame.png)?;
74 if let Some(tip) = &frame.tooltip_png {
75 fs::write(renders.join("readme_tooltip.png"), tip)?;
76 }
77
78 println!("mode={:?} lens=trial", surface.mode());
79 println!(
80 "content={}x{} visible_rows={}..{} png_bytes={}",
81 frame.content_width,
82 frame.content_height,
83 frame.visible_row_start,
84 frame.visible_row_end,
85 frame.png.len()
86 );
87 println!(
88 "host audit (must not contain prices): {:?}",
89 frame.host.audit_text()
90 );
91 println!("wrote {}", frame_path.display());
92
93 surface.set_mode(SurfaceMode::Copyable);
94 let copyable = surface.render(&grid, &req)?;
95 println!("copyable TSV:\n{}", copyable.host.audit_text());
96
97 write_readme_shots(&renders)?;
98 Ok(())
99}
100
101fn write_readme_shots(renders: &std::path::Path) -> Result<(), Box<dyn std::error::Error>> {
102 let mut rows = Vec::new();
103 for i in 0..8u32 {
104 rows.push(Row::new(
105 i,
106 vec![
107 CellValue::text(format!("SKU-{i:03}")),
108 CellValue::float(12.0 + f64::from(i) * 2.15, 2),
109 CellValue::int(i64::from(i) * 4 + 3),
110 ],
111 ));
112 }
113 let grid = Grid::try_new(
114 vec![
115 Column::new(0, "sku"),
116 Column::new(1, "price"),
117 Column::new(2, "qty"),
118 ],
119 rows,
120 )?;
121 let surface = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
122 let m = surface.metrics(&grid);
123 let frame = surface.render(
124 &grid,
125 &FrameRequest::full(Viewport::window(m.content_width.max(320), 200)),
126 )?;
127 fs::write(renders.join("readme_table.png"), &frame.png)?;
128 Ok(())
129}Trait Implementations§
Auto Trait Implementations§
impl Forget for Surface
impl Freeze for Surface
impl Move for Surface
impl RefUnwindSafe for Surface
impl Send for Surface
impl Sync for Surface
impl Unpin for Surface
impl UnsafeUnpin for Surface
impl UnwindSafe for Surface
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more