# Catalog Photo Framing Packager Local source edition 1.0.0. Fit up to eight transparent product cutouts to consistent white catalog squares. Download finished PNGs and an exact crop and placement sheet. ## Run locally Extract the complete ZIP. Use Python 3.12 from a terminal in the extracted directory. Create a virtual environment and activate it, then run: python -m pip install -r requirements.txt python run.py example.json results Use a new output folder for each run. Start with example.json and replace its synthetic values with your own data. Preserve field names, types and units. Files and reports are processed on your computer. ## Inputs Supply side (64–512 pixels), margin (at least zero, leaving two interior pixels) and up to eight photos, each with a unique id and pngBase64. Use already isolated products in still 8-bit RGBA PNGs with sRGB pixel values, no ICC profile or EXIF and at most 2 MiB combined. Each input can be up to 1600 pixels per edge and 1.6 million pixels. Every nonzero alpha pixel contributes to the subject bounds. ## Results PHOTOS.zip contains opaque square PNGs on white. The longer side of each trimmed subject fills the available width or height. The shorter dimension is centered with at most one pixel of asymmetric padding. Soft edges are blended before resizing. PLACEMENT.csv maps each input to its file, source crop and output rectangle. Fully transparent inputs are refused. The results folder includes summary.json and the output files produced by this input. The sample produces: PHOTOS.zip, PLACEMENT.csv. ## Español · Generador de encuadres para fotos de catálogo Encuadra recortes transparentes en cuadrados blancos uniformes y exporta los PNG y sus coordenadas. Extrae el ZIP completo y abre una terminal en esa carpeta con Python 3.12. Crea y activa un entorno virtual e instala las dependencias con el comando anterior. Ejecuta: python run.py example.json resultados Copia example.json para preparar tus datos. Conserva los nombres y tipos de los campos, usa una carpeta de salida nueva y consulta summary.json junto con los archivos generados. La descripción detallada de los campos está en inglés. The included LICENSE covers use and modification for your own personal and commercial projects. This edition includes its source and can run locally after setup.