Image Combiner

Combine images in grid.

Usage

Python

combine_images(
    img_paths,
    n_rows=None,
    n_cols=None,
    resize=False,
    fill=False,
    background=(0, 0, 0),
    cell_width=None,
    cell_height=None,
    output_path=None,
    show=False,
)

Return a PIL.Image.Image object, which represents the combined image.

CLI

python image_combiner.py [-h] [-nr N_ROWS] [-nc N_COLS] [-r] [-f] [-b BACKGROUND BACKGROUND BACKGROUND] [-cw CELL_WIDTH] [-ch CELL_HEIGHT] [-o OUTPUT_PATH] [-s]
                         img_paths [img_paths ...]

Combine images in grid.

positional arguments:
  img_paths             Paths to images to be combined

options:
  -h, --help            show this help message and exit
  -nr N_ROWS, --n_rows N_ROWS
                        Number of rows in the grid (default: None)
  -nc N_COLS, --n_cols N_COLS
                        Number of columns in the grid (default: None)
  -r, --resize          Resize each image to match at least one dimension of a cell's size (default: False)
  -f, --fill            Crop each image to fill an entire cell (default: False)
  -b BACKGROUND BACKGROUND BACKGROUND, --background BACKGROUND BACKGROUND BACKGROUND
                        Background color (RGB) (default: (0, 0, 0))
  -cw CELL_WIDTH, --cell_width CELL_WIDTH
                        Width of each cell in the grid (default: None)
  -ch CELL_HEIGHT, --cell_height CELL_HEIGHT
                        Height of each cell in the grid (default: None)
  -o OUTPUT_PATH, --output_path OUTPUT_PATH
                        Output path of the combined image (default: None)
  -s, --show            Show the combined image (default: False)