3.5 VDEC 模块 API 手册#
1. 概述#
本文件详细介绍了 K230_CanMV VDEC 模块的 API。该模块支持 H.264 和 H.265 解码，并能够与 VO 模块进行绑定，将解码后的数据输出至 VO 显示设备。
2. API 介绍#
本模块提供了 Decoder 类，该类包含以下方法：
2.1 Decoder.__init__#
描述
构造函数，用于初始化解码器实例。
语法
decoder = Decoder(K_PT_H264)
参数
参数名称 |
描述 |
输入/输出 |
|---|---|---|
type |
编码类型 |
输入 |
返回值
返回值 |
描述 |
|---|---|
0 |
成功 |
非 0 |
失败 |
注意事项
VDEC 模块最多支持四路并发解码。
2.2 Decoder.Create#
描述
创建解码器实例。
语法
decoder = Decoder(K_PT_H264)
decoder.create()
参数
无
返回值
返回值 |
描述 |
|---|---|
0 |
成功 |
非 0 |
失败 |
2.3 Decoder.destroy#
描述
销毁解码器实例。
语法
decoder = Decoder(K_PT_H264)
decoder.destroy()
参数
无
返回值
返回值 |
描述 |
|---|---|
0 |
成功 |
非 0 |
失败 |
2.4 Decoder.Start#
描述
启动解码器，开始解码过程。
语法
decoder = Decoder(K_PT_H264)
decoder.Start()
参数
无
返回值
返回值 |
描述 |
|---|---|
0 |
成功 |
非 0 |
失败 |
2.5 Decoder.decode#
描述
对一帧数据进行解码。
语法
decoder = Decoder(K_PT_H264)
decoder.decode(stream_data)
参数
参数名称 |
描述 |
输入/输出 |
|---|---|---|
stream_data |
编码数据 |
输入 |
返回值
返回值 |
描述 |
|---|---|
0 |
成功 |
非 0 |
失败 |
2.6 Decoder.stop#
描述
释放当前解码帧的码流缓冲区。
语法
decoder = Decoder(K_PT_H264)
decoder.stop()
参数
无
返回值
返回值 |
描述 |
|---|---|
0 |
成功 |
非 0 |
失败 |
2.7 Decoder.bind_info#
描述
在调用 Display.bind_layer 时使用，用于获取绑定信息。
语法
vdec.bind_info(width=vdec_width, height=vdec_height, chn=0)
参数
参数名称 |
描述 |
输入/输出 |
|---|---|---|
width |
解码帧的宽度 |
输入 |
height |
解码帧的高度 |
输入 |
chn |
编码输出通道号 |
输入 |
返回值
返回值 |
描述 |
|---|---|
无 |
3. 数据结构描述#
3.1 StreamData#
说明
码流结构体，包含解码数据及其时间戳信息。
定义
class StreamData:
def __init__(self):
self.data
self.pts
成员
成员名称 |
描述 |
|---|---|
data |
码流数据 |
pts |
时间戳信息 |
4. 示例程序#
4.1 示例 1#
from media.media import *
from mpp.payload_struct import *
import media.vdecoder as vdecoder
from media.display import *
import time
import os
STREAM_SIZE = 40960
def vdec_test(file_name, width=1280, height=720):
print("vdec_test start")
vdec_chn = VENC_CHN_ID_0
vdec_width = ALIGN_UP(width, 16)
vdec_height = height
vdec = None
vdec_payload_type = K_PT_H264
# display_type = Display.VIRT
display_type = Display.ST7701 # 使用 ST7701 LCD 屏幕作为输出，最大分辨率 800*480
# display_type = Display.LT9611 # 使用 HDMI 作为输出
# 判断文件类型
suffix = file_name.split('.')[-1]
if suffix == '264':
vdec_payload_type = K_PT_H264
elif suffix == '265':
vdec_payload_type = K_PT_H265
else:
print("未知的文件扩展名")
return
# 实例化视频解码器
vdec = vdecoder.Decoder(vdec_payload_type)
# 初始化显示设备
if display_type == Display.VIRT:
Display.init(display_type, width=vdec_width, height=vdec_height, fps=30)
else:
Display.init(display_type, to_ide=True)
# 初始化缓冲区
MediaManager.init()
# 创建视频解码器
vdec.create()
# 绑定显示
bind_info = vdec.bind_info(width=vdec_width, height=vdec_height, chn=vdec.get_vdec_channel())
Display.bind_layer(**bind_info, layer=Display.LAYER_VIDEO1)
vdec.start()
# 打开文件
with open(file_name, "rb") as fi:
while True:
os.exitpoint()
# 读取视频数据流
data = fi.read(STREAM_SIZE)
if not data:
break
# 解码数据流
vdec.decode(data)
# 停止视频解码器
vdec.stop()
# 销毁视频解码器
vdec.destroy()
time.sleep(1)
# 关闭显示
Display.deinit()
# 释放缓冲区
MediaManager.deinit()
print("vdec_test stop")
if __name__ == "__main__":
os.exitpoint(os.EXITPOINT_ENABLE)
vdec_test("/sdcard/examples/test.264", 800, 480) # 解码 H.264/H.265 视频文件