x_ite 8.4.3 → 8.5.3

package/docs/_posts/components/Layout/ScreenFontStyle.md

@@ -0,0 +1,137 @@
+---
+title: ScreenFontStyle
+date: 2022-01-07
+nav: components-Layout
+categories: [components, Layout]
+tags: [ScreenFontStyle, Layout]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+ScreenFontStyle is an X3DFontStyleNode defines the size, family, justification, and other styles used within a screen layout. ScreenFontStyle renders text so that it appears identical to typical 2D applications by specifying pointSize in points (as in 2D document layout) rather than size in meters. Each glyph of text is rendered as a quadrilateral with a texture applied.
+
+The ScreenFontStyle node belongs to the **Layout** component and its default container field is *fontStyle.* It is available since X3D version 3.2 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DFontStyleNode
+    + ScreenFontStyle
+```
+
+## Fields
+
+### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
+
+Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+
+### SFString [in, out] **language** ""
+
+*language* codes consist of a primary code and a (possibly empty) series of subcodes. [ language-code = primary-code ( "-" subcode )\* ] Two-letter primary codes are reserved for language abbreviations. Two-letter primary codes include en (English), fr (French), de (German), it (Italian), nl (Dutch), el (Greek), es (Spanish), pt (Portuguese), ar (Arabic), he (Hebrew), ru (Russian), zh (Chinese), ja (Japanese), hi (Hindi), ur (Urdu), and sa (Sanskrit). Any two-letter subcode is understood to be a country code.
+
+#### Warning
+
+- Do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.
+
+#### See Also
+
+- [See ISO639.2 Codes for the Representation of Names of Languages](https://www.loc.gov/standards/iso639-2/php/code_list.php){:target="_blank"}
+- [See RFC3066 Tags for the Identification of Languages](https://tools.ietf.org/html/rfc3066){:target="_blank"}
+- [See ISO3166 or](http://xml.coverpages.org/languageIdentifiers.html){:target="_blank"}
+- [Relates to Internationalization (i18n)](https://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+
+### MFString [in, out] **family** "SERIF"
+
+Array of quoted font family names in preference order, browsers use the first supported family.
+
+#### Hints
+
+- Example family array might be "Times" "SERIF" Values with guaranteed support include "SERIF" "SANS" "TYPEWRITER". SERIF and SANS are variable-width fonts (for example, Times Roman and Arial). TYPEWRITER is a fixed-width font (for example, Courier). MFString arrays can have multiple values, so "separate each individual string" "by using quote marks". See [15.2.2.2 Font family and style](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/text.html#Fontfamilyandstyle){:target="_blank"} for details.
+
+#### Warning
+
+- Font family support often varies.
+
+#### See Also
+
+- [Relates to Internationalization (i18n)](https://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+
+### SFString [in, out] **style** "PLAIN" <small>["PLAIN"|"BOLD"|"ITALIC"|"BOLDITALIC"|""]</small>
+
+Pick one of four values for text style.
+
+#### Hint
+
+- See [15.2.2.2 Font family and style](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/text.html#Fontfamilyandstyle){:target="_blank"} for details.
+
+#### Warning
+
+- Do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.
+
+### SFFloat [in, out] **pointSize** 12 <small>(0,∞)</small>
+
+*pointSize* field specifies the size of text in points. Nominal height (in local coordinate system) of text glyphs Also sets default spacing between adjacent lines of text.
+
+#### Hint
+
+- PointSize replaces the size field of the FontStyle node.
+
+### SFFloat [in, out] **spacing** 1 <small>[0,∞)</small>
+
+Adjustment factor for line spacing between adjacent lines of text.
+
+### SFBool [in, out] **horizontal** TRUE
+
+Whether text direction is horizontal (true) or vertical (false).
+
+#### Hint
+
+- See [15.2.2.3 Direction and justification](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/text.html#Directionandjustification){:target="_blank"} for details.
+
+#### See Also
+
+- [Relates to Internationalization (i18n)](https://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+
+### SFBool [in, out] **leftToRight** TRUE
+
+Field leftToRight.
+
+### SFBool [in, out] **topToBottom** TRUE
+
+Whether text direction is top-to-bottom (true) or bottom-to-top (false).
+
+#### Hint
+
+- See [15.2.2.3 Direction and justification](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/text.html#Directionandjustification){:target="_blank"} for details.
+
+#### See Also
+
+- [Relates to Internationalization (i18n)](https://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+
+### MFString [in, out] **justify** "BEGIN" <small>["BEGIN"|"END"|"FIRST","MIDDLE"|""]</small>
+
+The justify field determines alignment of the above text layout relative to the origin of the object coordinate system.
+
+#### Hints
+
+- Preferred value is usually justify=' "MIDDLE" "MIDDLE" ' for centered justification horizontally and vertically. MFString arrays can have multiple values, so "separate each individual string" "by using quote marks". See [15.2.2.3 Direction and justification](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/text.html#Directionandjustification){:target="_blank"} for details.
+
+#### Warnings
+
+- Exactly two string values are provided for major and minor axis alignment. Do not use illegal values such as LEFT RIGHT TOP BOTTOM or CENTER.
+
+## Description
+
+### Hint
+
+- First add a Text node as a parent.
+
+## External Links
+
+- [X3D Specification of ScreenFontStyle](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layout.html#ScreenFontStyle){:target="_blank"}

package/docs/_posts/components/Layout/ScreenGroup.md

@@ -0,0 +1,71 @@
+---
+title: ScreenGroup
+date: 2022-01-07
+nav: components-Layout
+categories: [components, Layout]
+tags: [ScreenGroup, Layout]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+ScreenGroup is a Grouping node that can contain most nodes. ScreenGroup modifies the screen scale in such a way that one unit is equal to one pixel in both the horizontal and vertical directions.
+
+The ScreenGroup node belongs to the **Layout** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DGroupingNode
+      + ScreenGroup
+```
+
+## Fields
+
+### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
+
+Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+
+### SFVec3f [ ] **bboxSize** -1 -1 -1 <small>(0,∞) or -1 -1 -1</small>
+
+Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
+
+#### Hint
+
+- Can be useful for collision computations or inverse-kinematics (IK) engines.
+
+### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
+
+Bounding box center: optional hint for position offset from origin of local coordinate system.
+
+### MFNode [in] **addChildren**
+
+Input field addChildren.
+
+### MFNode [in] **removeChildren**
+
+Input field removeChildren.
+
+### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
+
+Grouping nodes contain a list of children nodes.
+
+#### Hint
+
+- Each grouping node defines a coordinate space for its children, relative to the coordinate space of its parent node. Thus transformations accumulate down the scene graph hierarchy.
+
+## Description
+
+### Hint
+
+- Insert a Shape node before adding geometry or Appearance.
+
+## External Links
+
+- [X3D Specification of ScreenGroup](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layout.html#ScreenGroup){:target="_blank"}

package/docs/_posts/components/Lighting/DirectionalLight.md

@@ -0,0 +1,100 @@
+---
+title: DirectionalLight
+date: 2022-01-07
+nav: components-Lighting
+categories: [components, Lighting]
+tags: [DirectionalLight, Lighting]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+DirectionalLight creates parallel light rays to illuminate geometric shapes. Light is scoped and only illuminates geometry within its enclosing parent group! No source location is needed since rays are parallel from an infinitely distant source. DirectionalLight nodes do not attenuate with distance. Lights have no visible shape themselves and shine through occluding geometry.
+
+The DirectionalLight node belongs to the **Lighting** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DLightNode
+      + DirectionalLight
+```
+
+## Fields
+
+### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
+
+Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+
+### SFBool [in, out] **global** FALSE
+
+*global* lights illuminate all objects within their volume of lighting influence. Scoped lights only illuminate objects within the same transformation hierarchy.
+
+### SFBool [in, out] **on** TRUE
+
+Enables/disables this light source.
+
+### SFColor [in, out] **color** 1 1 1 <small>[0,1]</small>
+
+*color* of light, applied to colors of objects.
+
+#### See Also
+
+- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+
+### SFFloat [in, out] **intensity** 1 <small>[0,∞)</small>
+
+Brightness of direct emission from the light.
+
+### SFFloat [in, out] **ambientIntensity** 0 <small>[0,1]</small>
+
+Brightness of ambient (nondirectional background) emission from the light. Interchange profile hint: this field may be ignored, applying the default value regardless.
+
+### SFVec3f [in, out] **direction** 0 0 -1 <small>(-∞,∞)</small>
+
+Orientation vector of light relative to local coordinate system.
+
+#### Hint
+
+- Animate direction to simulate time-of-day sunlight effects.
+
+### SFBool [in, out] **shadows** FALSE
+
+*shadows* field indicates whether or not this light casts a shadow behind illuminated X3DShapeNode geometry.
+
+### SFColor [in, out] **shadowColor** 0 0 0 <small class="small">[0,1] <span class="yellow">non standard</span></small>
+
+Color of shadow, applied to colors of objects.
+
+### SFFloat [in, out] **shadowIntensity** 0 <small class="small">[0,1]</small>
+
+*shadowIntensity* field defines how much light is obscured by shapes that cast shadows, ranging from 0 (light not obscured, no visible shadows) to 1 (light completely obscured, full-intensity shadows).
+
+### SFFloat [in, out] **shadowBias** 0.005 <small class="small">[0,1] <span class="yellow">non standard</span></small>
+
+The shadowBias value controls the visibility of *shadow acne*.
+
+### SFInt32 [ ] **shadowMapSize** 1024 <small class="small">[0,∞) <span class="yellow">non standard</span></small>
+
+Size of the shadow map in pixels, must be power of two.
+
+## Description
+
+### Hints
+
+- Animate direction to simulate time-of-day sunlight effects.
+- HeadLight enabled on/off is controlled by NavigationInfo.
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/Lighting/DirectionalLight/DirectionalLight.x3d"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of DirectionalLight](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/lighting.html#DirectionalLight){:target="_blank"}

package/docs/_posts/components/Lighting/EnvironmentLight.md

@@ -0,0 +1,91 @@
+---
+title: EnvironmentLight
+date: 2023-01-31
+nav: components-Lighting
+categories: [components, Lighting]
+tags: [EnvironmentLight, Lighting]
+---
+<style>
+.post h3 {
+   word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+EnvironmentLight ...
+
+The EnvironmentLight node belongs to the **Lighting** component and its default container field is *children.* It is available since X3D version 4.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DLightNode
+      + EnvironmentLight
+```
+
+## Fields
+
+### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
+
+Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+
+### SFBool [in, out] **global** TRUE
+
+*global* lights illuminate all objects within their volume of lighting influence. Scoped lights only illuminate objects within the same transformation hierarchy.
+
+### SFBool [in, out] **on** TRUE
+
+Enables/disables this light source.
+
+### SFRotation [in, out] **rotation** 0 0 1 0 <small>[-1,1] or (-∞,∞)</small>
+
+### SFColor [in, out] **color** 1 1 1 <small>[0,1]</small>
+
+*color* of light, applied to colors of objects.
+
+#### See Also
+
+- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+
+### SFFloat [in, out] **intensity** 1 <small>[0,∞)</small>
+
+Brightness of direct emission from the light.
+
+### SFFloat [in, out] **ambientIntensity** 0 <small>[0,1]</small>
+
+Brightness of ambient (nondirectional background) emission from the light.
+
+### MFFloat [in, out] **diffuseCoefficients** [ ]
+
+### SFNode [in, out] **diffuse** NULL <small>[X3DSingleTextureNode]</small>
+
+### SFNode [in, out] **diffuseTexture** NULL <small>[X3DEnvironmentTextureNode]</small>
+
+### SFNode [in, out] **specularTexture** NULL <small>[X3DEnvironmentTextureNode]</small>
+
+### SFBool [in, out] **shadows** FALSE
+
+*shadows* field indicates whether or not this light casts a shadow behind illuminated X3DShapeNode geometry.
+
+### SFColor [in, out] **shadowColor** 0 0 0 <small class="small">[0,1] <span class="yellow">non standard</span></small>
+
+Color of shadow, applied to colors of objects.
+
+### SFFloat [in, out] **shadowIntensity** 0 <small class="small">[0,1]</small>
+
+*shadowIntensity* field defines how much light is obscured by shapes that cast shadows, ranging from 0 (light not obscured, no visible shadows) to 1 (light completely obscured, full-intensity shadows).
+
+### SFFloat [in, out] **shadowBias** 0.005 <small class="small">[0,1] <span class="yellow">non standard</span></small>
+
+The shadowBias value controls the visibility of *shadow acne*.
+
+### SFInt32 [ ] **shadowMapSize** 1024 <small class="small">[0,∞) <span class="yellow">non standard</span></small>
+
+Size of the shadow map in pixels, must be power of two.
+
+## External Links
+
+- [X3D Specification of EnvironmentLight](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/lighting.html#EnvironmentLight){:target="_blank"}

package/docs/_posts/components/Lighting/PointLight.md

@@ -0,0 +1,103 @@
+---
+title: PointLight
+date: 2022-01-07
+nav: components-Lighting
+categories: [components, Lighting]
+tags: [PointLight, Lighting]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+PointLight is a single light source that illuminates outwards in all directions. Light illuminates all geometry and is normally scoped to illuminate peers and children nodes within the scene graph hierarchy Lights have no visible shape themselves and shine through occluding geometry.
+
+The PointLight node belongs to the **Lighting** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DLightNode
+      + PointLight
+```
+
+## Fields
+
+### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
+
+Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+
+### SFBool [in, out] **global** TRUE
+
+*global* lights illuminate all objects within their volume of lighting influence. Scoped lights only illuminate objects within the same transformation hierarchy.
+
+### SFBool [in, out] **on** TRUE
+
+Enables/disables this light source.
+
+### SFColor [in, out] **color** 1 1 1 <small>[0,1]</small>
+
+*color* of light, applied to colors of objects.
+
+#### See Also
+
+- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+
+### SFFloat [in, out] **intensity** 1 <small>[0,∞)</small>
+
+Brightness of direct emission from the light.
+
+### SFFloat [in, out] **ambientIntensity** 0 <small>[0,1]</small>
+
+Brightness of ambient (nondirectional background) emission from the light.
+
+### SFVec3f [in, out] **attenuation** 1 0 0 <small>[0,∞)</small>
+
+Constant, linear-distance and squared-distance dropoff factors.
+
+### SFVec3f [in, out] **location** 0 0 0 <small>(-∞,∞)</small>
+
+Position of light relative to local coordinate system.
+
+### SFFloat [in, out] **radius** 100 <small>[0,∞)</small>
+
+Maximum effective distance of light relative to local light position, affected by ancestor scaling.
+
+### SFBool [in, out] **shadows** FALSE
+
+*shadows* field indicates whether or not this light casts a shadow behind illuminated X3DShapeNode geometry.
+
+### SFColor [in, out] **shadowColor** 0 0 0 <small class="small">[0,1] <span class="yellow">non standard</span></small>
+
+Color of shadow, applied to colors of objects.
+
+### SFFloat [in, out] **shadowIntensity** 0 <small class="small">[0,1]</small>
+
+*shadowIntensity* field defines how much light is obscured by shapes that cast shadows, ranging from 0 (light not obscured, no visible shadows) to 1 (light completely obscured, full-intensity shadows).
+
+### SFFloat [in, out] **shadowBias** 0.005 <small class="small">[0,1] <span class="yellow">non standard</span></small>
+
+The shadowBias value controls the visibility of *shadow acne*.
+
+### SFInt32 [ ] **shadowMapSize** 1024 <small class="small">[0,∞) <span class="yellow">non standard</span></small>
+
+Size of the shadow map in pixels, must be power of two.
+
+## Description
+
+### Hint
+
+- HeadLight enabled on/off is controlled by NavigationInfo.
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/Lighting/PointLight/PointLight.x3d"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of PointLight](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/lighting.html#PointLight){:target="_blank"}

package/docs/_posts/components/Lighting/SpotLight.md

@@ -0,0 +1,132 @@
+---
+title: SpotLight
+date: 2022-01-07
+nav: components-Lighting
+categories: [components, Lighting]
+tags: [SpotLight, Lighting]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+SpotLight is a light source that illuminates geometry within a conical beam. Light illuminates all geometry and is normally scoped to illuminate peers and children nodes within the scene graph hierarchy Lights have no visible shape themselves and shine through occluding geometry.
+
+The SpotLight node belongs to the **Lighting** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DLightNode
+      + SpotLight
+```
+
+## Fields
+
+### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
+
+Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+
+### SFBool [in, out] **global** TRUE
+
+*global* lights illuminate all objects within their volume of lighting influence. Scoped lights only illuminate objects within the same transformation hierarchy.
+
+### SFBool [in, out] **on** TRUE
+
+Enables/disables this light source.
+
+### SFColor [in, out] **color** 1 1 1 <small>[0,1]</small>
+
+*color* of light, applied to colors of objects.
+
+#### See Also
+
+- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+
+### SFFloat [in, out] **intensity** 1 <small>[0,∞)</small>
+
+Brightness of direct emission from the light.
+
+### SFFloat [in, out] **ambientIntensity** 0 <small>[0,1]</small>
+
+Brightness of ambient (nondirectional background) emission from the light.
+
+### SFVec3f [in, out] **attenuation** 1 0 0 <small>[0,∞)</small>
+
+Constant, linear-distance and squared-distance dropoff factors.
+
+### SFVec3f [in, out] **location** 0 0 0 <small>(-∞,∞)</small>
+
+Position of light relative to local coordinate system.
+
+### SFVec3f [in, out] **direction** 0 0 -1 <small>(-∞,∞)</small>
+
+Orientation vector of light relative to local coordinate system.
+
+### SFFloat [in, out] **radius** 100 <small>[0,∞)</small>
+
+Maximum effective distance of light relative to local light position, affected by ancestor scaling.
+
+### SFFloat [in, out] **beamWidth** π/4 <small>(0,π/2]</small>
+
+Inner conical solid angle (in radians) where light source has uniform full intensity.
+
+#### Hint
+
+- BeamWidth is inner angle of full intensity, cutOffAngle is outer angle of zero intensity. Therefore set beamWidth\<= cutOffAngle.
+
+#### Warning
+
+- If beamWidth > cutOffAngle, then beamWidth reset to equal cutOffAngle.
+
+### SFFloat [in, out] **cutOffAngle** π/2 <small>(0,π/2]</small>
+
+Outer conical solid angle (in radians) where light source intensity becomes zero.
+
+#### Hint
+
+- beamWidth is inner angle of full intensity, cutOffAngle is outer angle of zero intensity. Therefore set beamWidth\<= cutOffAngle.
+
+#### Warnings
+
+- If beamWidth > cutOffAngle, then beamWidth reset to equal cutOffAngle.
+- If shadows is `TRUE`, cutOffAngle must be significantly smaller than π/2.
+
+### SFBool [in, out] **shadows** FALSE
+
+*shadows* field indicates whether or not this light casts a shadow behind illuminated X3DShapeNode geometry.
+
+### SFColor [in, out] **shadowColor** 0 0 0 <small class="small">[0,1] <span class="yellow">non standard</span></small>
+
+Color of shadow, applied to colors of objects.
+
+### SFFloat [in, out] **shadowIntensity** 0 <small class="small">[0,1]</small>
+
+*shadowIntensity* field defines how much light is obscured by shapes that cast shadows, ranging from 0 (light not obscured, no visible shadows) to 1 (light completely obscured, full-intensity shadows).
+
+### SFFloat [in, out] **shadowBias** 0.005 <small class="small">[0,1] <span class="yellow">non standard</span></small>
+
+The shadowBias value controls the visibility of *shadow acne*.
+
+### SFInt32 [ ] **shadowMapSize** 1024 <small class="small">[0,∞) <span class="yellow">non standard</span></small>
+
+Size of the shadow map in pixels, must be power of two.
+
+## Description
+
+### Hint
+
+- HeadLight enabled on/off is controlled by NavigationInfo.
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/Lighting/SpotLight/SpotLight.x3d"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of SpotLight](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/lighting.html#SpotLight){:target="_blank"}

package/docs/_posts/components/NURBS/Contour2D.md

@@ -0,0 +1,57 @@
+---
+title: Contour2D
+date: 2022-01-07
+nav: components-NURBS
+categories: [components, NURBS]
+tags: [Contour2D, NURBS]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+Contour2D groups a set of curve segments into a composite contour. The children segments form a closed loop, with first point of first child repeated as last point of last child, and last point of each segment repeated as the first point of the next consecutive segment. The children segments are type NurbsCurve2D or ContourPolyline2D, enumerated in the consecutive order of contour topology.
+
+The Contour2D node belongs to the **NURBS** component and its default container field is *trimmingContour.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + Contour2D
+```
+
+## Fields
+
+### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
+
+Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+
+### MFNode [in] **addChildren**
+
+Input field addChildren.
+
+### MFNode [in] **removeChildren**
+
+Input field removeChildren.
+
+### MFNode [in, out] **children** [ ] <small>[NurbsCurve2D|ContourPolyline2D]</small>
+
+Input/Output field children.
+
+## Description
+
+### Hint
+
+- Contour2D is used as the trimmingContour field of the NurbsTrimmedSurface node.
+
+### Warning
+
+- Contour2D is not a renderable geometry node.
+
+## External Links
+
+- [X3D Specification of Contour2D](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#Contour2D){:target="_blank"}