x_ite 8.0.0 → 8.3.0

package/docs/{reference/Prototype-Services.md → _posts/reference/prototype-services.md}

@@ -1,16 +1,10 @@
 ---
-# Feel free to add content and custom Front Matter to this file.
-# To modify the layout, see https://jekyllrb.com/docs/themes/#overriding-theme-defaults
-
-layout: single
+title: Prototype Services
+date: 2022-11-28
+nav: reference
+categories: [Reference]
+tags: [prototype, services]
 ---
-# Prototype Services
-
-* [X3DProtoDeclaration](#x3dprotodeclaration)
-* [X3DExternProtoDeclaration](#x3dexternprotodeclaration)
-* [ProtoDeclarationArray](#protodeclarationarray)
-* [ExternProtoDeclarationArray](#externprotodeclarationarray)
-
 ## X3DProtoDeclaration
 
 A PROTO declaration is represented by the X3DProtoDeclaration object. This object can only be fetched using the X3DExecutionContext object.
@@ -75,7 +69,7 @@ Always has the value of true. This property is read only.
 
 #### **loadState**
 
-The value is one of the *\_STATE* properties defined in the X3DConstants object. This property is read only.
+The value is one of the *_STATE* properties defined in the X3DConstants object. This property is read only.
 
 ### Methods
 
@@ -97,7 +91,7 @@ Returns the X3D XML-encoded string that, if parsed as the value of createX3DFrom
 
 ## 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).
+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).
 
 ### Instance Creation Method\(s\)
 
@@ -115,7 +109,7 @@ None
 
 ## ExternProtoDeclarationArray
 
-ExternProtoDeclarationArray is an object that represents an array of X3DExternProtoDeclaration objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. *externProtoDeclarationArrayName*\[*index*\], where *index* is an integer-valued expression with 0&lt;=*index*&lt;length and length is the number of elements in the array).
+ExternProtoDeclarationArray is an object that represents an array of X3DExternProtoDeclaration objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. *externProtoDeclarationArrayName*[*index*], where *index* is an integer-valued expression with 0\<=*index*\<length and length is the number of elements in the array).
 
 ### Instance Creation Method\(s\)
 

package/docs/{reference/Route-Services.md → _posts/reference/route-services.md}

@@ -1,14 +1,10 @@
 ---
-# Feel free to add content and custom Front Matter to this file.
-# To modify the layout, see https://jekyllrb.com/docs/themes/#overriding-theme-defaults
-
-layout: single
+title: Route Services
+date: 2022-11-28
+nav: reference
+categories: [Reference]
+tags: [route, services]
 ---
-# Route Services
-
-* [X3DRoute](#x3droute)
-* [RouteArray](#routearray)
-
 ## X3DRoute
 
 Routes are represented by the X3DRoute object. Routes can only be created through calls to the addRoute () function of X3DExecutionContext.
@@ -41,7 +37,7 @@ None.
 
 ## RouteArray
 
-RouteArray is an object that represents an array of X3DRoute objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. *routeArrayName*\[*index*\], where *index* is an integer-valued expression with 0<=*index*<length and length is the number of elements in the array).
+RouteArray is an object that represents an array of X3DRoute objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. *routeArrayName*[*index*], where *index* is an integer-valued expression with 0\<=*index*\<length and length is the number of elements in the array).
 
 ### Instance Creation Method\(s\)
 

package/docs/{reference/Scene-Services.md → _posts/reference/scene-services.md}

@@ -1,20 +1,10 @@
 ---
-# Feel free to add content and custom Front Matter to this file.
-# To modify the layout, see https://jekyllrb.com/docs/themes/#overriding-theme-defaults
-
-layout: single
+title: Scene Services
+date: 2022-11-28
+nav: reference
+categories: [Reference]
+tags: [scene, services]
 ---
-# Scene Services
-
-* [X3DExecutionContext](#x3dexecutioncontext)
-* [X3DScene](#x3dscene)
-* [ProfileInfo](#profileinfo)
-* [ComponentInfo](#componentinfo)
-* [UnitInfo](#unitinfo)
-* [ProfileInfoArray](#profileinfoarray)
-* [ComponentInfoArray](#componentinfoarray)
-* [UnitInfoArray](#unitinfoarray)
-
 ## X3DExecutionContext
 
 This section lists the methods available in the X3DExecutionContext object, which allows scripts to get access to the scene graph.
@@ -27,7 +17,7 @@ None. This object cannot be instantiated by the user.
 
 #### **specificationVersion**
 
-The string represent the basic specification version used by the parsed file in decimal format. For example, a scene conforming to this specification returns a value such as "3.3". This property is read only.
+The string represent the basic specification version used by the parsed file in decimal format. For example, a scene conforming to this specification returns a value such as "4.0". This property is read only.
 
 #### **encoding**
 
@@ -288,7 +278,7 @@ Additional units, called *derived units* are used in this International Standard
          <td>length/second<sup>2</sup></td>
       </tr>
       <tr>
-         <td>angular\_rate</td>
+         <td>angular_rate</td>
          <td>angle/second</td>
       </tr>
       <tr>
@@ -306,7 +296,7 @@ Additional units, called *derived units* are used in this International Standard
    </tbody>
 </table>
 
-The standard color space used by this International Standard is RGB where each color component has the range \[0.,1.\].
+The standard color space used by this International Standard is RGB where each color component has the range [0.,1.].
 
 #### **name**
 
@@ -322,7 +312,7 @@ None.
 
 ## ProfileInfoArray
 
-ProfileInfoArray is an object that represents an array of ProfileInfo objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. *profileInfoArrayName*\[*index*\], where *index* is an integer-valued expression with 0&lt;=*index*&lt;length and length is the number of elements in the array).
+ProfileInfoArray is an object that represents an array of ProfileInfo objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. *profileInfoArrayName*[*index*], where *index* is an integer-valued expression with 0\<=*index*\<length and length is the number of elements in the array).
 
 ### Instance Creation Method\(s\)
 
@@ -340,7 +330,7 @@ None
 
 ## ComponentInfoArray
 
-ComponentInfoArray is an object that represents an array of ComponentInfo objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. *componentInfoArrayName*\[*index*\], where *index* is an integer-valued expression with 0&lt;=*index*&lt;length and length is the number of elements in the array).
+ComponentInfoArray is an object that represents an array of ComponentInfo objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. *componentInfoArrayName*[*index*], where *index* is an integer-valued expression with 0\<=*index*\<length and length is the number of elements in the array).
 
 ### Instance Creation Method\(s\)
 
@@ -358,7 +348,7 @@ None
 
 ## UnitInfoArray
 
-UnitInfoArray is an object that represents an array of UnitInfo objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. *unitInfoArrayName*\[*index*\], where *index* is an integer-valued expression with 0&lt;=*index*&lt;length and length is the number of elements in the array).
+UnitInfoArray is an object that represents an array of UnitInfo objects. This is a read-only object. Individual elements of the array can be referenced using the standard C-style dereferencing operator (e.g. *unitInfoArrayName*[*index*], where *index* is an integer-valued expression with 0\<=*index*\<length and length is the number of elements in the array).
 
 ### Instance Creation Method\(s\)
 

package/docs/{reference/Script-Node-Authoring-Interface.md → _posts/reference/script-node-authoring-interface.md}

@@ -1,11 +1,10 @@
 ---
-# Feel free to add content and custom Front Matter to this file.
-# To modify the layout, see https://jekyllrb.com/docs/themes/#overriding-theme-defaults
-
-layout: single
+title: Script Node Authoring Interface
+date: 2022-11-28
+nav: reference
+categories: [Reference]
+tags: [script, node, authoring, interface]
 ---
-# Script Node Authoring Interface
-
 ## Overview
 
 This is a reference for ECMAScript, a scripting language for X3D Script nodes. ECMAScript grew out of the need for a lightweight script language in X3D. It is a subset of the JavaScript language, with X3D data types supported as JavaScript built-in objects.
@@ -32,7 +31,7 @@ The names specified in the declaration of a function (the data value and the tim
 
 Local variables can be created simply by assigning to a name that does not yet exist. Assigning to such a variable causes it take the type of the expression, so these local variables always have the type of the last assignment. Local variables are scoped by the block in which they were first introduced. Once that block is exited, the variable ceases to exist. Variables corresponding to outputOnly fields or initializeOnly fields of the Script node are global in scope.
 
-Variable names must start with the a lowercase character ('a' through 'z'), an uppercase character ('A' through 'Z'), or an underscore ('\_'). Subsequent characters can be any of these or a digit ('0' through '9'). Variable names are case sensitive.
+Variable names must start with the a lowercase character ('a' through 'z'), an uppercase character ('A' through 'Z'), or an underscore ('_'). Subsequent characters can be any of these or a digit ('0' through '9'). Variable names are case sensitive.
 
 Numeric, boolean, and string literals are allowed. Numeric literals can be integers in decimal (417), hex (0x5C), or octal (0177) notation. They can also be floating point numbers in fixed (1.76) or exponential (2.7e-12) notation. All numeric literals are of the number type. Boolean literals can be 'true' or 'false' and have the boolean type. String literals can be any sequence of UTF8 characters enclosed in single quotes ('), and have the type String. Special (non-printable) characters can be included in a string using the following escape sequences:
 
@@ -202,7 +201,7 @@ Combining objects of different types in a single expression or assignment statem
 
 ### MF Objects
 
-Most SF objects in ECMAScript have a corresponding MF object. An MFObject is essentially an array of objects, with each element of the array having the type of the corresponding SF object. All MF objects have a *length* property which returns or sets the number of elements in the MF object. Array indexes start at 0. If *vecArray* is an MFVec3f object then *vecArray\[0\]* is the first SFVec3f object in the array.
+Most SF objects in ECMAScript have a corresponding MF object. An MFObject is essentially an array of objects, with each element of the array having the type of the corresponding SF object. All MF objects have a *length* property which returns or sets the number of elements in the MF object. Array indexes start at 0. If *vecArray* is an MFVec3f object then *vecArray[0]* is the first SFVec3f object in the array.
 
 Dereferencing an MF object creates a new object of the corresponding SF object type with the contents of the dereferenced element. Assigning an SF object to a dereferenced MF object (which must be of the corresponding type) copies the contents of the SF object into the dereferenced element.
 
@@ -211,7 +210,7 @@ Dereferencing an MF object creates a new object of the corresponding SF object t
 The *url* field of the Script node may contain a URL that references ECMAScript code:
 
 ```js
-Script { url "http://foo.com/myScript.js" }
+Script { url "https://example.com/myScript.js" }
 ```
 
 The *ecmascript:* protocol allows the script to be placed inline as follows:
@@ -232,7 +231,7 @@ The *url* field may contain multiple URL's and thus reference a remote file or i
 ```js
 Script {
   url [
-    "http://foo.com/myScript.js",
+    "https://example.com/myScript.js",
     "ecmascript: function foo () { ... }"
   ]
 }
@@ -341,7 +340,7 @@ function set_rot (value)
 }
 ```
 
-This sends a set\_translation inputOnly field to the Transform node. An inputOnly field on a passed node can appear only on the left side of the assignment. An outputOnly fields or inputOutput field in the passed node can appear only on the right side, which reads the last value sent out. Fields in the passed node cannot be accessed, but inputOutput fields can either send an event to the »set\_...« inputOnly field, or read the current value of the »...\_changed« outputOnly fields. This follows the routing model of the rest of X3D.
+This sends a set_translation inputOnly field to the Transform node. An inputOnly field on a passed node can appear only on the left side of the assignment. An outputOnly fields or inputOutput field in the passed node can appear only on the right side, which reads the last value sent out. Fields in the passed node cannot be accessed, but inputOutput fields can either send an event to the »set_...« inputOnly field, or read the current value of the »..._changed« outputOnly fields. This follows the routing model of the rest of X3D.
 
 ### Sending OutputOnly Fields
 

package/docs/_posts/report-a-bug.md

@@ -0,0 +1,15 @@
+---
+title: Report a Bug
+date: 2022-12-02
+nav: main
+categories: []
+tags: [bug, report, issue]
+---
+If you run into any bugs or encounter any other abnormal issues with X_ITE, let us know!
+
+Here's an example of a helpful bug report:
+
+>*I fell through a hole on the Resistance map. I was running along the wall near the pool of water and fell through a black hole in the wall. I got stuck and had to leave the match. This happened while playing Search and Destroy.*
+{: .prompt-danger }
+
+[X_ITE Feedback Survey and Bug Report](https://github.com/create3000/x_ite/issues){:target="_blank"}

package/docs/_posts/setup-a-localhost-server.md

@@ -0,0 +1,42 @@
+---
+title: Setup a localhost Server
+date: 2022-12-02
+nav: main
+categories: []
+tags: [setup, localhost, server, xhr]
+---
+## Overview
+
+X_ITE makes use of the XMLHttpRequest object to load files and there's no way round that. But that means files loading using the file:// scheme protocol are subject to the same origin policy and are handled as cross origin requests (CORS) and cross origin requests are only supported for protocol schemes: https, http and data. **That means X_ITE cannot have access to this files.**
+
+To work around this problem you must set up a localhost server, then you can access your local files under the web address http://**localhost**/...
+
+## Using an Application
+
+There are several applications on the Internet which can make a localhost server. Here I would like to recommend you two of them:
+
+MacOS users can use [Personal Web Server](https://apps.apple.com/de/app/personal-web-server/id1486323797?mt=12), which can serves files through a web server, and is very easy to use.
+
+Another application is [XAMPP](https://www.apachefriends.org/index.html), which runs on several operating systems and is very popular.
+
+## Using Python
+
+If you have [Python](https://www.python.org){:target="_blank"} installed, then it is quite easy to start a **localhost** server.
+
+Just open a Terminal and go to the directory you want to make available.
+
+```sh
+# Let's make the Desktop directory available.
+$ cd Desktop
+```
+
+Type in the following command to start the server.
+
+```sh
+$ python3 -m http.server
+```
+
+By default, this will run the contents of the directory on a local web server, on port 8000. You can go to this server by going to the URL http://**localhost**:8000 in your web browser. Here you'll see the contents of the directory listed — click the HTML file you want to run.
+
+>**Tip:** If you already have something running on port 8000, you can choose another port by running the server command followed by an alternative port number, e.g. python3 -m http.server 7800. You can then access your content at http://**localhost**:7800.
+{: .prompt-tip }