Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Sean Nam committed Mar 20, 2019
1 parent 43b1fc5 commit 56e85eb
Showing 1 changed file with 16 additions and 15 deletions.
31 changes: 16 additions & 15 deletions README.md
Expand Up @@ -8,7 +8,7 @@ arXiv: [https://arxiv.org/abs/1902.06838](https://arxiv.org/abs/1902.06838)
![Teaser GUI](imgs/GUI.gif)

## Overview
We learn to edit face image with a deep network. Our network SC-FEGAN is well suited to generate high quality synthetic image using intuitive user inputs with sketch and color. We used SN-patchGAN discriminator and Unet-like generator with gated convolutional layers.
Edit face images using a a deep neural network. Users can edit face images using intuitive inputs such as sketching and coloring, from which our network SC-FEGAN generates high quality synthetic images. We used SN-patchGAN discriminator and Unet-like generator with gated convolutional layers.

![Teaser Image](imgs/teaser.jpg)

Expand All @@ -20,37 +20,38 @@ We learn to edit face image with a deep network. Our network SC-FEGAN is well su
- opencv-python
- pyyaml

## Usage
## Setup
First, download the model from [Google drive](https://drive.google.com/open?id=1VPsYuIK_DY3Gw07LEjUhg2LwbEDlFpq1).

Basic usage is:
Run these commands to start the program.
```
mv /${HOME}/SC-FEGAN.ckpt.* /${HOME}/ckpt/
python3 demo.py
```

Select the number of GPU by editing `demo.yaml` file (not support multi-GPUs).
Select the number of GPUs you want to use by editing `demo.yaml` file (multi-GPUs are not supported).
```
GPU_NUM: 1 (the number you want to use)
#GPU_NUM: (if you want to use only CPU, erase the number)
```

You can use our network with simple GUI. The only erased regions are filled.

The buttons in GUI:
## How to Use
Edit face images using a simple GUI. Only erased regions of the image are filled in by the network.

Explanation of the buttons:

- `Open Image`: Open the image you want to edit and reset sketch and color.
- `Mask`: Click this button and draw the mask on the left viewer.
- `Sketches`: Click this button and draw the line for sketch on the left viewer.
- `Color`: Click this button and draw the line for color. If you click this first time, you have to choose the color from palette.
- `Palette`: Click this button to change color. If you choose the color, then click the `Color` button to change.
- `Save Img`: Click this button to save results. It is saved as '*name.jpg*'.
- `Open Image`: Open the image you want to edit.
- `Mask`: Draw a mask on the desired regions of the face on the left viewer.
- `Sketches`: Sketch the desired lines on the left viewer.
- `Color`: Draw colored lines. If you click this button the first time, you have to choose a color from the palette.
- `Palette`: Change color. After choosing a color, click the `Color` button to apply the change.
- `Save Img`: Save the results. It is saved as '*name.jpg*'.
- `Arrange`: Arrange the editing works.
- `Undo`: Undo previous editing work.
- `Complete`: Complete the image and show it on the right.
- `Complete`: Generate the image and show it on the right viewer.


We recommend using this in the following steps:
We recommend using the following workflow:
```
1. Draw the sketch plausibly referring to the original image.
2. Draw the mask on the sketched region.
Expand Down

0 comments on commit 56e85eb

Please sign in to comment.