emulatgor opengl: First commit of the host renderer library.

This is a library which includes all the OpenGL renderer functionality,
it is packaged in a library so that both the renderer process and the emulator
program will be able to use that functionality.

NOTES:
   1) gl_proc.h and GLDispatch.{h,cpp} in this commit will be replaced
      with the decoder auto-generated dispatch in a later commit, the
      auto-generated dispatch is currently missing some extension functions
      required for the renderer.
   2) look at host/include/libOpenglRender/render_api.h for the external
      interface defined for this library (to be used by the emulator).

The following is a description of each component:

FrameBuffer - The main object which manages the framebuffer and color buffers.
              This is a singleton which get initialized through its initialize
              static function. It initializes the OpenGL renderer and must be
              called first. This initialization function is not thread safe so
              it must be called before any thread that is calling to this
              library is created.

FBConfig - Includes a static set of configs supported by the renderer which get
           initialized during FrameBuffer initialization phase. Also,
           an instance of this class includes the a description of one frame
           buffer configuration supported by the renderer.

RenderContext - encapsulate a rendering context state.

ColorBuffer - implements a color buffer object as a texture which can be bind
              as render target or source.

WindowSurface - implements the functionality of a native window which can be
                bound to a rendering context and its target ColorBuffer can
                be specified and replaced.

ThreadInfo - holds per-thread information.

EGLDispatch - loads the EGL plugin library, all egl calls are made through
              this dispatch table which get initialized during initialization
              phase.

GLDispatch - loads the GLES plugin library, all GLES calls are made through
             this dispatch table which get initialized during initialization
             phase - This will be replaced by the auto-generated code of the
             decoder ...

RenderThread - implements a thread that reads command tokens from an IOStream
               and decode it.

RenderControl - implements the host side implementation of the renderControl
                API, when a renderControl token is decoded from the stream
                it is dispatched to this implementation.

RenderServer - implements a TCP server which listens to port number and
               launcges a RenderThread for each new connection.

Change-Id: I9f34d17bdfcb715893a13cd30086c767f499df87

tools/emulator/opengl/host/libs/libOpenglRender/WindowSurface.h

@@ -0,0 +1,64 @@
+/*
+* Copyright (C) 2011 The Android Open Source Project
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+#ifndef _LIBRENDER_WINDOWSURFACE_H
+#define _LIBRENDER_WINDOWSURFACE_H
+
+#include "ColorBuffer.h"
+#include "RenderContext.h"
+#include "SmartPtr.h"
+#include "FixedBuffer.h"
+#include <EGL/egl.h>
+#include <GLES/gl.h>
+
+enum SurfaceBindType {
+    SURFACE_BIND_READ,
+    SURFACE_BIND_DRAW,
+    SURFACE_BIND_READDRAW
+};
+
+class WindowSurface
+{
+public:
+    static WindowSurface *create(int p_config, int p_width, int p_height);
+    ~WindowSurface();
+    EGLSurface getEGLSurface() const { return m_eglSurface; }
+
+    void setColorBuffer(ColorBufferPtr p_colorBuffer);
+    void bind(RenderContextPtr p_ctx, SurfaceBindType p_bindType);
+
+private:
+    WindowSurface();
+
+    void copyToColorBuffer();  // copy pbuffer content with readback+download
+
+private:
+    GLuint m_fbObj;   // GLES Framebuffer object (when EGLimage is used)
+    GLuint m_depthRB;
+    GLuint m_stencilRB;
+    EGLSurface m_eglSurface;
+    ColorBufferPtr m_attachedColorBuffer;
+    RenderContextPtr m_readContext;
+    RenderContextPtr m_drawContext;
+    GLuint m_width;
+    GLuint m_height;
+    bool m_useEGLImage;
+    bool m_useBindToTexture;
+    FixedBuffer m_xferBuffer;
+};
+
+typedef SmartPtr<WindowSurface> WindowSurfacePtr;
+
+#endif