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/include/libOpenglRender/render_api.h

@@ -0,0 +1,71 @@
+/*
+* 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 _OPENGL_RENDERER_RENDER_API_H
+#define _OPENGL_RENDERER_RENDER_API_H
+
+#include "IOStream.h"
+
+#if defined(_WIN32) || defined(__VC32__) && !defined(__CYGWIN__) && !defined(__SCITECH_SNAP__) /* Win32 and WinCE */
+#include <windows.h>
+
+typedef HDC     FBNativeDisplayType;
+typedef HWND    FBNativeWindowType;
+
+#elif defined(__linux__)
+
+#include <X11/Xlib.h>
+#include <X11/Xutil.h>
+
+typedef Window   FBNativeWindowType;
+
+#else
+#error "Unsupported platform"
+#endif
+
+
+//
+// initOpenGLRenderer - initialize the OpenGL renderer process.
+//     window is the native window to be used as the framebuffer.
+//     x,y,width,height are the dimensions of the rendering subwindow.
+//     portNum is the tcp port number the renderer is listening to.
+//
+// returns true if renderer has been starter successfully;
+//
+// This function is *NOT* thread safe and should be called first
+// to initialize the renderer.
+//
+bool initOpenGLRenderer(FBNativeWindowType window,
+                        int x, int y, int width, int height,
+                        int portNum);
+
+//
+// stopOpenGLRenderer - stops the OpenGL renderer process.
+//     This functions is *NOT* thread safe and should be called
+//     only if previous initOpenGLRenderer has returned true.
+//
+bool stopOpenGLRenderer();
+
+//
+// createRenderThread - opens a new communication channel to the renderer
+//   process and creates new rendering thread.
+//   returns a pointer to IOStream through which command tokens are being sent
+//   to the render thread for execution. 'p_stream_buffer_size' is the internal
+//   stream buffer size.
+//   The thread is destroyed when deleting the IOStream object.
+//
+IOStream *createRenderThread(int p_stream_buffer_size);
+
+#endif