x_ite 8.3.1 → 8.3.3

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

@@ -802,41 +802,9 @@ An integer containing the number of elements in the array. Assigning an integer
 
 Returns true if the passed MF* *array* of the same type is equals to this object, otherwise false.
 
-#### SF* **pop** ()
+#### Other Array functions
 
-The `pop` method removes the last element from an array and returns that value to the caller. The return value is the removed element from the array; `undefined` if the array is empty.
-
-#### Number **push** (*element1 [, ..., elementN]*)
-
-The `push` method appends values to an array. The return value is the new length of the object upon which the method was called.
-
-#### SF* **shift** ()
-
-The `shift` method removes the first element from an array and returns that value to the caller. The return value is the removed element from the array; `undefined` if the array is empty.
-
-#### Array **splice** (*start [, deleteCount, [item1, item2, ...]]*)
-
-#### start
-
-Index at which to start changing the array (with origin 0). If greater than the length of the array, actual starting index will be set to the length of the array. If negative, will begin that many elements from the end of the array (with origin 1) and will be set to 0 if absolute value is greater than the length of the array.
-
-#### deleteCount *optional*
-
-An integer indicating the number of old array elements to remove. If *deleteCount* is 0, no elements are removed. In this case, you should specify at least one new element. If *deleteCount* is greater than the number of elements left in the array starting at start, then all of the elements through the end of the array will be deleted.
-
-If *deleteCount* is omitted, or if its value is larger than array.length - start, then all of the elements beginning with start index on through the end of the array will be deleted.
-
-#### item1, item2, ... *optional*
-
-The elements to add to the array, beginning at the start index. If you don't specify any elements, `splice` will only remove elements from the array.
-
-#### Return value
-
-An MF* array containing the deleted elements. If only one element is removed, an array of one element is returned. If no elements are removed, an empty array is returned.
-
-#### Number **unshift** (*element1 [, ..., elementN]*)
-
-The `unshift` method inserts the given values to the beginning of an X3DArrayField object. The return value is the new length of the object upon which the method was called.
+Common Array functions like `at`, `concat`, `entries`, `every`, `fill`, `filter`, `find`, `findIndex`, `findLast`, `findLastIndex`, `flat`, `flatMap`, `forEach`, `includes`, `indexOf`, `join`, `keys`, `lastIndexOf`, `map`, `pop`, `push`, `reduce`, `reduceRight`, `shift`, `slice`, `some`, `splice`, `unshift`, `values` are also available.
 
 ## MFBool Object
 

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

@@ -144,14 +144,25 @@ Creates or updates the exported node *exportedName.*
 
 Removes the exported node *exportedName.*
 
-#### String **toVRMLString** ()
+#### String **toVRMLString** (\[options\])
 
 Returns the X3D VRML-encoded string that, if parsed as the value of createX3DFromString () of X3DBrowser, produce this scene.
 
-#### String **toXMLString** ()
+##### Options
+
+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)
+
+#### String **toXMLString** (\[options\])
 
 Returns the X3D XML-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/tutorials/basic-nodes.md

@@ -28,7 +28,7 @@ Here is a typical X3D Classic Encoded file with a single node:
 
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>
-<X3D profile='Full' version='4.0' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-4.0.xsd'>
+<X3D profile='Full' version='{{ site.x3d_latest_version }}' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-{{ site.x3d_latest_version }}.xsd'>
   <Scene>
     <PlaneSensor DEF='Sensor'
         offset='0 2 0'/>
@@ -46,7 +46,7 @@ Here is a typical X3D Classic Encoded file with a single node:
 ### Classic Encoding
 
 ```js
-#X3D V4.0 utf8
+#X3D V{{ site.x3d_latest_version }} utf8
 
 # A sample file with a simple scene
 

package/docs/_posts/tutorials/building-a-x3d-world.md

@@ -23,7 +23,7 @@ X3D files contain:
 
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>
-<X3D profile='Full' version='4.0' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-4.0.xsd'>
+<X3D profile='Full' version='{{ site.x3d_latest_version }}' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-{{ site.x3d_latest_version }}.xsd'>
   <Scene>
   <!-- A Cylinder -->
   <Shape>
@@ -41,7 +41,7 @@ X3D files contain:
 ### Classic Encoding
 
 ```js
-#X3D V4.0 utf8
+#X3D V{{ site.x3d_latest_version }} utf8
 # A Cylinder
 Shape {
   appearance Appearance {
@@ -64,10 +64,10 @@ Shape {
 
 ## Understanding the header
 
-**\#X3D V4.0 utf8**
+**\#X3D V{{ site.x3d_latest_version }} utf8**
 
 - **\#X3D:** File contains X3D text
-- **V4.0 :** Text conforms to version 4.0 syntax
+- **V{{ site.x3d_latest_version }} :** Text conforms to version {{ site.x3d_latest_version }} syntax
 - **utf8 :** Text uses UTF8 character set
 
 ## Understanding UTF8
@@ -150,9 +150,25 @@ Every field has:
 - Fields can be listed in any order
   - The order doesn't affect the node
 
+## Placing nodes
+
+Every node has a »containerField« attribute with a default value, which is different for each node type. You can change the value if needed.
+
+```xml
+<Collision>
+  <Shape containerField='proxy'>
+    <Box/>
+  </Shape>
+  <Transform>
+    <!-- ... -->
+  </Transform>
+</Collision>
+```
+
 ## Summary
 
 - The file header gives the version and encoding
 - Nodes describe scene content
 - Fields and values specify node attributes
+- containerField attribute can be changed.
 - Everything is case sensitive

package/docs/_posts/tutorials/building-primitive-shapes.md

@@ -100,7 +100,7 @@ Text { ... }
 
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>
-<X3D profile='Full' version='4.0' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-4.0.xsd'>
+<X3D profile='Full' version='{{ site.x3d_latest_version }}' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-{{ site.x3d_latest_version }}.xsd'>
   <Scene>
     <Shape>
       <Appearance>
@@ -116,7 +116,7 @@ Text { ... }
 ### Classic Encoding
 
 ```js
-#X3D V4.0 utf8
+#X3D V{{ site.x3d_latest_version }} utf8
 # A cylinder
 Shape {
   appearance Appearance {
@@ -149,7 +149,7 @@ Shape {
 
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>
-<X3D profile='Full' version='4.0' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-4.0.xsd'>
+<X3D profile='Full' version='{{ site.x3d_latest_version }}' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-{{ site.x3d_latest_version }}.xsd'>
   <Scene>
     <Shape>
       <Appearance>
@@ -173,7 +173,7 @@ Shape {
 ### Classic Encoding
 
 ```js
-#X3D V4.0 utf8
+#X3D V{{ site.x3d_latest_version }} utf8
 
 Shape {
   appearance Appearance {

package/docs/_posts/tutorials/creating-new-node-types.md

@@ -153,10 +153,15 @@ The new node type can be used like any other type.
 ### XML Encoding
 
 ```xml
+<!-- Official Syntax -->
 <ProtoInstance name='BouncingBall'>
   <fieldValue name='cycleInterval' value='2'/>
   <fieldValue name='bounceHeight' value='3'/>
 </ProtoInstance>
+<!-- Short Syntax -->
+<BouncingBall
+    cycleInterval='2'
+    bounceHeight='3'/>
 ```
 
 ### Classic Encoding
@@ -184,6 +189,23 @@ For example, if the first node is a geometry node:
 
 The new node type can be used wherever the first node of the prototype body can be used.
 
+- In XML the default value of the »containerField« attribute of a ProtoInstance element is »children«. Change this attribute to whatever value you need.
+
+### XML Encoding
+
+```xml
+<Shape>
+  <!-- Official Syntax -->
+  <ProtoInstance name='Torus' containerField='geometry'>
+    <!-- ... -->
+  </ProtoInstance>
+</Shape>
+<Shape>
+  <!-- Short Syntax -->
+  <Torus containerField='geometry' .../>
+</Shape>
+```
+
 ## A sample prototype use
 
 Create a **BouncingBall** node type that:

package/docs/_posts/tutorials/hello-world.md

@@ -31,7 +31,7 @@ As first a very easy example, we will create a sphere with a texture and a text
 
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>
-<X3D profile='Full' version='4.0' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-4.0.xsd'>
+<X3D profile='Full' version='{{ site.x3d_latest_version }}' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-{{ site.x3d_latest_version }}.xsd'>
   <Scene>
     <Transform>
       <Shape>
@@ -45,7 +45,7 @@ As first a very easy example, we will create a sphere with a texture and a text
 ### Classic Encoding
 
 ```js
-#X3D V4.0 utf8
+#X3D V{{ site.x3d_latest_version }} utf8
 
 Transform {
   children Shape {
@@ -62,7 +62,7 @@ Now we have a sphere, but we don't see if it is rotating, let's assign a texture
 
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>
-<X3D profile='Full' version='4.0' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-4.0.xsd'>
+<X3D profile='Full' version='{{ site.x3d_latest_version }}' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-{{ site.x3d_latest_version }}.xsd'>
   <Scene>
     <Transform>
       <Shape>
@@ -80,7 +80,7 @@ Now we have a sphere, but we don't see if it is rotating, let's assign a texture
 ### Classic Encoding
 
 ```js
-#X3D V4.0 utf8
+#X3D V{{ site.x3d_latest_version }} utf8
 
 Transform {
   children Shape {
@@ -119,7 +119,7 @@ Now the sphere looks like an earth and you are very curious how the text will be
 
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>
-<X3D profile='Full' version='4.0' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-4.0.xsd'>
+<X3D profile='Full' version='{{ site.x3d_latest_version }}' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-{{ site.x3d_latest_version }}.xsd'>
   <Scene>
     <Viewpoint
         description='Home'
@@ -155,7 +155,7 @@ Now the sphere looks like an earth and you are very curious how the text will be
 ### Classic Encoding
 
 ```js
-#X3D V4.0 utf8
+#X3D V{{ site.x3d_latest_version }} utf8
 
 META "title" "about:hello_world"
 

package/docs/_posts/tutorials/improving-performance.md

@@ -76,7 +76,7 @@ Prototyping objects that are used frequently with a few modifications is another
 
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>
-<X3D profile='Full' version='4.0' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-4.0.xsd'>
+<X3D profile='Full' version='{{ site.x3d_latest_version }}' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-{{ site.x3d_latest_version }}.xsd'>
   <head>
     <meta name='comment' content='World of Titania'/>
     <meta name='created' content='Fri, 29 Jun 2018 13:24:34 GMT'/>
@@ -148,7 +148,7 @@ function set_whichChoice (value)
 ### Classic Encoding
 
 ```js
-#X3D V4.0 utf8 Titania V4.3.0
+#X3D V{{ site.x3d_latest_version }} utf8
 
 PROTO BooleanSwitch [
   inputOutput    SFBool  whichChoice FALSE

package/docs/_posts/tutorials/writing-program-scripts-with-ecmascript.md

@@ -337,7 +337,7 @@ ROUTE Bouncer.value_changed  TO Ball.set_translation
 
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>
-<X3D profile='Full' version='4.0' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-4.0.xsd'>
+<X3D profile='Full' version='{{ site.x3d_latest_version }}' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-{{ site.x3d_latest_version }}.xsd'>
   <Scene>
     <Transform DEF='Ball'>
       <Shape>
@@ -390,7 +390,7 @@ function set_fraction (fraction, time)
 ### Classic Encoding
 
 ```js
-#X3D V4.0 utf8 Titania V4.3.0
+#X3D V{{ site.x3d_latest_version }} utf8
 
 DEF Ball Transform {
   children [

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

@@ -5,6 +5,24 @@ nav: main
 categories: []
 tags: [new, releases]
 ---
+## X_ITE v8.3.3 Released
+
+### New Features
+
+- Added to*String options (scene, style, precision, doublePrecision).
+- Added output styles (CLEAN, SMALL, COMPACT, TIDY).
+- Prefer PROTO's during parse.
+- Collect joint nodes if no provided (HAnim).
+- Relaxed VRML parser (parse top level statements in MFNode).
+- XML short syntax of prototype instances.
+
+### Bug Fixes
+
+- Fixed bug when floating point numbers are printed.
+- Fixed bug when MFImage is printed.
+- Fixed component's highest levels.
+- Fixed double count of headlight.
+
 ## X_ITE v8.3.0 Released
 
 *Leipzig, 14st December 2022:* We right now released a new version.
@@ -512,7 +530,7 @@ This release also increased pure rendering speed (without routing and scripting)
 - Fixed picking and Layout node.
 - Fixed bug with composite glyphs in Text node.
 - Fixed bug with data URLs.
-- Fixed bug in toXMLString and toVRMLString when outputing protos.
+- Fixed bug in toXMLString and toVRMLString when outputting protos.
 
 ## X_ITE v4.4.7 Released
 
@@ -552,7 +570,7 @@ This release also increased pure rendering speed (without routing and scripting)
 - Fixed bug when parsing SFMatrix3d/f values.
 - Fixed bug when parsing data URLs.
 - Fixed shadow handling.
-- Fixed bug in MF\* fields pop and shift.
+- Fixed bug in MF* fields pop and shift.
 
 ## X_ITE v4.4.3 Released
 
@@ -879,7 +897,7 @@ You can tune the *shadowIntensity*. It is the intensity of the shadow. 0 means n
 - Optimizations in IndexedQuadSet and QuadSet
 - Optimized CoordinateInterpolator, NormalInterpolator, and CoordinateInterpolator2D
 - Support for more textures for custom shaders
-- New »StraigtenHorizon« browser option
+- New »StraightenHorizon« browser option
 - Better rendering of Text in some cases
 
 ### Bug Fixes

package/docs/_tabs/playground.html

@@ -5,7 +5,7 @@ order: 3
 icon: fas fa-rocket
 ---
 <style>
-.row, .post, .post-content {
+.post, .post-content {
    height: 100%;
 }
 
@@ -15,24 +15,68 @@ icon: fas fa-rocket
 
 /* Table */
 
-table {
-  width: 100%;
-  height: 100%;
-  table-layout: fixed;
+.row {
+  display: flex;
+  height: calc(100vh - 180px);
 }
 
-table td {
-   width: 50%;
-   vertical-align: top;
+.column {
+  flex: 50%;
+  width: 50%;
+  height: 100%;
 }
 
 /* Editor */
 
+html {
+   --editor-background: rgba(0,0,0,0.2);
+   --editor-gutter: rgba(255,255,255,0.05);
+   --editor-active-line: #202d40;
+   --editor-selected-word: #274f79;
+   --xml-tag: var(--text-color);
+   --xml-tag-name: #5a9cd8;
+   --xml-attribute-name: #9fdcfe;
+   --xml-attribute-equals: #d4d4d4;
+   --xml-attribute-value: #cd9177;
+   --json-parenthesis: #fdd601;
+   --json-identifier: #9fdcfe;
+   --json-variable: #9fdcfe;
+   --json-numeric: #b7cea5;
+   --json-string: #cd9177;
+   --json-boolean: #5a9cd8;
+   --json-punctuation: #d4d4d4;
+   --system-red: rgb(255, 69, 58);
+   --system-yellow: rgb(255, 214, 10);
+   --system-blue: rgb(10, 132, 255);
+}
+
+html[data-mode=light] {
+   --editor-background: rgba(0,0,0,0.01);
+   --editor-gutter: #f3f3f3;
+   --editor-active-line: #d7e5f8;
+   --editor-selected-word: #aed6ff;
+   --xml-tag: var(--text-color);
+   --xml-tag-name: #7e0000;
+   --xml-attribute-name: #e20200;
+   --xml-attribute-equals: #000000;
+   --xml-attribute-value: #1000ff;
+   --json-parenthesis: #369327;
+   --json-identifier: #1251a6;
+   --json-variable: #1251a6;
+   --json-numeric: #1e8657;
+   --json-string: #a01515;
+   --json-boolean: #1000ff;
+   --json-punctuation: #000000;
+   --system-red: rgb(255, 59, 48);
+   --system-yellow: rgb(255, 204, 0);
+   --system-blue: rgb(0, 122, 255);
+}
+
 #editor, .console {
    outline: none;
    border: none;
    padding: 0.5rem;
-   background: rgba(0,0,0,0.2);
+   background: var(--editor-background);
    width: 100%;
    height: 100%;
    resize: none;
@@ -42,64 +86,88 @@ table td {
    white-space: pre;
 }
 
+.console {
+   height: 50%;
+}
+
+.post x3d-canvas {
+   display: block;
+   width: 100%;
+   height: 50%;
+   aspect-ratio: unset;
+}
+
 .ace_gutter {
-   background: rgba(255,255,255,0.05) !important;
+   background: var(--editor-gutter) !important;
+}
+
+.ace_gutter-active-line,
+.ace_active-line {
+   background: var(--editor-active-line) !important;
+}
+
+.ace_selected-word,
+.ace_selection {
+   border: none !important;
+   background: var(--editor-selected-word) !important;
 }
 
 /* XML */
 
 .ace_tag-open, .ace_tag-close, .ace_end-tag-open {
-   color: var(--text-color) !important;
+   color: var(--xml-tag) !important;
 }
 
 .ace_tag-name {
-   color: #5a9cd8 !important;
+   color: var(--xml-tag-name) !important;
 }
 
 .ace_attribute-name {
-   color: #9fdcfe !important;
+   color: var(--xml-attribute-name) !important;
 }
 
 .ace_attribute-equals {
-   color: #d4d4d4 !important;
+   color: var(--xml-attribute-equals) !important;
 }
 
 .ace_attribute-value {
-   color: #cd9177 !important;
+   color: var(--xml-attribute-value) !important;
 }
 
 /* JSON */
 
 .ace_paren {
-   color: #fdd601 !important;
+   color: var(--json-parenthesis) !important;
 }
 
 .ace_identifier {
-   color: #9fdcfe !important;
+   color: var(--json-identifier) !important;
 }
 
 .ace_variable {
-   color: #9fdcfe !important;
+   color: var(--json-variable) !important;
 }
 
-.ace_numeric {
-   color: #b7cea5 !important;
+.ace_numeric,
+.ace_keyword.ace_operator {
+   color: var(--json-numeric) !important;
 }
 
 .ace_string {
-   color: #cd9177 !important;
+   color: var(--json-string) !important;
 }
 
 .ace_boolean {
-   color: #5a9cd8 !important;
+   color: var(--json-boolean) !important;
+}
+
+.ace_punctuation.ace_operator {
+   color: var(--json-punctuation) !important;
 }
 
 /* Console */
 
 .console {
-   --system-red: rgb(255, 69, 58);
-   --system-yellow: rgb(255, 214, 10);
-   --system-blue: rgb(10, 132, 255);
    overflow: scroll;
 }
 
@@ -107,21 +175,13 @@ span.info {
    color: var(--system-blue);
 }
 
-span.warning {
+span.warn {
    color: var(--system-yellow);
 }
 
 span.error {
    color: var(--system-red);
 }
-
-/* Canvas */
-
-.post x3d-canvas {
-   width: 100%;
-   height: 100%;
-   aspect-ratio: unset;
-}
 </style>
 
 <pre style="display:none">
@@ -182,7 +242,7 @@ $(function ()
       <Shape>
          <Appearance>
             <Material
-               diffuseColor='0 0.5 1'></Material>
+                  diffuseColor='0 0.5 1'></Material>
          </Appearance>
          <Box></Box>
       </Shape>
@@ -211,6 +271,9 @@ $(function ()
                text    = Array .prototype .slice .call (args) .join ("") + "\n",
                element = $("<span></span>") .addClass (classes) .text (text);
 
+            if (text .includes ("No suitable"))
+               return;
+
             log .apply (this, args);
 
             $(".console") .append (element);
@@ -219,28 +282,18 @@ $(function ()
       }
    }
 
-   console .log     = output (console .log,     "log");
-   console .info    = output (console .info,    "info");
-   console .warning = output (console .warning, "warning");
-   console .error   = output (console .error,   "error");
-   console .debug   = output (console .debug,   "debug");
+   console .log   = output (console .log,   "log");
+   console .info  = output (console .info,  "info");
+   console .warn  = output (console .warn,  "warn");
+   console .error = output (console .error, "error");
+   console .debug = output (console .debug, "debug");
 })();
 </script>
 
-<table>
-   <tr>
-      <td>
-         <table>
-            <tr>
-               <td><x3d-canvas splashScreen="false"></x3d-canvas></td>
-            </tr>
-            <tr>
-               <td><div class="console"></div></td>
-            </tr>
-         </table>
-      </td>
-      <td>
-         <div id="editor"></div>
-      </td>
-   </tr>
-</table>
+<div class="row">
+   <div class="column">
+      <x3d-canvas splashScreen="false"></x3d-canvas>
+      <div class="console"></div>
+   </div>
+   <div class="column"><div id="editor"></div></div>
+</div>