https://github.com/andyg2/repage
Repage removes the background based on a threshold, then positions the remaining image centrally in the specified output size.
https://github.com/andyg2/repage
background-removal centering crop-image gd image-processing php7 resize-images
Last synced: 4 months ago
JSON representation
Repage removes the background based on a threshold, then positions the remaining image centrally in the specified output size.
- Host: GitHub
- URL: https://github.com/andyg2/repage
- Owner: andyg2
- Created: 2022-08-05T22:20:58.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2022-08-05T23:14:16.000Z (almost 4 years ago)
- Last Synced: 2025-09-22T05:45:13.639Z (9 months ago)
- Topics: background-removal, centering, crop-image, gd, image-processing, php7, resize-images
- Language: PHP
- Homepage:
- Size: 832 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### Image repager - attempts to remove background, crops and positions centrally
#### From this
#### To this
### DIRECTORIES
```php
$p['source'] = './source/'; // path of source images with trailing slash
$p['dest'] = './dest/'; // path of destination images with trailing slash
```
### FILE NAMING
#### Adds dimentions to file [basename]-1200x900.jpg and, if destination exists increments filename is_integer [basename]-1200x900-2.jpg
```php
$p['autoname'] = false;
```
### DESTINATION_DIMENSIONS
#### defaults to 800 x 600 if omitted
```php
$p['destination_width'] = 1200;
$p['destination_height'] = 900;
```
### BACKGROUND_COLOR - defaults to white if omitted
#### Specify rgb values
```php
$p['background_color']['r'] = 127;
$p['background_color']['g'] = 127;
$p['background_color']['b'] = 127;
```
#### Or: Use hex value
```php
$p['background_color'] = '#CCCCCC';
```
#### Or: Detect background colors - average color of 10 pixels in from each corder
```php
$p['background_color'] = 10; // (auto)
```
### IMAGE_PADDING
#### Add 20 pixels additional border to crop
```php
$p['image_padding'] = 20;
```
### CROPPING_THRESHOLD
#### Automatic
```php
$p['cropping_threshold'] = 'auto';
```
#### Or Specify a threshold
```php
$p['cropping_threshold'] = 50;
```
## Examples
### Batch images
#### args for batch_repage($p)
##### Process all images in ./source/*.{png,jpeg,jpg,gif}, save as original filenames in ./dest/* as a 1200 x 900 image, get background color from 10px in from the corners, add additional 20px padding to cropped image.
```php
$p['source'] = './source/';
$p['dest'] = './dest/';
$p['autoname'] = false;
$p['destination_width'] = 1200;
$p['destination_height'] = 900;
$p['background_color'] = 10;
$p['image_padding'] = 20;
$p['cropping_threshold'] = 'auto';
```
### Single image
#### args for repage_image($p)
##### Process './source/jack-daniels.jpeg', save as './dest/jack-daniels-400x300.jpeg' (autoname) as a 400 x 300 image, white background color for fropping and fill, add 100px padding around cropped image.
```php
$p['input_image'] = './source/jack-daniels.jpeg';
$p['output_image'] = './dest/jack-daniels.jpeg';
$p['autoname'] = true;
$p['destination_width'] = 400;
$p['destination_height'] = 300;
$p['background_color']['r'] = 255;
$p['background_color']['g'] = 255;
$p['background_color']['b'] = 255;
$p['image_padding'] = 100;
$p['cropping_threshold'] = 'auto';
```
#### Source
#### Result
