Metadata-Version: 2.1
Name: roundface
Version: 0.0.17
Summary: Detect Faces In Images and Generate Profile Photos
Home-page: https://github.com/Edward-K1/roundface
Author: Edward Kigozi
License: UNKNOWN
Description: # Roundface
        Generate profile photos for all faces in a given image
        
        **Input**
        
        ![Source image](https://github.com/Edward-K1/roundface/blob/develop/resources/images/sample.jpg?raw=true)
        
        **Output**
        
        ![demo image](https://github.com/Edward-K1/roundface/blob/develop/resources/images/1.jpg?raw=true) ![demo image](https://github.com/Edward-K1/roundface/blob/develop/resources/images/2.jpg?raw=true) ![demo image](https://github.com/Edward-K1/roundface/blob/develop/resources/images/3.jpg?raw=true)
        
        **Greyed**
        
        ![demo image](https://github.com/Edward-K1/roundface/blob/develop/resources/images/1-grey.jpg?raw=true) ![demo image](https://github.com/Edward-K1/roundface/blob/develop/resources/images/2-grey.jpg?raw=true) ![demo image](https://github.com/Edward-K1/roundface/blob/develop/resources/images/3-grey.jpg?raw=true)
        
        ## Requirements:
        - Python 3
        - OpenCV
        - NumPy
        
        ## Installation
        ```
        pip install opencv-python roundface
        ```
        
        ## Project Setup
        - Clone repo
        - CD in project
        - Create python virtual environment: `python -m venv venv`
        - Activate virtual environment: `venv/bin/activate` or `venv\Scripts\activate`
        - Install requirements with pip: `pip install -r requirement.txt`
        
        ## Usage:
        `roundface - s <path to image file or folder>`
        
        `python roundface.py - s <path to image file or folder>`
        
        ## More Options:
        
        **-g**  or  **--grey**   Integer. 1 or 0. Specifies whether resulting photos should be greyed out.
        
        **- sz**  or  **--size**   Integer. Desired output size in pixels
        
        **- r**  or  **--radius**  Integer (Float). e.g 1.2 for 20% more than the default radius.
        
        **Faces that can't fit a particular radius will be skipped**
        
        
        ## Examples
        
        ```
        roundface -s z://home/photos
        roundface -s z://home/photos/myself.jpg
        roundface -s vacation/photos - sz 400 -g 1
        roundface -s vacation/photos - sz 400 -r 1.0
        ```
        ---
        
        ```
        python roundface.py -s z://home/photos
        python roundface.py -s z://home/photos/myself.jpg
        python roundface.py -s vacation/photos - sz 400 -g 1
        python roundface.py -s vacation/photos - sz 400 -r 1.0
        ```
        A folder named **roundface** will in created in the same location as the image source. It will contain the output photos.
        
        ## Credits:
        [Pexels](https://www.pexels.com/photo/three-children-sitting-on-stairs-1212805/)   
        [Towards Data Science](https://towardsdatascience.com/extracting-faces-using-opencv-face-detection-neural-network-475c5cd0c260)
        
Keywords: face detect roundface profile photo
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
