[Android] LibVLC: IVLCVout: add more comments for onNewVideoLayout()

[Thomas Guillem]

vlc-android | branch: 3.0.x | Thomas Guillem <thomas at gllm.fr> | Mon Feb 26 17:19:07 2018 +0100| [d2cc25317adc1a39e99650bdd7e25bf8c7c6303c] | committer: Geoffrey Métais

LibVLC: IVLCVout: add more comments for onNewVideoLayout()

(cherry picked from commit cd1762ed3b6ada94c9f867dac8dab3803f265ad0)

> https://code.videolan.org/videolan/vlc-android/commit/d2cc25317adc1a39e99650bdd7e25bf8c7c6303c
---

 libvlc/src/org/videolan/libvlc/IVLCVout.java | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/libvlc/src/org/videolan/libvlc/IVLCVout.java b/libvlc/src/org/videolan/libvlc/IVLCVout.java
index f71cd699f..c13094755 100644
--- a/libvlc/src/org/videolan/libvlc/IVLCVout.java
+++ b/libvlc/src/org/videolan/libvlc/IVLCVout.java
@@ -38,6 +38,12 @@ public interface IVLCVout {
          * LayoutsParams accordingly. If width and height are 0, LayoutParams should be reset to the
          * initial state (MATCH_PARENT).
          *
+         * By default, "android-display" is used when doing HW decoding and if Video and Subtitles
+         * surfaces are correctly attached. You could force "--vout=android-display" from LibVLC
+         * arguments if you want to use this module without subtitles. Otherwise, the "opengles2"
+         * module will be used (for SW and HW decoding) and this callback will always send a size of
+         * 0.
+         *
          * @param vlcVout vlcVout
          * @param width Frame width
          * @param height Frame height