diff options
Diffstat (limited to 'android/android_surface_output.h')
-rw-r--r-- | android/android_surface_output.h | 15 |
1 files changed, 8 insertions, 7 deletions
diff --git a/android/android_surface_output.h b/android/android_surface_output.h index f8ca4ff76..5f0f734c3 100644 --- a/android/android_surface_output.h +++ b/android/android_surface_output.h @@ -315,14 +315,15 @@ protected: bool iIsMIOConfigured; /* - * The value of mNumberOfFramesToHold is hardware/platform specific. - * 1. On non-overlay based platforms, its value it set to 2 - * so as to avoid potential tearings oberved during video playback. - * 2. On overlay-based platforms, its value should be overwritten. - * We have observed video decoder starvation when a value other than 1. + * The value of mNumberOfFramesToHold is decoder specific. + * + * Please make sure that the number of unique output buffers from the decoder + * (either hardware or software) is not less than 1 + mNumberOfFramesToHold; + * otherwise, we will have starvation. + * + * On some platforms, mNumberOfFramesToHold needs to set to more than 1 (such as + * 2) in order to workaround a tearing issue from SF during video playback. * - * We set the default value to 2 in this class. Please change its value - * accordingly in the derived class. */ int mNumberOfFramesToHold; |