Image Dimension Converter

Purpose & User Intent: The tool computes exact image dimensions from width_px and height_px in pixels and validates inputs for asset pipelines. Target users are designers, frontend developers, and asset managers needing precise, repeatable sizes for banners, thumbnails, and social graphics. It supports optional scale_factor and an aspect_ratio preservation toggle to avoid distortion when resizing.
Core Logic & Features: Required inputs: width_px and height_px (positive integers, px). Optional: preserve_aspect_ratio (boolean, default true), scale_factor (float, 0.1–10). Outputs: width_px_out, height_px_out (integers, px); aspect_preserved (boolean). If scale_factor is provided, both dimensions are scaled: new_w = round(width_px * scale_factor); new_h = round(height_px * scale_factor). If preserve_aspect_ratio is true and a scale is applied, the ratio is preserved. If no scaling occurs, outputs equal inputs.
Inputs & Outputs: Inputs: width_px (integer, px, sample 1024, required), height_px (integer, px, sample 768, required), preserve_aspect_ratio (boolean, sample true, optional), scale_factor (float, sample 0.5, optional). Outputs: width_px_out, height_px_out (integers, px). Formatting: integer pixel values.
Algorithms & Calculations: The core calculation uses: new_w = round(width_px * scale_factor) and new_h = round(height_px * scale_factor) when scale_factor is provided. If aspect_preserved is true and a target width/height is supplied, derive the other dimension proportionally to maintain the original ratio. If scale_factor is omitted, outputs mirror inputs. All results are rounded to the nearest integer.
Error & Edge Cases: Reject non-positive inputs; clamp values to safe maximums; non-integer inputs are rounded before processing; if scale_factor is out of permitted range, clamp to bounds. No external data dependencies.
Industry/Region & Localization: Pixel-based dimensions align with standard digital imaging practices worldwide; no currency or locale-specific formatting is required. Localization is limited to ensuring consistent unit usage (px).
Assumptions & Exclusions: Assumes inputs are measurements in pixels and that the tool performs only dimensional arithmetic, not image data manipulation, color processing, or file format conversion.