|  |  |  | GStreamer Bad Plugins 0.10 Library Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
#include <gst/codecparsers/gstvc1parser.h> #define MAX_HRD_NUM_LEAKY_BUCKETS #define GST_VC1_BFRACTION_BASIS enum GstVC1StartCode; enum GstVC1Profile; enum GstVC1ParserResult; enum GstVC1PictureType; enum GstVC1Level; enum GstVC1QuantizerSpec; enum GstVC1DQProfile; enum GstVC1Condover; enum GstVC1MvMode; struct GstVC1SeqHdr; struct GstVC1AdvancedSeqHdr; struct GstVC1SeqLayer; struct GstVC1SeqStructA; struct GstVC1SeqStructB; struct GstVC1SeqStructC; struct GstVC1HrdParam; struct GstVC1EntryPointHdr; struct GstVC1FrameHdr; struct GstVC1PicAdvanced; struct GstVC1PicSimpleMain; GstVC1Picture; struct GstVC1VopDquant; struct GstVC1BDU; GstVC1ParserResult gst_vc1_identify_next_bdu (const guint8 *data,gsize size,GstVC1BDU *bdu); GstVC1ParserResult gst_vc1_parse_sequence_header (const guint8 *data,gsize size,GstVC1SeqHdr *seqhdr); GstVC1ParserResult gst_vc1_parse_sequence_layer (const guint8 *data,gsize size,GstVC1SeqLayer *seqlayer); GstVC1ParserResult gst_vc1_parse_sequence_header_struct_a (const guint8 *data,gsize size,GstVC1SeqStructA *structa); GstVC1ParserResult gst_vc1_parse_sequence_header_struct_b (const guint8 *data,gsize size,GstVC1SeqStructB *structb); GstVC1ParserResult gst_vc1_parse_sequence_header_struct_c (const guint8 *data,gsize size,GstVC1SeqStructC *structc); GstVC1ParserResult gst_vc1_parse_entry_point_header (const guint8 *data,gsize size,GstVC1EntryPointHdr *entrypoint,GstVC1SeqHdr *seqhdr); GstVC1ParserResult gst_vc1_parse_frame_header (const guint8 *data,gsize size,GstVC1FrameHdr *framehdr,GstVC1SeqHdr *seqhdr,GstVC1BitPlanes *bitplanes); GstVC1BitPlanes * gst_vc1_bitplanes_new (void); void gst_vc1_bitplanes_free (GstVC1BitPlanes *bitplanes); void gst_vc1_bitplanes_free_1 (GstVC1BitPlanes *bitplanes); gboolean gst_vc1_bitplanes_ensure_size (GstVC1BitPlanes *bitplanes,GstVC1SeqHdr *seqhdr);
For more details about the structures, look at the smpte specifications (S421m-2006.pdf).
typedef enum {
  GST_VC1_END_OF_SEQ       = 0x0A,
  GST_VC1_SLICE            = 0x0B,
  GST_VC1_FIELD            = 0x0C,
  GST_VC1_FRAME            = 0x0D,
  GST_VC1_ENTRYPOINT       = 0x0E,
  GST_VC1_SEQUENCE         = 0x0F,
  GST_VC1_SLICE_USER       = 0x1B,
  GST_VC1_FIELD_USER       = 0x1C,
  GST_VC1_FRAME_USER       = 0x1D,
  GST_VC1_ENTRY_POINT_USER = 0x1E,
  GST_VC1_SEQUENCE_USER    = 0x1F
} GstVC1StartCode;
typedef enum {
  GST_VC1_PROFILE_SIMPLE,
  GST_VC1_PROFILE_MAIN,
  GST_VC1_PROFILE_RESERVED,
  GST_VC1_PROFILE_ADVANCED
} GstVC1Profile;
typedef enum {
  GST_VC1_PARSER_OK,
  GST_VC1_PARSER_BROKEN_DATA,
  GST_VC1_PARSER_NO_BDU,
  GST_VC1_PARSER_NO_BDU_END,
  GST_VC1_PARSER_ERROR,
} GstVC1ParserResult;
typedef enum {
  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
} GstVC1PictureType;
typedef enum {
    GST_VC1_LEVEL_LOW    = 0,    /* Simple/Main profile low level */
    GST_VC1_LEVEL_MEDIUM = 1,    /* Simple/Main profile medium level */
    GST_VC1_LEVEL_HIGH   = 2,   /* Main profile high level */
    GST_VC1_LEVEL_L0    = 0,    /* Advanced profile level 0 */
    GST_VC1_LEVEL_L1    = 1,    /* Advanced profile level 1 */
    GST_VC1_LEVEL_L2    = 2,    /* Advanced profile level 2 */
    GST_VC1_LEVEL_L3    = 3,    /* Advanced profile level 3 */
    GST_VC1_LEVEL_L4    = 4,    /* Advanced profile level 4 */
    /* 5 to 7 reserved */
    GST_VC1_LEVEL_UNKNOWN = 255  /* Unknown profile */
} GstVC1Level;
typedef enum {
  GST_VC1_QUANTIZER_IMPLICITLY,
  GST_VC1_QUANTIZER_EXPLICITLY,
  GST_VC1_QUANTIZER_NON_UNIFORM,
  GST_VC1_QUANTIZER_UNIFORM
} GstVC1QuantizerSpec;
typedef enum {
  GST_VC1_DQPROFILE_FOUR_EDGES,
  GST_VC1_DQPROFILE_DOUBLE_EDGES,
  GST_VC1_DQPROFILE_SINGLE_EDGE,
  GST_VC1_DQPROFILE_ALL_MBS
} GstVC1DQProfile;
typedef enum {
  GST_VC1_CONDOVER_NONE,
  GST_VC1_CONDOVER_ALL,
  GST_VC1_CONDOVER_SELECT
} GstVC1Condover;
typedef enum {
  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
} GstVC1MvMode;
struct GstVC1SeqHdr {
  GstVC1Profile profile;
  GstVC1SeqStructC struct_c;
  /*  calculated */
  guint mb_height;
  guint mb_width;
  guint mb_stride;
  GstVC1AdvancedSeqHdr   advanced;
};
Structure for sequence headers in any profile.
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;
};
Structure for the advanced profile sequence headers specific parameters.
struct GstVC1SeqLayer {
  guint32 numframes;
  GstVC1SeqStructA struct_a;
  GstVC1SeqStructB struct_b;
  GstVC1SeqStructC struct_c;
};
struct GstVC1SeqStructB {
  GstVC1Level  level;
  guint8 cbr;
  guint32 framerate;
  /* In simple and main profiles only */
  guint32 hrd_buffer;
  guint32 hrd_rate;
};
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 {
  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 {
  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];
};
Structure for entrypoint header, this will be used only in advanced profiles
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;
};
Structure that represent picture in any profile or mode.
You should look at ptype and profile to know what is currently
in use.
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 {
  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 */
};
struct GstVC1VopDquant {
  guint8 pqdiff;
  guint8 abspq;
  /* Computed */
  guint8 altpquant;
  /*  if dqant != 2*/
  guint8 dquantfrm;
  guint8 dqprofile;
  /* if dqprofile == GST_VC1_DQPROFILE_SINGLE_EDGE
   * or GST_VC1_DQPROFILE_DOUBLE_EDGE:*/
  guint8 dqsbedge;
  /* if dqprofile == GST_VC1_DQPROFILE_SINGLE_EDGE
   * or GST_VC1_DQPROFILE_DOUBLE_EDGE:*/
  guint8 dqbedge;
  /* if dqprofile == GST_VC1_DQPROFILE_ALL_MBS */
  guint8 dqbilevel;
};
struct GstVC1BDU {
  GstVC1StartCode type;
  guint size;
  guint sc_offset;
  guint offset;
  guint8 * data;
};
Structure that represents a Bitstream Data Unit.
GstVC1ParserResult gst_vc1_identify_next_bdu (const guint8 *data,gsize size,GstVC1BDU *bdu);
Parses data and fills bdu fields
| 
 | The data to parse | 
| 
 | the size of data | 
| 
 | The GstVC1BDU where to store parsed bdu headers. [out] | 
| Returns : | a GstVC1ParserResult | 
GstVC1ParserResult gst_vc1_parse_sequence_header (const guint8 *data,gsize size,GstVC1SeqHdr *seqhdr);
Parses data, and fills seqhdr fields.
| 
 | The data to parse | 
| 
 | the size of data | 
| 
 | The GstVC1SeqHdr to set. | 
| Returns : | a GstVC1ParserResult | 
GstVC1ParserResult gst_vc1_parse_sequence_layer (const guint8 *data,gsize size,GstVC1SeqLayer *seqlayer);
Parses data, and fills seqlayer fields.
| 
 | The data to parse | 
| 
 | the size of data | 
| 
 | The GstVC1SeqLayer to set. | 
| Returns : | a GstVC1ParserResult | 
GstVC1ParserResult gst_vc1_parse_sequence_header_struct_a (const guint8 *data,gsize size,GstVC1SeqStructA *structa);
Parses data, and fills structa fields.
| 
 | The data to parse | 
| 
 | the size of data | 
| 
 | The GstVC1SeqStructA to set. | 
| Returns : | a GstVC1ParserResult | 
GstVC1ParserResult gst_vc1_parse_sequence_header_struct_b (const guint8 *data,gsize size,GstVC1SeqStructB *structb);
Parses data, and fills structb fields.
| 
 | The data to parse | 
| 
 | the size of data | 
| 
 | The GstVC1SeqStructB to set. | 
| Returns : | a GstVC1ParserResult | 
GstVC1ParserResult gst_vc1_parse_sequence_header_struct_c (const guint8 *data,gsize size,GstVC1SeqStructC *structc);
Parses data, and fills structc fields.
| 
 | The data to parse | 
| 
 | the size of data | 
| 
 | The GstVC1SeqStructC to set. | 
| Returns : | a GstVC1ParserResult | 
GstVC1ParserResult gst_vc1_parse_entry_point_header (const guint8 *data,gsize size,GstVC1EntryPointHdr *entrypoint,GstVC1SeqHdr *seqhdr);
Parses data, and sets entrypoint fields.
| 
 | The data to parse | 
| 
 | the size of data | 
| 
 | The GstVC1EntryPointHdr to set. [out] | 
| 
 | The GstVC1SeqHdr currently being parsed | 
| Returns : | a GstVC1EntryPointHdr | 
GstVC1ParserResult gst_vc1_parse_frame_header (const guint8 *data,gsize size,GstVC1FrameHdr *framehdr,GstVC1SeqHdr *seqhdr,GstVC1BitPlanes *bitplanes);
Parses data, and fills entrypoint fields.
| 
 | The data to parse | 
| 
 | the size of data | 
| 
 | The GstVC1FrameHdr to fill. | 
| 
 | The GstVC1SeqHdr currently being parsed | 
| 
 | The GstVC1BitPlanes to store bitplanes in or NULL | 
| Returns : | a GstVC1ParserResult | 
GstVC1BitPlanes *   gst_vc1_bitplanes_new               (void);
Creates a new GstVC1BitPlanes. It should be freed with
gst_vc1_bitplanes_free() after use.
| 
 | The GstVC1SeqHdr from which to set bitplanes | 
| Returns : | a new GstVC1BitPlanes | 
gboolean gst_vc1_bitplanes_ensure_size (GstVC1BitPlanes *bitplanes,GstVC1SeqHdr *seqhdr);
Fills the bitplanes structure from seqhdr, this function
should be called after gst_vc1_parse_sequence_header if
in simple or main mode, or after gst_vc1_parse_entry_point_header
if in advanced mode.
| 
 | The GstVC1BitPlanes to reset | 
| 
 | The GstVC1SeqHdr from which to set bitplanes | 
| Returns : | TRUEif everything went fine,FALSEotherwize |