Photo Distortion Tool

Purpose & User Intent: Non-destructive distortion tool for images enabling warp, swirl, and pinch effects. Target users include graphic designers, social media editors, marketers, and hobbyists. When: during creative ideation, mockups, or variant generation to explore visual concepts. The tool accepts an image input, applies a mathematical distortion to pixel coordinates, and outputs a new bitmap.
Core Logic & Features: Distortion engines include warp (pixel displacement via a field), swirl (angular offset around the center with radius-based strength), and pinch (compresses near a focal point). Required inputs: input_image and distortion_type with intensity 0-100%. Optional features: radius, seed for deterministic noise, output_format (PNG/JPG/WEBP), and batch processing. Outputs produce a single distorted bitmap in the selected format.
Inputs & Outputs: Input fields: input_image (URL or file, string, required), distortion_type (enum: warp|swirl|pinch, required), intensity (number 0-100, required), radius (number, px, optional), seed (integer, optional), output_format (string: PNG/JPG/WEBP, optional). Outputs: distorted_image (image file) in the chosen format; width/height metadata; alpha preserved if supported.
Algorithms & Calculations: Distortions are per-pixel remappings. Warp uses a displacement map; Swirl rotates pixels around the center with strength proportional to radial distance; Pinch scales distances toward/away from the focal point. Intensity scales from 0 to 1; radius defines the affected region; seed yields deterministic variation.
Error & Edge Cases: Invalid or unsupported inputs fail gracefully. Large images may require more memory and time. Intensity outside 0-100% is clamped. When required inputs are missing, defaults are applied; outputs may crop if requested dimensions are smaller than the source. Color and alpha handling follow output format capabilities.
Industry/Region & Localization: Uses sRGB color space; supports standard image formats; units are pixels for size and radius; locale does not affect results.
Assumptions & Exclusions: Assumes user wants creative distortion, not photo restoration or landmark-aware edits; excludes facial recognition, color grading, or multi-layer compositing. Processing is performed by a deterministic pipeline where seeds are provided.