Merge branch 4.x

2026-07-30 15:53:03 +04:00 · 2025-11-17 12:30:39 +03:00
parent d1da626502 6f74546488
commit 1b6fb61b89
64 changed files with 988 additions and 384 deletions
@@ -34,6 +34,15 @@ make
 sudo make install
 ```

+By default, when `-DOBSENSOR_USE_ORBBEC_SDK=ON` is enabled, OrbbecSDK v2 is used (i.e., `ORBBEC_SDK_VERSION` defaults to `2`); it supports the entire Orbbec Gemini 330 series.
+
+If you need legacy cameras such as Orbbec Femto, Gemini2XL, or Astra+, switch to OrbbecSDK v1 with the flag `-DORBBEC_SDK_VERSION=1`:
+```bash
+  cmake -DOBSENSOR_USE_ORBBEC_SDK=ON -DORBBEC_SDK_VERSION=1 ..
+  make -j
+  sudo make install
+```
+
 Code
 ----

@@ -1,7 +1,7 @@
 Using OpenCV with gdb-powered IDEs {#tutorial_linux_gdb_pretty_printer}
 =====================

-@prev_tutorial{tutorial_linux_install}
+@prev_tutorial{tutorial_oneapi_install}
@next_tutorial{tutorial_linux_gcc_cmake}

 |    |    |
@@ -2,7 +2,7 @@ Installation in Linux {#tutorial_linux_install}
 =====================

@prev_tutorial{tutorial_env_reference}
-@next_tutorial{tutorial_linux_gdb_pretty_printer}
+@next_tutorial{tutorial_oneapi_install}

 |    |    |
 | -: | :- |
@@ -0,0 +1,106 @@
+Building OpenCV with oneAPI {#tutorial_oneapi_install}
+===========================
+
+
+@prev_tutorial{tutorial_linux_install}
+@next_tutorial{tutorial_linux_gcc_cmake}
+
+|    |    |
+| -: | :- |
+| Original author | Alessandro de Oliveira Faria |
+| Compatibility | OpenCV >= 4.11.0 |
+
+@tableofcontents
+
+# Quick start {#tutorial_oneapi_install_quick_start}
+
+**oneAPI** is Intel's open initiative (now also maintained by the UXL Foundation) that combines a specification and a set of toolkits for programming CPUs, GPUs, FPGAs and NPUs with a single code base. The core is the SYCL standard (single-source C++ for parallelism), complemented by high-performance libraries — oneTBB (parallelism), oneMKL (linear algebra), oneDNN (neural networks), oneVPL (video), etc. Thus, when you compile with oneAPI's DPC++ (icpx) compiler, the binary gains optimized execution paths that choose, at runtime, the best vector instructions or the available device, without changing the source code.
+
+## Why compile OpenCV with the oneAPI ecosystem when targeting the CPU:
+
+* Simple, because by enabling the CMake options -DWITH_SYCL=ON -DWITH_TBB=ON -DWITH_ONEDNN=ON -DWITH_IPP=ON and using the icpx compiler, the OpenCV core starts to directly invoke oneAPI libraries.
+* oneDNN replaces the generic kernels of the cv::dnn layer with implementations that exploit AVX2, AVX-512, AMX and VNNI, accelerating convolutions, matmul and network post-processing by up to 3-5× on modern CPUs.
+* oneTBB takes over the thread pool, scheduling filters like cv::resize, cv::GaussianBlur or the G-API pipeline across all cores without busy-wait.
+* IPP (now distributed via oneAPI Base Toolkit) provides optimized intrinsic routines for elementary operations (SAD, DFT, median blur), which OpenCV calls when it encounters the HAVE_IPP macro.
+* All this happens transparently: the source code that uses cv::Mat remains the same, but the linked symbols point to vectorized versions, and the internal dispatcher selects the appropriate vector width at runtime.
+
+
+## CPU Processor Requirements
+
+Systems based on Intel® 64 architectures below are supported both as host and target platforms.
+
+* Intel® Core™ processor family or higher
+* Intel® Xeon® processor family
+* Intel® Xeon® Scalable processor family
+
+
+### Requirements for Accelerators
+
+* Integrated GEN9 (and higher) GPUs. See source in Intel® Graphics Compiler for OpenCL™
+* FPGA Card: see Intel(R) DPC++ Compiler System Requirements.
+
+### Disk Space Requirements
+
+* 3.3 GB of disk space (minimum) on a standard installation.
+
+@note: During the installation process, the installer may need up to 6 GB of additional temporary disk storage to manage the download and intermediate installation files.
+
+
+### Memory Requirements
+
+* 8 GB RAM recommended
+
+
+## How To install oneAPI
+
+Installing oneAPI: To quickly set up the oneAPI ecosystem on openSUSE, simply follow the official guide https://www.intel.com/content/www/us/en/developer/articles/guide/installation-guide-for-oneapi-toolkits.html, which shows you how to enable the distribution’s dedicated repository (zypper ar … oneAPI) and install the metapackages ― for example, intel-basekit (DPC++, TBB, oneDNN, IPP compilers) and, optionally, intel-hpckit or intel-renderkit if you need HPC or graphics tools. The guide also explains post-installation tweaks, such as loading the environment with source /opt/intel/oneapi/setvars.sh , ensuring that the binaries (icpx, dpcpp) and libraries are immediately available in your shell for compiling and running accelerated applications.
+
+## Download, Github Instruction, Build and Install
+
+1. Below are the commands to download last version (latest release on the date of publication of this text):
+
+```
+git clone https://github.com/opencv/opencv.git
+```
+
+2. and make sure you are using branch 4.*:
+
+```
+git status
+On branch 4.x
+```
+
+3. Navigate to OpenCV repository and prepare the build folder:
+
+```
+cd opencv
+mkdir build
+cd build
+```
+
+4. Set up Intel oneAPI environment variables. For default installation:
+
+```
+source /opt/intel/oneapi/setvars.sh
+```
+
+5. Run CMake * with Intel® oneAPI DPC++/C++ Compiler to configure the project:
+
+```
+ cmake -DCMAKE_C_COMPILER=icx \
+       -DCMAKE_CXX_COMPILER=icpx
+       -DCMAKE_CXX_FLAGS="-march=native -mavx -mfma -msse -msse2" ..
+ cmake --build .
+```
+6. Now Make sure openCV* is compiled with Intel® oneAPI DPC++/C++ Compiler and install:
+
+```
+readelf -p .comment bin/opencv_annotation
+String dump of section '.comment':
+  [     0]  GCC: (SUSE Linux) 13.3.1 20250313 [revision 4ef1d8c84faeebffeb0cc01ee22e891b41e5c4e0]
+  [    56]  GCC: (SUSE Linux) 12.3.0
+  [    6f]  Intel(R) oneAPI DPC++/C++ Compiler 2025.1.1 (2025.1.1.20250418)
+make install
+```
+
+Have fun...
@@ -9,6 +9,7 @@ Introduction to OpenCV {#tutorial_table_of_content_introduction}

 ##### Linux
 -   @subpage tutorial_linux_install
+-   @subpage tutorial_oneapi_install
 -   @subpage tutorial_linux_gdb_pretty_printer
 -   @subpage tutorial_linux_gcc_cmake
 -   @subpage tutorial_linux_eclipse
@@ -379,6 +379,9 @@ our OpenCV library that we use in our projects. Start up a command window and en

    setx OpenCV_DIR D:\OpenCV\build\x64\vc17     (suggested for Visual Studio 2022 - 64 bit Windows)
    setx OpenCV_DIR D:\OpenCV\build\x86\vc17     (suggested for Visual Studio 2022 - 32 bit Windows)
+
+    setx OpenCV_DIR D:\OpenCV\build\x64\vc18     (suggested for Visual Studio 2026 - 64 bit Windows)
+    setx OpenCV_DIR D:\OpenCV\build\x86\vc18     (suggested for Visual Studio 2026 - 32 bit Windows)
@endcode
 Here the directory is where you have your OpenCV binaries (*extracted* or *built*). You can have
 different platform (e.g. x64 instead of x86) or compiler type, so substitute appropriate value.