Play with ncnn

Sample projects to use ncnn in C++ for multi-platform
Typical project structure is like the following diagram

Target

Platform
- Linux (x64)
- Linux (armv7)
- Linux (aarch64)
- Android (aarch64)
- Windows (x64). Visual Studio 2019
Option
- with Vulkan
- without Vulkan

Usage

./main [input]
 - input = blank
    - use the default image file set in source code (main.cpp)
    - e.g. ./main
 - input = *.mp4, *.avi, *.webm
    - use video file
    - e.g. ./main test.mp4
 - input = *.jpg, *.png, *.bmp
    - use image file
    - e.g. ./main test.jpg
 - input = number (e.g. 0, 1, 2, ...)
    - use camera
    - e.g. ./main 0

How to build a project

0. Requirements

OpenCV 4.x
Vulkan SDK (even if you don’t use it)
- https://github.com/iwatake2222/InferenceHelper#extra-steps-ncnn

1. Download

Download source code and pre-built libraries

  git clone https://github.com/iwatake2222/play_with_ncnn.git
  cd play_with_ncnn
  git submodule update --init
  sh InferenceHelper/third_party/download_prebuilt_libraries.sh

Download models
```
  sh ./download_resource.sh
```
If you want to change pre-built library to be used, modify the following file
- InferenceHelper/third_party/cmakes/ncnn.cmake

2-a. Build in Linux

cd pj_ncnn_cls_mobilenet_v2   # for example
mkdir -p build && cd build
cmake ..
make
./main

2-b. Build in Windows (Visual Studio)

Configure and Generate a new project using cmake-gui for Visual Studio 2019 64-bit
- Where is the source code : path-to-play_with_ncnn/pj_ncnn_cls_mobilenet_v2 (for example)
- Where to build the binaries : path-to-build (any)
Open main.sln
Set main project as a startup project, then build and run!

Note: Debug mode in Visual Studio doesn’t work because debuggable libraries are not provided

2-c. Build in Android Studio

Please refer to
- https://github.com/iwatake2222/InferenceHelper_Sample#2-d-build-in-android-studio
Copy resource directory to /storage/emulated/0/Android/data/com.iwatake.viewandroidncnn/files/Documents/resource
- the directory will be created after running the app (so the first run should fail because model files cannot be read)
Modify ViewAndroid\app\src\main\cpp\CMakeLists.txt to select a image processor you want to use
- set(ImageProcessor_DIR "${CMAKE_CURRENT_LIST_DIR}/../../../../../pj_ncnn_cls_mobilenet_v2/image_processor")
- replace pj_ncnn_cls_mobilenet_v2 to another
In case you encounter error: use of typeid requires -frtti error, modify ViewAndroid\sdk\native\jni\include\opencv2\opencv_modules.hpp
- //#define HAVE_OPENCV_FLANN

License

Licensed under the Apache License, Version 2.0
- LICENSE

Acknowledgements

This project utilizes OSS (Open Source Software)
- NOTICE.md