【待续】海思Hi3520A学习笔记

/*********************************************************************
* By                       :     Lile
* Last Modified   :     2015年3月3日星期二  08:46:13
* Email                 :     [e-mail]
* HomePage      :      http://blog.csdn.net/lile777
* CopyRight        :      该文章版权由Lile所有。可在非商业目的下任意传播和复制。
*                                   对于商业目的下对本文的任何行为需经作者同意。
*********************************************************************/

1、  YUV420  YUV422  YUV444

          4:2:2乃是指數位影像資料的格式,一般而言數位影像以色差端子來說,
            分成三個component,即Y,Cb,Cr(或叫Y,U,V),但是由於人類視覺系統只對亮度反應較敏銳,為了減少資料頻寬(因為傳輸媒介(如網路或電波)的頻寬是有限的),U,V的部分就會用偷工減料的方式來因應.常見格式有YUV420,YUV422,YUV444三種格式.
            其中YUV444是完全未刪減最逼真的格式,即每4個Y,配4個U,4個V
            YUV422則是在UV上減半之格式,即每4個Y,配2個U,2個V
            YUV420則是在UV上減1/4之格式,即每4個Y,配1個U,1個V
            當然啦YUV420在這三者間顏色的表現較不細緻,不過由於人類不易察覺,這個格式廣為DVD所應用.

出处：http://203.208.39.132/search?q=cache:doj0KBXwSv4J:blog.csdn.net/arau_sh/archive/2008/10/13/3068824.aspx+YUV420+YUV422&cd=1&hl=zh-CN&ct=clnk&gl=cn&st_usg=ALhdy29TkqWKJtUWWRqZcNQy27Ni2XXrog

2、hiH264_DEC_ATTR_S 结构体

/* 解码器属性数据结构 */
typedef struct hiH264_DEC_ATTR_S
{

HI_U32 uPictureFormat; /* 解码器输出图像格式 */

                                             /* 0x00: 目前解码库只支持YUV420图像格式 */

HI_U32 uStreamInType; /* 输入码流格式 */

                                             /* 0x00: 目前解码库只支持以“00 00 01”为 nalu分割符的流式H.264码流 */

HI_U32 uPicWidthInMB; /* 图像宽度(以宏块为单位) */

HI_U32 uPicHeightInMB; /* 图像高度(以宏块为单位) */

HI_U32 uBufNum;            /* 参考帧数目 */

HI_U32 uWorkMode;   /* 解码器工作模式 */

Bit31 ~Bit3

Bit2

Bit1

Bit0

保留

00: 仅解码图像

10: 保留

01: 解码Hi351x数字水印

11: 保留

0: 快速输出模式;

1: 正常输出模式

H264_USERDATA_S *pUserData; /* 用户私有数据 */

HI_U32 uReserved; /* 保留字 */

} H264_DEC_ATTR_S;

3、hiH264_DEC_FRAME_S 解码输出图像结构体

/* 解码器输出图像信息数据结构 */
typedef struct hiH264_DEC_FRAME_S
{

HI_U8 *pY; /* Y分量地址 */

HI_U8 *pU; /* U分量地址 */

HI_U8 *pV; /* V分量地址 */

HI_U32 uWidth; /* 图像宽度(以像素为单位) */

HI_U32 uHeight; /* 图像高度(以像素为单位) */

HI_U32 uYStride; /* 输出Y分量的stride (以像素为单位) */

HI_U32 uUVStride; /* 输出U/V分量stride (以像素为单位) */

HI_U32 uCroppingLeftOffset; /* 图像裁减信息:左边界裁减像素数 */

HI_U32 uCroppingRightOffset; /* 图像裁减信息:右边界裁减像素数 */

HI_U32 uCroppingTopOffset; /* 图像裁减信息:上边界裁减像素数 */

HI_U32 uCroppingBottomOffset; /* 图像裁减信息:下边界裁减像素数 */

HI_U32 uDpbIdx; /* 输出图像在dpb中的序号 */

HI_U32 tPicFlag; /* 图像类型：0:帧; 1:顶场; 2:底场 */

HI_U32 bError; /* 图像是否有错：0:正确;1:图像有错 */

HI_U32 bIntra; /* 图像是否为IDR帧：0:非IDR帧;1:IDR帧 */

HI_U64 ullPTS; /* 时间戳 */

HI_U32 uPictureID; /* 图像序号 */

HI_U32 uReserved; /* 保留字 */

H264_USERDATA_S *pUserData; /* 指向用户私有数据 */

} H264_DEC_FRAME_S;

4、hiH264_LIBINFO_S 

/* 解码库版本、版权和能力集信息数据结构 */
typedef struct hiH264_LIBINFO_S

{

HI_U32 uMajor; /* 主编号 */

HI_U32 uMinor; /* 次编号 */

HI_U32 uRelease; /* 发布编号 */

HI_U32 uBuild; /* 建构编号 */

const HI_CHAR*sVersion; /* 版本信息 */

const HI_CHAR*sCopyRight; /* 版权信息 */

HI_U32 uFunctionSet;/* 解码库能力集 */

HI_U32uPictureFormat;/* 支持的输出图像格式*/

  /* 0x00:当前仅支持YUV420图像格式 */

HI_U32uStreamInType; /* 输入码流格式*/

   /* 0x00:当前仅支持以“00 00 01”为nalu分割符的流式H.264码流 */

HI_U32 uPicWidth; /*最大图像宽度(以像素为单位) */

HI_U32 uPicHeight;/* 最大图像高度(以像素为单位) */

HI_U32 uBufNum; /* 最大参考帧数目 */

HI_U32 uReserved; /*保留字 */

} H264_LIBINFO_S;

5、HI_HDL HI_DLLEXPORT Hi264DecCreate( H264_DEC_ATTR_S *pDecAttr );

/*
创建解码器句柄。在解码开始时，分配解码空间和初始化解码器相关的变量及状态，
设置解码器输入码流类型、输出图像格式、解码器支持的最大图像的宽高、解码器支
持的最大参考帧数目等解码器属性。
上层应用可以使用多线程创建多个解码器，实现多路解码。

创建成功后， 返回值为  创建解码器的句柄
*/

     /*create a decoder*/
    handle = Hi264DecCreate(&dec_attrbute);

6、 QueryPerformanceFrequency()

类型：Win32API
原型：BOOL QueryPerformanceFrequency(LARGE_INTEGER *lpFrequency);
作用：返回硬件支持的高精度计数器的频率。
返回值：非零，硬件支持高精度计数器；

                零，硬件不支持，读取失败。

QueryPerformanceFrequency()  
供WIN9X使用的高精度定时器：QueryPerformanceFrequency()和QueryPerformanceCounter()，要求计算机从硬件上支持高精度定时器。
函数的原形是：
　　BOOL QueryPerformanceFrequency(LARGE_INTEGER *lpFrequency);
　　BOOL QueryPerformanceCounter (LARGE_INTEGER *lpCount);
数据类型LARGEINTEGER既可以是一个作为8字节长的整数，也可以是作为两个4字节长的整数的联合结构，其具体用法根据编译器是否支持64位而定。该类型的定义如下：
　　typeef union _ LARGE_INTEGER
　　{

　　 struct

　　 {

　　 DWORD LowPart;

　　 LONG HighPart;

　　 };

　　 LONGLONG QuadPart;

　　} LARGE_INTEGER;

       在定时前应该

              先调用QueryPerformanceFrequency()函数获得机器内部计时器的时钟频率。

              接着在需要严格计时的事件发生前和发生之后分别调用QueryPerformanceCounter()，利用两次获得的计数之差和时钟频率，就可以计算出事件经历的精确时间。

       测试函数SLEEP(100)的精确持续时间方法：

　　LARGE_INTEGER litmp;

　　LONGLONG qt1,qt2;

　　double dft,dff,dfm;

　　QueryPerformanceFrequency(&litmp);//获得时钟频率

　　dff=(double)litmp.QuadPart;

　　QueryPerformanceCounter(&litmp);//获得初始值

　　qt1=litmp.QuadPart;Sleep(100);

　　QueryPerformanceCounter(&litmp);//获得终止值

　　qt2=litmp.QuadPart;

　　dfm=(double)(qt2-qt1);

　　dft=dfm/dff;//获得对应的时间值

        需要注意的是DFT计算的结果单位是秒。

7、Hi264DecFrame(handle, buf,  len, 0, &dec_frame,  flags); 
/// 对输入的一段码流进行解码并按帧输出图像；
/// 本函数仅支持流式解码，对于以“00 00 01”为nalu 分隔符的连续、线性H.264 码流，
/// 用户可从任意起始地址、任意长度配置给解码器解码。
HI_S32 HI_DLLEXPORT Hi264DecFrame(
    HI_HDL  hDec,
    HI_U8*  pStream,
    HI_U32  iStreamLen,
    HI_U64  ullPTS,
    H264_DEC_FRAME_S *pDecFrame,   // 输出图片 格式
    HI_U32  uFlags );

返回值

宏定义

含义

0

HI_H264DEC_OK

函数执行成功，有一帧图像输出。

-1

HI_H264DEC_NEED_MORE_BITS

剩余码流不够解码一帧的数据，需要重新配置更多的码流。uFlags为0时才会返回此值。

-2

HI_H264DEC_NO_PICTURE

解码器内部残留的图像已经全部输出完毕。uFlags为1时才会返回此值。

-3

HI_H264DEC_ERR_HANDLE

解码器句柄为空或输出图像结构体为空。

【注意】
在调用本函数过程中需要注意以下两点：
在解码过程中，用户应该将码流分段，并依次配置给解码器。当用户调用此函数，将一段码流配置给解码器之后，应对函数的参数做如下配置：

pStream=NULL；

iStreamLen=0；

uFlags=0；

然后循环调用此函数，直到函数返回HI_H264DEC_NEED_MORE_BITS 时才能再次配置一段新的码流。
在上述循环调用的过程中，如果函数返回 HI_H264DEC_OK 则表明有一帧图像输出，用户必须在循环调用内部及时处理存储在pDecFrame 中的图像。


在解码结束时，为了输出解码器内部可能的残留图像，用户可对函数的参数做如下配置：

uFlags=1；

pStream=NULL；

然后循环调用此函数，直到函数返回HI_H264DEC_NO_PICTURE 时才能停止解码。
在上述循环调用的过程中，如果函数返回 HI_H264DEC_OK 则表明有一帧图像输出，用户必须在循环调用内部及时处理存储在pDecFrame 中的图像。
解码函数提供时间戳透传功能，输入的时间戳将保存在当前码流解码后的图像结构体H264_DEC_FRAME_S 中，并随解码图像一起输出。