[EPIC-6378] Prepare/restructure for stable RC

.gitignore

@@ -1,2 +1,6 @@
 .DS_Store
 statistics.dat
+examples/python/__pycache__
+examples/c/build/*
+examples/nodejs/node_modules
+examples/java/libs/*.jar

examples/c/CMakeLists.txt

@@ -6,11 +6,12 @@ set(CMAKE_C_STANDARD 99)
 if(NOT SCANBOTSDK_VERSION)
     message(FATAL_ERROR "SCANBOTSDK_VERSION is not set.")
 endif()
-if(NOT SCANBOTSDK_API_TOKEN)
-    message(FATAL_ERROR "SCANBOTSDK_API_TOKEN is not set.")
-endif()
 set(CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake/")
 set(SCANBOTSDK_DIR "${CMAKE_CURRENT_BINARY_DIR}/scanbotsdk")
 find_package(ScanbotSDK REQUIRED)
 
-add_subdirectory(barcode)
+file(GLOB_RECURSE SOURCE_FILES CONFIGURE_DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/src/*.c)
+add_executable(scanbotsdk_example ${SOURCE_FILES})
+target_include_directories(scanbotsdk_example PRIVATE include)
+target_link_libraries(scanbotsdk_example PRIVATE scanbotsdk)
+

examples/c/README.md

@@ -1,10 +1,6 @@
-# API Documentation
-The API documentation is accessible here:
-* [Scanbot SDK - C API](https://api-docs.scanbot.io/document-scanner-sdk/linux/c-api/index.html)
+# Scanbot SDK for Linux – C Example
 
-# Installation
-
-## NVidia Jetson
+### NVidia Jetson
 
 > Scanbot SDK requires Jetpack 6.1, CUDA 12.6 and TensorRT 10.3 to run with GPU acceleration.
 
@@ -20,11 +16,22 @@ sudo apt install -y cmake build-essential wget
 sudo apt install -y nvidia-l4t-cuda libnvinfer10 libnvinfer-plugin10 libnvonnxparsers10
 ```
 
+### ⚡ Performance notes (Jetson)
+To avoid throttling, set max GPU/CPU/memory clocks:
+```bash
+sudo jetson_clocks --store
+sudo jetson_clocks
+```
+Restore defaults later:
+```bash
+sudo jetson_clocks --restore
+```
+
 * You're now ready to run the examples.
 
 ----
 
-## Raspberry Pi OS, Ubuntu, Debian
+### Raspberry Pi OS, Ubuntu, Debian
 
 * Install a C compiler, CMake and wget:
 
@@ -34,17 +41,36 @@ sudo apt install -y cmake build-essential wget
 
 * You're now ready to build the examples.
 
-# Building the Examples
+## Building the Examples
+
 In order to build all examples, run the following commands:
 
 ```bash
 mkdir build
 cd build
-cmake -DSCANBOTSDK_VERSION=<SCANBOTSDK_VERSION> -DSCANBOTSDK_API_TOKEN=<SCANBOTSDK_API_TOKEN> ..
+# Replace `<SCANBOTSDK_VERSION>` with the actual version number of the SDK you want to install.
+cmake -DSCANBOTSDK_VERSION=<SCANBOTSDK_VERSION> ..
 make
 ```
 
-Replace `SCANBOTSDK_VERSION` and `SCANBOTSDK_API_TOKEN` with the values you received from us.
+## Usage
+The example supports four modes: **scan**, **analyze**, **classify**, and **parse**.
+```bash
+./scanbotsdk_example scan <subcommand> --file <path/to/file.jpg> [--license <KEY>]
+./scanbotsdk_example scan <subcommand> --file <path/to/file.jpg> [--license <KEY>]
+./scanbotsdk_example analyze <subcommand> --file <path/to/file.jpg> [--save <out.jpg>] [--license <KEY>]
+./scanbotsdk_example analyze <subcommand> --file <path/to/file.jpg> [--save <out.jpg>] [--license <KEY>]
+./scanbotsdk_example classify <subcommand> --file <path/to/file.jpg> [--license <KEY>]
+./scanbotsdk_example parse <subcommand> --text "<input>" [--license <KEY>]
+```
+
+## Example
+```bash
+./scanbotsdk_example scan barcode --file images/example.jpg --license <KEY>
+./scanbotsdk_example analyze analyse_multi_page --file files/doc.pdf --license <KEY>
+./scanbotsdk_example analyze crop_analyze --file images/doc.jpg --save out/crop.jpg --license <KEY>
+./scanbotsdk_example parse mrz --text "P<UTOERIKSSON<<ANNA<MARIA<<<<<<" --license <KEY>
+```
 
-# Running the Examples
-See the `README.md` files in the individual example directories for instructions on how to run them.
+## API References
+👉 [Scanbot SDK - C API](https://api-docs.scanbot.io/document-scanner-sdk/linux/c-api/index.html)