Merge branch 'main' into 335-buffer-not-being-flushed-when-the-input-…

…buffer-size-is-less-than-set-buffer_size-in-audiototextxform-module

.gitattributes

@@ -0,0 +1,2 @@
+data/mp4Reader_saveOrCompare/jpeg/*.jpg filter=lfs diff=lfs merge=lfs -text
+data/mp4Reader_saveOrCompare/h264/*.h264 filter=lfs diff=lfs merge=lfs -text

.github/workflows/CI-Linux-ARM64.yml

@@ -18,8 +18,9 @@ jobs:
  is-selfhosted: true
  cuda: 'ON'
  prep-cmd: 'echo skipping builder prep as I can not sudo'
+ bootstrap-cmd: 'export PATH="$HOME/.local/bin/gcc-8:$PATH" && export VCPKG_FORCE_SYSTEM_BINARIES=1 && ./vcpkg/bootstrap-vcpkg.sh'
  cache-path: './none'
- cmake-conf-cmd: 'export VCPKG_FORCE_SYSTEM_BINARIES=1 && export VCPKG_OVERLAY_PORTS=../thirdparty/custom-overlay && cmake -B . -DENABLE_ARM64=ON ../base'
+ cmake-conf-cmd: 'export VCPKG_OVERLAY_PORTS=../thirdparty/custom-overlay && cmake -B . -DENABLE_ARM64=ON ../base'
  nProc: 6
  jetson-publish:
  needs: jetson-build-test

.github/workflows/CI-Linux-CUDA.yml

@@ -18,6 +18,7 @@ jobs:
  is-selfhosted: true
  cuda: 'ON'
  prep-cmd: 'echo skipping builder prep as I can not sudo'
+ bootstrap-cmd: 'export PATH="/usr/bin/gcc-8:$PATH" && ./vcpkg/bootstrap-vcpkg.sh'
  cache-path: './none'
  nProc: 6
  linux-cuda-publish:

.github/workflows/build-test-lin-container.yml

@@ -30,7 +30,7 @@ on:
  prep-cmd:
  type: string
  description: 'commands required to be run on a builder to prep it for build'
- default: 'sudo apt-get update -qq && sudo apt-get -y install ca-certificates curl zip unzip tar autoconf automake autopoint build-essential flex git-core libass-dev libfreetype6-dev libgnutls28-dev libmp3lame-dev libsdl2-dev libtool libsoup-gnome2.4-dev libva-dev libvdpau-dev libvorbis-dev libxcb1-dev libxcb-shm0-dev libxcb-xfixes0-dev libncurses5-dev libncursesw5-dev ninja-build pkg-config texinfo wget yasm zlib1g-dev nasm gperf bison python3 python3-pip dos2unix libx11-dev libgles2-mesa-dev && pip3 install meson'
+ default: 'sudo apt-get update -qq && sudo apt-get -y install ca-certificates curl zip unzip tar autoconf automake autopoint build-essential flex git-core libass-dev libfreetype6-dev libgnutls28-dev libmp3lame-dev libsdl2-dev libtool libsoup-gnome2.4-dev libva-dev libvdpau-dev libvorbis-dev libxcb1-dev libxcb-shm0-dev libxcb-xfixes0-dev libncurses5-dev libncursesw5-dev ninja-build pkg-config texinfo wget yasm zlib1g-dev nasm gperf bison python3 python3-pip dos2unix libx11-dev libgles2-mesa-dev libxinerama-dev libxcursor-dev xorg-dev libglu1-mesa-dev python3-jinja2 && pip3 install meson'
  required: false
  prep-check-cmd:
  type: string

.github/workflows/build-test-lin.yml

@@ -30,7 +30,7 @@ on:
  prep-cmd:
  type: string
  description: 'commands required to be run on a builder to prep it for build'
- default: 'sudo apt-get update -qq && sudo apt-get -y install ca-certificates curl zip unzip tar autoconf automake autopoint build-essential flex git-core libass-dev libfreetype6-dev libgnutls28-dev libmp3lame-dev libsdl2-dev libtool libsoup-gnome2.4-dev libva-dev libvdpau-dev libvorbis-dev libxdamage-dev libxcb1-dev libxcb-shm0-dev libxcb-xfixes0-dev libncurses5-dev libncursesw5-dev ninja-build pkg-config texinfo wget yasm zlib1g-dev nasm gperf bison python3 python3-pip dos2unix libx11-dev libgles2-mesa-dev && pip3 install meson'
+ default: 'sudo apt-get update -qq && sudo apt-get -y install ca-certificates curl zip unzip tar autoconf automake autopoint build-essential flex git-core libass-dev libfreetype6-dev libgnutls28-dev libmp3lame-dev libsdl2-dev libtool libsoup-gnome2.4-dev libva-dev libvdpau-dev libvorbis-dev libxdamage-dev libxcb1-dev libxcb-shm0-dev libxcb-xfixes0-dev libncurses5-dev libncursesw5-dev ninja-build pkg-config texinfo wget yasm zlib1g-dev nasm gperf bison python3 python3-pip dos2unix libx11-dev libgles2-mesa-dev libxinerama-dev libxcursor-dev xorg-dev libglu1-mesa-dev python3-jinja2 && pip3 install meson && pip3 install Jinja2'
  required: false
  prep-check-cmd:
  type: string

.github/workflows/build-test-win.yml

@@ -84,11 +84,11 @@ jobs:
  if: ${{ contains(inputs.cuda,'ON')}} 
  run: |
  (nvcc --version) || echo 'please install cuda'
- Get-Item 'c:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.7\include\cudnn.h' || echo 'install cudnn as described in the readme.md'
+ Get-Item 'c:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.8\include\cudnn.h' || echo 'install cudnn as described in the readme.md'
  Get-Item Env:CUDA_HOME
  Get-Item Env:CUDA_PATH
- echo "CUDA_HOME=c:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.7" >> $GITHUB_ENV
- echo "CUDA_PATH=c:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.7\bin" >> $GITHUB_ENV
+ echo "CUDA_HOME=c:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.8" >> $GITHUB_ENV
+ echo "CUDA_PATH=c:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v11.8\bin" >> $GITHUB_ENV
  
  - name: Cleanup workspace on self hosted runners
  if: inputs.is-selfhosted

.github/workflows/doxy.yml

@@ -0,0 +1,27 @@
+name: Doxygen Action
+
+on:
+ push:
+ branches: [ main ]
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v2
+
+ - name: Update Footer with Commit Hash
+ run: |
+ COMMIT_HASH=$(git rev-parse --short HEAD)
+ sed -i "s/@COMMIT_HASH@/$COMMIT_HASH/g" data/gh-pages-assets/pages/footer.html
+ 
+ - name: Doxygen Action
+ uses: mattnotmitt/doxygen-action@v1.1.0
+ with:
+ doxyfile-path: "./Doxyfile" 
+ working-directory: "." 
+
+ - name: Deploy
+ uses: peaceiris/actions-gh-pages@v3
+ with:
+ github_token: ${{ secrets.GITHUB_TOKEN }}
+ publish_dir: ./documentation/html

.pre-commit-config.yaml

@@ -0,0 +1,5 @@
+repos:
+ - repo: https://github.com/pre-commit/mirrors-clang-format
+ rev: v17.0.6
+ hooks:
+ - id: clang-format

Doxyfile

@@ -0,0 +1,57 @@
+# Doxyfile configuration file
+# Project name and version
+PROJECT_NAME = "ApraPipes"
+PROJECT_NUMBER = 1.0
+# The directory where the documentation will be created
+OUTPUT_DIRECTORY = ./documentation
+# The root directory of the source code
+INPUT = ./base/include ./base/src ./data/gh-pages-assets/pages/index.md ./data/gh-pages-assets/pages/introduction.md ./data/gh-pages-assets/pages/Tutorial_Adding_New_Module.md ./data/gh-pages-assets/pages/CUDAKernelProgrammingGuide.md
+# File patterns to include in the documentation
+FILE_PATTERNS = *.h *.hpp *.c *.cpp *.md
+# Exclude directories and files
+EXCLUDE = *
+# Recurse through subdirectories
+RECURSIVE = YES
+# Generate documentation for all entities
+EXTRACT_ALL = YES
+# Strip implementation details from documentation
+EXTRACT_PRIVATE = YES
+EXTRACT_STATIC = YES
+HIDE_UNDOC_MEMBERS = YES
+HIDE_UNDOC_CLASSES = YES
+MARKDOWN_SUPPORT = YES
+USE_MDFILE_AS_MAINPAGE = index.md
+# Configuration options for HTML output
+GENERATE_HTML = YES
+HTML_OUTPUT = html
+HTML_FILE_EXTENSION = .html
+HTML_COLORSTYLE = LIGHT
+HTML_COLORSTYLE_HUE = 77
+HTML_COLORSTYLE_SAT = 147
+HTML_COLORSTYLE_GAMMA = 115
+HTML_FOOTER = data/gh-pages-assets/pages/footer.html
+HTML_HEADER = data/gh-pages-assets/pages/logo.html 
+
+# Configuration options for LaTeX output
+GENERATE_LATEX = NO
+# Configuration options for Man pages (UNIX specific)
+GENERATE_MAN = NO
+LATEX_OUTPUT = latex
+# Additional include paths
+INCLUDE_PATH =
+# Predefined macros
+PREDEFINED =
+# Enable collaboration diagram
+HAVE_DOT = YES
+UML_LOOK = YES
+CALL_GRAPH = YES
+CALLER_GRAPH = YES
+
+IMAGE_PATH = data/gh-pages-assets/_images
+HTML_EXTRA_STYLESHEET = data/gh-pages-assets/pages/custom.css
+SHOW_NAMESPACES = NO
+SHOW_FILES = NO
+GENERATE_TREEVIEW = YES
+DISABLE_INDEX = NO
+HTML_EXTRA_FILES = data/gh-pages-assets/_images/apralogo.png
+

README.md

@@ -42,7 +42,7 @@ Aprapipes is automatically built and tested on Ubuntu (18.04 and 20.04), Jetson
 
  ### Cuda
  * Create an account on developer.nvidia.com if you're not already a member. Note : Otherwise the next step will show HTTP 404/403 error.
- * Windows 10/11 : [Cuda Toolkit 10.2](https://developer.nvidia.com/cuda-10.2-download-archive?target_os=Windows&target_arch=x86_64&target_version=10&target_type=exelocal) or [CUDA Toolkit 11.7](https://developer.nvidia.com/cuda-downloads?target_os=Windows&target_arch=x86_64).
+ * Windows 10/11 : [Cuda Toolkit 10.2](https://developer.nvidia.com/cuda-10.2-download-archive?target_os=Windows&target_arch=x86_64&target_version=10&target_type=exelocal) or [CUDA Toolkit 11.8](https://developer.nvidia.com/cuda-11-8-0-download-archive?target_os=Windows).
 
  ### Cudnn
  * Download [Cudnn](https://developer.nvidia.com/rdp/cudnn-archive#a-collapse765-102) and extract files where cuda is installed. Note: Please be aware that this process requires some effort. Here are the necessary steps:
@@ -118,7 +118,7 @@ Aprapipes is automatically built and tested on Ubuntu (18.04 and 20.04), Jetson
  * Create an account on developer.nvidia.com if you're not already a member. Note : Otherwise the next step will show HTTP 404/403 error.
  * Ubuntu 18.04/20.04: 
  18.04 - [CUDA Toolkit 10.2](https://developer.nvidia.com/cuda-10.2-download-archive?target_os=Linux&target_arch=x86_64&target_distro=Ubuntu&target_version=1804&target_type=debnetwork) 
- 20.04 - [CUDA Toolkit 11.7](https://developer.nvidia.com/cuda-11-7-0-download-archive?target_os=Linux&target_arch=x86_64&Distribution=Ubuntu&target_version=20.04)
+ 20.04 - [CUDA Toolkit 11.8](https://developer.nvidia.com/cuda-11-8-0-download-archive?target_os=Linux&target_arch=x86_64&Distribution=Ubuntu&target_version=20.04)
 
  ### Cudnn 
  * Download [Cudnn](https://developer.nvidia.com/rdp/cudnn-archive#a-collapse765-102)