Resize Image

Purpose & User Intent: The tool solves the need to resize raster images to exact pixel dimensions for web, social, email, and content workflows. Primary users include web developers, digital marketers, photographers, and content teams who must fit assets within maximum display sizes or bandwidth constraints. When a source image must be adapted to multiple sizes, this tool enables consistent outputs without altering the original.
Core Logic & Features: The service accepts a source image, required target width and height in pixels, and optional advanced options. Required inputs include the image file and at least one dimension; optional features include preserve aspect ratio, padding, selected output format, and quality/compression. The system can preserve input metadata when requested and can recompress the result to meet size constraints.
Inputs & Outputs: Inputs include image_file (file), width_px (int), height_px (int), keep_aspect (bool, default true), padding (bool, default false), output_format (string: JPEG, PNG, WEBP), quality (0–100). Outputs include resized_image (binary) and a metadata summary including final_dimensions and final_size.
Algorithms & Calculations: Resize uses standard resampling algorithms (nearest, bilinear, bicubic) with aspect-ratio handling: scale = min(width_px/iw, height_px/ih) if keep_aspect is true; new_w = round(scale*iw); new_h = round(scale*ih). If padding is enabled, the remaining canvas is filled with a configurable background.
Error & Edge Cases: Invalid formats, zero or negative dimensions, missing image, or oversized files trigger domain errors and fail gracefully with a precise error code; large images are downsampled progressively to meet memory constraints. Industry/Region & Localization: Dimensions are in pixels; color space is assumed sRGB; the tool uses standard web formats and is suitable for global web workflows; no currency or locale-specific rules apply. Assumptions & Exclusions: The tool operates on a single image per run; batch processing and vector-to-raster conversion are out of scope; advanced image editing (filters, sharpening, or color adjustments) is excluded.