Layout

pub fn new(x_range: (f64, f64), y_range: (f64, f64)) -> Self

let layout = Layout::new((0.0, 10.0), (0.0, 100.0));

pub fn auto_from_plots(plots: &[Plot]) -> Self

let scatter = ScatterPlot::new()
    .with_data(vec![(1.0, 2.0), (3.0, 4.0)]);

let plots: Vec<Plot> = vec![scatter.into()];
let layout = Layout::auto_from_plots(&plots)
    .with_title("My Plot")
    .with_x_label("X Axis");

pub fn auto_from_data(data: &[f64], x_range: std::ops::Range<f64>) -> Self

pub fn auto_from_twin_y_plots(primary: &[Plot], secondary: &[Plot]) -> Self

pub fn with_width(mut self, width: f64) -> Self

pub fn with_height(mut self, height: f64) -> Self

let layout = Layout::auto_from_plots(&plots)
    .with_width(800.0)
    .with_height(600.0);

pub fn with_title<S: Into<String>>(mut self, title: S) -> Self

pub fn with_x_label<S: Into<String>>(mut self, label: S) -> Self

pub fn with_y_label<S: Into<String>>(mut self, label: S) -> Self

let layout = Layout::auto_from_plots(&plots)
    .with_title("Gene Expression Analysis")
    .with_x_label("Time (hours)")
    .with_y_label("Expression Level");

pub fn with_ticks(mut self, ticks: usize) -> Self

pub fn with_show_grid(mut self, show: bool) -> Self

let layout = Layout::auto_from_plots(&plots)
    .with_ticks(10)
    .with_show_grid(false);

pub fn with_x_categories(mut self, labels: Vec<String>) -> Self

pub fn with_y_categories(mut self, labels: Vec<String>) -> Self

pub fn with_log_x(mut self) -> Self

pub fn with_log_y(mut self) -> Self

pub fn with_log_scale(mut self) -> Self

let layout = Layout::auto_from_plots(&plots)
    .with_log_y()  // Log scale for y-axis only
    .with_title("Log-scale Plot");

pub fn with_legend_position(mut self, pos: LegendPosition) -> Self

use kuva::plot::legend::LegendPosition;

let layout = Layout::auto_from_plots(&plots)
    .with_legend_position(LegendPosition::BottomRight);

pub fn with_tick_format(mut self, fmt: TickFormat) -> Self

pub fn with_x_tick_format(mut self, fmt: TickFormat) -> Self

pub fn with_y_tick_format(mut self, fmt: TickFormat) -> Self

use kuva::render::layout::TickFormat;

let layout = Layout::auto_from_plots(&plots)
    .with_y_tick_format(TickFormat::Percent)  // Show y-axis as percentages
    .with_x_tick_format(TickFormat::Integer); // Show x-axis as integers

pub fn with_font_family<S: Into<String>>(mut self, family: S) -> Self

pub fn with_title_size(mut self, size: u32) -> Self

pub fn with_label_size(mut self, size: u32) -> Self

pub fn with_tick_size(mut self, size: u32) -> Self

pub fn with_body_size(mut self, size: u32) -> Self

let layout = Layout::auto_from_plots(&plots)
    .with_font_family("Arial")
    .with_title_size(20)
    .with_label_size(16)
    .with_tick_size(12);

pub fn with_theme(mut self, theme: Theme) -> Self

pub fn with_palette(mut self, palette: Palette) -> Self

use kuva::render::theme::Theme;
use kuva::render::palette::Palette;

let layout = Layout::auto_from_plots(&plots)
    .with_theme(Theme::dark())
    .with_palette(Palette::tableau10());

pub fn with_y2_range(mut self, min: f64, max: f64) -> Self

pub fn with_y2_label<S: Into<String>>(mut self, label: S) -> Self

pub fn with_log_y2(mut self) -> Self

pub fn with_y2_tick_format(mut self, fmt: TickFormat) -> Self

pub fn with_y2_auto(mut self, secondary: &[Plot]) -> Self

let primary_plots = vec![line1.into()];
let secondary_plots = vec![line2.into()];

let layout = Layout::auto_from_twin_y_plots(&primary_plots, &secondary_plots)
    .with_y_label("Primary")
    .with_y2_label("Secondary");

pub fn with_x_datetime(mut self, axis: DateTimeAxis) -> Self

pub fn with_y_datetime(mut self, axis: DateTimeAxis) -> Self

pub fn with_x_tick_rotate(mut self, angle: f64) -> Self

use kuva::render::datetime::{DateTimeAxis, DateUnit};

let layout = Layout::auto_from_plots(&plots)
    .with_x_datetime(DateTimeAxis::new(DateUnit::Day))
    .with_x_tick_rotate(-45.0);  // Diagonal labels

pub fn with_annotation(mut self, annotation: TextAnnotation) -> Self

pub fn with_reference_line(mut self, line: ReferenceLine) -> Self

pub fn with_shaded_region(mut self, region: ShadedRegion) -> Self

pub fn with_clamp_axis(mut self) -> Self

pub fn with_clamp_y_axis(mut self) -> Self

pub fn with_term_rows(mut self, rows: u32) -> Self

use kuva::prelude::*;
use kuva::render::layout::{Layout, TickFormat};
use kuva::render::theme::Theme;
use kuva::render::palette::Palette;
use kuva::plot::legend::LegendPosition;

// Create multiple plots
let scatter = ScatterPlot::new()
    .with_data(vec![(1.0, 2.0), (2.0, 4.0), (3.0, 3.5)])
    .with_color("steelblue")
    .with_legend_label("Data Series");

let line = LinePlot::new()
    .with_data(vec![(0.0, 1.0), (1.0, 2.0), (2.0, 3.0), (3.0, 4.0)])
    .with_color("red")
    .with_legend_label("Trend");

let plots: Vec<Plot> = vec![scatter.into(), line.into()];

// Configure comprehensive layout
let layout = Layout::auto_from_plots(&plots)
    .with_width(1000.0)
    .with_height(700.0)
    .with_title("Comprehensive Analysis")
    .with_x_label("Time (seconds)")
    .with_y_label("Signal Intensity")
    .with_ticks(8)
    .with_show_grid(true)
    .with_y_tick_format(TickFormat::Fixed(2))
    .with_theme(Theme::default())
    .with_palette(Palette::tableau10())
    .with_legend_position(LegendPosition::TopRight)
    .with_font_family("Arial")
    .with_title_size(18)
    .with_label_size(14);

let svg = kuva::render_to_svg(plots, layout);