• uavs3d
• license
• compile
• • windows
  • linux/mac
  • ios
  • android
• Run tests
• • window/linux/mac/android
  • ios
• Contributors

uavs3d

uavs3d is an opensource and cross-platform avs3 decoder, supports AVS3-P2 baseline profile.

features:

1. AVS3-P2 baseline profile.
2. supports to compile for Android/IOS/Windows/Linux/MacOS systems.
3. optimized for ARMv7/ARMv8/SSE4/AVX2 chips.
4. 10bit decoding on all supported platforms.

license

Copyright reserved by “Peking University Shenzhen Graduate School”, “Peng Cheng Laboratory”, and “Guangdong Bohua UHD Innovation Corporation”


This program is a free software. You can redistribute it and/or modify it under the terms of the Open-Intelligence Open Source License V1.1. (http://www.aitisa.org.cn/uploadfile/2018/0910/20180910031548314.pdf)

For more details, please view the file "COPYING" in the project.

compile

The default configuration only support 8bit decoding.

To support 10bit streams decoding, edit source/decore/com_def.h : #define BIT_DEPTH 10

windows

Prerequisites:
Visual Studio 2017

build:

1. ./version.bat (to generate version.h)
2. solution file: build/x86_windows/uavs3d.sln

linux/mac

Prerequisites:

1. gawk (http://www.gnu.org/software/gawk/)
2. CMake (https://cmake.org) version 2.8 or higher

Build:

1. ./version.sh
2. mkdir build/linux
3. cd build/linux && cmake ../..
4. make && make install

to build shared library, edit source/CMakeLists.txt:

add_library(uavs3d SHARED ${DIR_UAVS3D_SRC} ${DIR_X86_256_SRC} ${DIR_X86_SRC})

ios

Prerequisites:
XCode

Build:

1. ./version.sh (generate the version.h)
2. xcode solution file: build/ios/uavs3d.xcodeproj

android

Prerequisites:
Android NDK (https://developer.android.google.cn/ndk/downloads/).

Build ndk library or executable file:

1. ./version.sh (generate the version.h)
2. cd build/android/ndk/jni
3. $NDK_PATH/ndk-build

The executable application for arm64-v8a is generated by default.
To generate static or shared library for other platforms, modify correlative options in Android.mk and Application.mk.

Run tests

window/linux/mac/android

sample: ./uavs3d -i input.avs3 -o output.yuv -t 8 -l 2 -s 1

Arguments:

short name	long name	introduction
-h	--help	Print this help
-v	--version	Version information
-i	--input	Input file
-o	--output	Output file
-l	--loglevel	Log level: 0: no message; 1: seq level; 2: frame level (default)
-t	--threads	Number of frame-level threads
-f	--frames	Total frames to decode
-s	--check_md5	Enable to check md5 or not

ios

Edit build/ios/uavs3d/main.m to configure decoding options.

Contributors

This program is originally developed by the team of Prof.Ronggang Wang (rgwang@pkusz.edu.cn) at Peking University Shenzhen Graduate School.

• Main contributors:
  • Zhenyu Wang (wangzhenyu@pkusz.edu.cn), Peking University Shenzhen Graduate School.
  • Bingjie Han (hanbj@pkusz.edu.cn), Peking University Shenzhen Graduate School.
  • Jiang Du, Peking University Shenzhen Graduate School.
  • Kui Fan, Peking University Shenzhen Graduate School.
  • Xi Xie, Peking University Shenzhen Graduate School.
  • Guisen Xu, Peking University Shenzhen Graduate School.
  • Xufeng Li, Peking University Shenzhen Graduate School.
  • Yangang Cai, Peking University Shenzhen Graduate School.
  • Hao Lv, Peng Cheng Laboratory.
  • Ronggang Wang (rgwang@pkusz.edu.cn), Peking University Shenzhen Graduate School