# toolkit

**Repository Path**: mgdh/toolkit

## Basic Information

- **Project Name**: toolkit
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-21
- **Last Updated**: 2026-08-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# UniInfer Toolkit

`toolkit` contains reusable infrastructure and operators shared by UniInfer
applications. Public headers use a shallow module layout under `include`;
concrete implementations use the same layout under `src`.

## Directory layout

```text
toolkit/
├── include/
│   ├── common/                queues, logging, timing
│   ├── media/                 Frame and timestamp synchronization
│   ├── ops/                   vision and CUDA operators
│   └── toolkit.hpp            common aggregate header
├── src/
│   ├── common/
│   └── ops/
└── tests/
```

Application-specific adapters do not belong here. FFmpeg contexts, ROS 2
nodes, configuration policy, UI code, and camera reconnect logic remain in
their applications.

## CMake targets

- `UniInfer::Common`: bounded queue, logger, and timer utilities.
- `UniInfer::Media`: backend-neutral frame model and frame synchronizer.
- `UniInfer::VisionOps`: optional OpenCV image operators.
- `UniInfer::CudaOps`: optional CUDA operators.
- `UniInfer::ToolkitCore`: compatibility aggregate for Utils and Media.
- `UniInfer::Toolkit`: aggregate for the common toolkit and enabled vision
  operators.

```cmake
set(UNINFER_TOOLKIT_WITH_OPENCV OFF)
set(UNINFER_TOOLKIT_ENABLE_CUDA ON)
add_subdirectory(path/to/toolkit)

target_link_libraries(my_pipeline PRIVATE
    UniInfer::Media
    UniInfer::CudaOps
)
```

Public headers are included by module:

```cpp
#include <common/bounded_queue.hpp>
#include <media/frame.hpp>
#include <media/frame_synchronizer.hpp>
#include <ops/image_splitter.hpp>
#include <ops/nv12_compositor.hpp>
```

The media layer stores reference-counted surface handles, not pixel copies.
FFmpeg, GStreamer/NVMM, ROS 2/NITROS, and CPU-memory backends provide their own
resource adapters outside the toolkit.

## Tests

```bash
cmake -S . -B build \
  -DUNINFER_TOOLKIT_WITH_OPENCV=OFF \
  -DUNINFER_TOOLKIT_BUILD_TESTS=ON
cmake --build build
ctest --test-dir build --output-on-failure
```