Jetson Linux API 参考
32.7.4 Release
00_video_decode (视频解码)

概述

video_decode 示例应用程序演示了如何使用 libv4l2 组件分配的缓冲区来解码 H.264、H.265、VP8、VP9、MPEG4 或 MPEG2 视频流。

该应用程序读取 H.264、H.265、VP8、VP9、MPEG4 或 MPEG2 基本视频文件，对其进行解码，并将其传递给 EGL 渲染器以显示解码后的图像，而无需任何额外的内存复制。

支持的视频格式包括

  • H.264
  • H.265
  • VP8
  • VP9
  • MPEG4
  • MPEG2

构建和运行

前提条件

  • 您已按照构建和运行中的步骤 1-3 进行操作。
  • 如果您是从主机 Linux PC (x86) 构建，则您已按照构建和运行中的步骤 4 进行操作。

构建

  • 输入
     $ cd /usr/src/jetson_multimedia_api/samples/00_video_decode
 $ make

运行

  • 输入
     $ ./video_decode <in-format> [options] <in-file>

查看支持的选项

输入

   $ ./video_decode --help

示例

  $ ./video_decode H264 ../../data/Video/sample_outdoor_car_1080p_10fps.h264

流程

下图显示了此示例的流程。

  • 输出 平面接收比特流格式的输入，并将其传递给 解码器 进行解码。
  • 捕获 平面以 YUV 格式将解码帧传输到应用程序。
  • 对于输出 平面，应用程序支持 MMAP 和 USRPTR 内存类型。对于捕获 平面，它支持 MMAP 和 DMABUF 内存类型。
  • 应用程序还可以从捕获平面转储文件。

主要结构和类

该示例使用以下主要结构和类。

元素描述
NvVideoDecoder 包含所有视频解码相关的元素和函数。
NvEglRenderer 包含所有 EGL 显示渲染相关的功能。
dec_capture_loop指向解码捕获循环的线程处理程序的指针。

NvVideoDecoder 类封装了所有视频解码相关的元素和函数。示例中使用的主要成员是

成员描述
output_plane 指定 V4L2 输出平面。
capture_plane 指定 V4L2 捕获平面。
createVideoDecoder 用于创建视频解码对象的静态函数。
subscribeEvent 订阅事件。
setOutputPlaneFormat 设置输出平面格式。
setCapturePlaneFormat 设置捕获平面格式。
dqEvent 出队 V4L2 设备报告的事件。
isInError 检查是否处于错误状态。

NvVideoDecoder 类包含两个关键元素：output_plane 和 capture_plane。这些对象派生自 NvV4l2ElementPlane 类类型。该示例使用以下主要成员

元素描述
setupPlane 设置 V4L2 元素的平面。
deinitPlane 销毁 V4L2 元素的平面。
setStreamStatus 启动/停止流。
setDQThreadCallback 设置出队缓冲区线程的回调函数。
startDQThread 启动出队缓冲区的线程。
stopDQThread 停止出队缓冲区的线程。
qBuffer 排队 V4L2 缓冲区。
dqBuffer 出队 V4L2 缓冲区。
getNumBuffers 获取 V4L2 缓冲区的数量。
getNumQueuedBuffers 获取当前在平面上排队的缓冲区数量。
. All rights reserved.