mirror of
https://github.com/open-mmlab/mmdeploy.git
synced 2025-01-14 08:09:43 +08:00
b59d83bf7b
* move to dev-1.x * fix wrong class name * redesign Params argument mechanisms * change demo build to ant * remove unused debugging file * fix demo * remove hardcode * a general build.xml * update README * fix clang-format * rename follow java format * update docs * fix lint * fix java_api build * fix ci * fix java api ci * fix lint * fix opencv build privilege * fix CI ant build * remove opencv build because is too slow * fix lib path * fix wrong dir * fix run demo location * fix ant command * fix opencv * mv opencv to java demo * fix CI * fix comments * add absolute lib path in ci * find lib * find lib * fix mmdeploy lib path in ci * fix pose ocr pose-tracker * support RotatedDetection and Segmentation score * add cmake * fix lint * fix yapf * fix clang-format * fix clang-format * fix java api ci * fix ocr src pic * add rotate * add opencv lib * fix lib * fix libgstreamer missing * add libgstreamer-plugin * fix comments * fix comments * add avcodec for posetracker * fix CI * fix java ci comments * fix test_java_demo format * fix lint and ffmpeg missing * fix comments * a copy of array for java * fix demo stuck * fix test_java_demo.py * fix popd and pushd * fix java_api * fix java api handle * update for api * add java docstrings for demo * add docstring for posetracker java and fix handle * add some java api docstrings * return ec * add error code for java * add all java docs * fix clang-format * fix PoseTracker apply api for batch inference * fix missing error code * remove author * remove author * remove destroy window * fix wrong code * fix Context * fix java docs * fix comments * fix compile failed * fix for and if format * fix error code * fix bracket
69 lines
2.1 KiB
Markdown
69 lines
2.1 KiB
Markdown
# Usage
|
|
|
|
**step 1.** Install Apache Ant.
|
|
|
|
Please check the Apache Ant existence using `ant -h` in the command line.
|
|
|
|
If there is no Apache Ant installed, please follow the command below.
|
|
|
|
```
|
|
sudo apt-get update
|
|
sudo apt-get install ant
|
|
```
|
|
|
|
Set environment variable
|
|
|
|
```
|
|
export ANT_HOME=/usr/share/ant
|
|
export PATH=${ANT_HOME}/bin:${PATH}
|
|
```
|
|
|
|
**step 2.** Build OpenCV jar package (PoseTracker only).
|
|
|
|
PoseTracker demo needs OpenCV Java, if you are interested in PoseTracker demo, you need to build OpenCV jar package first.
|
|
|
|
Using OpenCV-4.7.0 as example:
|
|
|
|
```
|
|
export OPENCV_VERSION=4.7.0
|
|
export JAVA_AWT_INCLUDE_PATH=${JAVA_HOME}
|
|
export JAVA_AWT_LIBRARY=${JAVA_HOME}
|
|
export JAVA_INCLUDE_PATH=${JAVA_HOME}/include
|
|
export JAVA_INCLUDE_PATH2=${JAVA_HOME}/include/darwin
|
|
export JAVA_JVM_LIBRARY=${JAVA_HOME}
|
|
|
|
wget https://github.com/opencv/opencv/archive/${OPENCV_VERSION}.zip
|
|
unzip ${OPENCV_VERSION}.zip && rm -rf ${OPENCV_VERSION}.zip && cd opencv-${OPENCV_VERSION}
|
|
mkdir -p build && cd build
|
|
cmake -DCMAKE_BUILD_TYPE=RELEASE -DBUILD_JAVA=ON ..
|
|
make -j8 && make install
|
|
```
|
|
|
|
**step 3.** Build MMDeploy Java API.
|
|
|
|
Please check the existence of `*.class` in `${MMDEPLOY_DIR}/csrc/mmdeploy/apis/java/mmdeploy`.
|
|
|
|
If there is no existence of `*.class`, please follow this [tutorial](../../csrc/mmdeploy/apis/java/README.md) to build Java class.
|
|
|
|
**step 4.** Build demo.
|
|
|
|
Use **ImageClassification** as example.
|
|
|
|
First, you should set your mmdeploy path, opencv path, model path and image path to `${MMDEPLOY_DIR}`, `${OPENCV_DIR}`, `${MODEL_PATH}` and `${IMAGE_PATH}`. And then follow the bash codes.
|
|
|
|
```bash
|
|
cd demo/java
|
|
export TASK=ImageClassification
|
|
export ARGS=cpu\ ${MODEL_PATH}\ ${IMAGE_PATH}
|
|
ant -DtaskName=${TASK} -DjarDir=${OPENCV_DIR}/build/bin -DlibDir=${OPENCV_DIR}/build/lib:${MMDEPLOY_DIR}/build/lib -Dcommand=${ARGS}
|
|
```
|
|
|
|
As for **PoseTracker**, you should execute:
|
|
|
|
```bash
|
|
cd demo/java
|
|
export TASK=PoseTracker
|
|
export ARGS=cpu\ ${DET_MODEL_PATH}\ ${POSE_MODEL_PATH}\ ${VIDEO_PATH}
|
|
ant -DtaskName=${TASK} -DjarDir=${OPENCV_DIR}/build/bin -DlibDir=${OPENCV_DIR}/build/lib:${MMDEPLOY_DIR}/build/lib -Dcommand="${ARGS}"
|
|
```
|