add comment

Author: ChillingVan

canvasgl/src/main/java/com/chillingvan/canvasgl/glview/texture/BaseGLCanvasTextureView.java

@@ -14,9 +14,11 @@
 import com.chillingvan.canvasgl.glview.GLView;
 
 /**
- * Created by Chilling on 2016/11/11.
+ *
+ * From init to run: onSizeChange --> onSurfaceTextureAvailable --> createGLThread --> createSurface --> onSurfaceCreated --> onSurfaceChanged
+ * From pause to run: onResume --> createSurface --> onSurfaceChanged
+ * From stop to run: onResume --> onSurfaceTextureAvailable --> createGLThread --> createSurface  --> onSurfaceCreated --> onSurfaceChanged
  */
-
 abstract class BaseGLCanvasTextureView extends BaseGLTextureView implements GLViewRenderer {
 
 

canvasgl/src/main/java/com/chillingvan/canvasgl/glview/texture/BaseGLTextureView.java

@@ -40,6 +40,13 @@
  * Can make it not opaque by setOpaque(false).
  *
  * The surface of canvasGL is provided by TextureView.
+ *
+ * onSurfaceTextureSizeChanged onResume onPause onSurfaceTextureDestroyed onSurfaceTextureUpdated
+ * From init to run: onSizeChanged --> onSurfaceTextureAvailable --> createGLThread --> createSurface
+ * From run to pause: onPause --> destroySurface
+ * From pause to run: onResume --> createSurface
+ * From run to stop: onPause --> destroySurface --> onSurfaceTextureDestroyed --> EGLHelper.finish --> GLThread.exit
+ * From stop to run: onResume --> onSurfaceTextureAvailable --> createGLThread --> createSurface
  */
 abstract class BaseGLTextureView extends TextureView implements TextureView.SurfaceTextureListener {
 
@@ -239,6 +246,9 @@ public void run() {
         cacheEvents.clear();
     }
 
+    /**
+     * surface inited or updated.
+     */
     private void freshSurface(int width, int height) {
         surfaceCreated();
         surfaceChanged(width, height);
@@ -255,6 +265,9 @@ public void onSurfaceTextureSizeChanged(SurfaceTexture surface, int width, int h
         }
     }
 
+    /**
+     * This will be called when windows detached. Activity onPause will cause window detached.
+     */
     @Override
     public boolean onSurfaceTextureDestroyed(SurfaceTexture surface) {
         Loggers.d("BaseGLTextureView", "onSurfaceTextureDestroyed: ");

canvasgl/src/main/java/com/chillingvan/canvasgl/glview/texture/GLSurfaceTextureProducerView.java

@@ -37,6 +37,8 @@
 /**
  * This will generate a texture which is in the eglContext of the CanvasGL. And the texture can be used outside.
  * For example, the generated texture can be used in camera preview texture or {@link GLSharedContextView}.
+ *
+ * From pause to run: onResume --> createSurface --> onSurfaceChanged
  */
 public abstract class GLSurfaceTextureProducerView extends GLSharedContextView {
     private static final String TAG = "GLSurfaceTextureProduce";
@@ -93,7 +95,7 @@ public void onSurfaceTextureAvailable(SurfaceTexture surface, int width, int hei
     @Override
     public void onSurfaceChanged(int width, int height) {
         super.onSurfaceChanged(width, height);
-        Loggers.d(TAG, "onSizeChanged: ");
+        Loggers.d(TAG, "onSurfaceChanged: ");
         producedRawTexture = new RawTexture(width, height, false, producedTextureTarget);
         if (!producedRawTexture.isLoaded()) {
             producedRawTexture.prepare(mCanvas.getGlCanvas());

canvasgl/src/main/java/com/chillingvan/canvasgl/glview/texture/gles/GLThread.java

@@ -43,9 +43,9 @@
 import javax.microedition.khronos.opengles.GL;
 
 /**
- * Created by Chilling on 2016/10/30.
+ * Create GL Context --> Create Surface
+ * And then draw with OpenGL and finally eglSwap to update the screen.
  */
-
 public class GLThread extends Thread {
     private static final String TAG = "GLThread";
     public final static boolean LOG_RENDERER_DRAW_FRAME = false;
@@ -65,7 +65,6 @@ public class GLThread extends Thread {
     private Object mSurface;
 
     private OnCreateGLContextListener onCreateGLContextListener;
-    private boolean mPreserveEGLContextOnPause = true;
 
 
     // Once the thread is started, all accesses to the following member
@@ -135,11 +134,6 @@ public void run() {
     }
 
 
-    public void setPreserveEGLContextOnPause(boolean mPreserveEGLContextOnPause) {
-        this.mPreserveEGLContextOnPause = mPreserveEGLContextOnPause;
-    }
-
-
     /**
      * This private method should only be called inside a
      * synchronized(sGLThreadManager) block.
@@ -218,16 +212,6 @@ private void guardedRun() throws InterruptedException {
                             stopEglSurfaceLocked();
                         }
 
-                        // When pausing, optionally release the EGL Context:
-                        if (pausing && mHaveEglContext) {
-                            boolean preserveEglContextOnPause = mPreserveEGLContextOnPause;
-                            if (!preserveEglContextOnPause) {
-                                stopEglContextLocked();
-                                FileLogger.i(TAG, "releasing EGL context because paused tid=" + getId());
-                            }
-                        }
-
-
                         // Have we lost the SurfaceView surface?
                         if ((!mHasSurface) && (!mWaitingForSurface)) {
                             FileLogger.i(TAG, "noticed surfaceView surface lost tid=" + getId());
@@ -362,6 +346,7 @@ private void guardedRun() throws InterruptedException {
                     createGlInterface = false;
                 }
 
+                // Make sure context and surface are created
                 if (createEglContext) {
                     FileLogger.w("GLThread", "onSurfaceCreated");
                     mRenderer.onSurfaceCreated();