make_image_square

# make_image_square


Tiny helper that turns any image size into a **1:1 layout plan**: square canvas size plus left/right/top/bottom padding so you can fit without cropping.

Useful when you need the math for letterboxing / pillarboxing before you draw to a canvas, generate CSS `object-fit`-style boxes, or prep assets for Instagram and profile photos.

## Install


```elixir

def deps do

  [

    {:make_image_square, "~> 0.1.0"}

  ]

end

```


## Usage


```elixir

# 1200×800 landscape → 1200×1200 with top/bottom pads

layout = MakeImageSquare.make_image_square(1200, 800)

# canvas 1200, pad_top 200, pad_bottom 200



# Force a specific square edge (e.g. 1080 for feed posts)

ig = MakeImageSquare.make_image_square(1200, 800, canvas_size: 1080)



# Padding-only helper

pads = MakeImageSquare.square_padding(800, 1200)

```


### Modes


| Mode | Behavior |
|------|----------|
| `:fit` (default) | Entire image visible; empty bands become padding |
| `:fill` | Image covers the square; caller is expected to crop overflow |

## Notes


- This package only returns numbers. It does not decode or rewrite image files.
- Prefer not to wire up ImageMagick or Vix yourself? There is a [square photo editor you can use in a browser](https://squareimage.run) that can letterbox, blur the frame, or crop without Mix.

## License


MIT