x_ite 4.7.5 → 4.7.9

package/docs/What's-New.md

@@ -1,5 +1,60 @@
 # What's New
 
+## X\_ITE v4.7.7 Released
+
+*Leipzig, 30th January 2022*: This release is primarily a bug fix release, but there are also new features.
+
+{% capture notice-text %}
+#### New Features
+
+- Output XML or VRML encoding when viewpoint is copied.
+- Added browser option "Timings", but removed attribute.
+- Return promise from X3D function.
+
+{% endcapture %}
+<div class="notice--success">{{ notice-text | markdownify }}</div>
+
+{% capture notice-text %}
+#### Bug Fixes
+
+- Prevent accidental navigation when context menu is closed.
+- Fixed copy to clipboard of viewpoint when in fullscreen mode.
+
+{% endcapture %}
+<div class="notice--success">{{ notice-text | markdownify }}</div>
+
+## X\_ITE v4.7.6 Released
+
+*Leipzig, 23th January 2022*: This release implements the new X3Dv4 UnlitMaterial. This also means that the custom shader interface has changed:
+
+- Depreciated x3d_FrontMaterial in favor of x3d_Material uniform.
+- Removed x3d_BackMaterial uniform.
+- Removed x3d_Lighting uniform.
+- Removed x3d_SeparateBackColors uniform.
+
+{% capture notice-text %}
+#### New Features
+
+- Added X3DSingleTextureNode class.
+- Added X3DSingleTextureTransformNode class.
+- Added X3DSingleTextureCoordinateNode class.
+- Added UnlitMaterial class.
+- Implemented Appearance *backMaterial* field.
+
+{% endcapture %}
+<div class="notice--success">{{ notice-text | markdownify }}</div>
+
+{% capture notice-text %}
+#### Bug Fixes
+
+- Fixed bug in aliases handling and proto nodes setup.
+- Fixed bug in initialization of TextureTransformMatrix3D.
+- Fixed wireframe mode for geometry.
+- Optimized POINT shading.
+
+{% endcapture %}
+<div class="notice--success">{{ notice-text | markdownify }}</div>
+
 ## X\_ITE v4.7.3 Released
 
 *Leipzig, 16th January 2022*: This release fixes bugs, and a lot of code clean up has been done.
@@ -184,7 +239,7 @@ This release also increased pure rendering speed (without routing and scripting)
 {% capture notice-text %}
 #### Bug Fixes
 
-- Fixed a bug in X3DViepointNode when the viewpoint is animated.
+- Fixed a bug in X3DViewpointNode when the viewpoint is animated.
 
 {% endcapture %}
 <div class="notice--success">{{ notice-text | markdownify }}</div>
@@ -535,7 +590,7 @@ This release also increased pure rendering speed (without routing and scripting)
 - Implemented MultiTexture, MultiTextureTransform, and MultiTextureCoordinate.
 - Implemented FillProperties.
 - Faster startup of browser.
-- Better transitions with OthoViewpoint.
+- Better transitions with OrthoViewpoint.
 
 {% endcapture %}
 <div class="notice--success">{{ notice-text | markdownify }}</div>
@@ -842,7 +897,7 @@ for more information. Additionally we tested X\_ITE against <http://www.web3d.or
 
 ## X\_ITE v4.2.8 Released
 
-*Leipzig, 31th Oktober 2018:* The X3DCanvas element has now the onload, onshutdown, and onerror attributes and properties. There is also jQuery support for these event handler when calling jQuery.fn.on and jQuery.fn.off:
+*Leipzig, 31th October 2018:* The X3DCanvas element has now the onload, onshutdown, and onerror attributes and properties. There is also jQuery support for these event handler when calling jQuery.fn.on and jQuery.fn.off:
 
 ```js
 const element = $("X3DCanvas");
@@ -870,7 +925,7 @@ element .on ("load", function () { console .log ("load, yeah"); });
 
 ## X\_ITE v4.2.7 Released
 
-*Leipzig, 29th Oktober 2018:* This version fixes some important bugs and makes X\_ITE more specification conform.
+*Leipzig, 29th October 2018:* This version fixes some important bugs and makes X\_ITE more specification conform.
 
 {% capture notice-text %}
 #### Bug Fixes
@@ -885,7 +940,7 @@ element .on ("load", function () { console .log ("load, yeah"); });
 
 ## X\_ITE v4.2.6 Released
 
-*Leipzig, 14th Oktober 2018:* With this version, X\_ITE includes a new polygon tessellator, ie. X\_ITE can better render concave polygons witch also affects polygon font support, which is now even better.
+*Leipzig, 14th October 2018:* With this version, X\_ITE includes a new polygon tessellator, ie. X\_ITE can better render concave polygons witch also affects polygon font support, which is now even better.
 
 {% capture notice-text %}
 #### New Features
@@ -908,7 +963,7 @@ element .on ("load", function () { console .log ("load, yeah"); });
 
 ## X\_ITE v4.2.5 Released
 
-*Leipzig, 1st Oktober 2018:* This version fixes loads of bugs and added loads of small Features.
+*Leipzig, 1st October 2018:* This version fixes loads of bugs and added loads of small Features.
 
 {% capture notice-text %}
 #### New Features

package/docs/_config.yml

@@ -20,7 +20,7 @@ github: [metadata]
 author:
   name: *title
   avatar: "assets/images/logo.png"
-  bio: "Version 4.7.5"
+  bio: "Version 4.7.9"
   links:
     - label: "GitHub"
       icon: "fab fa-2x fa-fw fa-github"

package/docs/index.md

@@ -8,7 +8,7 @@ X3D is an ISO-ratified, royalty-free open standards file format and run-time arc
 
 X\_ITE supports custom shaders, clip planes, reflection mapping, script nodes, prototyping capabilities and event driven programming to provide you with an improved quality level of virtual effects and tools ready for the Internet.
 
-**Developer note:** X\_ITE runs best in fresh installs of Google Chrome, Chromium, Firefox, Safari, Opera, and Microsoft Edge. X\_ITE uses the latest JavaScript standard, but is also compatible with older browser, and is either now available on your desktop computer or on your modern smart-phone.
+**Developer note:** X\_ITE runs best in fresh installs of Google Chrome, Chromium, Firefox, Safari, Opera, and Microsoft Edge. X\_ITE uses the latest JavaScript standard, but is also compatible with older browser, and is available both on your desktop computer and on your modern smart-phone.
 {: .notice--info}
 
 If you ever get in trouble, please [file a bug](https://github.com/create3000/x_ite/issues).
@@ -804,6 +804,18 @@ There is a ZIP archive available to locally install X\_ITE on your server. Compr
 
 [Download X\_ITE ZIP archive](https://create3000.github.io/code/x_ite/latest/dist/x_ite.zip)
 
+### You also can get it on NPM
+
+```sh
+$ npm install x_ite
+```
+
+It can be used in [Electron](https://www.electronjs.org) apps in the **renderer process** like this:
+
+```js
+const X3D = require ("x_ite")
+```
+
 ### Using X\_ITE with a CDN
 
 CDNs can offer a performance benefit by hosting X\_ITE on servers spread across the globe. This also offers an advantage that if the visitor to your webpage has already downloaded a copy of X\_ITE from the same CDN, it won't have to be re-downloaded. To use the X\_ITE CDN, just reference the CSS and JavaScript file in the script tag directly from the GitHub CDN or jsDelivr CDN domain.
@@ -812,22 +824,22 @@ CDNs can offer a performance benefit by hosting X\_ITE on servers spread across
 
 GitCDN serves raw files directly from GitHub with proper Content-Type headers and a super fast CDN!
 
-#### Snipped
+#### Latest Stable Version
 
-If you are on production and everything works fine, then use a numbered version.
+If you are a developer or you always wanna be up to date:
 
 ```html
-<link rel="stylesheet" type="text/css" href="https://create3000.github.io/code/x_ite/4.7.5/dist/x_ite.css"/>
-<script type="text/javascript" src="https://create3000.github.io/code/x_ite/4.7.5/dist/x_ite.min.js"></script>
+<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>
 ```
 
-#### Latest Stable Version
+#### Snipped
 
-If you are a developer or you always wanna be up to date:
+If you are on production and everything works fine, then use a numbered version.
 
 ```html
-<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>
+<link rel="stylesheet" type="text/css" href="https://create3000.github.io/code/x_ite/4.7.9/dist/x_ite.css"/>
+<script type="text/javascript" src="https://create3000.github.io/code/x_ite/4.7.9/dist/x_ite.min.js"></script>
 ```
 
 ### jsDelivr CDN
@@ -972,11 +984,6 @@ A Boolean value (`true` or `false`) to indicate whether the splash screen should
 A String value with the URL that should be loaded on page load. If no src attribute is specified or the src attribute is empty an empty scene is displayed.
 {: .notice}
 
-### timings
-
-A Boolean value (`true` or `false`) to indicate whether the browser timings bubble should be displayed if the context menu option is enabled. The default value for the timings attribute is `true`. This attribute changes the facility whether browsers timings can be displayed, if browser timings are really displayed is in the hand of the user if he toggles the context menu option to true.
-{: .notice}
-
 ### url
 
 A MFString value with urls that should be loaded on page load. If no url attribute is specified or the attribute is empty an empty scene is displayed. If both src and url attribute are specified the src attribute takes precedence.

package/docs/reference/Browser-Services.md

@@ -44,10 +44,6 @@ The real type of this class is dependent on whether the user code is inside a pr
 
 ### Methods
 
-#### X3DScene **createScene** (\[*ProfileInfo profile, ComponentInfo component1, ...*\])
-
-Creates a new scene with the given profile and components.
-
 #### void **replaceWorld** (*X3DScene*)
 
 Replace the current world with this new scene that has been loaded or constructed from somewhere.
@@ -62,9 +58,9 @@ Parse the passed URL into a X3D scene. When complete send the passed event to th
 
 If event and node are omitted a X3DScene object is returned.
 
-#### void **loadURL** (*MFString url, MFString parameter*)
+#### Promise **loadURL** (*MFString url \[, MFString parameter\]*)
 
-Load the passed URL, using the passed parameter string to possibly redirect it to another frame. If the destination is the frame containing the current scene, this method may never return.
+Load the passed URL, using the passed parameter string to possibly redirect it to another frame. If the destination is the frame containing the current scene, this method may never return. The return value is a Promise object, that is resolved when the new scene is loaded.
 
 #### X3DScene **importDocument** (*DOMObject dom*)
 
@@ -158,7 +154,13 @@ Returns a browser option with the corresponding name.
          <td>Dashboard</td>
          <td>Display browser navigation user interface.</td>
          <td>Boolean</td>
-         <td>Specified by bound NavigationInfo in content</td>
+         <td>true</td>
+      </tr>
+      <tr>
+         <td>Rubberband</td>
+         <td>Display a rubberband line when walk or fly.</td>
+         <td>Boolean</td>
+         <td>true</td>
       </tr>
       <tr>
          <td>EnableInlineViewpoints</td>
@@ -220,6 +222,12 @@ Returns a browser option with the corresponding name.
          <td>Boolean</td>
          <td>false</td>
       </tr>
+      <tr>
+         <td>Timings</td>
+         <td>Whether browser timings should be displayed.</td>
+         <td>Boolean</td>
+         <td>false</td>
+      </tr>
    </tbody>
 </table>
 
@@ -322,7 +330,23 @@ Prints *object* to the browser's console without a newline character. Successive
 
 Prints *object* to the browser's console, inserting a newline character after the output. Successive calls to this function will result in each output presented on separate lines. The output is the implicit call to the object's `toString ()` function.
 
-### More Methods
+### VRML Methods
+
+#### String **getName** ()
+
+#### String **getVersion** ()
+
+#### Number **getCurrentSpeed** ()
+
+#### Number **getCurrentFrameRate** ()
+
+#### String **getWorldURL** ()
+
+#### void **replaceWorld** (*MFNode nodes*)
+
+#### MFNode **createVrmlFromString** (*String vrmlSyntax*)
+
+#### void **createVrmlFromURL** (*MFString url, SFNode node, String event*)
 
 #### void **addRoute** (*SFNode sourceNode, String sourceField, SFNode destinationNode, String destinationField*)
 
@@ -331,3 +355,7 @@ Add a route from the passed *sourceField* to the passed *destinationField*.
 #### void **deleteRoute** (*SFNode sourceNode, String sourceField, SFNode destinationNode, String destinationField*)
 
 Remove the route between the passed *sourceField* and passed *destinationField*, if one exists.
+
+#### void **loadURL** (*MFString url \[, MFString parameter\]*)
+
+#### void **setDescription** (*String description*)

package/docs/reference/Script-Node-Authoring-Interface.md

@@ -313,14 +313,22 @@ The script can access any inputOutput field, inputOnly fields or outputOnly fiel
 DEF SomeNode Transform { }
 
 Script {
-  inputOnly      SFVec3f pos
-  initializeOnly SFNode  node USE SomeNode
+  inputOnly      SFVec3f    set_pos
+  inputOutput    SFRotation rot
+  initializeOnly SFNode     node USE SomeNode
   url "ecmascript:
 ...
 
-function pos (value)
+// Callback for 'inputOnly SFVec3f set_pos'.
+function set_pos (value)
 {
-  node .set_translation = value;
+  node .translation = value;
+}
+
+// Callback for 'inputOutput SFRotation rot'.
+function set_rot (value)
+{
+  node .rotation = value;
 }
   "
   directOutput TRUE

package/package.json

@@ -1,9 +1,9 @@
 {
 	"name": "x_ite",
-	"version": "4.7.5",
-	"revision": "1122",
+	"version": "4.7.9",
+	"revision": "1135",
 	"description": "X_ITE X3D Browser, a framework for integrating and manipulating X3D and VRML scenes in HTML.",
-	"main": "src/x_ite.js",
+	"main": "dist/x_ite.js",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/create3000/x_ite.git"
@@ -12,9 +12,14 @@
 		"X3D",
 		"VRML",
 		"WebGL",
-		"browser"
+		"browser",
+		"3D",
+		"wrl",
+		"JavaScript",
+		"JSON",
+		"xite"
 	],
-	"author": "Holger Seelig <holger.seelig@yahoo.de>",
+	"author": "Holger Seelig <holger.seelig@gmail.com>",
 	"license": "GPL-3.0",
 	"homepage": "https://create3000.github.io/x_ite/",
 	"contributors": [
@@ -59,12 +64,14 @@
 		"require": "^0.4.4",
 		"requirejs": ">=2.3.6",
 		"requirejs-text": ">=2.0.15",
-		"sprintf-js": ">=1.1.2",
 		"uglify-js-es6": ">=2.8.9"
 	},
 	"scripts": {
 		"lint": "jshint **",
 		"build": "make",
 		"-prebuild:js": "npm run lint"
+	},
+	"dependencies": {
+		"sprintf-js": "^1.1.2"
 	}
 }

package/src/assets/components/picking.js

@@ -45,6 +45,7 @@
  *
  ******************************************************************************/
 
+
 define ([
 	"x_ite/Components",
 	"x_ite/Components/Picking/LinePickSensor",
@@ -54,7 +55,7 @@ define ([
 	"x_ite/Components/Picking/VolumePickSensor",
 	"x_ite/Components/Picking/X3DPickSensorNode",
 	"x_ite/Components/Picking/X3DPickableObject",
-	X3D .getComponentUrl ("rigid-body-physics"),
+	require .getComponentUrl ("rigid-body-physics"),
 ],
 function (Components,
           LinePickSensor,
@@ -84,4 +85,3 @@ function (Components,
 		},
 	});
 });
-

package/src/assets/components/volume-rendering.js

@@ -65,8 +65,8 @@ define ([
 	"x_ite/Components/VolumeRendering/X3DComposableVolumeRenderStyleNode",
 	"x_ite/Components/VolumeRendering/X3DVolumeDataNode",
 	"x_ite/Components/VolumeRendering/X3DVolumeRenderStyleNode",
-	X3D .getComponentUrl ("cad-geometry"),
-	X3D .getComponentUrl ("texturing-3d"),
+	require .getComponentUrl ("cad-geometry"),
+	require .getComponentUrl ("texturing-3d"),
 ],
 function (Components,
           X3DVolumeRenderingContext,

package/src/assets/shaders/webgl1/FallbackUnlit.fs

@@ -12,11 +12,10 @@ varying vec4 color;
 void
 main ()
 {
-	vec4 textureColor = x3d_NumTextures > 0 ? texture2D (x3d_Texture2D [0], texCoord .st) : vec4 (1.0);
-	vec4 finalColor   = vec4 (0.0);
+	vec4 finalColor = x3d_NumTextures > 0 ? texture2D (x3d_Texture2D [0], texCoord .st) : vec4 (1.0);
 
-	finalColor .rgb += x3d_Material .emissiveColor;
-	finalColor .a    = textureColor .a * color .a * (1.0 - x3d_Material .transparency);
+	finalColor .rgb *= x3d_Material .emissiveColor;
+	finalColor .a   *= color .a * (1.0 - x3d_Material .transparency);
 
 	gl_FragColor = finalColor;
 }

package/src/assets/shaders/webgl1/Gouraud.vs

@@ -11,7 +11,6 @@ uniform bool x3d_ColorMaterial; // true if a X3DColorNode is attached, otherwise
 
 uniform int x3d_NumLights;
 uniform x3d_LightSourceParameters x3d_LightSource [x3d_MaxLights];
-uniform bool x3d_SeparateBackColor;
 uniform x3d_MaterialParameters x3d_Material;
 
 attribute float x3d_FogDepth;

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

@@ -12,7 +12,6 @@ uniform float x3d_AlphaCutoff;
 
 uniform int x3d_NumLights;
 uniform x3d_LightSourceParameters x3d_LightSource [x3d_MaxLights];
-uniform bool x3d_SeparateBackColor;
 uniform x3d_MaterialParameters x3d_Material;
 
 varying float fogDepth;    // fog depth

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

@@ -10,9 +10,6 @@ uniform int   x3d_GeometryType;
 uniform bool  x3d_ColorMaterial; // true if a X3DColorNode is attached, otherwise false
 uniform float x3d_AlphaCutoff;
 
-uniform int x3d_NumLights;
-uniform x3d_LightSourceParameters x3d_LightSource [x3d_MaxLights];
-uniform bool x3d_SeparateBackColor;
 uniform x3d_MaterialParameters x3d_Material;
 
 varying float fogDepth;    // fog depth

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

@@ -12,7 +12,6 @@ uniform bool x3d_ColorMaterial; // true if a X3DColorNode is attached, otherwise
 
 uniform int x3d_NumLights;
 uniform x3d_LightSourceParameters x3d_LightSource [x3d_MaxLights];
-uniform bool x3d_SeparateBackColor;
 uniform x3d_MaterialParameters x3d_Material;
 
 in float x3d_FogDepth;

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

@@ -9,7 +9,6 @@ uniform float x3d_AlphaCutoff;
 
 uniform int x3d_NumLights;
 uniform x3d_LightSourceParameters x3d_LightSource [x3d_MaxLights];
-uniform bool x3d_SeparateBackColor;
 uniform x3d_MaterialParameters x3d_Material;
 
 in float fogDepth;    // fog depth

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

@@ -7,9 +7,6 @@ uniform int   x3d_GeometryType;
 uniform bool  x3d_ColorMaterial; // true if a X3DColorNode is attached, otherwise false
 uniform float x3d_AlphaCutoff;
 
-uniform int x3d_NumLights;
-uniform x3d_LightSourceParameters x3d_LightSource [x3d_MaxLights];
-uniform bool x3d_SeparateBackColor;
 uniform x3d_MaterialParameters x3d_Material;
 
 in float fogDepth;    // fog depth

package/src/bookmarks.js

@@ -47,7 +47,7 @@
  ******************************************************************************/
 
 
-var Bookmarks = (function ()
+const Bookmarks = (function ()
 {
 "use strict";
 
@@ -61,16 +61,13 @@ var Bookmarks = (function ()
 	{
 		setup: function (array)
 		{
-			for (var a = 0; a < array .length; ++ a)
+			for (const bookmarks of array)
 			{
-				var
-					bookmarks = array [a],
-					server    = bookmarks .server;
+				const server = bookmarks .server;
 
-				for (var i = 0, length = bookmarks .length; i < length; ++ i)
+				for (const bookmark of bookmarks)
 				{
-					var
-						bookmark  = bookmarks [i],
+					const
 						component = bookmark .component,
 						test      = bookmark .test,
 						path      = bookmark .path;
@@ -91,8 +88,8 @@ var Bookmarks = (function ()
 						if (! path .match (/\.(?:x3d|x3dz|x3dv|x3dvz|x3dj|x3djz|wrl|wrz)$/))
 							continue;
 
-						var basename = path .match (/([^\/]+)\.\w+$/);
-						var name     = basename [1] .replace (/([A-Z]+)/g, ' $1');
+						const basename = path .match (/([^\/]+)\.\w+$/);
+						const name     = basename [1] .replace (/([A-Z]+)/g, ' $1');
 
 						var element = $('<span/>')
 							.addClass ('example-box')
@@ -126,7 +123,7 @@ var Bookmarks = (function ()
 		},
 		restore: function (first)
 		{
-			var url = this .browser .getLocalStorage () ["Bookmarks.url"];
+			const url = this .browser .getLocalStorage () ["Bookmarks.url"];
 
 			if (url)
 				this .loadURL (url);

package/src/examples.js

@@ -1,4 +1,4 @@
-var X_ITE_EXAMPLES = [
+const X_ITE_EXAMPLES = [
 	{ component: "CADGeometry", test: "QuadSet" },
 	{ component: "CubeMapTexturing", test: "ComposedCubeMapTexture" },
 	{ component: "CubeMapTexturing", test: "GeneratedCubeMapTexture" },