diff options
| -rw-r--r-- | include/android/surface_control.h | 63 |
1 files changed, 0 insertions, 63 deletions
diff --git a/include/android/surface_control.h b/include/android/surface_control.h index 95540153b3..6323333429 100644 --- a/include/android/surface_control.h +++ b/include/android/surface_control.h @@ -781,69 +781,6 @@ void ASurfaceTransaction_setFrameRateWithChangeStrategy(ASurfaceTransaction* _No __INTRODUCED_IN(31); /** - * Sets the intended frame rate for the given \a surface_control. - * - * On devices that are capable of running the display at different frame rates, - * the system may choose a display refresh rate to better match this surface's frame - * rate. Usage of this API won't introduce frame rate throttling, or affect other - * aspects of the application's frame production pipeline. However, because the system - * may change the display refresh rate, calls to this function may result in changes - * to Choreographer callback timings, and changes to the time interval at which the - * system releases buffers back to the application. - * - * You can register for changes in the refresh rate using - * \a AChoreographer_registerRefreshRateCallback. - * - * See ASurfaceTransaction_clearFrameRate(). - * - * Available since API level 36. - * - * \param desiredMinRate The desired minimum frame rate (inclusive) for the surface, specifying that - * the surface prefers the device render rate to be at least `desiredMinRate`. - * - * <p>Set `desiredMinRate` = `desiredMaxRate` to indicate the surface prefers an exact frame rate. - * - * <p>Set `desiredMinRate` = 0 to indicate the surface has no preference - * and any frame rate is acceptable. - * - * <p>The value should be greater than or equal to 0. - * - * \param desiredMaxRate The desired maximum frame rate (inclusive) for the surface, specifying that - * the surface prefers the device render rate to be at most `desiredMaxRate`. - * - * <p>Set `desiredMaxRate` = `desiredMinRate` to indicate the surface prefers an exact frame rate. - * - * <p>Set `desiredMaxRate` = positive infinity to indicate the surface has no preference - * and any frame rate is acceptable. - * - * <p>The value should be greater than or equal to `desiredMinRate`. - * - * \param fixedSourceRate The "fixed source" frame rate of the surface if the content has an - * inherently fixed frame rate, e.g. a video that has a specific frame rate. - * - * <p>When the frame rate chosen for the surface is the `fixedSourceRate` or a - * multiple, the surface can render without frame pulldown, for optimal smoothness. For - * example, a 30 fps video (`fixedSourceRate`=30) renders just as smoothly on 30 fps, - * 60 fps, 90 fps, 120 fps, and so on. - * - * <p>Setting the fixed source rate can also be used together with a desired - * frame rate min and max via setting `desiredMinRate` and `desiredMaxRate`. This still - * means the surface's content has a fixed frame rate of `fixedSourceRate`, but additionally - * specifies the preference to be in the range [`desiredMinRate`, `desiredMaxRate`]. For example, an - * app might want to specify there is 30 fps video (`fixedSourceRate`=30) as well as a smooth - * animation on the same surface which looks good when drawing within a frame rate range such as - * [`desiredMinRate`, `desiredMaxRate`] = [60,120]. - * - * \param changeFrameRateStrategy Whether display refresh rate transitions caused by this surface - * should be seamless. A seamless transition is one that doesn't have any visual interruptions, such - * as a black screen for a second or two. - */ -void ASurfaceTransaction_setFrameRateParams( - ASurfaceTransaction* _Nonnull transaction, ASurfaceControl* _Nonnull surface_control, - float desiredMinRate, float desiredMaxRate, float fixedSourceRate, - ANativeWindow_ChangeFrameRateStrategy changeFrameRateStrategy) __INTRODUCED_IN(36); - -/** * Clears the frame rate which is set for \a surface_control. * * This is equivalent to calling |