Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/luisdemarchi/cordova-plugin-facedetection-lite
A face detection plugin tested on old and offline smartphone for hybrid applications in Cordova. Runs on iOS, Android and Browser.
https://github.com/luisdemarchi/cordova-plugin-facedetection-lite
android browser cordova cordova-plugin detection face-detection facial-detection image-processing ios mobile
Last synced: 1 day ago
JSON representation
A face detection plugin tested on old and offline smartphone for hybrid applications in Cordova. Runs on iOS, Android and Browser.
- Host: GitHub
- URL: https://github.com/luisdemarchi/cordova-plugin-facedetection-lite
- Owner: luisdemarchi
- License: unlicense
- Created: 2019-06-13T20:25:55.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2019-10-30T14:20:28.000Z (about 5 years ago)
- Last Synced: 2024-12-17T19:37:26.815Z (11 days ago)
- Topics: android, browser, cordova, cordova-plugin, detection, face-detection, facial-detection, image-processing, ios, mobile
- Language: C
- Homepage:
- Size: 8.58 MB
- Stars: 7
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Cordova Plugin Face Detection - LITE
=======================
Plugin for facial detection in real-time and off-line, extremely lite. It is designed to run on old smartphones.
This plugin implemented the method described in [2013 by Markuš et al] (http://arxiv.org/abs/1305.4537).
PS: For older smartphones, it is ideal that each frame reviewed has a maximum height and width of 60 pixels and the processing cycle runs every 100 milliseconds or more. In the sample project, this was implemented.
# Installation
This plugin can be used on the iOS, Android, Electron and Browser platforms;
```
cordova plugins add cordova-plugin-facedetection-lite
```
# Methods
### initFaceDetection(sizeFrameMemory, faceFinderPath, resultCallback)
* `sizeFrameMemory` - Number of frames that will be used to reinforce the detection of all faces. Defaults to 5
* `faceFinderPath` - Facial training file location, being allowed offline. Defaults to [cascades/facefinder](https://raw.githubusercontent.com/nenadmarkus/pico/c2e81f9d23cc11d1a612fd21e4f9de0921a5d0d9/rnt/cascades/facefinder)
* `resultCallback` - Callback function
##### Code:
```javascript
facedetection.initFaceDetection(5, "./facefinder", function (result) {
/* Here you can create the loop to detect frames */
});
```
**Warning**: Until the current version, the parameters are being ignored on some platforms, being ixed default value in the code.
### detections(rgba, width, height, minSizeFace, maxSizeFace, iouthreshold, resultCallback)
* `rgba` - Image in byte array
* `width` - Image width
* `height` - Image height
* `minSizeFace` - Minimum size of selected faces
* `maxSizeFace` - Maximum size of selected faces
* `resultCallback` - Callback function
##### Code:
```javascript
facedetection.detections(rgba, cameraWidth, cameraHeight, cameraWidth * 0.2, cameraWidth * 1.2, 0.1, function (dets) {
for (i = 0; i < dets.length; ++i) {
var box = dets[i];
var canvasPreviewCtx = canvasPreview.getContext('2d');
canvasPreviewCtx.beginPath();
canvasPreviewCtx.arc(box[1], box[0], box[2] / 2, 0, 2 * Math.PI, false);
canvasPreviewCtx.lineWidth = 1;
canvasPreviewCtx.strokeStyle = 'red';
canvasPreviewCtx.stroke();
}
});
```
**Warning**: Until the current version, only the first 3 parameters are implemented and the rest of the parameters are being ignored on some of the platforms, being fixed default value in the code.
# Sample App
[cordova-sample-facedetection](https://github.com/luisdemarchi/cordova-sample-facedetection) for a complete working Cordova example for Android, iOS and Browser platforms.
iOS / Android
Browser
# Task List
- [x] Basic structure of the plugin;
- [x] Add PicoJS library to the Browser
- [x] Compile Pico library in C for iOS
- [x] Compile Pico library in C for Android
- [ ] Process dynamic path to training file
- [ ] Process dynamic parameters when calling each function
# Development
If you intend to do some improvement in the project, follow some instructions, such as compiling library in the C language.
## Recompiling libraries
If you modify the C source files, be sure to re-build the compiled libraries.
#### Android
You can re-build the `libpicornt.so` binaries using the ndk-build script.
To do so:
- Install Android NDK as [instructed here](https://developer.android.com/ndk/guides/index.html)
- Add the NDK install path to your path environment variable
- By default it's installed under $ANDROID_SDK_HOME/ndk-bundle
- e.g. `export PATH=$PATH;$ANDROID_SDK_HOME/ndk-bundle`
- Set the ANDROID_NDK_HOME environment variable to your NDK install path
- e.g. `export ANDROID_NDK_HOME=$ANDROID_SDK_HOME/ndk-bundle`
- Open terminal in plugin root folder
- Run `./compile-android` (`compile-android.cmd` on Windows)
#### iOS
If you modify the C source code in `common/picornt/` you'll need to rebuild the static library and headers in `src/ios/libs`.
- Open terminal in plugin root folder
- Run `./compile-ios`
# Credits
Created by Luís De Marchi [@luisdemarchi](https://github.com/luisdemarchi) - [Linkedin](https://www.linkedin.com/in/luis5/)
#### Libraries used:
- Mobile (Language C) : [nenadmarkus/pico](https://github.com/nenadmarkus/pico)
- Browser (Language JS): [tehnokv/picojs](https://github.com/tehnokv/picojs)