x_ite 8.3.3 → 8.4.1

package/docs/_config.yml

@@ -20,8 +20,8 @@ timezone:
 # ↓ --------------------------
 
 title: X_ITE X3D Browser               # the main title
-version: 8.3.3                         # x_ite latest version
-x3d_latest_version: 8.3.3                # x3d latest version
+version: 8.4.1                         # x_ite latest version
+x3d_latest_version: 8.4.1                # x3d latest version
 
 tagline: Step Into The Future          # it will display as the sub-title
 

package/docs/_posts/reference/field-services-and-objects.md

@@ -407,14 +407,24 @@ Returns the node type name.
 
 Removes a field callback function associated with the parameters *name* and *key*.
 
-#### String **toVRMLString** ()
+#### String **toVRMLString** (\[options\])
 
 Returns the X3D VRML-encoded string that, if parsed as the value of an SFNode field, produce this node.
 
-#### String **toXMLString** ()
+For options see X3DScene.toVRMLString.
+
+#### String **toXMLString** (\[options\])
 
 Returns the X3D XML-encoded string that, if parsed as the value of an SFNode field, produce this node.
 
+For options see X3DScene.toVRMLString.
+
+#### String **toJSONString** (\[options\])
+
+Returns the X3D JSON-encoded string that, if parsed as the value of an SFNode field, produce this node.
+
+For options see X3DScene.toVRMLString.
+
 ## SFRotation Object
 
 The SFRotation object corresponds to a X3D SFRotation field.
@@ -966,14 +976,24 @@ An integer containing the number of elements in the array. Assigning an integer
 
 ### Methods
 
-#### String **toVRMLString** ()
+#### String **toVRMLString** (\[options\])
 
 Returns the X3D VRML-encoded string that, if parsed as the value of an MFNode field, produce this node.
 
-#### String **toXMLString** ()
+For options see X3DScene.toVRMLString.
+
+#### String **toXMLString** (\[options\])
 
 Returns the X3D XML-encoded string that, if parsed as the value of an MFNode field, produce this node.
 
+For options see X3DScene.toVRMLString.
+
+#### String **toJSONString** (\[options\])
+
+Returns the X3D JSON-encoded string that, if parsed as the value of an MFNode field, produce this node.
+
+For options see X3DScene.toVRMLString.
+
 ## MFRotation Object
 
 The MFRotation object corresponds to a X3D MFRotation field. It is used to store a one-dimensional array of SFRotation objects. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. *mfRotationObjectName*[*index*], where *index* is an integer-valued expression with 0<=*index*<length and length is the number of elements in the array). Assigning to an element with *index* > length results in the array being dynamically expanded to contain length elements. All elements not explicitly initialized are set to SFRotation (0, 0, 1, 0).

package/docs/_posts/reference/prototype-services.md

@@ -33,14 +33,24 @@ Always has the value of false. This property is read only.
 
 Creates a new default instance of the prototype.
 
-#### String **toVRMLString** ()
+#### String **toVRMLString** (\[options\])
 
 Returns the X3D VRML-encoded string that, if parsed as the value of createX3DFromString () of X3DBrowser, produce this prototype.
 
-#### String **toXMLString** ()
+For options see X3DScene.toVRMLString.
+
+#### String **toXMLString** (\[options\])
 
 Returns the X3D XML-encoded string that, if parsed as the value of createX3DFromString () of X3DBrowser, produce this prototype.
 
+For options see X3DScene.toVRMLString.
+
+#### String **toJSONString** (\[options\])
+
+Returns the X3D JSON-encoded string that, if parsed as the value of createX3DFromString () of X3DBrowser, produce this prototype.
+
+For options see X3DScene.toVRMLString.
+
 ## X3DExternProtoDeclaration
 
 An EXTERNPROTO declaration is represented by the X3DExternProtoDeclaration object. EXTERNPROTO declarations can only be fetched using the X3DExecutionContext object.
@@ -81,14 +91,24 @@ Creates a new default instance of the extern prototype.
 
 Triggers the load of the extern prototype. If the extern prototype is already loaded or the load is already in progress, this request is silently ignored.
 
-#### String **toVRMLString** ()
+#### String **toVRMLString** (\[options\])
 
 Returns the X3D VRML-encoded string that, if parsed as the value of createX3DFromString () of X3DBrowser, produce this extern prototype.
 
-#### String **toXMLString** ()
+For options see X3DScene.toVRMLString.
+
+#### String **toXMLString** (\[options\])
 
 Returns the X3D XML-encoded string that, if parsed as the value of createX3DFromString () of X3DBrowser, produce this extern prototype.
 
+For options see X3DScene.toVRMLString.
+
+#### String **toJSONString** (\[options\])
+
+Returns the X3D JSON-encoded string that, if parsed as the value of createX3DFromString () of X3DBrowser, produce this extern prototype.
+
+For options see X3DScene.toVRMLString.
+
 ## ProtoDeclarationArray
 
 ProtoDeclarationArray is an object that represents an array of X3DProtoDeclaration objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. *protoDeclarationArrayName*[*index*], where *index* is an integer-valued expression with 0\<=*index*\<length and length is the number of elements in the array).

package/docs/_posts/reference/scene-services.md

@@ -152,10 +152,9 @@ Returns the X3D VRML-encoded string that, if parsed as the value of createX3DFro
 
 An object with one or more of these properties:
 
-* **scene:** scene to use for units (default: current scene)
-* **style:** string, output style (one of: **"TIDY"**, "COMPACT", "SMALL", "CLEAN")
-* **precision:** integer, float precision (default: 6)
-* **doublePrecision:** integer, double precision (default: 14)
+* **style:** string, output style, one of: **"TIDY"**, "COMPACT", "SMALL", "CLEAN"
+* **precision:** integer, float precision, default: 6
+* **doublePrecision:** integer, double precision, default: 14
 
 #### String **toXMLString** (\[options\])
 
@@ -163,6 +162,12 @@ Returns the X3D XML-encoded string that, if parsed as the value of createX3DFrom
 
 For options see toVRMLString.
 
+#### String **toJSONString** (\[options\])
+
+Returns the X3D JSON-encoded string that, if parsed as the value of createX3DFromString () of X3DBrowser, produce this scene.
+
+For options see toVRMLString.
+
 ## ProfileInfo
 
 This object stores information about a particular X3D profile.

package/docs/_posts/what's-new.md

@@ -5,8 +5,18 @@ nav: main
 categories: []
 tags: [new, releases]
 ---
+## X_ITE v8.4.0 Released
+
+*Leipzig, 3rd January 2023:* We right now released a new version. With this version toJSONString is implemented and available for X3DScene, SFNode, MFNode, X3DProtoDeclaration, and X3DExternProtoDeclaration.
+
+### New Features
+
+- Implemented toJSONString.
+
 ## X_ITE v8.3.3 Released
 
+*Leipzig, 31st December 2022:* We right now released a new version.
+
 ### New Features
 
 - Added to*String options (scene, style, precision, doublePrecision).
@@ -25,7 +35,7 @@ tags: [new, releases]
 
 ## X_ITE v8.3.0 Released
 
-*Leipzig, 14st December 2022:* We right now released a new version.
+*Leipzig, 14th December 2022:* We right now released a new version.
 
 ### New Features
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "x_ite",
-	"version": "8.3.3",
+	"version": "8.4.1",
 	"description": "X_ITE X3D Browser, view and manipulate X3D and VRML scenes in HTML.",
 	"homepage": "https://create3000.github.io/x_ite/",
 	"author": "Holger Seelig <holger.seelig@gmail.com>",

package/src/x_ite/Base/X3DInfoArray.js

@@ -273,6 +273,32 @@ X3DInfoArray .prototype = {
          }
       }
    },
+   toJSONStream: function (generator, comma)
+   {
+      let lastProperty = false;
+
+      for (const value of this [_array])
+      {
+         try
+         {
+            value .toJSONStream (generator, true);
+
+            generator .string += ',';
+            generator .string += generator .TidyBreak ();
+
+            lastProperty = true;
+         }
+         catch (error)
+         {
+            // console .error (error);
+         }
+      }
+
+      if (lastProperty && !comma)
+         generator .string = generator .string .replace (/,(\s*)$/s, "$1");
+
+      return lastProperty;
+   },
 };
 
 for (const key of Reflect .ownKeys (X3DInfoArray .prototype))

package/src/x_ite/Base/X3DObject.js

@@ -171,7 +171,7 @@ X3DObject .prototype =
       if (options .scene)
          generator .PushExecutionContext (options .scene);
 
-      this .toVRMLStream (generator); // TODO.
+      this .toJSONStream (generator);
 
       return generator .string;
    },

package/src/x_ite/Base/X3DObjectArrayField.js

@@ -533,6 +533,50 @@ X3DObjectArrayField .prototype = Object .assign (Object .create (X3DArrayField .
          generator .PopUnitCategory ();
       }
    },
+   toJSONStream: function (generator)
+   {
+      const
+         target = this [_target],
+         length = target .length;
+
+      if (length)
+      {
+         const value = this .getValue ();
+
+         generator .PushUnitCategory (target .getUnit ());
+
+         generator .string += '[';
+         generator .string += generator .ListBreak ();
+         generator .string += generator .IncIndent ();
+
+         for (let i = 0, n = length - 1; i < n; ++ i)
+         {
+            generator .string += generator .ListIndent ();
+
+            value [i] .toJSONStreamValue (generator);
+
+            generator .string += ',';
+            generator .string += generator .ListBreak ();
+         }
+
+         generator .string += generator .ListIndent ();
+
+         value .at (-1) .toJSONStreamValue (generator);
+
+         generator .string += generator .ListBreak ();
+         generator .string += generator .DecIndent ();
+         generator .string += generator .ListIndent ();
+         generator .string += ']';
+
+         generator .PopUnitCategory ();
+      }
+      else
+      {
+         generator .string += '[';
+         generator .string += generator .TidySpace ();
+         generator .string += ']';
+      }
+   },
    dispose: function ()
    {
       const

package/src/x_ite/Base/X3DTypedArrayField.js

@@ -840,6 +840,80 @@ X3DTypedArrayField .prototype = Object .assign (Object .create (X3DArrayField .p
          generator .PopUnitCategory ();
       }
    },
+   toJSONStream: function (generator)
+   {
+      const
+         target = this [_target],
+         length = target .length;
+
+      if (length)
+      {
+         const
+            array      = target .getValue (),
+            components = target .getComponents (),
+            value      = new (target .getSingleType ()) ();
+
+         generator .PushUnitCategory (target .getUnit ());
+
+         generator .string += '[';
+         generator .string += generator .ListBreak ();
+         generator .string += generator .IncIndent ();
+
+         if (components === 1)
+         {
+            for (let i = 0, n = length - 1; i < n; ++ i)
+            {
+               generator .string += generator .ListIndent ();
+
+               value .set (array [i * components]);
+               value .toJSONStreamValue (generator);
+
+               generator .string += ',';
+               generator .string += generator .ListBreak ();
+            }
+
+            generator .string += generator .ListIndent ();
+
+            value .set (array [(length - 1) * components]);
+            value .toJSONStreamValue (generator);
+         }
+         else
+         {
+            for (let i = 0, n = length - 1; i < n; ++ i)
+            {
+               generator .string += generator .ListIndent ();
+
+               for (let c = 0, first = i * components; c < components; ++ c, ++ first)
+                  value [c] = array [first];
+
+               value .toJSONStreamValue (generator);
+
+               generator .string += ',';
+               generator .string += generator .ListBreak ();
+            }
+
+            generator .string += generator .ListIndent ();
+
+            for (let c = 0, first = (length - 1) * components; c < components; ++ c, ++ first)
+               value [c] = array [first];
+
+            value .toJSONStreamValue (generator);
+         }
+
+         generator .string += generator .ListBreak ();
+         generator .string += generator .DecIndent ();
+         generator .string += generator .ListIndent ();
+         generator .string += ']';
+
+         generator .PopUnitCategory ();
+      }
+      else
+      {
+         generator .string += '[';
+         generator .string += generator .TidySpace ();
+         generator .string += ']';
+      }
+   },
    dispose: function ()
    {
       X3DArrayField .prototype .dispose .call (this [_target]);

package/src/x_ite/Browser/VERSION.js

@@ -45,4 +45,4 @@
  *
  ******************************************************************************/
 
-export default "8.3.3";
+export default "8.4.1";