https://github.com/zamhown/wear-a-mask

😷 An SPA that uses only the front-end to perform deep-learning-based facial landmark detection on images and automatically adds breathing mask stickers.
https://github.com/zamhown/wear-a-mask

canvas deep-learning face-apijs face-detection javascript tensorflow-js vue

Last synced: 8 days ago
JSON representation

😷 An SPA that uses only the front-end to perform deep-learning-based facial landmark detection on images and automatically adds breathing mask stickers.

• Host: GitHub
• URL: https://github.com/zamhown/wear-a-mask
• Owner: zamhown
• License: mit
• Created: 2020-01-22T18:21:37.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2023-01-05T05:47:18.000Z (almost 2 years ago)
• Last Synced: 2024-10-16T14:24:35.351Z (23 days ago)
• Topics: canvas, deep-learning, face-apijs, face-detection, javascript, tensorflow-js, vue
• Language: JavaScript
• Homepage: https://zamhown.github.io/wear-a-mask
• Size: 10.4 MB
• Stars: 238
• Watchers: 9
• Forks: 49
• Open Issues: 25
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-github-star - wear-a-mask - end to perform deep-learning-based facial landmark detection on images and automatically adds breathing mask stickers. | zamhown | 239 | (JavaScript)

README

        


# Wear a Mask on Your Avatar

A single-page application that uses only the front-end to perform deep-learning-based facial landmark detection on images and automatically adds breathing mask stickers.   

**Wear a mask on your SNS avatars, just make more people aware of epidemic diseases and public health!**  

  

Application link: [https://zamhown.github.io/wear-a-mask](https://zamhown.github.io/wear-a-mask)  

Application link (Chinese version): [https://zamhown.gitee.io/wear-a-mask](https://zamhown.gitee.io/wear-a-mask)  

  

[中文版ReadMe](https://github.com/zamhown/wear-a-mask/blob/master/readme/README-chs.md)  

## Usage

After the user uploads his or her avatar, the page will automatically detect the face in the picture, and identify the key points to match the most suitable mask sticker.  Then the user can change the position, size, rotation angle and flip of the sticker in an editor implemented by canvas, and then export the modified avatar.  The entire process is performed on the front end, and the pictures do not need to be uploaded to the server.  

  

Usage case screenshot：  

![example](https://raw.githubusercontent.com/zamhown/wear-a-mask/master/assets/example-en.jpg)  

## Face Detection and Facial Landmark Detection

The project uses [face-api.js](https://github.com/justadudewhohacks/face-api.js) which is based on [TensorFlow.js](https://github.com/tensorflow/tfjs).  

The face detection task uses the SSD MobileNet V1 model (trained with the [WIDERFACE dataset](http://mmlab.ie.cuhk.edu.hk/projects/WIDERFace)), and the facial landmark detection task uses a 68-point CNN-based detection model built by the author of face-api.js (the training dataset contains about 35,000 facial images). The models' weight data comes from face-api.js.  

## Automatic Selection and Positioning of Mask Stickers

The project contains several mask sticker images and data for each mask. Three key points were marked on each mask sticker (upper left corner, upper right corner, and bottom of chin). After detecting the landmarks on the user's avatar, the mask sticker that best matches the face shape can be automatically selected based on these data. After calculating the corresponding geometric transformation, the sticker image will be put in the appropriate position on the avatar.  

![mask example](https://raw.githubusercontent.com/zamhown/wear-a-mask/master/assets/mask-example.png)  

## Image Editor With Sticker Editing Function

The image editor for this project is implemented using canvas, based on the npm package [xl_canvas](https://www.npmjs.com/package/xl_canvas). Because the package can not be used directly, it was deeply modified, and a series of functions such as flip, touch support, and export at the original resolution were added and finally integrated into the project.

## Commands

### Project setup

```

npm install

```

### Compiles and hot-reloads for development

```

npm run serve

```

### Compiles and minifies for production

Run `build.bat`.  

  

---

Have fun!