Skip to content
forked from hdline/uavs2d

uavs2d is a free decode library for the 2nd generation IEEE 1857 video coding standard

Notifications You must be signed in to change notification settings

musicwood/uavs2d

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

1. 结构说明 

1.1 avs2_info_t 序列信息,解码序列头的时候会带出该结构,记录序列的基本信息

typedef struct {            
    int     profile_id;      // 暂时无用  
    int     level_id;        // 暂时无用  
    int     progressive_seq; // 暂时无用  
    int     img_width;       // 图像宽度
    int     img_height;      // 图像高度
    float   frame_rate;      // 帧率
} avs2_info_t;

1.2 avs2_frame_t 解码输入输出结构,送入码流,输出序列信息或图像

typedef struct avs2_frame_t {
    unsigned char     *bs_buf;       // [in ] 码流buffer
    int                bs_len;       // [in ] 码流长度

    int                dec_stats;    // [out] 解码状态,见后续说明

    unsigned long long pts;          // [in/out] 时间戳,播放ES流暂时不需要

    unsigned int       frm_type;     // [out] 当前输出图像的类型,暂时不需要
    unsigned int       qp;           // [out] 当前输出图像的QP,暂时不需要

    int                i_stride;     // [in ] 指定输出图像y分量的跨度
    int                i_stridec;    // [in ] 指定输出图像uv分量的跨度
    int                i_output_type;// [in ] 指定输出图像格式(I420/YUYV)
    unsigned char     *p_buf_y;      // [in: pointer; out: data] 指定输出图像存放的buffer,该buffer由调用者申请,避免输出之后的数据再做一次拷贝
    unsigned char     *p_buf_u;      // [in: pointer; out: data] 同上,存放u分量
    unsigned char     *p_buf_v;      // [in: pointer; out: data] 同上,存放v分量

    avs2_info_t        info;         // [out] 记录序列头信息,解码序列头时带出该信息

} avs2_frame_t;

注: A. dec_stats的值为

#define AVS2_TYPE_DECODED    1        // 正常解码,有图像输出
#define AVS2_TYPE_SEQ        2        // 正常解码,解码了一个序列头
#define AVS2_TYPE_ERROR     -1        // 解码出错
#define AVS2_TYPE_NEEDMORE  -2        // 需要更多数据 (由于解码需要对图像重排序,同时解码库使用的是帧级并行,因此一开始送入几帧图像后并不能马上输出,会返回该值,属正常情况)

     B. i_output_type表示输出图像类型,可以选择I420格式,也可以选择YUYV交织格式。
        选择YUYV时, i_stridec/p_buf_u/p_buf_v没有用,p_buf_y指向YUYV的buffer,i_stride表示按yuyv方式存储时, buffer的跨度

2. 函数说明  

2.1 void * avs2_lib_create(int threads)

    创建解码库。
    threads: 指定解码线程数目,4核8线程机器上,设为9合适
    返回值 : 解码库句柄

2.2 void  avs2_lib_decode(void *handle, avs2_frame_t *frm);

    解码图像或序列头。    
    handle: 解码库句柄
    frm   : 输入输出结构,送入码流,输出序列信息或图像

2.3 void  avs2_lib_flush(void *handle, avs2_frame_t *frm);

    输出延迟的图像。   
    handle: 解码库句柄
    frm   : 输入输出结构,输出序列信息或图像(码流指针不会被用到)

2.4 void  avs2_lib_destroy(void *handle);

    销毁解码库。
    handle: 待销毁的解码库句柄。


3. 调用程序切分码流方法

    每个解码单元是由码流中3字节(0x000001)的起始码前缀分隔,码流中一旦出现0x000001,就一定表示这个是一个新的解码单元(除非传输过程出现误码)
    每个0x000001之后的一个字节表示解码单元类型:
    B0 - 序列头
    B1 - 码流结束标记
    B2/B5/B7 - user data或其他一些数据,暂时不用关心
    B3 - I帧图像头
    B6 - P/B/F帧图像头
    00~AF - 条带头(一幅图像包含1个或多个条带)

    原则上,每个解码单元都是可以独立解码的,但是为了实现方便及调用方便,这里要求每次送入一个完整的帧,或序列头。
    
    扫描码流时,如果发现0x000001B0,则之后的数据是序列头,继续扫描后面的码流,直到下一个0x000001,之间这段数据的长度就是序列头的长度。
 
    解码图像时,如果发现0x000001B3或0x000001B6,则是图像头,继续扫描后面的码流, 直到下一个0x000001B3或0x000001B6或0x000001B0,之间的数据长度就是图像长度。

    注:A. 送入数据解码时,需要带着0x000001起始码前缀。

        B. 码流中B2/B5/B7等类型的解码单元可以包含在图像数据或序列头数据中一同送入,解码库中会自动丢弃这些数据。
           因此,切分序列头和图像帧起始就只需要看0x000001(B0/B3/B6)这三个分隔符,解码时只需要将连续两个分割符之间的数据送入解码库即可(数据要带着数据前的那个分割符一同送入)。

    




About

uavs2d is a free decode library for the 2nd generation IEEE 1857 video coding standard

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 77.0%
  • Assembly 22.6%
  • Other 0.4%