src/codecs/h263/mod.rs

   1 use std::fmt;
   2 use std::ops::{Add, Sub};
   3 use super::DecoderResult;
   4 use frame::NAVideoBuffer;
   5
   6 pub mod code;
   7 pub mod data;
   8 pub mod decoder;
   9
  10 #[cfg(feature="decoder_intel263")]
  11 pub mod intel263;
  12 #[cfg(feature="decoder_realvideo1")]
  13 pub mod rv10;
  14 #[cfg(feature="decoder_realvideo2")]
  15 pub mod rv20;
  16
  17 pub trait BlockDecoder {
  18     fn decode_pichdr(&mut self) -> DecoderResult<PicInfo>;
  19     fn decode_slice_header(&mut self, pinfo: &PicInfo) -> DecoderResult<SliceInfo>;
  20     fn decode_block_header(&mut self, pinfo: &PicInfo, sinfo: &SliceInfo, sstate: &SliceState) -> DecoderResult<BlockInfo>;
  21     fn decode_block_intra(&mut self, info: &BlockInfo, sstate: &SliceState, quant: u8, no: usize, coded: bool, blk: &mut [i16; 64]) -> DecoderResult<()>;
  22     fn decode_block_inter(&mut self, info: &BlockInfo, sstate: &SliceState, quant: u8, no: usize, coded: bool, blk: &mut [i16; 64]) -> DecoderResult<()>;
  23     fn is_slice_end(&mut self) -> bool;
  24 }
  25
  26 pub trait BlockDSP {
  27     fn idct(&self, blk: &mut [i16; 64]);
  28     fn copy_blocks(&self, dst: &mut NAVideoBuffer<u8>, src: &NAVideoBuffer<u8>, xpos: usize, ypos: usize, w: usize, h: usize, mv: MV);
  29     fn avg_blocks(&self, dst: &mut NAVideoBuffer<u8>, src: &NAVideoBuffer<u8>, xpos: usize, ypos: usize, w: usize, h: usize, mv: MV);
  30     fn filter_row(&self, buf: &mut NAVideoBuffer<u8>, mb_y: usize, mb_w: usize, cbpi: &CBPInfo);
  31 }
  32
  33 #[allow(dead_code)]
  34 #[derive(Debug,Clone,Copy,PartialEq)]
  35 pub enum Type {
  36     I, P, PB, Skip, B, Special
  37 }
  38
  39 impl Type {
  40     pub fn is_ref(&self) -> bool {
  41         match *self {
  42             Type::I | Type::P | Type::PB => true,
  43             _                            => false,
  44         }
  45     }
  46 }
  47
  48 #[allow(dead_code)]
  49 #[derive(Debug,Clone,Copy)]
  50 pub struct PBInfo {
  51     trb:        u8,
  52     dbquant:    u8,
  53 }
  54
  55 impl PBInfo {
  56     pub fn new(trb: u8, dbquant: u8) -> Self {
  57         PBInfo{ trb: trb, dbquant: dbquant }
  58     }
  59     pub fn get_trb(&self) -> u8 { self.trb }
  60     pub fn get_dbquant(&self) -> u8 { self.dbquant }
  61 }
  62
  63 #[allow(dead_code)]
  64 #[derive(Debug,Clone,Copy)]
  65 pub struct PicInfo {
  66     pub w:          usize,
  67     pub h:          usize,
  68     pub mode:       Type,
  69     pub mvmode:     MVMode,
  70     pub umv:        bool,
  71     pub apm:        bool,
  72     pub quant:      u8,
  73     pub pb:         Option<PBInfo>,
  74     pub ts:         u16,
  75     pub plusinfo:   Option<PlusInfo>,
  76 }
  77
  78 #[allow(dead_code)]
  79 impl PicInfo {
  80     pub fn new(w: usize, h: usize, mode: Type, mvmode: MVMode, umv: bool, apm: bool, quant: u8, ts: u16, pb: Option<PBInfo>, plusinfo: Option<PlusInfo>) -> Self {
  81         PicInfo {
  82             w: w, h: h, mode: mode, mvmode: mvmode,
  83             umv: umv, apm: apm, quant: quant,
  84             pb: pb, ts: ts, plusinfo: plusinfo
  85         }
  86     }
  87     pub fn get_width(&self) -> usize { self.w }
  88     pub fn get_height(&self) -> usize { self.h }
  89     pub fn get_mode(&self) -> Type { self.mode }
  90     pub fn get_quant(&self) -> u8 { self.quant }
  91     pub fn get_apm(&self) -> bool { self.apm }
  92     pub fn is_pb(&self) -> bool { self.pb.is_some() }
  93     pub fn get_ts(&self) -> u16 { self.ts }
  94     pub fn get_pbinfo(&self) -> PBInfo { self.pb.unwrap() }
  95     pub fn get_plusifo(&self) -> Option<PlusInfo> { self.plusinfo }
  96     pub fn get_mvmode(&self) -> MVMode { self.mvmode }
  97 }
  98
  99 #[allow(dead_code)]
 100 #[derive(Debug,Clone,Copy)]
 101 pub struct PlusInfo {
 102     pub aic:        bool,
 103     pub deblock:    bool,
 104     pub aiv_mode:   bool,
 105     pub mq_mode:    bool,
 106 }
 107
 108 impl PlusInfo {
 109     pub fn new(aic: bool, deblock: bool, aiv_mode: bool, mq_mode: bool) -> Self {
 110         PlusInfo { aic: aic, deblock: deblock, aiv_mode: aiv_mode, mq_mode: mq_mode }
 111     }
 112 }
 113
 114 #[allow(dead_code)]
 115 #[derive(Debug,Clone,Copy)]
 116 pub struct SliceInfo {
 117     pub mb_x:   usize,
 118     pub mb_y:   usize,
 119     pub mb_end: usize,
 120     pub quant:  u8,
 121 }
 122
 123 #[allow(dead_code)]
 124 #[derive(Debug,Clone,Copy)]
 125 pub struct SliceState {
 126     pub is_iframe:  bool,
 127     pub mb_x:       usize,
 128     pub mb_y:       usize,
 129     pub first_line: bool,
 130     pub first_mb:   bool,
 131     pub slice_mb_x: usize,
 132     pub slice_mb_y: usize,
 133 }
 134
 135 const SLICE_NO_END: usize = 99999999;
 136
 137 impl SliceInfo {
 138     pub fn new(mb_x: usize, mb_y: usize, mb_end: usize, quant: u8) -> Self {
 139         SliceInfo{ mb_x: mb_x, mb_y: mb_y, mb_end: mb_end, quant: quant }
 140     }
 141     pub fn new_gob(mb_x: usize, mb_y: usize, quant: u8) -> Self {
 142         SliceInfo{ mb_x: mb_x, mb_y: mb_y, mb_end: SLICE_NO_END, quant: quant }
 143     }
 144     pub fn get_default_slice(pinfo: &PicInfo) -> Self {
 145         SliceInfo{ mb_x: 0, mb_y: 0, mb_end: SLICE_NO_END, quant: pinfo.get_quant() }
 146     }
 147     pub fn get_quant(&self) -> u8 { self.quant }
 148     pub fn is_at_end(&self, mb_pos: usize) -> bool { self.mb_end == mb_pos }
 149     pub fn needs_check(&self) -> bool { self.mb_end == SLICE_NO_END }
 150 }
 151
 152 impl SliceState {
 153     pub fn new(is_iframe: bool) -> Self {
 154         SliceState {
 155             is_iframe: is_iframe, mb_x: 0, mb_y: 0, first_line: true, first_mb: true,
 156             slice_mb_x: 0, slice_mb_y: 0
 157         }
 158     }
 159     pub fn next_mb(&mut self) {
 160         self.mb_x += 1; self.first_mb = false;
 161         if self.mb_x >= self.slice_mb_x && self.mb_y > self.slice_mb_y {
 162             self.first_line = false;
 163         }
 164     }
 165     pub fn new_row(&mut self) {
 166         self.mb_x = 0; self.mb_y += 1;
 167         if self.mb_x >= self.slice_mb_x && self.mb_y > self.slice_mb_y {
 168             self.first_line = false;
 169         }
 170         self.first_mb = true;
 171     }
 172     pub fn reset_slice(&mut self, smb_x: usize, smb_y: usize) {
 173         self.slice_mb_x = smb_x;
 174         self.slice_mb_y = smb_y;
 175         self.first_line = true;
 176         self.first_mb   = true;
 177     }
 178 }
 179
 180 #[derive(Debug,Clone,Copy)]
 181 pub struct BlockInfo {
 182     pub intra:   bool,
 183     pub skip:    bool,
 184     pub mode:    Type,
 185     pub cbp:     u8,
 186     pub q:       u8,
 187     pub mv:      [MV; 4],
 188     pub num_mv:  usize,
 189     pub bpart:   bool,
 190     pub b_cbp:   u8,
 191     pub mv2:     [MV; 2],
 192     pub num_mv2: usize,
 193     pub fwd:     bool,
 194     pub acpred:  ACPredMode,
 195 }
 196
 197 #[allow(dead_code)]
 198 #[derive(Debug,Clone,Copy)]
 199 pub struct BBlockInfo {
 200     present: bool,
 201     cbp:     u8,
 202     num_mv:  usize,
 203     fwd:     bool,
 204 }
 205
 206 #[allow(non_camel_case_types)]
 207 #[derive(Debug,Clone,Copy)]
 208 pub enum BlockMVInfo {
 209     Intra,
 210     Inter_1MV(MV),
 211     Inter_4MV([MV; 4]),
 212 }
 213
 214 #[allow(dead_code)]
 215 #[derive(Debug,Clone,Copy,PartialEq)]
 216 pub enum ACPredMode {
 217     None,
 218     DC,
 219     Ver,
 220     Hor,
 221 }
 222
 223 #[allow(dead_code)]
 224 impl BlockInfo {
 225     pub fn new(mode: Type, cbp: u8, q: u8) -> Self {
 226         BlockInfo {
 227             intra:   mode == Type::I,
 228             skip:    (cbp == 0) && (mode != Type::I),
 229             mode:    mode,
 230             cbp:     cbp,
 231             q:       q,
 232             mv:      [MV::new(0, 0), MV::new(0, 0), MV::new(0, 0), MV::new(0, 0)],
 233             num_mv:  0,
 234             bpart:   false,
 235             b_cbp:   0,
 236             mv2:     [ZERO_MV, ZERO_MV],
 237             num_mv2: 0,
 238             fwd:     false,
 239             acpred:  ACPredMode::None,
 240         }
 241     }
 242     pub fn is_intra(&self) -> bool { self.intra }
 243     pub fn is_skipped(&self) -> bool { self.skip }
 244     pub fn get_mode(&self) -> Type { self.mode }
 245     pub fn get_cbp(&self) -> u8 { self.cbp }
 246     pub fn get_q(&self) -> u8 { self.q }
 247     pub fn get_num_mvs(&self) -> usize { self.num_mv }
 248     pub fn get_mv(&self, idx: usize) -> MV { self.mv[idx] }
 249     pub fn has_b_part(&self) -> bool { self.bpart }
 250     pub fn get_cbp_b(&self) -> u8 { self.b_cbp }
 251     pub fn get_num_mvs2(&self) -> usize { self.num_mv2 }
 252     pub fn get_mv2(&self, idx: usize) -> MV { self.mv2[idx] }
 253     pub fn set_mv(&mut self, mvs: &[MV]) {
 254         if mvs.len() > 0 { self.skip = false; }
 255         let mut mv_arr: [MV; 4] = [MV::new(0, 0), MV::new(0, 0), MV::new(0, 0), MV::new(0, 0)];
 256         for i in 0..mvs.len() { mv_arr[i] = mvs[i]; }
 257         self.mv     = mv_arr;
 258         self.num_mv = mvs.len();
 259     }
 260     pub fn set_bpart(&mut self, bbinfo: BBlockInfo) {
 261         self.bpart = bbinfo.present;
 262         self.b_cbp = bbinfo.cbp;
 263         self.fwd   = bbinfo.fwd;
 264         self.num_mv2 = bbinfo.get_num_mv();
 265     }
 266     pub fn set_b_mv(&mut self, mvs: &[MV]) {
 267         if mvs.len() > 0 { self.skip = false; }
 268         let mut mv_arr: [MV; 2] = [ZERO_MV, ZERO_MV];
 269         for i in 0..mvs.len() { mv_arr[i] = mvs[i]; }
 270         self.mv2     = mv_arr;
 271         self.num_mv2 = mvs.len();
 272     }
 273     pub fn is_b_fwd(&self) -> bool { self.fwd }
 274     pub fn set_acpred(&mut self, acpred: ACPredMode) { self.acpred = acpred }
 275     pub fn get_acpred(&self) -> ACPredMode { self.acpred }
 276 }
 277
 278 impl BBlockInfo {
 279     pub fn new(present: bool, cbp: u8, num_mv: usize, fwd: bool) -> Self {
 280         BBlockInfo {
 281             present: present,
 282             cbp:     cbp,
 283             num_mv:  num_mv,
 284             fwd:     fwd,
 285         }
 286     }
 287     pub fn get_num_mv(&self) -> usize { self.num_mv }
 288 }
 289
 290 #[derive(Debug,Clone,Copy)]
 291 pub enum MVMode {
 292     Old,
 293     Long,
 294     UMV,
 295 }
 296
 297 #[derive(Debug,Clone,Copy)]
 298 pub struct MV {
 299     x: i16,
 300     y: i16,
 301 }
 302
 303 impl MV {
 304     pub fn new(x: i16, y: i16) -> Self { MV{ x: x, y: y } }
 305     pub fn pred(a: MV, b: MV, c: MV) -> Self {
 306         let x;
 307         if a.x < b.x {
 308             if b.x < c.x {
 309                 x = b.x;
 310             } else {
 311                 if a.x < c.x { x = c.x; } else { x = a.x; }
 312             }
 313         } else {
 314             if b.x < c.x {
 315                 if a.x < c.x { x = a.x; } else { x = c.x; }
 316             } else {
 317                 x = b.x;
 318             }
 319         }
 320         let y;
 321         if a.y < b.y {
 322             if b.y < c.y {
 323                 y = b.y;
 324             } else {
 325                 if a.y < c.y { y = c.y; } else { y = a.y; }
 326             }
 327         } else {
 328             if b.y < c.y {
 329                 if a.y < c.y { y = a.y; } else { y = c.y; }
 330             } else {
 331                 y = b.y;
 332             }
 333         }
 334         MV { x: x, y: y }
 335     }
 336     fn add_umv(pred_mv: MV, add: MV, mvmode: MVMode) -> Self {
 337         let mut new_mv = pred_mv + add;
 338         match mvmode {
 339             MVMode::Old => {
 340                     if      new_mv.x >=  64 { new_mv.x -= 64; }
 341                     else if new_mv.x <= -64 { new_mv.x += 64; }
 342                     if      new_mv.y >=  64 { new_mv.y -= 64; }
 343                     else if new_mv.y <= -64 { new_mv.y += 64; }
 344                 },
 345             MVMode::Long => {
 346                     if      new_mv.x >  31 { new_mv.x -= 64; }
 347                     else if new_mv.x < -32 { new_mv.x += 64; }
 348                     if      new_mv.y >  31 { new_mv.y -= 64; }
 349                     else if new_mv.y < -32 { new_mv.y += 64; }
 350                 },
 351             MVMode::UMV => {
 352                     if pred_mv.x >  32 && new_mv.x >  63 { new_mv.x -= 64; }
 353                     if pred_mv.x < -31 && new_mv.x < -63 { new_mv.x += 64; }
 354                     if pred_mv.y >  32 && new_mv.y >  63 { new_mv.y -= 64; }
 355                     if pred_mv.y < -31 && new_mv.y < -63 { new_mv.y += 64; }
 356                 },
 357         };
 358         new_mv
 359     }
 360     fn scale(&self, trb: u16, trd: u16) -> Self {
 361         if (trd == 0) || (trb == 0) {
 362             ZERO_MV
 363         } else {
 364             MV { x: (((self.x as i32) * (trb as i32)) / (trd as i32)) as i16, y: (((self.y as i32) * (trb as i32)) / (trd as i32)) as i16 }
 365         }
 366     }
 367     fn b_sub(pvec: MV, fwdvec: MV, bvec: MV, trb: u16, trd: u16) -> Self {
 368         let bscale = (trb as i32) - (trd as i32);
 369         let x = if bvec.x != 0 { fwdvec.x - pvec.x } else if trd != 0 { (bscale * (pvec.x as i32) / (trd as i32)) as i16 } else { 0 };
 370         let y = if bvec.y != 0 { fwdvec.y - pvec.y } else if trd != 0 { (bscale * (pvec.y as i32) / (trd as i32)) as i16 } else { 0 };
 371         MV { x: x, y: y }
 372     }
 373 }
 374
 375 pub const ZERO_MV: MV = MV { x: 0, y: 0 };
 376
 377 impl Add for MV {
 378     type Output = MV;
 379     fn add(self, other: MV) -> MV { MV { x: self.x + other.x, y: self.y + other.y } }
 380 }
 381
 382 impl Sub for MV {
 383     type Output = MV;
 384     fn sub(self, other: MV) -> MV { MV { x: self.x - other.x, y: self.y - other.y } }
 385 }
 386
 387 impl fmt::Display for MV {
 388     fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
 389         write!(f, "{},{}", self.x, self.y)
 390     }
 391 }
 392
 393 #[allow(dead_code)]
 394 pub struct CBPInfo {
 395     cbp:        Vec<u8>,
 396     q:          Vec<u8>,
 397     mb_w:       usize,
 398 }
 399
 400 impl CBPInfo {
 401     fn new() -> Self { CBPInfo{ cbp: Vec::new(), q: Vec::new(), mb_w: 0 } }
 402     fn reset(&mut self, mb_w: usize) {
 403         self.mb_w = mb_w;
 404         self.cbp.truncate(0);
 405         self.cbp.resize(self.mb_w * 2, 0);
 406         self.q.truncate(0);
 407         self.q.resize(self.mb_w * 2, 0);
 408     }
 409     fn update_row(&mut self) {
 410         for i in 0..self.mb_w {
 411             self.cbp[i] = self.cbp[self.mb_w + i];
 412             self.q[i]   = self.q[self.mb_w + i];
 413         }
 414     }
 415     fn set_cbp(&mut self, mb_x: usize, cbp: u8) {
 416         self.cbp[self.mb_w + mb_x] = cbp;
 417     }
 418     fn set_q(&mut self, mb_x: usize, q: u8) {
 419         self.q[self.mb_w + mb_x] = q;
 420     }
 421     pub fn get_q(&self, mb_x: usize) -> u8 { self.q[mb_x] }
 422     pub fn is_coded(&self, mb_x: usize, blk_no: usize) -> bool {
 423         (self.cbp[self.mb_w + mb_x] & (1 << (5 - blk_no))) != 0
 424     }
 425     pub fn is_coded_top(&self, mb_x: usize, blk_no: usize) -> bool {
 426         let cbp     = self.cbp[self.mb_w + mb_x];
 427         let cbp_top = self.cbp[mb_x];
 428         match blk_no {
 429             0 => { (cbp_top & 0b001000) != 0 },
 430             1 => { (cbp_top & 0b000100) != 0 },
 431             2 => { (cbp     & 0b100000) != 0 },
 432             3 => { (cbp     & 0b010000) != 0 },
 433             4 => { (cbp_top & 0b000010) != 0 },
 434             _ => { (cbp_top & 0b000001) != 0 },
 435         }
 436     }
 437 }
 438