diff --git a/Home.md b/Home.md index 6ac3b64..bbbf810 100644 --- a/Home.md +++ b/Home.md @@ -18,10 +18,22 @@ JavaScript module using TensorFlow/JS Machine Learning library
+*Check out [**Simple Live Demo**](https://vladmandic.github.io/human/demo/typescript/index.html) fully annotated app as a good start starting point ([html](https://github.com/vladmandic/human/blob/main/demo/typescript/index.html))([code](https://github.com/vladmandic/human/blob/main/demo/typescript/index.ts))* + +*Check out [**Main Live Demo**](https://vladmandic.github.io/human/demo/index.html) app for advanced processing of of webcam, video stream or images static images with all possible tunable options* + +- To start video detection, simply press *Play* +- To process images, simply drag & drop in your Browser window +- Note: For optimal performance, select only models you'd like to use +- Note: If you have modern GPU, WebGL (default) backend is preferred, otherwise select WASM backend + +
+ ## Demos - [**List of all Demo applications**](https://github.com/vladmandic/human/wiki/Demos) - [*Live:* **Main Application**](https://vladmandic.github.io/human/demo/index.html) +- [*Live:* **Simple Application**](https://vladmandic.github.io/human/demo/typescript/index.html) - [*Live:* **Face Extraction, Description, Identification and Matching**](https://vladmandic.github.io/human/demo/facematch/index.html) - [*Live:* **Face Extraction and 3D Rendering**](https://vladmandic.github.io/human/demo/face3d/index.html) - [*Live:* **Multithreaded Detection Showcasing Maximum Performance**](https://vladmandic.github.io/human/demo/multithread/index.html) @@ -45,6 +57,7 @@ JavaScript module using TensorFlow/JS Machine Learning library - [**Configuration Details**](https://github.com/vladmandic/human/wiki/Config) - [**Result Details**](https://github.com/vladmandic/human/wiki/Result) - [**Caching & Smoothing**](https://github.com/vladmandic/human/wiki/Caching) +- [**Input Processing**](https://github.com/vladmandic/human/wiki/Image) - [**Face Recognition & Face Description**](https://github.com/vladmandic/human/wiki/Embedding) - [**Gesture Recognition**](https://github.com/vladmandic/human/wiki/Gesture) - [**Common Issues**](https://github.com/vladmandic/human/wiki/Issues) @@ -72,8 +85,231 @@ JavaScript module using TensorFlow/JS Machine Learning library *Suggestions are welcome!* +

+ +## Examples + +Visit [Examples galery](https://vladmandic.github.io/human/samples/samples.html) for more examples + + +![samples](assets/samples.jpg) + +
+ +## Options + +All options as presented in the demo application... +> [demo/index.html](demo/index.html) + +![Options visible in demo](assets/screenshot-menu.png) + +
+ +**Results Browser:** +[ *Demo -> Display -> Show Results* ]
+![Results](assets/screenshot-results.png) + +
+ +## Advanced Examples + +1. **Face Similarity Matching:** +Extracts all faces from provided input images, +sorts them by similarity to selected face +and optionally matches detected face with database of known people to guess their names +> [demo/facematch](demo/facematch/index.html) + +![Face Matching](assets/screenshot-facematch.jpg) + +
+ +2. **Face3D OpenGL Rendering:** +> [demo/face3d](demo/face3d/index.html) + +![Face Matching](assets/screenshot-face3d.jpg) + +
+ +3. **VR Model Tracking:** +![vrmodel](assets/screenshot-vrm.jpg) + +
+ +**468-Point Face Mesh Defails:** +(view in full resolution to see keypoints) + +![FaceMesh](assets/facemesh.png) + +


+ +## Quick Start + +Simply load `Human` (*IIFE version*) directly from a cloud CDN in your HTML file: +(pick one: `jsdelirv`, `unpkg` or `cdnjs`) + +```html + + + +``` + +For details, including how to use `Browser ESM` version or `NodeJS` version of `Human`, see [**Installation**](https://github.com/vladmandic/human/wiki/Install) + +
+ +## Inputs + +`Human` library can process all known input types: + +- `Image`, `ImageData`, `ImageBitmap`, `Canvas`, `OffscreenCanvas`, `Tensor`, +- `HTMLImageElement`, `HTMLCanvasElement`, `HTMLVideoElement`, `HTMLMediaElement` + +Additionally, `HTMLVideoElement`, `HTMLMediaElement` can be a standard `