Struct PinstarState 

pub struct PinstarState {

    pub path: PathBuf,
    pub format: SupportedFormat,
    pub data: CanvasData,
    pub settings: Settings,
    pub viewport_x: f64,
    pub viewport_y: f64,
    pub zoom: f64,
    pub selection: Selection<String>,
    pub selected_edge_id: Option<String>,
    pub floating_editor: Option<TextArea<'static>>,
    pub raw_editor: TextArea<'static>,
    pub editor_focus: bool,
    pub mouse_pos: Option<(u16, u16)>,
    pub last_mouse_pos: Option<(u16, u16)>,
    pub last_click: Option<(u16, u16, Instant)>,
    pub context_menu: Option<PinstarContextMenu>,
    pub context_menu_pos: (f64, f64),
    pub connection_source_id: Option<String>,
    pub resizing_node_id: Option<String>,
    pub is_dragging_resize_handle: bool,
    pub deleting_connection_source_id: Option<String>,
    pub trigger_ext_editor: bool,
    pub trigger_whole_file_editor: bool,
    pub trigger_image_picker: bool,
    pub show_editor_pane: bool,
    pub drag_start_pos: Option<(f64, f64)>,
    pub rename_popup: Option<TextArea<'static>>,
    pub ext_editor_enabled: bool,
    pub last_mouse_canvas_pos: Option<(f64, f64)>,
    pub drag_captured_nodes: HashSet<String>,
    pub drag_group_children: HashSet<String>,
    pub show_grid: bool,
    pub mouse_selecting: bool,
    pub mouse_dragged: bool,
    pub locked: bool,
    pub last_modified: SystemTime,
    pub orthogonal_connections: bool,
    pub show_help: bool,
    pub help_tab: PinstarHelpTab,
    pub help_scroll: u16,
    pub select_rect_start: Option<(f64, f64)>,
    pub select_rect_end: Option<(f64, f64)>,
    pub has_layout_override: bool,
    pub undo_stack: Vec<PinstarSnapshot>,
    pub redo_stack: Vec<PinstarSnapshot>,
    pub rename_popup_rect: Option<Rect>,
    pub edge_overlay_rect: Option<Rect>,
    pub help_requested: bool,
    pub footer_hint: String,
    pub last_area: Rect,
    pub is_panning: bool,
    pub marquee: MarqueeState,
    pub right_down_screen: Option<(u16, u16)>,
    pub last_zoom_at: Option<Instant>,
    pub has_dragged: bool,
    pub image_cache: ImageCache,
    pub image_picker: Option<Picker>,
    pub image_decode_tx: Option<Sender<ImageJob>>,
    /* private fields */
}

Fields

path: PathBuf

format: SupportedFormat

data: CanvasData

settings: Settings

viewport_x: f64

viewport_y: f64

zoom: f64

selection: Selection<String>

selected_edge_id: Option<String>

floating_editor: Option<TextArea<'static>>

raw_editor: TextArea<'static>

editor_focus: bool

mouse_pos: Option<(u16, u16)>

last_mouse_pos: Option<(u16, u16)>

last_click: Option<(u16, u16, Instant)>

context_menu: Option<PinstarContextMenu>

context_menu_pos: (f64, f64)

connection_source_id: Option<String>

resizing_node_id: Option<String>

is_dragging_resize_handle: bool

deleting_connection_source_id: Option<String>

trigger_ext_editor: bool

trigger_whole_file_editor: bool

trigger_image_picker: bool

show_editor_pane: bool

drag_start_pos: Option<(f64, f64)>

rename_popup: Option<TextArea<'static>>

ext_editor_enabled: bool

last_mouse_canvas_pos: Option<(f64, f64)>

drag_captured_nodes: HashSet<String>

drag_group_children: HashSet<String>

show_grid: bool

mouse_selecting: bool

mouse_dragged: bool

locked: bool

last_modified: SystemTime

orthogonal_connections: bool

show_help: bool

help_tab: PinstarHelpTab

help_scroll: u16

select_rect_start: Option<(f64, f64)>

select_rect_end: Option<(f64, f64)>

has_layout_override: bool

undo_stack: Vec<PinstarSnapshot>

redo_stack: Vec<PinstarSnapshot>

rename_popup_rect: Option<Rect>

edge_overlay_rect: Option<Rect>

help_requested: bool

footer_hint: String

last_area: Rect

is_panning: bool

marquee: MarqueeState

right_down_screen: Option<(u16, u16)>

last_zoom_at: Option<Instant>

has_dragged: bool

image_cache: ImageCache

image_picker: Option<Picker>

image_decode_tx: Option<Sender<ImageJob>>

Implementations

impl PinstarState

pub fn load(path: &Path) -> Result<Self>

pub fn set_save_handler( &mut self, handler: impl Fn(&Path, &str, &str) -> Result<()> + Send + Sync + 'static, )

Let a host validate the loaded source and persist every eager save.

pub fn save(&mut self) -> Result<()>

pub fn take_save_error(&mut self) -> Option<String>

pub fn last_save_failed(&self) -> bool

pub fn active_mode_message(&self) -> Option<&'static str>

Returns the header-bar status message for the active transient mode (connection / delete-connection / resize), or None when idle.

pub fn record_undo_state(&mut self)

pub fn undo(&mut self) -> Result<()>

pub fn redo(&mut self) -> Result<()>

pub fn reload(&mut self) -> Result<()>

pub fn all_selected_node_ids(&self) -> HashSet<String>

pub fn select_nodes_in_rect(&mut self, x1: f64, y1: f64, x2: f64, y2: f64)

pub fn delete_selected_node(&mut self)

pub fn get_edge_segments( &self, edge: &CanvasEdge, ) -> Option<Vec<(f64, f64, f64, f64)>>

pub fn select_edge_at(&mut self, cx: f64, cy: f64) -> Option<String>

pub fn set_edge_color(&mut self, color: Option<String>)

pub fn set_edge_style(&mut self, style: EdgeStyle)

pub fn open_edge_context_menu(&mut self, x: u16, y: u16)

pub fn open_edge_menu_centered(&mut self, area: Rect)

Opens the edge context menu centered in the given view area.

pub fn selected_node_edges(&self) -> Vec<&CanvasEdge>

Edges connected to the currently selected node, in stable storage order. Used by the edge-list overlay and number-key selection.

pub fn select_edge_of_selected_node(&mut self, index: usize) -> Option<String>

Selects the edge at the given 1-based index among the selected node’s connected edges (deselecting the node). Returns its id, or None if out of range / no node selected.

pub fn is_view_transforming(&self) -> bool

Returns true while the view is undergoing continuous transforms (pan, zoom, node resize, connection drawing). During these states the pixel image render is suppressed to avoid churning the encode worker; cheap placeholder text is shown instead.

pub fn sync_from_raw_editor(&mut self) -> Result<()>

pub fn sync_to_raw_editor(&mut self)

pub fn pan(&mut self, dx: f64, dy: f64)

pub fn zoom_in(&mut self)

pub fn zoom_out(&mut self)

pub fn fit_to_view(&mut self, area: Rect)

pub fn screen_to_canvas(&self, sx: u16, sy: u16, area: Rect) -> (f64, f64)

pub fn node_at(&self, x: f64, y: f64) -> Option<String>

pub fn select_node_at(&mut self, x: f64, y: f64) -> Option<String>

pub fn center_on_selected(&mut self)

pub fn select_node_in_direction(&mut self, dx: f64, dy: f64)

pub fn toggle_editor(&mut self)

pub fn open_context_menu( &mut self, x: u16, y: u16, canvas_x: f64, canvas_y: f64, )

pub fn open_editor_context_menu(&mut self, x: u16, y: u16)

pub fn open_color_menu(&mut self, x: u16, y: u16, edge: bool)

pub fn open_shape_menu(&mut self, x: u16, y: u16)

pub fn open_orientation_menu(&mut self, x: u16, y: u16)

pub fn open_rename_popup(&mut self, mode: RenameMode)

Open the rename popup seeded from the selected node. Title mode renames the node title (clin); Id mode renames the node id and rewires edges (standalone bin).

pub fn rename_node_title(&mut self, new_title: String)

pub fn rename_node_id(&mut self, new_id: String)

pub fn start_resize(&mut self)

pub fn start_delete_connection(&mut self)

pub fn delete_node_connections(&mut self)

pub fn set_node_color(&mut self, color: Option<String>)

pub fn set_node_shape(&mut self, shape: NodeShape)

pub fn set_orientation(&mut self, orientation: DiagramOrientation)

pub fn cycle_orientation(&mut self)

pub fn add_text_node(&mut self, x: f64, y: f64)

pub fn add_group(&mut self, x: f64, y: f64)

pub fn add_image_node_with(&mut self, path: PathBuf, x: f64, y: f64)

Add an image file node at the given position. The host has already resolved the file path via its picker dialog.

pub fn start_connection(&mut self)

pub fn finish_connection(&mut self, target_id: &str)

pub fn finish_delete_connection(&mut self, target_id: &str)

pub fn resize_selected_node(&mut self, dw: f64, dh: f64)

pub fn capture_drag_nodes(&mut self)

pub fn capture_group_children(&mut self)

pub fn move_selected_node(&mut self, dx: f64, dy: f64)