# generic-rtsp-yolov8-render

**Repository Path**: wwhai/generic-rtsp-yolov8-render

## Basic Information

- **Project Name**: generic-rtsp-yolov8-render
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-11
- **Last Updated**: 2025-01-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 仓库介绍

从 RTSP 流拉取视频并渲染到图形界面，同时对每一帧进行图像处理。

### 功能特性

1. **RTSP 拉流**：通过提供 RTSP URL，从流媒体服务器拉取视频流。
2. **多线程处理**：
   - 线程 A：负责实时播放原始视频帧。
   - 线程 B：负责对视频帧进行图像识别处理。
3. **动态叠加检测框**：在播放器界面上实时绘制检测出的矩形框及标记文本：
   - 矩形框为红色，标记文本为绿色。
4. **硬件加速支持**：SDL2 硬件加速提升渲染性能。

### 项目结构

```
.
├── include/              # 头文件目录
│   ├── frame_queue.h      # 帧队列相关接口
│   ├── video_renderer.h   # 视频渲染接口
│   ├── video_processor.h  # 视频处理接口
│   ├── rtsp_client.h      # RTSP 拉流接口
├── src/                  # 源代码目录
│   ├── frame_queue.c      # 帧队列实现
│   ├── video_renderer.c   # 视频渲染实现
│   ├── video_processor.c  # 视频处理实现
│   ├── rtsp_client.c      # RTSP 拉流实现
│   ├── main.c             # 主程序入口
├── obj/                  # 中间文件存放目录
├── Makefile              # 构建脚本
├── README.md             # 项目说明文档
```

### 环境要求

- **开发语言**：C
- **依赖库**：
  - libavformat
  - libavcodec
  - libavutil
  - libswscale
  - SDL2
- **系统环境**：支持 Linux、Windows 等平台

### 编译与运行

#### 编译项目

确保系统已安装依赖库，并通过 `pkg-config` 正确配置库路径。执行以下命令编译项目：

```bash
make
```

#### 清理文件

删除生成的中间文件和可执行文件：

```bash
make clean
```

#### 运行程序

编译成功后，运行以下命令启动程序：

```bash
./rtsp_monitor <RTSP_URL>
```

示例：

```bash
./rtsp_monitor rtsp://192.168.1.10:554/live
```

### 核心模块说明

1. **RTSP 拉流模块 (`rtsp_client.c`)**
   负责通过 RTSP URL 拉取视频流，解析为帧并推送到帧队列。

2. **视频渲染模块 (`video_renderer.c`)**
   负责从队列中读取原始视频帧，并通过 SDL2 硬件加速渲染到图形界面。

3. **视频处理模块 (`video_processor.c`)**
   负责对帧进行识别处理（具体识别逻辑由用户实现），并生成矩形框及标记信息。