Merge branch 'master' of https://github.com/omerjerk/processing-video-android

Author: omerjerk

README.md

@@ -1,10 +1,23 @@
 # Processing Video implementation for Android
-In this branch, I'm maintaining another approach to render camera preview on processing's `GLSurfaceView`.
-The idea is to render camera preview on a `SurfaceTexture` and as soon as the new frame is received, copy the data from this `SurfaceTexture` to a custom texure bound to target `GL_TEXTURE_2D`. 
-We cannot directly render to processing's own texture because it's bound `GL_TEXTURE_2D` target, whereas for the preview to happen, the texture should be bound to `GL_TEXTURE_EXTERNAL_OES`.
+This library tries to expose the same API endpoints as that of processing-video library for PC. The sketch from processing-video library works for Android.
 
-**Behind the hood :**
+**A primitive example :**
+```
+import in.omerjerk.processing.video.android.*;
+
+Capture cap;
 
-I create a framebuffer object and a custom texture object, which is bound to target `GL_TEXTURE_2D`, and attach this texture to the previously created framebuffer at `GL_COLOR_ATTACHMENT0`. I then render SurfaceTexture's shader output to this framebuffer and it atomatically gets rendered upon the custom texture I created. I then call `glReadPixels` and assign these read pixels to `PImage`'s pixel array.
+void setup() {
+  size(720, 1280, P2D);
+  cap = new Capture(this);
+  String[] list = cap.list();
+  Capture.printCompatibleResolutionsList(cap);
+}
 
-For an alternative approach, please head over to testing branch.
+void draw() {
+  image(cap, 0, 0);
+}
+```
+
+**Behind the hood :**
+The idea is to render camera preview on a `SurfaceTexture` and as soon as the new frame is received, copy the data from this `SurfaceTexture` to a custom texure bound to target `GL_TEXTURE_2D` (Note : We cannot directly render to a texture bound to `GL_TEXTURE_2D` target, because for the preview to happen, the texture must be bound to `GL_TEXTURE_EXTERNAL_OES`). This custom texture is then rendered to a PGraphics object. The backing texture of that PGraphics object is then used as the texture cache for our PImage file which stores the video.