https://github.com/jakeoeding/rippy

A Python seam carving implementation
https://github.com/jakeoeding/rippy

numpy python3 seam-carving

Last synced: about 2 months ago
JSON representation

A Python seam carving implementation

• Host: GitHub
• URL: https://github.com/jakeoeding/rippy
• Owner: jakeoeding
• License: mit
• Created: 2021-06-18T19:03:51.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2022-03-26T15:34:18.000Z (about 4 years ago)
• Last Synced: 2025-05-15T08:14:24.073Z (about 1 year ago)
• Topics: numpy, python3, seam-carving
• Language: Python
• Homepage:
• Size: 78.7 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Rippy

Seam carving is a process that allows you to resize an image while leaving the important parts unaltered.

The process entails repeatedly finding a path of pixels, or a seam, through an image that is relatively nondescript and then removing it. To find such a seam, we compute the energy at each pixel and then determine the path of smallest cumulative energy from one end of the image to the other.

The measure for energy that Rippy uses is simply the gradient magnitude.

## Features

At the moment, Rippy supports vertical seam removal, horizontal seam removal, or both. If both axes are chosen for removal, the vertical seams will be removed first (despite this being potentially suboptimal).

## Usage

`python3 rip.py [-h] -img IMG -out OUT [-vert VERT] [-horz HORZ]`

### Required Arguments:

- Input image path: `-img IMG`

- Output image path: `-out OUT`

### Optional Arguments:

- Show help message and exit: `-h` or `--help`

- Number of vertical seams to remove: `-vert VERT`

- Number of horizontal seams to remove: `-horz HORZ`

## Examples

### Vertical Seam Removal

###### Command:

`python3 rip.py -img img/broadway_tower.jpg -out img/broadway_tower_carved.jpg -vert 100`

###### Original Image:

![Broadway Tower](img/broadway_tower.jpg)

###### Carving Process:

![Vertical carving demo](img/broadway_tower.gif)

###### Resulting Image:

![Broadway Tower (Carved)](img/broadway_tower_carved.jpg)

### Horizontal Seam Removal

###### Command:

`python3 rip.py -img img/corn.jpg -out img/corn_carved.jpg -horz 100`

###### Original Image:

![Corn](img/corn.jpg)

###### Carving Process:

![Horizontal carving demo](img/corn.gif)

###### Resulting Image:

![Corn (Carved)](img/corn_carved.jpg)

### Vertical and Horizontal Seam Removal

###### Command

`python3 rip.py -img img/moon.jpg -out img/moon_carved.jpg -vert 100 -horz 100`

###### Original Image:

![Moon](img/moon.jpg)

###### Carving Process:

![Vertical and horizontal carving demo](img/moon.gif)

###### Resulting Image:

![Moon (Carved)](img/moon_carved.jpg)

## License

MIT