Difference between revisions of "Appearance"

From Web3D.org
Jump to: navigation, search
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
* [[Node Reference]]
 
* [[Node Reference]]
 
==Appearance==
 
==Appearance==
 +
 +
Specification Link: [http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/shape.html#Appearance Appearance]
  
 
<pre>
 
<pre>
Line 8: Line 10:
 
   SFNode [in,out] material        NULL [X3DMaterialNode]
 
   SFNode [in,out] material        NULL [X3DMaterialNode]
 
   SFNode [in,out] metadata        NULL [X3DMetadataObject]
 
   SFNode [in,out] metadata        NULL [X3DMetadataObject]
 +
  MFNode [in,out] shaders          []  [X3DShaderNode]
 
   SFNode [in,out] texture          NULL [X3DTextureNode]
 
   SFNode [in,out] texture          NULL [X3DTextureNode]
 
   SFNode [in,out] textureTransform NULL [X3DTextureTransformNode]
 
   SFNode [in,out] textureTransform NULL [X3DTextureTransformNode]
Line 13: Line 16:
 
</pre>
 
</pre>
  
<p>The Appearance node specifies the visual properties of geometry. The value for each of the fields in this node may be <code>NULL</code>. However, if the field is non-<code>NULL</code>, it shall contain one node of the appropriate type.</p>
+
==DTD Validation==
 +
 
 +
===Children===
 +
 
 +
Children must appear as follows:
 +
 
 +
# A single, optional IS.
 +
# A single, optional node derived from ''X3DMetadataObject'' for the ''metadata'' field.
 +
# Any number, including none, of ''X3DAppearanceChildNodes'' or Prototypes, where ''X3DAppearanceChildNodes'' are:
 +
## [[LineProperties]]
 +
## [[FillProperties]]
 +
## MaterialNodes,  which are
 +
### [[Material]]
 +
### [[TwoSidedMaterial]]
 +
## Texture2DNodes, which are
 +
### [[ImageTexture]]
 +
### [[MovieTexture]]
 +
### [[MultiTexture]]
 +
### [[PixelTexture]]
 +
## CubeMapTextureNodes, which are
 +
### [[ComposedCubeMapTexture]]
 +
### [[GeneratedCubeMapTexture]]
 +
### [[ImageCubeMapTexture]]
 +
## ShaderNodes, which are
 +
### [[ComposedShader]]
 +
### [[PackagedShader]]
 +
### [[ProgramShader]]
 +
## Texture3DTextureNodes, which are
 +
### [[ComposedTexture3D]]
 +
### [[ImageTexture3D]]
 +
### [[PixelTexture3D]]
 +
## TextureTransformNodes, which are
 +
### [[TextureTransform]]
 +
### [[MultiTextureTransform]]
 +
## Texture3DTextureTransformNodes, which are
 +
### [[TextureTransformMatrix3D]]
 +
### [[TextureTransform3D]]
 +
 
 +
Note: There are no limitations on the numbers of nodes to match the interface definition.
 +
 
 +
===Attributes===
 +
 
 +
N/A.
 +
 
 +
==Schema Validation==
 +
 
 +
===Children===
 +
 
 +
Children must appear as follows:
 +
 
 +
# A single, optional IS.
 +
# A single, optional node derived from ''X3DMetadataObject'' for the ''metadata'' field.
 +
# Any number, including none, of either Prototypes, or the nodes listed below:
 +
## [[LineProperties]]
 +
## [[FillProperties]]
 +
## [[Material]]
 +
## [[TwoSidedMaterial]]
 +
## [[ComposedShader]]
 +
## [[PackagedShader]]
 +
## [[ProgramShader]]
 +
## [[ComposedCubeMapTexture]]
 +
## [[ComposedTexture3D]]
 +
## [[ImageTexture]]
 +
## [[ImageTexture3D]]
 +
## [[MovieTexture]]
 +
## [[MultiTexture]]
 +
## [[PixelTexture]]
 +
## [[PixelTexture3D]]
 +
## [[GeneratedCubeMapTexture]]
 +
## [[ImageCubeMapTexture]]
 +
## [[MultiTextureTransform]]
 +
## [[TextureTransform]]
 +
## [[TextureTransform3D]]
 +
## [[TextureTransformMatrix3D]]
 +
 
 +
Note: There are no limitations on the numbers of nodes to match the interface definition.
 +
 
 +
===Attributes===
  
<p>The <i>material</i> field, if specified, shall contain a Material node. If the <i>material</i> field is <code>NULL</code> or unspecified, lighting is off (all lights are ignored during rendering of the object that references this Appearance) and the unlit object colour is (1, 1, 1). Details of the X3D lighting model are in 17 Lighting component.</p>
+
N/A
  
<p>The <i>texture</i> field, if specified, shall contain one of the various types of texture nodes (see: Texturing component). If the texture node is <code>NULL</code> or the <i>texture</i> field is unspecified, the object that references this Appearance is not textured.</p>
+
==Schematron Validation==
  
<p>The <i>textureTransform</i> field, if specified, shall contain a TextureTransform node as defined in 18.4.8 TextureTransform. If the textureTransform is <code>NULL</code> or unspecified, the <i>textureTransform</i> field has no effect.</p>
+
TBD
  
<p>The <i>lineProperties</i> field, if specified, shall contain a LineProperties node as specified in 12.4.3 LineProperties. If lineProperties is <code>NULL</code> or unspecified, the <i>lineProperties</i> field has no effect.</p>
 
  
<p>The <i>fillProperties</i> field, if specified, shall contain a FillProperties node as specified in 12.4.2 FillProperties. If fillProperties is <code>NULL</code> or unspecified, the <i>fillProperties</i> field has no effect.</p>
 
 
* [[Node Reference]]
 
* [[Node Reference]]

Latest revision as of 09:42, 24 April 2015

Appearance

Specification Link: Appearance

Appearance : X3DAppearanceNode { 
  SFNode [in,out] fillProperties   NULL [FillProperties]
  SFNode [in,out] lineProperties   NULL [LineProperties]
  SFNode [in,out] material         NULL [X3DMaterialNode]
  SFNode [in,out] metadata         NULL [X3DMetadataObject]
  MFNode [in,out] shaders          []   [X3DShaderNode]
  SFNode [in,out] texture          NULL [X3DTextureNode]
  SFNode [in,out] textureTransform NULL [X3DTextureTransformNode]
}

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.
  3. Any number, including none, of X3DAppearanceChildNodes or Prototypes, where X3DAppearanceChildNodes are:
    1. LineProperties
    2. FillProperties
    3. MaterialNodes, which are
      1. Material
      2. TwoSidedMaterial
    4. Texture2DNodes, which are
      1. ImageTexture
      2. MovieTexture
      3. MultiTexture
      4. PixelTexture
    5. CubeMapTextureNodes, which are
      1. ComposedCubeMapTexture
      2. GeneratedCubeMapTexture
      3. ImageCubeMapTexture
    6. ShaderNodes, which are
      1. ComposedShader
      2. PackagedShader
      3. ProgramShader
    7. Texture3DTextureNodes, which are
      1. ComposedTexture3D
      2. ImageTexture3D
      3. PixelTexture3D
    8. TextureTransformNodes, which are
      1. TextureTransform
      2. MultiTextureTransform
    9. Texture3DTextureTransformNodes, which are
      1. TextureTransformMatrix3D
      2. TextureTransform3D

Note: There are no limitations on the numbers of nodes to match the interface definition.

Attributes

N/A.

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.
  3. Any number, including none, of either Prototypes, or the nodes listed below:
    1. LineProperties
    2. FillProperties
    3. Material
    4. TwoSidedMaterial
    5. ComposedShader
    6. PackagedShader
    7. ProgramShader
    8. ComposedCubeMapTexture
    9. ComposedTexture3D
    10. ImageTexture
    11. ImageTexture3D
    12. MovieTexture
    13. MultiTexture
    14. PixelTexture
    15. PixelTexture3D
    16. GeneratedCubeMapTexture
    17. ImageCubeMapTexture
    18. MultiTextureTransform
    19. TextureTransform
    20. TextureTransform3D
    21. TextureTransformMatrix3D

Note: There are no limitations on the numbers of nodes to match the interface definition.

Attributes

N/A

Schematron Validation

TBD