Google Git
Sign in
android / platform / external / libopenapv / e4fed4d
commite4fed4d0c414cff51808397e8e0121de3c273ede[log] [tgz]
authormss-park <76668072+mss-park@users.noreply.github.com>Thu Mar 27 20:09:54 2025 +0900
committerGitHub <noreply@github.com>Thu Mar 27 20:09:54 2025 +0900
tree8f566677d3e024bd822ff645388a485eaff842d1
parent655d27700db4739d0422a525700c9247fb233b94 [diff]
Update param auto (#61)

* modification of default number of threads in decoder

Signed-off-by: Minsoo Park <mss.park@samsung.com>

* modification

Signed-off-by: Minsoo Park <mss.park@samsung.com>

* refactoring for parameter parser

Signed-off-by: kp5.choi@samsung.com <kp5.choi@samsung.com>

* normalize LF

Signed-off-by: kp5.choi@samsung.com <kp5.choi@samsung.com>

* fixed oapv_get_num_cpu_cores function for android

Signed-off-by: kp5.choi@samsung.com <kp5.choi@samsung.com>

* update to change default parameter of encoder

Signed-off-by: Minsoo Park <mss.park@samsung.com>

* refacoring

Signed-off-by: kp5.choi@samsung.com <kp5.choi@samsung.com>

* refactoring more

Signed-off-by: kp5.choi@samsung.com <kp5.choi@samsung.com>

* fix to compile on window

Signed-off-by: Minsoo Park <mss.park@samsung.com>

* refactor

Signed-off-by: kp5.choi@samsung.com <kp5.choi@samsung.com>

* refactor

Signed-off-by: kp5.choi@samsung.com <kp5.choi@samsung.com>

---------

Signed-off-by: Minsoo Park <mss.park@samsung.com>
Signed-off-by: kp5.choi@samsung.com <kp5.choi@samsung.com>
Signed-off-by: mss-park <76668072+mss-park@users.noreply.github.com>
Co-authored-by: kp5.choi@samsung.com <kp5.choi@samsung.com>
8 files changed
tree: 8f566677d3e024bd822ff645388a485eaff842d1
  1. .github/
  2. app/
  3. inc/
  4. pkgconfig/
  5. readme/
  6. src/
  7. test/
  8. util/
  9. .clang-format
  10. .gitignore
  11. arm64_toolchain.cmake
  12. cmake_uninstall.cmake.in
  13. CMakeLists.txt
  14. LICENSE
  15. README.md
  16. version.txt
  17. windows_x86_64_toolchain.cmake
README.md

OAPV

OpenAPV (Open Advanced Professional Video Codec)

Build and test

OpenAPV provides the reference implementation of the APV codec which can be used to record professional-grade video and associated metadata without quality degradation. OpenAPV is free and open source software provided by LICENSE.

The OpenAPV supports the following features:

  • fully compliant with 422-10 and 400-10 profile of APV codec
  • Low complexity by optimization for ARM NEON and x86(64bit) SEE/AVX CPU
  • Supports tile-based multi-threading
  • Supports Various metadata including HDR10/10+ and user-defined format
  • Constant QP (CQP), average bitrate (ABR), and constant rate factor (CRF) are supported

APV codec

The APV codec is a professional video codec, which was developed in response to the need for professional level high quality video recording and post production. The primary purpose of the APV codec is for use in professional video recording and editing workflows for various types of content.

APV codec utilizes technologies known to be over 20 years to achieve a royalty free codec. APV builds a video codec using only conventional coding technologies, which consist of traditional methods published between the early 1980s and the end of the 1990s.

The APV codec standard has the following features:

  • Perceptually lossless video quality, which is close to raw video quality
  • Low complexity and high throughput intra frame only coding without pixel domain prediction
  • Support for high bit-rate range up to a few Gbps for 2K, 4K and 8K resolution content, enabled by a lightweight entropy coding scheme
  • Frame tiling for immersive content and for enabling parallel encoding and decoding
  • Support for various chroma sampling formats from 4:2:2 to 4:4:4, and bit-depths from 10 to 16
  • Support for multiple decoding and re-encoding without severe visual quality degradation
  • Support multi-view video and auxiliary video like depth, alpha, and preview
  • Support various metadata including HDR10/10+ and user-definded format

Related specification

How to build

  • Build Requirements

    For ARM

    • gcc-aarch64-linux-gnu
    • binutils-aarch64-linux-gnu

    For Windows (crosscompile)

    • mingw-w64
    • mingw-w64-tools

  • Build Instructions PC (Linux)

    cmake -DCMAKE_BUILD_TYPE=Release -S . -B build
cmake --build build

  • Build Instructions ARM (Crosscompile)

    cmake -S . -B build-arm -DCMAKE_TOOLCHAIN_FILE=aarch64_toolchain.cmake -DCMAKE_BUILD_TYPE=Release 
cmake --build build-arm

  • Build Instructions Windows (Crosscompile)

    cmake -S . -B build-windows -DCMAKE_TOOLCHAIN_FILE=windows_x86_64_toolchain.cmake -DCMAKE_BUILD_TYPE=Release 
cmake --build build-windows

  • Output Location

    • Executable applications can be found under build*/bin/
    • Library files can be found under build*/lib/

How to use

Encoder

Encoder as input require raw YCbCr file (422, 444), 10-bit or more.

Displaying help:

oapv_app_enc --help

Encoding:

oapv_app_enc -i input_1920x1080_yuv422_10bit.yuv -w 1920 -h 1080 -d 10 -z 30 --input-csp 2 -o encoded.apv
oapv_app_enc -i input.y4m -o encoded.apv

Decoder

Decoder output can be in yuv or y4m formats.

Displaying help:

oapv_app_dec --help

Decoding:

oapv_app_dec -i encoded.apv -o output.y4m

Utility

Graphical APV bitstream parser

Pattern file of APV bitstream for ImHex is provided here.

  1. Install ImHex application
  2. Download APV pattern file
  3. Open APV bitstream (*.apv file) with ImHex
  4. Import the APV pattern file on Pattern editor view of ImHex and apply

APV_on_ImHex

Testing

In build directory run ctest

Packaging

For generating package ready for distribution (default deb) execute in build directory cpack, or other formats (tgz, zip etc.) cpack -G TGZ.

License

See LICENSE file for details.

Graphic logo

OAPV OAPV OAPV OAPV OAPV OAPV