aboutsummaryrefslogtreecommitdiff
path: root/cast/streaming/resolution.h
blob: 4781555660c3fc83271c20c52c5e58a1bde4ace1 (plain)
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
// Copyright 2021 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
//
// Resolutions and dimensions (resolutions with a frame rate) are used
// extensively throughout cast streaming. Since their serialization to and
// from JSON is stable and standard, we have a single place definition for
// these for use both in our public APIs and private messages.

#ifndef CAST_STREAMING_RESOLUTION_H_
#define CAST_STREAMING_RESOLUTION_H_

#include "absl/types/optional.h"
#include "json/value.h"
#include "util/simple_fraction.h"

namespace openscreen {
namespace cast {

// A resolution in pixels.
struct Resolution {
  static bool TryParse(const Json::Value& value, Resolution* out);
  bool IsValid() const;
  Json::Value ToJson() const;

  // Returns true if both |width| and |height| of this instance are greater than
  // or equal to that of |other|.
  bool IsSupersetOf(const Resolution& other) const;

  bool operator==(const Resolution& other) const;
  bool operator!=(const Resolution& other) const;

  // Width and height in pixels.
  int width = 0;
  int height = 0;
};

// A resolution in pixels and a frame rate.
struct Dimensions {
  static bool TryParse(const Json::Value& value, Dimensions* out);
  bool IsValid() const;
  Json::Value ToJson() const;

  // Returns true if all properties of this instance are greater than or equal
  // to those of |other|.
  bool IsSupersetOf(const Dimensions& other) const;

  bool operator==(const Dimensions& other) const;
  bool operator!=(const Dimensions& other) const;

  // Get just the width and height fields (for comparisons).
  constexpr Resolution ToResolution() const { return {width, height}; }

  // The effective bit rate is the width * height * frame rate.
  constexpr int effective_bit_rate() const {
    return width * height * static_cast<double>(frame_rate);
  }

  // Width and height in pixels.
  int width = 0;
  int height = 0;

  // |frame_rate| is the maximum maintainable frame rate.
  SimpleFraction frame_rate{0, 1};
};

}  // namespace cast
}  // namespace openscreen

#endif  // CAST_STREAMING_RESOLUTION_H_