Difference between revisions of "Box"

From Web3D.org
Jump to: navigation, search
 
(25 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
*[[Node Reference]]
 
*[[Node Reference]]
 
==Box==
 
==Box==
 +
 +
Specification Link: [http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/geometry3D.html#Box Box]
 +
 
<pre>
 
<pre>
 
Box : X3DGeometryNode {  
 
Box : X3DGeometryNode {  
Line 9: Line 12:
 
</pre>
 
</pre>
  
{|
+
==DTD Validation==
|+Box : X3DGeometryNode {
+
 
| SFNode || [in,out] || metadata || NULL || [X3DMetadataObject]
+
===Children===
| SFVec3f || [] || size || 2 2 2 || (0,∞)
+
 
| SFBool || [] || solid || TRUE
+
Children must appear as follows:
|}
+
 
 +
# A single, optional IS.
 +
# A single, optional node derived from ''X3DMetadataObject'' for the ''metadata'' field.
 +
 
 +
===Attributes===
 +
 
 +
* There are no limits on the acceptable range of values for the ''size'' field.
 +
 
 +
==Schema Validation==
 +
 
 +
===Children===
 +
 
 +
Children must appear as follows:
 +
 
 +
# A single, optional IS.
 +
# A single, optional node derived from ''X3DMetadataObject'' for the ''metadata'' field.
  
The Box node specifies a rectangular parallelepiped box centred at (0, 0, 0) in the local coordinate system and aligned with the local coordinate axes. By default, the box measures 2 units in each dimension, from -1 to +1. The size field specifies the extents of the box along the X-, Y-, and Z-axes respectively and each component value shall be greater than zero. Figure 1 illustrates the Box node.
+
===Attributes===
<center>http://www.web3d.org/x3d/specifications/ISO-IEC-19775-X3DAbstractSpecification/Images/box.gif<br>Figure 1 - Box node</center>
+
  
 +
* There are no limits on the acceptable range of values for the ''size'' field.
  
Textures are applied individually to each face of the box. On the front (+Z), back (-Z), right (+X), and left (-X) faces of the box, when viewed from the outside with the +Y-axis up, the texture is mapped onto each face with the same orientation as if the image were displayed normally in 2D. On the top face of the box (+Y), when viewed from above and looking down the Y-axis toward the origin with the -Z-axis as the view up direction, the texture is mapped onto the face with the same orientation as if the image were displayed normally in 2D. On the bottom face of the box (-Y), when viewed from below looking up the Y-axis toward the origin with the +Z-axis as the view up direction, the texture is mapped onto the face with the same orientation as if the image were displayed normally in 2D. TextureTransform affects the texture coordinates of the Box.
+
==Schematron validation==
  
 +
TBD
  
The solid field determines whether the box is visible when viewed from the inside.
 
==Authoring Tip==
 
The size of a box cannot be changed after its creation.  In order to change its size you need to place it in a Transform node and change its scale field.
 
==Implementation Tip==
 
The size field is made initializeOnly so implementations can optimize memory and bus bandwidth under the covers.  All instances with the same size can share the same geometry instance. 
 
 
*[[Node Reference]]
 
*[[Node Reference]]

Latest revision as of 14:22, 29 April 2015

Box

Specification Link: Box

Box : X3DGeometryNode { 
  SFNode  [in,out] metadata NULL  [X3DMetadataObject]
  SFVec3f []       size     2 2 2 (0,∞)
  SFBool  []       solid    TRUE
}

DTD Validation

Children

Children must appear as follows:

  1. A single, optional IS.
  2. A single, optional node derived from X3DMetadataObject for the metadata field.

Attributes

  • There are no limits on the acceptable range of values for the size field.

Schema Validation

Children

Children must appear as follows:

  1. A single, optional IS.
  2. A single, optional node derived from X3DMetadataObject for the metadata field.

Attributes

  • There are no limits on the acceptable range of values for the size field.

Schematron validation

TBD