File: reference_picture_selection.h

package info (click to toggle)
chromium-browser 41.0.2272.118-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie-kfreebsd
  • size: 2,189,132 kB
  • sloc: cpp: 9,691,462; ansic: 3,341,451; python: 712,689; asm: 518,779; xml: 208,926; java: 169,820; sh: 119,353; perl: 68,907; makefile: 28,311; yacc: 13,305; objc: 11,385; tcl: 3,186; cs: 2,225; sql: 2,217; lex: 2,215; lisp: 1,349; pascal: 1,256; awk: 407; ruby: 155; sed: 53; php: 14; exp: 11
file content (78 lines) | stat: -rw-r--r-- 2,911 bytes parent folder | download | duplicates (9)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
/*
 *  Copyright (c) 2011 The WebRTC project authors. All Rights Reserved.
 *
 *  Use of this source code is governed by a BSD-style license
 *  that can be found in the LICENSE file in the root of the source
 *  tree. An additional intellectual property rights grant can be found
 *  in the file PATENTS.  All contributing project authors may
 *  be found in the AUTHORS file in the root of the source tree.
 */

/*
 * This file defines classes for doing reference picture selection, primarily
 * with VP8.
 */

#ifndef WEBRTC_MODULES_VIDEO_CODING_CODECS_REFERENCE_PICTURE_SELECTION_H_
#define WEBRTC_MODULES_VIDEO_CODING_CODECS_REFERENCE_PICTURE_SELECTION_H_

#include "webrtc/typedefs.h"

namespace webrtc {

class ReferencePictureSelection {
 public:
  ReferencePictureSelection();
  void Init();

  // Report a received reference picture selection indication. This will
  // introduce a new established reference if the received RPSI isn't too late.
  void ReceivedRPSI(int rpsi_picture_id);

  // Report a received slice loss indication. Returns true if a refresh frame
  // must be sent to the receiver, which is accomplished by only predicting
  // from the established reference.
  // |now_ts| is the RTP timestamp corresponding to the current time. Typically
  // the capture timestamp of the frame currently being processed.
  // Returns true if it's time to encode a decoder refresh, otherwise false.
  bool ReceivedSLI(uint32_t now_ts);

  // Returns the recommended VP8 encode flags needed. May refresh the decoder
  // and/or update the reference buffers.
  // |picture_id| picture id of the frame to be encoded.
  // |send_refresh| should be set to true if a decoder refresh should be
  // encoded, otherwise false.
  // |now_ts| is the RTP timestamp corresponding to the current time. Typically
  // the capture timestamp of the frame currently being processed.
  // Returns the flags to be given to the libvpx encoder when encoding the next
  // frame.
  int EncodeFlags(int picture_id, bool send_refresh, uint32_t now_ts);

  // Notify the RPS that the frame with picture id |picture_id| was encoded as
  // a key frame, effectively updating all reference buffers.
  void EncodedKeyFrame(int picture_id);

  // Set the round-trip time between the sender and the receiver to |rtt|
  // milliseconds.
  void SetRtt(int rtt);

 private:
  static uint32_t TimestampDiff(uint32_t new_ts, uint32_t old_ts);

  // The minimum time between reference frame updates.
  enum { kMinUpdateInterval = 90 * 10 };  // Timestamp frequency
  const double kRttConfidence;

  bool update_golden_next_;
  bool established_golden_;
  bool received_ack_;
  int last_sent_ref_picture_id_;
  uint32_t last_sent_ref_update_time_;
  int established_ref_picture_id_;
  uint32_t last_refresh_time_;
  uint32_t rtt_;
};

}  // namespace webrtc

#endif  // WEBRTC_MODULES_VIDEO_CODING_CODECS_REFERENCE_PICTURE_SELECTION_H_