Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/juniorxsound/retouch

🎬 An OpenGL application for editing and retouching images using depth-maps in 2.5D
https://github.com/juniorxsound/retouch

depth depth-map editor graphics image-processing machine-learning opengl

Last synced: 2 months ago
JSON representation

🎬 An OpenGL application for editing and retouching images using depth-maps in 2.5D

Host: GitHub
URL: https://github.com/juniorxsound/retouch
Owner: juniorxsound
License: lgpl-2.1
Created: 2018-02-05T23:10:21.000Z (almost 7 years ago)
Default Branch: master
Last Pushed: 2018-09-24T01:45:24.000Z (over 6 years ago)
Last Synced: 2023-10-20T20:52:42.256Z (about 1 year ago)
Topics: depth, depth-map, editor, graphics, image-processing, machine-learning, opengl
Language: C++
Homepage:
Size: 10.9 MB
Stars: 71
Watchers: 9
Forks: 12
Open Issues: 4
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # ReTouch

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)

[![Build Status](https://travis-ci.org/juniorxsound/ReTouch.svg?branch=master)](https://travis-ci.org/juniorxsound/ReTouch)

ReTouch is an OpenGL application that enables editing and retouching of images using depth-maps in 2.5D. The depth maps are generated by [Volume](http://volume.gl), a state of the art tool, that uses a CNN (Convolutional Neural Network) to predict depth-maps from 2D images . ReTouch uses these depth-maps to enable the addition of depth of field and color retouching for the foreground and background separately.

1. [Demo Video](https://www.youtube.com/watch?v=CAsy_jm85ZY)

1. [Features](#features)

1. [Installation](#installation)

1. [Dependencies](#dependencies)

1. [License](#license)

![Editor](https://github.com/juniorxsound/ReTouch/blob/master/resources/editor.gif)

## Features

- #### Image and Depth-map viewer

![Viewer](https://github.com/juniorxsound/ReTouch/blob/master/resources/depthmap.gif)

- #### Depth of field - switchable between foreground and background

![Depth of Field](https://github.com/juniorxsound/ReTouch/blob/master/resources/dof.gif)

- #### Color retouching  - Coloring for foreground and background separately

![Color](https://github.com/juniorxsound/ReTouch/blob/master/resources/color.gif)

## Installation

To install start by cloning the repo using ```--recursive``` flag, to clone submodules too. e.g

```

git clone https://github.com/juniorxsound/ReTouch --recursive

```

Once you have the repo cloned, make sure you have [CMake](https://cmake.org) installed. Create a directory titled ```build/``` in the root folder of the repo, ```cd``` into that folder and run

```

cmake ../

```

Once CMake finshes you can easily run

```

make

```

to build a new executable and run it by calling ```./ReTouch``` in the build folder

## Dependencies

- [GLFW](https://github.com/glfw/glfw)

- [GLEW](https://github.com/nigels-com/glew)

- [Eigen](https://github.com/libigl/eigen)

- [nanogui](https://github.com/wjakob/nanogui)

> Tested on macOS (10.13.2) using CMake (3.10.0)

> ReTouch was developed under the advisement of Prof. [Ken Perlin](https://github.com/futurerealitylab) and Prof. [Daniele Panozzo](https://github.com/danielepanozzo) @ NYU, Special thanks to [Shirin Anlen](http://shirin.works)

## License

Attached [here](https://github.com/juniorxsound/ReTouch/blob/master/LICENSE)