Qt Splitter Resize

Purpose & User Intent: This tool solves the problem of predicting and validating sizes in a Qt splitter layout for two panes. Target users are Qt developers, UI engineers, and prototypers who need to reason about pane proportions, min sizes, and responsive behavior without implementing a full UI. When designing resizable interfaces, users provide container dimension, orientation, and constraints to compute pane sizes.

Core Logic & Features: The tool models a two-pane splitter. Required features include: compute left and right pane sizes from container size, splitter thickness, optional initial split ratio or explicit sizes, and clamp results by minimum pane sizes. Optional/advanced features include: orientation support (horizontal or vertical), drag delta simulation, auto-fit to container, right-to-left orientation, and export of computed sizes in code snippets. Outputs include left_size, right_size, total_size in pixels, a validity flag, and a recommended layout summary. Data is expressed in px and kept consistent with Qt style conventions.

Inputs & Outputs: Inputs: container_size_px (number), orientation ('horizontal'|'vertical'), splitter_thickness_px (number), min_left_px (number), min_right_px (number), initial_split_ratio (0.0-1.0, optional), explicit_left_px (optional), explicit_right_px (optional). Outputs: left_px, right_px, total_px, valid (boolean), notes (string). Validation ensures container_size_px > min_left + min_right + splitter_thickness, and clamp results to minimums.

Algorithms & Calculations: If explicit_left_px or explicit_right_px provided, use them after clamping to min constraints. Else compute left = clamp(container_size_px * initial_split_ratio, min_left_px, container_size_px - min_right_px - splitter_thickness_px); right = container_size_px - splitter_thickness_px - left. If orientation is vertical, apply same logic to height instead of width. Ensure left + right + splitter_thickness = container_size_px.

Error & Edge Cases: If inputs are missing or non-numeric, mark invalid. If container_size is too small to accommodate minimums, return valid=false and indicate error reason. Handle non-finite values and negative numbers gracefully. External data unavailability is not applicable.

Industry/Region & Localization: Units are pixels; tool aligns with Qt widget sizing semantics and DPI independence. Localization scope is limited to numeric values; no currency or country-specific rules apply.

Assumptions & Exclusions: Assumes two-pane horizontal or vertical splitter in a Qt-like layout. Not responsible for rendering, event handling, or actual UI updates. Excludes support for more than two panes or non-linear splitter behavior.