x_ite 5.0.3 → 6.1.0

package/src/assets/shaders/webgl2/PBR.vs

@@ -4,16 +4,17 @@
 
 precision highp float;
 precision highp int;
+precision highp sampler2D;
 
 uniform mat4 x3d_ProjectionMatrix;
 uniform mat4 x3d_ModelViewMatrix;
 uniform mat3 x3d_NormalMatrix;
 
-in vec4 x3d_Vertex;
-in vec3 x3d_Normal;
+in vec4 x3d_Color;
 in vec4 x3d_TexCoord0;
 in vec4 x3d_TexCoord1;
-in vec4 x3d_Color;
+in vec3 x3d_Normal;
+in vec4 x3d_Vertex;
 
 out vec3 vertex;
 out vec3 normal;
@@ -27,15 +28,17 @@ out vec3 localVertex; // point on geometry in local coordinates
 out float depth;
 #endif
 
+#pragma X3D include "include/Particle.glsl"
+
 void
 main ()
 {
-   vec4 position = x3d_ModelViewMatrix * x3d_Vertex;
+   vec4 position = x3d_ModelViewMatrix * getVertex (x3d_Vertex);
 
    vertex      = position .xyz;
-   normal      = normalize (x3d_NormalMatrix * x3d_Normal);
-   texCoord0   = x3d_TexCoord0;
-   texCoord1   = x3d_TexCoord1;
+   normal      = x3d_NormalMatrix * x3d_Normal;
+   texCoord0   = getTexCoord (x3d_TexCoord0);
+   texCoord1   = getTexCoord (x3d_TexCoord1);
    color       = x3d_Color;
    localNormal = x3d_Normal;
    localVertex = x3d_Vertex .xyz;

package/src/assets/shaders/webgl2/Phong.fs

@@ -4,8 +4,8 @@ precision highp float;
 precision highp int;
 
 uniform int   x3d_GeometryType;
-uniform bool  x3d_ColorMaterial; // true if a X3DColorNode is attached, otherwise false
 uniform float x3d_AlphaCutoff;
+uniform bool  x3d_ColorMaterial; // true if a X3DColorNode is attached, otherwise false
 
 uniform int x3d_NumLights;
 uniform x3d_LightSourceParameters x3d_LightSource [x3d_MaxLights];
@@ -60,7 +60,7 @@ getAmbientColor (in vec3 diffuseColor)
    // Get texture color.
 
    #if defined(X3D_AMBIENT_TEXTURE)
-      vec4 texCoord = getTexCoord (x3d_AmbientTexture .textureTransformMapping, x3d_AmbientTexture .textureCoordinateMapping);
+      vec3 texCoord = getTexCoord (x3d_AmbientTexture .textureTransformMapping, x3d_AmbientTexture .textureCoordinateMapping);
 
       #if defined(X3D_AMBIENT_TEXTURE_2D)
          return ambientParameter * texture (x3d_AmbientTexture .texture2D, texCoord .st) .rgb;
@@ -85,14 +85,14 @@ getDiffuseColor ()
    // Get texture color.
 
    #if defined(X3D_DIFFUSE_TEXTURE)
-      vec4 texCoord = getTexCoord (x3d_DiffuseTexture .textureTransformMapping, x3d_DiffuseTexture .textureCoordinateMapping);
+      vec3 texCoord = getTexCoord (x3d_DiffuseTexture .textureTransformMapping, x3d_DiffuseTexture .textureCoordinateMapping);
 
       #if defined(X3D_DIFFUSE_TEXTURE_2D)
-         return diffuseParameter * texture (x3d_DiffuseTexture .texture2D, texCoord .st) .rgba;
+         return diffuseParameter * texture (x3d_DiffuseTexture .texture2D, texCoord .st);
       #elif defined(X3D_DIFFUSE_TEXTURE_3D)
-         return diffuseParameter * texture (x3d_DiffuseTexture .texture3D, texCoord .stp) .rgba;
+         return diffuseParameter * texture (x3d_DiffuseTexture .texture3D, texCoord .stp);
       #elif defined(X3D_DIFFUSE_TEXTURE_CUBE)
-         return diffuseParameter * texture (x3d_DiffuseTexture .textureCube, texCoord .stp) .rgba;
+         return diffuseParameter * texture (x3d_DiffuseTexture .textureCube, texCoord .stp);
       #endif
    #else
       return getTextureColor (diffuseParameter, vec4 (x3d_Material .specularColor, alpha));
@@ -109,7 +109,7 @@ getSpecularColor ()
    // Get texture color.
 
    #if defined(X3D_SPECULAR_TEXTURE)
-      vec4 texCoord = getTexCoord (x3d_SpecularTexture .textureTransformMapping, x3d_SpecularTexture .textureCoordinateMapping);
+      vec3 texCoord = getTexCoord (x3d_SpecularTexture .textureTransformMapping, x3d_SpecularTexture .textureCoordinateMapping);
 
       #if defined(X3D_SPECULAR_TEXTURE_2D)
          return specularParameter * texture (x3d_SpecularTexture .texture2D, texCoord .st) .rgb;
@@ -133,7 +133,7 @@ getEmissiveColor ()
    // Get texture color.
 
    #if defined(X3D_EMISSIVE_TEXTURE)
-      vec4 texCoord = getTexCoord (x3d_EmissiveTexture .textureTransformMapping, x3d_EmissiveTexture .textureCoordinateMapping);
+      vec3 texCoord = getTexCoord (x3d_EmissiveTexture .textureTransformMapping, x3d_EmissiveTexture .textureCoordinateMapping);
 
       #if defined(X3D_EMISSIVE_TEXTURE_2D)
          return emissiveParameter * texture (x3d_EmissiveTexture .texture2D, texCoord .st) .rgb;
@@ -157,7 +157,7 @@ getShininessFactor ()
    // Get texture color.
 
    #if defined(X3D_SHININESS_TEXTURE)
-      vec4 texCoord = getTexCoord (x3d_ShininessTexture .textureTransformMapping, x3d_ShininessTexture .textureCoordinateMapping);
+      vec3 texCoord = getTexCoord (x3d_ShininessTexture .textureTransformMapping, x3d_ShininessTexture .textureCoordinateMapping);
 
       #if defined(X3D_SHININESS_TEXTURE_2D)
          return shininess * texture (x3d_ShininessTexture .texture2D, texCoord .st) .a * 128.0;
@@ -177,7 +177,7 @@ getOcclusionFactor ()
    // Get texture color.
 
    #if defined(X3D_OCCLUSION_TEXTURE)
-      vec4 texCoord = getTexCoord (x3d_OcclusionTexture .textureTransformMapping, x3d_OcclusionTexture .textureCoordinateMapping);
+      vec3 texCoord = getTexCoord (x3d_OcclusionTexture .textureTransformMapping, x3d_OcclusionTexture .textureCoordinateMapping);
 
       #if defined(X3D_OCCLUSION_TEXTURE_2D)
          return texture (x3d_OcclusionTexture .texture2D, texCoord .st) .r;
@@ -240,7 +240,7 @@ getMaterialColor ()
          float specularFactor = shininessFactor > 0.0 ? pow (max (dot (N, H), 0.0), shininessFactor) : 1.0;
          vec3  specularTerm   = specularColor * specularFactor;
 
-         float attenuationFactor     = di ? 1.0 : 1.0 / max (c [0] + c [1] * dL + c [2] * (dL * dL), 1.0);
+         float attenuationFactor     = di ? 1.0 : 1.0 / max (dot (c, vec3 (1.0, dL, dL * dL)), 1.0);
          float spotFactor            = light .type == x3d_SpotLight ? getSpotFactor (light .cutOffAngle, light .beamWidth, L, d) : 1.0;
          float attenuationSpotFactor = attenuationFactor * spotFactor;
          vec3  ambientTerm           = light .ambientIntensity * ambientColor;

package/src/assets/shaders/webgl2/Phong.vs

@@ -2,6 +2,7 @@
 
 precision highp float;
 precision highp int;
+precision highp sampler2D;
 
 uniform mat3 x3d_NormalMatrix;
 uniform mat4 x3d_ProjectionMatrix;
@@ -39,10 +40,12 @@ out vec4  texCoord1;   // texCoord1
 out float depth;
 #endif
 
+#pragma X3D include "include/Particle.glsl"
+
 void
 main ()
 {
-   vec4 position = x3d_ModelViewMatrix * x3d_Vertex;
+   vec4 position = x3d_ModelViewMatrix * getVertex (x3d_Vertex);
 
    fogDepth    = x3d_FogDepth;
    color       = x3d_Color;
@@ -52,11 +55,11 @@ main ()
    localVertex = x3d_Vertex .xyz;
 
    #if x3d_MaxTextures > 0
-   texCoord0 = x3d_TexCoord0;
+   texCoord0 = getTexCoord (x3d_TexCoord0);
    #endif
 
    #if x3d_MaxTextures > 1
-   texCoord1 = x3d_TexCoord1;
+   texCoord1 = getTexCoord (x3d_TexCoord1);
    #endif
 
    gl_Position = x3d_ProjectionMatrix * position;

package/src/assets/shaders/webgl2/Point.vs

@@ -2,6 +2,7 @@
 
 precision highp float;
 precision highp int;
+precision highp sampler2D;
 
 uniform x3d_PointPropertiesParameters x3d_PointProperties;
 
@@ -25,12 +26,12 @@ out vec3  vertex;    // point on geometry
 out float depth;
 #endif
 
+#pragma X3D include "include/Particle.glsl"
+
 void
 main ()
 {
-   // Determine varyings.
-
-   vec4 position = x3d_ModelViewMatrix * x3d_Vertex;
+   vec4 position = x3d_ModelViewMatrix * getVertex (x3d_Vertex);
 
    fogDepth = x3d_FogDepth;
    vertex   = position .xyz;
@@ -49,7 +50,7 @@ main ()
    float dL                   = length (vertex);
 
    pointSize  = x3d_PointProperties .pointSizeScaleFactor;
-   pointSize *= 1.0 / (pointSizeAttenuation [0] + pointSizeAttenuation [1] * dL + pointSizeAttenuation [2] * (dL * dL));
+   pointSize /= dot (pointSizeAttenuation, vec3 (1.0, dL, dL * dL));
    pointSize  = clamp (pointSize, pointSizeMinValue, pointSizeMaxValue);
 
    gl_PointSize = pointSize > 1.0 && x3d_NumTextures == 0 ? pointSize + 1.0 : pointSize;

package/src/assets/shaders/webgl2/Unlit.fs

@@ -5,8 +5,8 @@ precision highp int;
 precision highp sampler3D;
 
 uniform int   x3d_GeometryType;
-uniform bool  x3d_ColorMaterial; // true if a X3DColorNode is attached, otherwise false
 uniform float x3d_AlphaCutoff;
+uniform bool  x3d_ColorMaterial; // true if a X3DColorNode is attached, otherwise false
 
 uniform x3d_UnlitMaterialParameters x3d_Material;
 
@@ -52,14 +52,14 @@ getEmissiveColor ()
    // Get texture color.
 
    #if defined(X3D_EMISSIVE_TEXTURE)
-      vec4 texCoord = getTexCoord (x3d_EmissiveTexture .textureTransformMapping, x3d_EmissiveTexture .textureCoordinateMapping);
+      vec3 texCoord = getTexCoord (x3d_EmissiveTexture .textureTransformMapping, x3d_EmissiveTexture .textureCoordinateMapping);
 
       #if defined(X3D_EMISSIVE_TEXTURE_2D)
-         return emissiveParameter * texture (x3d_EmissiveTexture .texture2D, texCoord .st) .rgba;
+         return emissiveParameter * texture (x3d_EmissiveTexture .texture2D, texCoord .st);
       #elif defined(X3D_EMISSIVE_TEXTURE_3D)
-         return emissiveParameter * texture (x3d_EmissiveTexture .texture3D, texCoord .stp) .rgba;
+         return emissiveParameter * texture (x3d_EmissiveTexture .texture3D, texCoord .stp);
       #elif defined(X3D_EMISSIVE_TEXTURE_CUBE)
-         return emissiveParameter * texture (x3d_EmissiveTexture .textureCube, texCoord .stp) .rgba;
+         return emissiveParameter * texture (x3d_EmissiveTexture .textureCube, texCoord .stp);
       #endif
    #else
       return getTextureColor (emissiveParameter, vec4 (vec3 (1.0), alpha));

package/src/assets/shaders/webgl2/Unlit.vs

@@ -2,6 +2,7 @@
 
 precision highp float;
 precision highp int;
+precision highp sampler2D;
 
 uniform mat3 x3d_NormalMatrix;
 uniform mat4 x3d_ProjectionMatrix;
@@ -39,10 +40,12 @@ out vec4  texCoord1;   // texCoord1
 out float depth;
 #endif
 
+#pragma X3D include "include/Particle.glsl"
+
 void
 main ()
 {
-   vec4 position = x3d_ModelViewMatrix * x3d_Vertex;
+   vec4 position = x3d_ModelViewMatrix * getVertex (x3d_Vertex);
 
    fogDepth    = x3d_FogDepth;
    color       = x3d_Color;
@@ -52,11 +55,11 @@ main ()
    localVertex = x3d_Vertex .xyz;
 
    #if x3d_MaxTextures > 0
-   texCoord0 = x3d_TexCoord0;
+   texCoord0 = getTexCoord (x3d_TexCoord0);
    #endif
 
    #if x3d_MaxTextures > 1
-   texCoord1 = x3d_TexCoord1;
+   texCoord1 = getTexCoord (x3d_TexCoord1);
    #endif
 
    gl_Position = x3d_ProjectionMatrix * position;

package/src/assets/shaders/webgl2/include/Line2.glsl

@@ -0,0 +1,20 @@
+struct Line2
+{
+   vec2 point;
+   vec2 direction;
+};
+
+Line2
+line2 (const in vec2 point1, const in vec2 point2)
+{
+   return Line2 (point1, normalize (point2 - point1));
+}
+
+vec2
+closest_point (const in Line2 line, const in vec2 point)
+{
+   vec2  r = point - line .point;
+   float d = dot (r, line .direction);
+
+   return line .direction * d + line .point;
+}

package/src/assets/shaders/webgl2/include/Normal.glsl

@@ -27,7 +27,7 @@ getNormalVector ()
    // Get normal vector.
 
    #if defined(X3D_NORMAL_TEXTURE)
-      vec4 texCoord    = getTexCoord (x3d_NormalTexture .textureTransformMapping, x3d_NormalTexture .textureCoordinateMapping);
+      vec3 texCoord    = getTexCoord (x3d_NormalTexture .textureTransformMapping, x3d_NormalTexture .textureCoordinateMapping);
       vec3 normalScale = vec3 (vec2 (x3d_Material .normalScale), 1.0);
       mat3 tbn         = getTBNMatrix (texCoord .st);
 

package/src/assets/shaders/webgl2/include/Particle.glsl

@@ -0,0 +1,36 @@
+in vec4 x3d_Particle;
+in mat4 x3d_ParticleMatrix;
+
+uniform sampler2D x3d_TexCoordRamp;
+
+vec4
+texelFetch (const in sampler2D sampler, const in int index, const in int lod)
+{
+   int   x = textureSize (sampler, lod) .x;
+   ivec2 p = ivec2 (index % x, index / x);
+   vec4  t = texelFetch (sampler, p, lod);
+
+   return t;
+}
+
+vec4
+getVertex (const in vec4 vertex)
+{
+   if (x3d_Particle [0] == 0.0)
+      return vertex;
+
+   return x3d_ParticleMatrix * vertex;
+}
+
+vec4
+getTexCoord (const in vec4 texCoord)
+{
+   int index0 = int (x3d_Particle [3]);
+
+   if (x3d_Particle [0] == 0.0 || index0 == -1)
+      return texCoord;
+
+   const int map [6] = int [6] (0, 1, 2, 0, 2, 3);
+
+   return texelFetch (x3d_TexCoordRamp, index0 + map [gl_VertexID % 6], 0);
+}

package/src/assets/shaders/webgl2/include/Texture.glsl

@@ -131,7 +131,7 @@ getTexCoord (const in x3d_TextureCoordinateGeneratorParameters textureCoordinate
    }
 }
 
-vec4
+vec3
 getTexCoord (const in int textureTransformMapping, const in int textureCoordinateMapping)
 {
    vec4 texCoord = getTexCoord (x3d_TextureCoordinateGenerator [textureCoordinateMapping], textureTransformMapping, textureCoordinateMapping);
@@ -141,7 +141,7 @@ getTexCoord (const in int textureTransformMapping, const in int textureCoordinat
    if ((x3d_GeometryType == x3d_Geometry2D) && (gl_FrontFacing == false))
       texCoord .s = 1.0 - texCoord .s;
 
-   return texCoord;
+   return texCoord .stp;
 }
 
 vec4
@@ -228,7 +228,7 @@ getTextureColor (const in vec4 diffuseColor, const in vec4 specularColor)
 
       // Get texture color.
 
-      vec4 texCoord     = getTexCoord (i, i);
+      vec3 texCoord     = getTexCoord (i, i);
       vec4 textureColor = vec4 (1.0);
 
       switch (x3d_TextureType [i])

package/src/example.html

@@ -2,19 +2,19 @@
   <html>
    <head>
     <meta charset="utf-8"/>
-    <link rel="stylesheet" type="text/css" href="https://create3000.github.io/code/x_ite/latest/dist/x_ite.css"/>
-    <script type="text/javascript" src="https://create3000.github.io/code/x_ite/latest/dist/x_ite.min.js"></script>
+    <script type="text/javascript" src="x_ite.min.js"></script>
+    <!-- <script type="text/javascript" src="https://create3000.github.io/code/x_ite/latest/dist/x_ite.min.js"></script> -->
     <style>
-X3DCanvas {
+x3d-canvas {
   width: 1000px;
   height: 563px;
 }
     </style>
   </head>
   <body>
-    <X3DCanvas src="https://cdn.rawgit.com/create3000/Library/main/Examples/X_ITE/info.x3d">
+    <x3d-canvas src="https://create3000.github.io/media/x_ite/info/info.x3d">
       <p>Your browser may not support all features required by X_ITE!</p>
-    </X3DCanvas>
-    <p>If the page is not running <a href="https://github.com/create3000/x_ite/wiki#using-firefox-chrome-and-opera-with-local-files">consider setup a localhost server</a>.</p>
+    </x3d-canvas>
+    <p>If local files are not loaded <a href="https://create3000.github.io/x_ite/#using-firefox-chrome-and-opera-with-local-files">consider setup a localhost server</a>.</p>
   </body>
 </html>

package/src/examples.js

@@ -52,9 +52,6 @@ const X_ITE_EXAMPLES = [
    { component: "Lighting", test: "PointLight" },
    { component: "Lighting", test: "Shadows" },
    { component: "Lighting", test: "SpotLight" },
-   { component: "NURBS", test: "NurbsCurve" },
-   { component: "NURBS", test: "NurbsPatchSurface" },
-   { component: "NURBS", test: "NurbsSweptSurface" },
    { component: "Navigation", test: "Billboard" },
    { component: "Navigation", test: "Collision" },
    { component: "Navigation", test: "LogarithmicDepthBuffer" },
@@ -64,6 +61,9 @@ const X_ITE_EXAMPLES = [
    { component: "Networking", test: "Anchor" },
    { component: "Networking", test: "Inline" },
    { component: "Networking", test: "LoadSensor" },
+   { component: "NURBS", test: "NurbsCurve" },
+   { component: "NURBS", test: "NurbsPatchSurface" },
+   { component: "NURBS", test: "NurbsSweptSurface" },
    { component: "ParticleSystems", test: "ConeEmitter" },
    { component: "ParticleSystems", test: "ExplosionEmitter" },
    { component: "ParticleSystems", test: "ForcePhysicsModel" },
@@ -122,8 +122,8 @@ const X_ITE_EXAMPLES = [
    { component: "X3D", test: "Approach" },
    { component: "X3D", test: "Arcadia" },
    { component: "X3D", test: "Astronomy" },
-   { component: "X3D", test: "BIC" },
    { component: "X3D", test: "BeyondGermany" },
+   { component: "X3D", test: "BIC" },
    { component: "X3D", test: "Chomp" },
    { component: "X3D", test: "Circles" },
    { component: "X3D", test: "CrazySpiral" },
@@ -148,3 +148,4 @@ const X_ITE_EXAMPLES = [
    { component: "X_ITE", test: "BlendMode" },
 ];
 X_ITE_EXAMPLES .server = "https://create3000.github.io/media/examples";
+

package/src/standard/Math/Algorithm.js

@@ -70,7 +70,7 @@ define (function ()
       },
       fract: function (value)
       {
-         return value > 0 ? value - Math .floor (value) : value - Math .ceil (value);
+         return value % 1;
       },
       clamp: function (value, min, max)
       {
@@ -96,23 +96,21 @@ define (function ()
       {
          let cosom = source .dot (destination);
 
-         if (cosom <= -1)
-            throw new Error ("slerp is not possible: vectors are inverse collinear.");
+         // if (cosom <= -1) ... vectors are inverse colinear.
 
-         if (cosom >= 1) // both normal vectors are equal
+         if (cosom >= 1) // Both normal vectors are equal.
             return source;
 
          if (cosom < 0)
          {
-            // Reverse signs so we travel the short way round
+            // Reverse signs so we travel the short way round.
             cosom = -cosom;
             destination .negate ();
          }
 
          const
-            omega = Math .acos (cosom),
-            sinom = Math .sin  (omega),
-
+            omega  = Math .acos (cosom),
+            sinom  = Math .sin  (omega),
             scale0 = Math .sin ((1 - t) * omega) / sinom,
             scale1 = Math .sin (t * omega) / sinom;
 
@@ -127,16 +125,14 @@ define (function ()
       {
          const cosom = source .dot (destination);
 
-         if (cosom <= -1)
-            throw new Error ("slerp is not possible: vectors are inverse collinear.");
+         // if (cosom <= -1) ... vectors are inverse colinear.
 
-         if (cosom >= 1) // both normal vectors are equal
+         if (cosom >= 1) // Both normal vectors are equal.
             return source;
 
          const
-            omega = Math .acos (cosom),
-            sinom = Math .sin  (omega),
-
+            omega  = Math .acos (cosom),
+            sinom  = Math .sin  (omega),
             scale0 = Math .sin ((1 - t) * omega) / sinom,
             scale1 = Math .sin (t * omega) / sinom;
 
@@ -172,7 +168,7 @@ define (function ()
       {
          return lhs > rhs;
       },
-      lowerBound: function (array, first, last, value, comp)
+      lowerBound: function (array, first, last, value, comp = this .less)
       {
          // http://en.cppreference.com/w/cpp/algorithm/lower_bound
 
@@ -197,7 +193,7 @@ define (function ()
 
          return first;
       },
-      upperBound: function (array, first, last, value, comp)
+      upperBound: function (array, first, last, value, comp = this .less)
       {
          // http://en.cppreference.com/w/cpp/algorithm/upper_bound
 
@@ -233,18 +229,6 @@ define (function ()
             result .add (key);
          }
 
-         return result;
-      },
-      map_difference: function (lhs, rhs, result)
-      {
-         for (const [key, value] of lhs)
-         {
-            if (rhs .has (key))
-               continue;
-
-            result .set (key, value);
-         }
-
          return result;
       },
    };

package/src/standard/Math/Geometry/Line2.js

@@ -0,0 +1,163 @@
+/* -*- 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 ([
+   "standard/Math/Numbers/Vector2",
+],
+function (Vector2)
+{
+"use strict";
+
+   function Line2 (point, direction)
+   {
+      this .point     = point     .copy ();
+      this .direction = direction .copy ();
+   }
+
+   Line2 .prototype =
+   {
+      constructor: Line2,
+      copy: function ()
+      {
+         const copy = Object .create (Line2 .prototype);
+         copy .point     = this .point .copy ();
+         copy .direction = this .direction .copy ();
+         return copy;
+      },
+      assign: function (line)
+      {
+         this .point     .assign (line .point);
+         this .direction .assign (line .direction);
+         return this;
+      },
+      set: function (point, direction)
+      {
+         this .point     .assign (point);
+         this .direction .assign (direction);
+         return this;
+      },
+      setPoints: function (point1, point2)
+      {
+         this .point .assign (point1);
+         this .direction .assign (point2) .subtract (point1) .normalize ();
+         return this;
+      },
+      multMatrixLine: function (matrix)
+      {
+         matrix .multMatrixVec (this .point);
+         matrix .multMatrixDir (this .direction) .normalize ();
+         return this;
+      },
+      multLineMatrix: function (matrix)
+      {
+         matrix .multVecMatrix (this .point);
+         matrix .multDirMatrix (this .direction) .normalize ();
+         return this;
+      },
+      getClosestPointToPoint: function (point, result)
+      {
+         const
+            r = result .assign (point) .subtract (this .point),
+            d = r .dot (this .direction);
+
+         return result .assign (this .direction) .multiply (d) .add (this .point);
+      },
+      getPerpendicularVectorToPoint: (function ()
+      {
+         const t = new Vector2 (0, 0);
+
+         return function (point, result)
+         {
+            result .assign (this .point) .subtract (point);
+
+            return result .subtract (t .assign (this .direction) .multiply (result .dot (this .direction)));
+         };
+      })(),
+      intersectsLine: (function ()
+      {
+         const u = new Vector2 (0, 0);
+
+         return function (line, point)
+         {
+            const
+               p1 = this .point,
+               p2 = line .point,
+               d1 = this .direction,
+               d2 = line .direction;
+
+            const theta = d1 .dot (d2); // angle between both lines
+
+            if (Math .abs (theta) >= 1)
+               return false; // lines are parallel
+
+            u .assign (p2) .subtract (p1);
+
+            const t = (u .dot (d1) - theta * u .dot (d2)) / (1 - theta * theta);
+
+            point .assign (d1) .multiply (t) .add (p1);
+
+            return true;
+         };
+      })(),
+      toString: function ()
+      {
+         return this .point + ", " + this .direction;
+      },
+   };
+
+   Line2 .Points = function (point1, point2)
+   {
+      const line = Object .create (Line2 .prototype);
+      line .point     = point1 .copy ();
+      line .direction = Vector2 .subtract (point2, point1) .normalize ();
+      return line;
+   };
+
+   return Line2;
+});