vc1parser

vc1parser

Functions

Types and Values

Includes

#include <gst/codecparsers/gstvc1parser.h>

Description

Functions

gst_vc1_identify_next_bdu ()

GstVC1ParserResult
gst_vc1_identify_next_bdu (const guint8 *data,
                           gsize size,
                           GstVC1BDU *bdu);

gst_vc1_parse_sequence_header ()

GstVC1ParserResult
gst_vc1_parse_sequence_header (const guint8 *data,
                               gsize size,
                               GstVC1SeqHdr *seqhdr);

gst_vc1_parse_sequence_layer ()

GstVC1ParserResult
gst_vc1_parse_sequence_layer (const guint8 *data,
                              gsize size,
                              GstVC1SeqLayer *seqlayer);

gst_vc1_parse_sequence_header_struct_a ()

GstVC1ParserResult
gst_vc1_parse_sequence_header_struct_a
                               (const guint8 *data,
                                gsize size,
                                GstVC1SeqStructA *structa);

gst_vc1_parse_sequence_header_struct_b ()

GstVC1ParserResult
gst_vc1_parse_sequence_header_struct_b
                               (const guint8 *data,
                                gsize size,
                                GstVC1SeqStructB *structb);

gst_vc1_parse_sequence_header_struct_c ()

GstVC1ParserResult
gst_vc1_parse_sequence_header_struct_c
                               (const guint8 *data,
                                gsize size,
                                GstVC1SeqStructC *structc);

gst_vc1_parse_entry_point_header ()

GstVC1ParserResult
gst_vc1_parse_entry_point_header (const guint8 *data,
                                  gsize size,
                                  GstVC1EntryPointHdr *entrypoint,
                                  GstVC1SeqHdr *seqhdr);

gst_vc1_parse_frame_header ()

GstVC1ParserResult
gst_vc1_parse_frame_header (const guint8 *data,
                            gsize size,
                            GstVC1FrameHdr *framehdr,
                            GstVC1SeqHdr *seqhdr,
                            GstVC1BitPlanes *bitplanes);

gst_vc1_bitplanes_new ()

GstVC1BitPlanes *
gst_vc1_bitplanes_new (void);

gst_vc1_bitplanes_free ()

void
gst_vc1_bitplanes_free (GstVC1BitPlanes *bitplanes);

gst_vc1_bitplanes_free_1 ()

void
gst_vc1_bitplanes_free_1 (GstVC1BitPlanes *bitplanes);

gst_vc1_bitplanes_ensure_size ()

gboolean
gst_vc1_bitplanes_ensure_size (GstVC1BitPlanes *bitplanes,
                               GstVC1SeqHdr *seqhdr);

Types and Values

MAX_HRD_NUM_LEAKY_BUCKETS

#define MAX_HRD_NUM_LEAKY_BUCKETS 31

GST_VC1_BFRACTION_BASIS

#define GST_VC1_BFRACTION_BASIS 840

enum GstVC1StartCode

Members

GST_VC1_END_OF_SEQ

   

GST_VC1_SLICE

   

GST_VC1_FIELD

   

GST_VC1_FRAME

   

GST_VC1_ENTRYPOINT

   

GST_VC1_SEQUENCE

   

GST_VC1_SLICE_USER

   

GST_VC1_FIELD_USER

   

GST_VC1_FRAME_USER

   

GST_VC1_ENTRY_POINT_USER

   

GST_VC1_SEQUENCE_USER

   

enum GstVC1Profile

Members

GST_VC1_PROFILE_SIMPLE

   

GST_VC1_PROFILE_MAIN

   

GST_VC1_PROFILE_RESERVED

   

GST_VC1_PROFILE_ADVANCED

   

enum GstVC1ParserResult

Members

GST_VC1_PARSER_OK

   

GST_VC1_PARSER_BROKEN_DATA

   

GST_VC1_PARSER_NO_BDU

   

GST_VC1_PARSER_NO_BDU_END

   

GST_VC1_PARSER_ERROR

   

enum GstVC1PictureType

Members

GST_VC1_PICTURE_TYPE_P

   

GST_VC1_PICTURE_TYPE_B

   

GST_VC1_PICTURE_TYPE_I

   

GST_VC1_PICTURE_TYPE_BI

   

GST_VC1_PICTURE_TYPE_SKIPPED

   

enum GstVC1Level

Members

GST_VC1_LEVEL_LOW

   

GST_VC1_LEVEL_MEDIUM

   

GST_VC1_LEVEL_HIGH

   

GST_VC1_LEVEL_L0

   

GST_VC1_LEVEL_L1

   

GST_VC1_LEVEL_L2

   

GST_VC1_LEVEL_L3

   

GST_VC1_LEVEL_L4

   

GST_VC1_LEVEL_UNKNOWN

   

enum GstVC1QuantizerSpec

Members

GST_VC1_QUANTIZER_IMPLICITLY

   

GST_VC1_QUANTIZER_EXPLICITLY

   

GST_VC1_QUANTIZER_NON_UNIFORM

   

GST_VC1_QUANTIZER_UNIFORM

   

enum GstVC1DQProfile

Members

GST_VC1_DQPROFILE_FOUR_EDGES

   

GST_VC1_DQPROFILE_DOUBLE_EDGES

   

GST_VC1_DQPROFILE_SINGLE_EDGE

   

GST_VC1_DQPROFILE_ALL_MBS

   

enum GstVC1Condover

Members

GST_VC1_CONDOVER_NONE

   

GST_VC1_CONDOVER_ALL

   

GST_VC1_CONDOVER_SELECT

   

enum GstVC1MvMode

Members

GST_VC1_MVMODE_1MV_HPEL_BILINEAR

   

GST_VC1_MVMODE_1MV

   

GST_VC1_MVMODE_1MV_HPEL

   

GST_VC1_MVMODE_MIXED_MV

   

GST_VC1_MVMODE_INTENSITY_COMP

   

struct GstVC1SeqHdr

struct GstVC1SeqHdr {
  GstVC1Profile profile;

  GstVC1SeqStructC struct_c;

  /*  calculated */
  guint mb_height;
  guint mb_width;
  guint mb_stride;

  GstVC1AdvancedSeqHdr   advanced;
};

struct GstVC1AdvancedSeqHdr

struct GstVC1AdvancedSeqHdr {
  GstVC1Level  level;

  guint8  frmrtq_postproc;
  guint8  bitrtq_postproc;
  guint8  postprocflag;
  guint16 max_coded_width;
  guint16 max_coded_height;
  guint8  pulldown;
  guint8  interlace;
  guint8  tfcntrflag;
  guint8  finterpflag;
  guint8  psf;
  guint8  display_ext;
  guint16 disp_horiz_size;
  guint16 disp_vert_size;
  guint8  aspect_ratio_flag;
  guint8  aspect_ratio;
  guint8  aspect_horiz_size;
  guint8  aspect_vert_size;
  guint8  framerate_flag;
  guint8  framerateind;
  guint8  frameratenr;
  guint8  frameratedr;
  guint16 framerateexp;
  guint8  color_format_flag;
  guint8  color_prim;
  guint8  transfer_char;
  guint8  matrix_coef;
  guint8  hrd_param_flag;
  guint8  colordiff_format;

  GstVC1HrdParam hrd_param;

  /* computed */
  guint framerate; /* Around in fps, 0 if unknown*/
  guint bitrate;   /* Around in kpbs, 0 if unknown*/
  guint par_n;
  guint par_d;
  guint fps_n;
  guint fps_d;

  /* The last parsed entry point */
  GstVC1EntryPointHdr entrypoint;
};

struct GstVC1SeqLayer

struct GstVC1SeqLayer {
  guint32 numframes;

  GstVC1SeqStructA struct_a;
  GstVC1SeqStructB struct_b;
  GstVC1SeqStructC struct_c;
};

struct GstVC1SeqStructA

struct GstVC1SeqStructA {
  guint32 vert_size;
  guint32 horiz_size;
};

struct GstVC1SeqStructB

struct GstVC1SeqStructB {
  GstVC1Level  level;

  guint8 cbr;
  guint32 framerate;

  /* In simple and main profiles only */
  guint32 hrd_buffer;
  guint32 hrd_rate;
};

struct GstVC1SeqStructC

struct GstVC1SeqStructC {
  GstVC1Profile profile;

  /* Only in simple and main profiles */
  guint8 frmrtq_postproc;
  guint8 bitrtq_postproc;
  guint8 res_sprite;
  guint8 loop_filter;
  guint8 multires;
  guint8 fastuvmc;
  guint8 extended_mv;
  guint8 dquant;
  guint8 vstransform;
  guint8 overlap;
  guint8 syncmarker;
  guint8 rangered;
  guint8 maxbframes;
  guint8 quantizer;
  guint8 finterpflag;

  /* Computed */
  guint framerate; /* Around in fps, 0 if unknown*/
  guint bitrate;   /* Around in kpbs, 0 if unknown*/

  /* This should be filled by user if previously known */
  guint16 coded_width;
  /* This should be filled by user if previously known */
  guint16 coded_height;

  /* Wmvp specific */
  guint8 wmvp;          /* Specify if the stream is wmp or not */
  /* In the wmvp case, the framerate is not computed but in the bistream */
  guint8 slice_code;
};

struct GstVC1HrdParam

struct GstVC1HrdParam {
  guint8 hrd_num_leaky_buckets;
  guint8 bit_rate_exponent;
  guint8 buffer_size_exponent;
  guint16 hrd_rate[MAX_HRD_NUM_LEAKY_BUCKETS];
  guint16 hrd_buffer[MAX_HRD_NUM_LEAKY_BUCKETS];
};

struct GstVC1EntryPointHdr

struct GstVC1EntryPointHdr {
  guint8 broken_link;
  guint8 closed_entry;
  guint8 panscan_flag;
  guint8 refdist_flag;
  guint8 loopfilter;
  guint8 fastuvmc;
  guint8 extended_mv;
  guint8 dquant;
  guint8 vstransform;
  guint8 overlap;
  guint8 quantizer;
  guint8 coded_size_flag;
  guint16 coded_width;
  guint16 coded_height;
  guint8 extended_dmv;
  guint8 range_mapy_flag;
  guint8 range_mapy;
  guint8 range_mapuv_flag;
  guint8 range_mapuv;

  guint8 hrd_full[MAX_HRD_NUM_LEAKY_BUCKETS];
};

struct GstVC1FrameHdr

struct GstVC1FrameHdr {
  /* common fields */
  GstVC1PictureType ptype;
  guint8 interpfrm;
  guint8 halfqp;
  guint8 transacfrm;
  guint8 transdctab;
  guint8 pqindex;
  guint8 pquantizer;

  /* Computed */
  guint8 pquant;

  /* Convenience fields */
  guint8 profile;
  guint8 dquant;

  /*  If dquant */
  GstVC1VopDquant vopdquant;

  union {
    GstVC1PicSimpleMain simple;
    GstVC1PicAdvanced advanced;
  } pic;

  /* Size of the picture layer in bits */
  guint header_size;
};

struct GstVC1PicAdvanced

struct GstVC1PicAdvanced {
  GstVC1FrameCodingMode fcm;
  guint8  tfcntr;

  guint8  rptfrm;
  guint8  tff;
  guint8  rff;
  guint8  ps_present;
  guint32 ps_hoffset;
  guint32 ps_voffset;
  guint16 ps_width;
  guint16 ps_height;
  guint8  rndctrl;
  guint8  uvsamp;
  guint8  postproc;

  /*  B and P picture specific */
  guint8  mvrange;
  guint8  mvmode;
  guint8  mvtab;
  guint8  cbptab;
  guint8  ttmbf;
  guint8  ttfrm;

  /* B and BI picture only
   * Should be divided by #GST_VC1_BFRACTION_BASIS
   * to get the real value. */
  guint16 bfraction;

  /* ppic */
  guint8  mvmode2;
  guint8  lumscale;
  guint8  lumshift;

  /* bipic */
  guint8  bf;
  guint8  condover;
  guint8  transacfrm2;

  /* Biplane value, those fields only mention the fact
   * that the bitplane is in raw mode or not */
  guint8  acpred;
  guint8  overflags;
  guint8  mvtypemb;
  guint8  skipmb;
  guint8  directmb;
  guint8  forwardmb; /* B pic interlace field only */

  /* For interlaced pictures only */
  guint8  fieldtx;

  /* P and B pictures */
  guint8  intcomp;
  guint8  dmvrange;
  guint8  mbmodetab;
  guint8  imvtab;
  guint8  icbptab;
  guint8  mvbptab2;
  guint8  mvbptab4; /* If 4mvswitch in ppic */

  /*  P picture */
  guint8  mvswitch4;

  /* For interlaced fields only */
  guint16 refdist;
  guint8 fptype; /* Raw value */

  /* P pic */
  guint8  numref;
  guint8  reffield;
  guint8  lumscale2;
  guint8  lumshift2;
  guint8  intcompfield;
};

struct GstVC1PicSimpleMain

struct GstVC1PicSimpleMain {
  guint8 frmcnt;
  guint8 mvrange;
  guint8 rangeredfrm;

  /* I and P pic simple and main profiles only */
  guint8 respic;

  /* I and BI pic simple and main profiles only */
  guint8 transacfrm2;
  guint8 bf;

  /* B and P pic simple and main profiles only */
  guint8 mvmode;
  guint8 mvtab;
  guint8 ttmbf;

  /* P pic simple and main profiles only */
  guint8 mvmode2;
  guint8 lumscale;
  guint8 lumshift;

  guint8 cbptab;
  guint8 ttfrm;

  /* B and BI picture only
   * Should be divided by #GST_VC1_BFRACTION_BASIS
   * to get the real value. */
  guint16 bfraction;

  /* Biplane value, those fields only mention the fact
   * that the bitplane is in raw mode or not */
  guint8 mvtypemb;
  guint8 skipmb;
  guint8 directmb; /* B pic main profile only */
};

GstVC1Picture

typedef struct _GstVC1Picture GstVC1Picture;

struct GstVC1VopDquant

struct GstVC1VopDquant {
  guint8 pqdiff;
  guint8 abspq;

  /* Computed */
  guint8 altpquant;

  /*  if dqant != 2*/
  guint8 dquantfrm;
  guint8 dqprofile;

  /* Boundary edge selection. This represents DQSBEDGE
   * if dqprofile == GST_VC1_DQPROFILE_SINGLE_EDGE or
   * DQDBEDGE if dqprofile == GST_VC1_DQPROFILE_DOUBLE_EDGE */
  guint8 dqbedge;

  /* FIXME: remove */
  guint8 unused;

  /* if dqprofile == GST_VC1_DQPROFILE_ALL_MBS */
  guint8 dqbilevel;
};

struct GstVC1BDU

struct GstVC1BDU {
  GstVC1StartCode type;
  guint size;
  guint sc_offset;
  guint offset;
  guint8 * data;
};