Add SetVideoMode API to avsettings

chromecast/public/avsettings.h

 // Copyright 2015 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.
 
 #ifndef CHROMECAST_PUBLIC_AVSETTINGS_H_
 #define CHROMECAST_PUBLIC_AVSETTINGS_H_
 
 #include <stdint.h>
 
 #include "output_restrictions.h"
@@ skipping 273 matching lines @@
 
   // Supported HDR output modes.
   enum HdrOutputType {
     HDR_OUTPUT_SDR,  // not HDR
     HDR_OUTPUT_HDR,  // HDR with static metadata
     HDR_OUTPUT_DOLBYVISION  // DolbyVision output
   };
 
   // Gets the current HDR output type.
   virtual HdrOutputType GetHdrOutputType() = 0;
+
+  // Sets the HDMI video mode according to the given parameters:
+  //

[halliwell, 2016/10/03 21:05:28]

nit, can lose blank line

+  // |allow_4k|: if false, the resolution set will not be a 4K resolution.
+  //

[halliwell, 2016/10/03 21:05:28]

ditto

+  // |optimize_for_fps|: *Attempts* to pick a refresh rate optimal for the
+  // given content frame rate. |optimize_for_fps| is expressed as framerate
+  // * 100. I.e. 24hz -> 2400, 23.98hz -> 2398, etc.  Values <= 0 are ignored.
+  //
+  // Returns:
+  // - true if HDMI video mode change is beginning.  Caller should wait for
+  //   SCREEN_INFO_CHANGED event for mode change to complete.
+  // - false if no HDMI video mode change has begun.  This could be because
+  // HDMI is disconnected, or the current resolution is already good for the
+  // given parameters.
+  //

[halliwell, 2016/10/03 21:05:28]

nit, lose one of these blank lines.

+  //
+  // This API only applies to devices that output HDMI, otherwise return false.

[halliwell, 2016/10/03 21:05:27]

This sentence is weird.  Just "Non-HDMI devices should return false." ?

+  virtual bool SetHdmiVideoMode(bool allow_4k, int optimize_for_fps) = 0;
 };
 
 }  // namespace chromecast
 
 #endif  // CHROMECAST_PUBLIC_AVSETTINGS_H_