x_ite 8.11.7 → 8.11.9

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

@@ -1,174 +0,0 @@
----
-title: Building an X3D World
-date: 2022-11-28
-nav: tutorials-shapes-geometry-and-appearance
-categories: [Tutorials]
-tags: [Building, World]
----
-## X3D file structure
-
-X3D files contain:
-
-- The file header
-- Comments - notes to yourself
-- Nodes - nuggets of scene information
-- Fields - node attributes you can change
-- Values - attribute values
-- Routes - connections between fields
-- more ...
-
-## A sample X3D file
-
-### XML Encoding
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<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>
-    <Appearance>
-      <Material/>
-    <Appearance>
-    <Cylinder
-        height='2.0'
-        radius='1.5'/>
-    </Shape>
-  </Scene>
-</X3D>
-```
-
-### Classic Encoding
-
-```js
-#X3D V{{ site.x3d_latest_version }} utf8
-# A Cylinder
-Shape {
-  appearance Appearance {
-    material Material { }
-  }
-  geometry Cylinder {
-    height 2.0
-    radius 1.5
-  }
-}
-```
-
-### Example
-
-<x3d-canvas src="https://create3000.github.io/media/tutorials/scenes/cylinder1/cylinder1.x3dv" update="auto">
-  <img src="https://create3000.github.io/media/tutorials/scenes/cylinder1/screenshot.png" alt="Cylinder"/>
-</x3d-canvas>
-
-[Download ZIP Archive](https://create3000.github.io/media/tutorials/scenes/cylinder1/cylinder1.zip)
-
-## Understanding the header
-
-**\#X3D V{{ site.x3d_latest_version }} utf8**
-
-- **\#X3D:** File contains X3D text
-- **V{{ site.x3d_latest_version }} :** Text conforms to version {{ site.x3d_latest_version }} syntax
-- **utf8 :** Text uses UTF8 character set
-
-## Understanding UTF8
-
-- utf8 is an international character set standard
-- utf8 stands for:
-  - UCS (Universal Character Set) Transformation Format, 8-bit
-  - Can encodes up to 2,164,864 characters for many languages
-  - ASCII is a subset
-
-## Using comments
-
-```js
-# A Cylinder
-```
-
-- Comments start with a number-sign (**\#**) and extend to the end of the line
-
-## Using nodes
-
-### XML Encoding
-
-```xml
-<Cylinder/>
-```
-
-### Classic Encoding
-
-```js
-Cylinder {
-}
-```
-
-- Nodes describe shapes, lights, sounds, etc.
-- Every node has:
-  - A node type ([Shape](../components/shape/shape), [Cylinder](../components/geometry3d/cylinder), etc.)
-  - A pair of curly-braces
-  - Zero or more fields inside the curly-braces
-
-## Using node type names
-
-Node type names are case sensitive:
-
-- Each word starts with an upper-case character
-- The rest of the word is lower-case
-
-Some examples:
-
-[Appearance](../components/shape/appearance), [Cylinder](../components/geometry3d/cylinder), [Material](../components/shape/material), [Shape](../components/shape/shape)
-
-## Using fields and values
-
-### XML Encoding
-
-```xml
-<Cylinder
-    height='2.0'
-    radius='1.5'/>
-```
-
-### Classic Encoding
-
-```js
-Cylinder {
-  height 2.0
-  radius 1.5
-}
-```
-
-- Fields describe node attributes
-
-Every field has:
-
-- A field name (height, radius, etc.)
-- A data type (float, integer, etc.)
-- A default value
-- Different node types have different fields
-- Fields are optional
-  - A default value is used if a field is not given
-- 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-elevation-grids.md

@@ -1,177 +0,0 @@
----
-title: Building Elevation Grids
-date: 2022-11-28
-nav: tutorials-animation-sensors-and-geometry
-categories: [Tutorials]
-tags: [Building, Elevation grids]
----
-## Motivation
-
-- Building terrains is very common
-  - Hills, valleys, mountains
-  - Other tricky uses...
-- You can build a terrain using an [IndexedFaceSet](../components/geometry3d/indexedfaceset) node
-- You can build terrains more efficiently using an [ElevationGrid](../components/geometry3d/elevationgrid) node
-
-## Syntax: ElevationGrid
-
-An [ElevationGrid](../components/geometry3d/elevationgrid) geometry node creates terrains:
-
-- *xDimension* and *zDimension* - grid size
-- *xSpacing* and *zSpacing* - row and column distances
-
-### XML Encoding
-
-```xml
-<Shape>
-  <Appearance><!-- ... --></Appearance>
-  <ElevationGrid
-      xDimension='3'
-      zDimension='2'
-      xSpacing='1.0'
-      zSpacing='1.0'
-      ... />
-</Shape>
-```
-
-### Classic Encoding
-
-```js
-Shape {
-  appearance Appearance { ... }
-  geometry ElevationGrid {
-    xDimension 3
-    zDimension 2
-    xSpacing   1.0
-    zSpacing   1.0
-    ...
-  }
-}
-```
-
-An [ElevationGrid](../components/geometry3d/elevationgrid) geometry node creates terrains:
-
-- *height* - elevations at grid points
-
-### XML Encoding
-
-```xml
-<Shape>
-  <Appearance><!-- ... --></Appearance>
-  <ElevationGrid
-      ...
-      height='0.0, -0.5, 0.0,
-              0.2,  4.0, 0.0'/>
-</Shape>
-```
-
-### Classic Encoding
-
-```js
-Shape {
-  appearance Appearance { ... }
-  geometry ElevationGrid {
-    ...
-    height [
-      0.0, -0.5, 0.0,
-      0.2,  4.0, 0.0
-    ]
-  }
-}
-```
-
-An [ElevationGrid](../components/geometry3d/elevationgrid) geometry node creates terrains
-
-- *solid* - shape is solid
-- *ccw* - faces are counter-clockwise
-
-### XML Encoding
-
-```xml
-<Shape>
-  <Appearance><!-- ... --></Appearance>
-  <ElevationGrid
-      solid='true'
-      ccw='true'
-      ... />
-</Shape>
-```
-
-### Classic Encoding
-
-```js
-Shape {
-  appearance Appearance { ... }
-  geometry ElevationGrid {
-    ...
-    solid TRUE
-    ccw TRUE
-  }
-}
-```
-
-## A sample elevation grid
-
-### XML Encoding
-
-```xml
-<Shape>
-  <Appearance><!-- ... --></Appearance>
-  <ElevationGrid
-      xDimension='9'
-      zDimension='9'
-      xSpacing='1.0'
-      zSpacing='1.0'
-      solid='false'
-      height='0.0, 0.0, 0.5, 1.0, 0.5, 0.0, 0.0, 0.0, 0.0,
-              0.0, 0.0, 0.0, 0.0, 2.5, 0.5, 0.0, 0.0, 0.0,
-              0.0, 0.0, 0.5, 0.5, 3.0, 1.0, 0.5, 0.0, 1.0,
-              0.0, 0.0, 0.5, 2.0, 4.5, 2.5, 1.0, 1.5, 0.5,
-              1.0, 2.5, 3.0, 4.5, 5.5, 3.5, 3.0, 1.0, 0.0,
-              0.5, 2.0, 2.0, 2.5, 3.5, 4.0, 2.0, 0.5, 0.0,
-              0.0, 0.0, 0.5, 1.5, 1.0, 2.0, 3.0, 1.5, 0.0,
-              0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 2.0, 1.5, 0.5,
-              0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.5, 0.0, 0.0,'/>
-</Shape>
-```
-
-### Classic Encoding
-
-```js
-Shape {
-  appearance Appearance { ... }
-  geometry ElevationGrid {
-    xDimension 9
-    zDimension 9
-    xSpacing   1.0
-    zSpacing   1.0
-    solid FALSE
-    height [
-      0.0, 0.0, 0.5, 1.0, 0.5, 0.0, 0.0, 0.0, 0.0,
-      0.0, 0.0, 0.0, 0.0, 2.5, 0.5, 0.0, 0.0, 0.0,
-      0.0, 0.0, 0.5, 0.5, 3.0, 1.0, 0.5, 0.0, 1.0,
-      0.0, 0.0, 0.5, 2.0, 4.5, 2.5, 1.0, 1.5, 0.5,
-      1.0, 2.5, 3.0, 4.5, 5.5, 3.5, 3.0, 1.0, 0.0,
-      0.5, 2.0, 2.0, 2.5, 3.5, 4.0, 2.0, 0.5, 0.0,
-      0.0, 0.0, 0.5, 1.5, 1.0, 2.0, 3.0, 1.5, 0.0,
-      0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 2.0, 1.5, 0.5,
-      0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.5, 0.0, 0.0,
-    ]
-  }
-}
-```
-
-### Example
-
-<x3d-canvas src="https://create3000.github.io/media/tutorials/scenes/elevation-grid/elevation-grid.x3dv" update="auto">
-  <img src="https://create3000.github.io/media/tutorials/scenes/elevation-grid/screenshot.png" alt="Elevation Grid"/>
-</x3d-canvas>
-
-[Download ZIP Archive](https://create3000.github.io/media/tutorials/scenes/elevation-grid/elevation-grid.zip)
-
-## Summary
-
-- An [ElevationGrid](../components/geometry3d/elevationgrid) node efficiently creates a terrain
-- Grid size is specified in the *xDimension* and *zDimension* fields
-- Grid spacing is specified in the *xSpacing* and *zSpacing* field
-- Elevations at each grid point are specified in the *height* field

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

@@ -1,150 +0,0 @@
----
-title: Build Extruded Shapes
-date: 2022-11-28
-nav: tutorials-animation-sensors-and-geometry
-categories: [Tutorials]
-tags: [Build, Extruded, Shapes]
----
-## Motivation
-
-Extruded shapes are very common
-
-- Tubes, pipes, bars, vases, donuts
-- Other tricky uses...
-
-How can you do it:
-
-- You can build extruded shapes using an [IndexedFaceSet](../components/geometry3d/indexedfaceset) node.
-- You can build extruded shapes more easily and efficiently using an [Extrusion](../components/geometry3d/extrusion) node.
-
-## Creating extruded shapes
-
-Extruded shapes are described by:
-
-- A 2-D cross-section
-- A 3-D spine along which to sweep the cross-section
-
-Extruded shapes are like long bubbles created with a bubble wand:
-
-- The bubble wand's outline is the cross-section
-- The path along which you swing the wand is the spine
-
-## Syntax: Extrusion
-
-An [Extrusion](../components/geometry3d/extrusion) geometry node creates extruded geometry:
-
-- *crossSection* - 2-D cross-section
-- *spine* - 3-D sweep path
-- *endCap* and *beginCap* - cap ends
-
-### XML Encoding
-
-```xml
-<Shape>
-  <Appearance><!-- ... --></Appearance>
-  <Extrusion
-      crossSection='...'
-      spine='...'
-      endCap='true'
-      beginCap='true'
-      ... />
-</Shape>
-```
-
-### Classic Encoding
-
-```js
-Shape {
-  appearance Appearance { ... }
-  geometry Extrusion {
-    crossSection [ ... ]
-    spine [ ...  ]
-    endCap TRUE
-    beginCap TRUE
-    ...
-  }
-}
-```
-
-An [Extrusion](../components/geometry3d/extrusion) geometry node creates extruded geometry:
-
-- *solid* - shape is solid
-- *ccw* - faces are counter-clockwise
-- *convex* - faces are convex
-
-### XML Encoding
-
-```xml
-<Shape>
-  <Appearance><!-- ... --></Appearance>
-  <Extrusion
-      ...
-      solid='true'
-      ccw='true'
-      convex='true'/>
-</Shape>
-```
-
-### Classic Encoding
-
-```js
-Shape {
-  appearance Appearance { ... }
-  geometry Extrusion {
-    ...
-    solid TRUE
-    ccw TRUE
-    convex TRUE
-  }
-}
-```
-
-## Squishing and twisting extruded shapes
-
-You can scale the cross-section along the spine:
-
-- Vases, musical instruments
-- Surfaces of revolution
-
-You can rotate the cross-section along the spine
-
-- Twisting ribbons
-
-## Syntax: Extrusion
-
-An [Extrusion](../components/geometry3d/extrusion) geometry node creates geometry using:
-
-- *scale* - cross-section scaling per spine point
-- *orientation* - cross-section rotation per spine point
-
-### XML Encoding
-
-```xml
-<Shape>
-  <Appearance><!-- ... --></Appearance>
-  <Extrusion
-      ...
-      scale='...'
-      orientation='...'/>
-</Shape>
-```
-
-### Classic Encoding
-
-```js
-Shape {
-  appearance Appearance { ... }
-  geometry Extrusion {
-    ...
-    scale [ ... ]
-    orientation [ ... ]
-  }
-}
-```
-
-## Summary
-
-- An [Extrusion](../components/geometry3d/extrusion) node efficiently creates extruded shapes
-- The *crossSection* field specifies the cross-section
-- The *spine* field specifies the sweep path
-- The *scale* and *orientation* fields specify scaling and rotation at each spine point

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

@@ -1,211 +0,0 @@
----
-title: Building Primitive Shapes
-date: 2022-11-28
-nav: tutorials-shapes-geometry-and-appearance
-categories: [Tutorials]
-tags: [Building, Primitive, Shapes]
----
-## Motivation
-
-Shapes are the building blocks of an X3D world. Primitive Shapes are standard building blocks:
-
-- [Box](../components/geometry3d/box)
-- [Cone](../components/geometry3d/cone)
-- [Cylinder](../components/geometry3d/cylinder)
-- [Sphere](../components/geometry3d/sphere)
-- [Text](../components/text/text)
-- and more from the [CADGeometry](../components//cadgeometry)**,** [Geometry2D](../components//geometry2d)**,** and [Rendering](../components//rendering) component
-
-## Syntax: Shape
-
-- A [Shape](../components/shape/shape) node builds a shape
-  - *appearance* - color and texture
-  - *geometry* - form, or structure
-
-### XML Encoding
-
-```xml
-<Shape>
-  <!-- appearance ... -->
-  <!-- geometry ... -->
-<Shape>
-```
-
-### Classic Encoding
-
-```js
-Shape {
-  appearance ...
-  geometry ...
-}
-```
-
-## Specifying appearance
-
-- [Shape](../components/shape/shape) appearance is described by appearance nodes
-- For now, we'll use nodes to create a shaded white appearance:
-
-### XML Encoding
-
-```xml
-<Shape>
-  <Appearance>
-    <Material/>
-  </Appearance>
-  <!-- geometry ... -->
-</Shape>
-```
-
-### Classic Encoding
-
-```js
-Shape {
-  appearance Appearance {
-    material Material { }
-  }
-  geometry ...
-}
-```
-
-## Specifying geometry
-
-[Shape](../components/shape/shape) geometry is built with geometry nodes:
-
-### XML Encoding
-
-```xml
-<Box ... />
-<Cone ... />
-<Cylinder ... />
-<Sphere ... />
-<Text ... />
-```
-
-### Classic Encoding
-
-```js
-Box { ... }
-Cone { ... }
-Cylinder { ... }
-Sphere { ... }
-Text { ... }
-```
-
-- Geometry node fields control dimensions
-  - Dimensions usually in meters, but can be anything
-
-## A sample primitive shape
-
-### XML Encoding
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<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>
-        <Material/>
-      </Appearance>
-      <Cylinder
-          radius='1.5'/>
-    </Shape>
-  </Scene>
-</X3D>
-```
-
-### Classic Encoding
-
-```js
-#X3D V{{ site.x3d_latest_version }} utf8
-# A cylinder
-Shape {
-  appearance Appearance {
-    material Material { }
-  }
-  geometry Cylinder {
-    height 2.0
-    radius 1.5
-  }
-}
-```
-
-### Example
-
-<x3d-canvas src="https://create3000.github.io/media/tutorials/scenes/cylinder1/cylinder1.x3dv" update="auto">
-  <img src="https://create3000.github.io/media/tutorials/scenes/cylinder1/screenshot.png" alt="Cylinder"/>
-</x3d-canvas>
-
-[Download ZIP Archive](https://create3000.github.io/media/tutorials/scenes/cylinder1/cylinder1.zip)
-
-## Building multiple shapes
-
-- Shapes are built centered in the world
-- A X3D file can contain multiple shapes
-- Shapes overlap when built at the same location
-
-## A sample file with multiple shapes
-
-### XML Encoding
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<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>
-        <Material/>
-      </Appearance>
-      <Box
-          size='1 1 1'/>
-    </Shape>
-    <Shape>
-      <Appearance>
-        <Material/>
-      </Appearance>
-      <Sphere
-          radius='0.7'/>
-    </Shape>
-    <!-- ... -->
-  </Scene>
-</X3D>
-```
-
-### Classic Encoding
-
-```js
-#X3D V{{ site.x3d_latest_version }} utf8
-
-Shape {
-  appearance Appearance {
-    material Material { }
-  }
-  geometry Box {
-    size 1.0 1.0 1.0
-  }
-}
-
-Shape {
-  appearance Appearance {
-    material Material { }
-  }
-  geometry Sphere {
-    radius 0.7
-  }
-}
-
-...
-```
-
-### Example
-
-<x3d-canvas src="https://create3000.github.io/media/tutorials/scenes/multiple-shapes/multiple-shapes.x3dv" update="auto">
-  <img src="https://create3000.github.io/media/tutorials/scenes/multiple-shapes/screenshot.png" alt="Multiple Shapes"/>
-</x3d-canvas>
-
-[Download ZIP Archive](https://create3000.github.io/media/tutorials/scenes/multiple-shapes/multiple-shapes.zip)
-
-## Summary
-
-- Shapes are built using a [Shape](../components/shape/shape) node
-- [Shape](../components/shape/shape) geometry is built using geometry nodes, such as [Box](../components/geometry3d/box), [Cone](../components/geometry3d/cone), [Cylinder](../components/geometry3d/cylinder), [Sphere](../components/geometry3d/sphere), and [Text](../components/text/text)
-- Text fonts are controlled using a [FontStyle](../components/text/fontstyle) node