Android: Prepare moving EglBase10/EglBase14 from to API to src

webrtc/sdk/android/api/org/webrtc/EglBase.java

 /*
  *  Copyright 2015 The WebRTC project authors. All Rights Reserved.
  *
  *  Use of this source code is governed by a BSD-style license
  *  that can be found in the LICENSE file in the root of the source
  *  tree. An additional intellectual property rights grant can be found
  *  in the file PATENTS.  All contributing project authors may
  *  be found in the AUTHORS file in the root of the source tree.
  */
 
@@ skipping 62 matching lines @@
   public static final int[] CONFIG_RECORDABLE = {
     EGL10.EGL_RED_SIZE, 8,
     EGL10.EGL_GREEN_SIZE, 8,
     EGL10.EGL_BLUE_SIZE, 8,
     EGL10.EGL_RENDERABLE_TYPE, EGL_OPENGL_ES2_BIT,
     EGL_RECORDABLE_ANDROID, 1,
     EGL10.EGL_NONE
   };
   // clang-format on
 
-  // Create a new context with the specified config attributes, sharing data with sharedContext.
-  // |sharedContext| can be null.
+  /**
+   * Create a new context with the specified config attributes, sharing data with |sharedContext|.
+   * If |sharedContext| is null, a root context is created. This function will try to create an EGL
+   * 1.4 context if possible, and an EGL 1.0 context otherwise.
+   */
   public static EglBase create(Context sharedContext, int[] configAttributes) {
     return (EglBase14.isEGL14Supported()
                && (sharedContext == null || sharedContext instanceof EglBase14.Context))
         ? new EglBase14((EglBase14.Context) sharedContext, configAttributes)
         : new EglBase10((EglBase10.Context) sharedContext, configAttributes);
   }
 
+  /**
+   * Helper function for creating a plain root context. This function will try to create an EGL 1.4
+   * context if possible, and an EGL 1.0 context otherwise.
+   */
   public static EglBase create() {
-    return create(null, CONFIG_PLAIN);
+    return create(null /* shaderContext */, CONFIG_PLAIN);
   }
 
+  /**
+   * Helper function for creating a plain context, sharing data with |sharedContext|. This function
+   * will try to create an EGL 1.4 context if possible, and an EGL 1.0 context otherwise.
+   */
   public static EglBase create(Context sharedContext) {
     return create(sharedContext, CONFIG_PLAIN);
   }
 
+  /**
+   * Explicitly create a root EGl 1.0 context with the specified config attributes.
+   */
+  public static EglBase createEgl10(int[] configAttributes) {
+    return new EglBase10(null /* shaderContext */, configAttributes);
+  }
+
+  /**
+   * Explicitly create a root EGl 1.4 context with the specified config attributes.
+   */
+  public static EglBase createEgl14(int[] configAttributes) {
+    return new EglBase14(null /* shaderContext */, configAttributes);
+  }
+
   public abstract void createSurface(Surface surface);
 
   // Create EGLSurface from the Android SurfaceTexture.
   public abstract void createSurface(SurfaceTexture surfaceTexture);
 
   // Create dummy 1x1 pixel buffer surface so the context can be made current.
   public abstract void createDummyPbufferSurface();
 
   public abstract void createPbufferSurface(int width, int height);
 
   public abstract Context getEglBaseContext();
 
   public abstract boolean hasSurface();
 
   public abstract int surfaceWidth();
 
   public abstract int surfaceHeight();
 
   public abstract void releaseSurface();
 
   public abstract void release();
 
   public abstract void makeCurrent();
 
   // Detach the current EGL context, so that it can be made current on another thread.
   public abstract void detachCurrent();
 
   public abstract void swapBuffers();
 }