Aspect Ratio Calculator

WHAT IT DOES

Aspect Ratio Calculator determines the aspect ratio of any width and height combination. Enter the width and height values, and the tool instantly calculates the simplified ratio (e.g., 16:9), decimal value (e.g., 1.7778), and height percentage of width. A visual preview shows a scaled rectangle representing your dimensions. The tool includes common preset ratios (16:9, 4:3, 21:9, 3:2, 5:4, 1:1, 1.85:1, 2.35:1, 9:16, 2:3) that you can apply with one click. Swap width and height with a single button, and copy results in multiple formats.

WHERE IT RUNS

The extension runs entirely within your browser's local environment using the BotGentz framework. All ratio calculations, simplification, and preview rendering occur on your machine without any network requests. No dimension data, calculation results, or user activity is ever transmitted, uploaded, or stored externally. The tool works on any website and respects the browser's security boundaries, operating within the isolated extension sandbox. Aspect ratio calculation uses pure JavaScript mathematical operations.

HOW TO USE

Click the extension toolbar icon to open the Aspect Ratio Calculator panel. Enter the width and height in the input fields. The results update automatically showing the simplified ratio, decimal value, height percentage, and dimensions. A visual preview displays a scaled rectangle representing your dimensions. Click any preset button (16:9, 4:3, 21:9, etc.) to apply that ratio to the inputs. Click "Swap Width/Height" to exchange the width and height values. Click "Copy Result" to copy the result in your chosen format. Toggle "Show preview" to show or hide the visual preview. Toggle "Simplify ratio" to enable or disable ratio simplification. Choose the "Copy Format" (Ratio, Decimal, Dimensions, or Full) to control what is copied. The panel updates instantly as you type.

THE RATIO CALCULATION ENGINE — WHY IT WORKS

Most aspect ratio calculators simply divide width by height and display the decimal value. This tool provides a comprehensive analysis: it calculates the decimal ratio (w/h), the height as a percentage of width, and a simplified ratio using the greatest common divisor (GCD) algorithm. The simplification engine reduces the ratio to its smallest whole-number form using Euclidean algorithm, then scales the result to keep it readable (max 100). If the simplified ratio is very large, it scales down; if very small, it scales up. The tool also compares the calculated ratio against a database of common presets and displays the closest matching preset. The visual preview uses the HTML5 Canvas API to draw a scaled representation of the rectangle, centered and proportionally sized within the preview area. This combined approach gives you both the mathematical and visual understanding of your aspect ratio.

THE PANEL

The Aspect Ratio Calculator panel is fully draggable by its title bar and remembers its position on screen per website. It snaps to the edges of your browser window for clean alignment. Collapse the panel to a compact icon strip using the minimize button, restoring it with a single click. Resize the panel by dragging any edge or corner; the input fields, results, and preview adjust proportionally. Press the Escape key to close the panel instantly. The panel maintains independent state for each browser tab, allowing you to calculate ratios in multiple tabs simultaneously.

PLEASE NOTE

This extension requires the free BotGentz extension framework to be installed and enabled. The tool accepts integer values for width and height; decimal values are also supported but may produce less precise simplified ratios. The visual preview shows a scaled representation, not the exact pixel size. The closest preset detection uses a tolerance of 0.05; some ratios may not match any preset. All calculation data is processed locally and is never transmitted, logged, or shared. The extension requests no network permissions and functions entirely offline. The source code is fully auditable and available for review.