x_ite 5.0.3 → 6.1.0

package/src/x_ite/Browser/Core/Context.js

@@ -0,0 +1,185 @@
+/* -*- Mode: JavaScript; coding: utf-8; tab-width: 3; indent-tabs-mode: tab; c-basic-offset: 3 -*-
+ *******************************************************************************
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright create3000, Scheffelstraße 31a, Leipzig, Germany 2011.
+ *
+ * All rights reserved. Holger Seelig <holger.seelig@yahoo.de>.
+ *
+ * The copyright notice above does not evidence any actual of intended
+ * publication of such source code, and is an unpublished work by create3000.
+ * This material contains CONFIDENTIAL INFORMATION that is the property of
+ * create3000.
+ *
+ * No permission is granted to copy, distribute, or create derivative works from
+ * the contents of this software, in whole or in part, without the prior written
+ * permission of create3000.
+ *
+ * NON-MILITARY USE ONLY
+ *
+ * All create3000 software are effectively free software with a non-military use
+ * restriction. It is free. Well commented source is provided. You may reuse the
+ * source in any way you please with the exception anything that uses it must be
+ * marked to indicate is contains 'non-military use only' components.
+ *
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * Copyright 2015, 2016 Holger Seelig <holger.seelig@yahoo.de>.
+ *
+ * This file is part of the X_ITE Project.
+ *
+ * X_ITE is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU General Public License version 3 only, as published by the
+ * Free Software Foundation.
+ *
+ * X_ITE is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
+ * A PARTICULAR PURPOSE. See the GNU General Public License version 3 for more
+ * details (a copy is included in the LICENSE file that accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version 3
+ * along with X_ITE.  If not, see <http://www.gnu.org/licenses/gpl.html> for a
+ * copy of the GPLv3 License.
+ *
+ * For Silvio, Joy and Adi.
+ *
+ ******************************************************************************/
+
+
+define ([
+   "x_ite/DEBUG",
+],
+function (DEBUG)
+{
+"use strict";
+
+   const extensions = [
+      "ANGLE_instanced_arrays",
+      "EXT_blend_minmax",
+      "EXT_frag_depth",
+      "EXT_shader_texture_lod",
+      "EXT_texture_filter_anisotropic",
+      "OES_element_index_uint",
+      "OES_standard_derivatives",
+      "OES_texture_float",
+      "OES_texture_float_linear",
+      "OES_texture_half_float",
+      "OES_texture_half_float_linear",
+      "OES_vertex_array_object",
+      "WEBGL_compressed_texture_s3tc",
+      //"WEBGL_debug_renderer_info",
+      "WEBGL_debug_shaders",
+      "WEBGL_depth_texture",
+      "WEBGL_draw_buffers",
+      "WEBGL_lose_context",
+
+      "EXT_color_buffer_float",
+      "EXT_color_buffer_half_float",
+      "EXT_disjoint_timer_query",
+      "EXT_disjoint_timer_query_webgl2",
+      "EXT_sRGB",
+      "WEBGL_color_buffer_float",
+      "WEBGL_compressed_texture_astc",
+      "WEBGL_compressed_texture_atc",
+      "WEBGL_compressed_texture_etc",
+      "WEBGL_compressed_texture_etc1",
+      "WEBGL_compressed_texture_pvrtc",
+      "WEBGL_compressed_texture_s3tc",
+      "WEBGL_compressed_texture_s3tc_srgb",
+
+      "EXT_float_blend",
+      "OES_fbo_render_mipmap",
+      "WEBGL_get_buffer_sub_data_async",
+      "WEBGL_multiview",
+      "WEBGL_security_sensitive_resources",
+      "WEBGL_shared_resources",
+
+      "EXT_clip_cull_distance",
+      "WEBGL_debug",
+      "WEBGL_dynamic_texture",
+      "WEBGL_subarray_uploads",
+      "WEBGL_texture_multisample",
+      "WEBGL_texture_source_iframe",
+      "WEBGL_video_texture",
+
+      "EXT_texture_storage",
+      "OES_depth24",
+      "WEBGL_debug_shader_precision",
+      "WEBGL_draw_elements_no_range_check",
+      "WEBGL_subscribe_uniform",
+      "WEBGL_texture_from_depth_video",
+   ];
+
+   const Context =
+   {
+      create: function (canvas, version, preserveDrawingBuffer)
+      {
+         const options = { preserveDrawingBuffer: preserveDrawingBuffer };
+
+         let gl = null;
+
+         if (version >= 2 && ! gl)
+         {
+            gl = canvas .getContext ("webgl2", options);
+
+            if (gl)
+               gl .getVersion = function () { return 2; };
+         }
+
+         if (version >= 1 && ! gl)
+         {
+            gl = canvas .getContext ("webgl",              options) ||
+                 canvas .getContext ("experimental-webgl", options);
+
+            if (gl)
+            {
+               gl .getVersion = function () { return 1; };
+
+               {
+                  const ext = gl .getExtension ("OES_vertex_array_object");
+
+                  gl .bindVertexArray   =  ext .bindVertexArrayOES   .bind (ext);
+                  gl .createVertexArray =  ext .createVertexArrayOES .bind (ext);
+                  gl .deleteVertexArray =  ext .deleteVertexArrayOES .bind (ext);
+                  gl .isVertexArray     =  ext .isVertexArrayOES     .bind (ext);
+               }
+            }
+          }
+
+         if (! gl)
+            throw new Error ("Couldn't create WebGL context.");
+
+         // Feature detection:
+
+         // If the aliased lineWidth ranges are both 1, gl .lineWidth is probably not possible,
+         // thus we disable it completely to prevent webgl errors.
+
+         const aliasedLineWidthRange = gl .getParameter (gl .ALIASED_LINE_WIDTH_RANGE);
+
+         if (aliasedLineWidthRange [0] === 1 && aliasedLineWidthRange [1] === 1)
+         {
+            gl .lineWidth            = Function .prototype;
+            gl .MUST_TRANSFORM_LINES = gl .getVersion () >= 2;
+
+            if (DEBUG)
+               console .info ("Lines are transformed if necessary to obtain thick lines.");
+         }
+         else
+         {
+            gl .MUST_TRANSFORM_LINES = false;
+         }
+
+         // Load extensions.
+
+         for (const extension of extensions)
+            gl .getExtension (extension);
+
+         // Return context.
+
+         return gl;
+      },
+   }
+
+   return Context;
+});