Overview
Appearance specifies the visual properties of geometry by containing the Material, ImageTexture/MovieTexture/PixelTexture, FillProperties, LineProperties, and TextureTransform nodes.
The Appearance node belongs to the Shape component and its default container field is appearance. It is available since X3D version 2.0 or later.
Hierarchy
1
2
3
+ X3DNode
+ X3DAppearanceNode
+ Appearance
Fields
SFNode [in, out] metadata NULL [X3DMetadataObject]
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] alphaMode “AUTO” [“AUTO”|”OPAQUE”|”MASK”|”BLEND”]
Provides options for control of alpha transparency handling for textures. AUTO means Material transparency is applied to texture transparency for full backwards compatibility with X3D3, OPAQUE means ignore alpha transparency to render texture as opaque, MASK means alpha-testing of pixels as fully transparent when alpha value is less than alphaCutoff and fully opaque when alpha value is greater than or equal to alphaCutoff, BLEND combines partial transparency of textures and materials.
Hint
SFFloat [in, out] alphaCutoff 0.5 [0,1]
Threshold value used for pixel rendering either transparent or opaque, used when alphaMode=”MASK”.
Hint
SFNode [in, out] pointProperties NULL [PointProperties]
Single contained PointProperties node that can specify additional visual attributes applied to corresponding point geometry.
SFNode [in, out] lineProperties NULL [LineProperties]
Single contained LineProperties node that can specify additional visual attributes applied to corresponding line geometry.
SFNode [in, out] fillProperties NULL [FillProperties]
Single contained FillProperties node that can specify additional visual attributes applied to polygonal areas of corresponding geometry, on top of whatever other appearance is already defined.
SFNode [in, out] material NULL [X3DMaterialNode]
Single contained Material node that can specify visual attributes for lighting response (color types, transparency, etc.) applied to corresponding geometry.
Warning
- If material is NULL or unspecified, lighting is off (all lights ignored) for this Shape and unlit object color is (1, 1, 1).
SFNode [in, out] backMaterial NULL [X3DOneSidedMaterialNode]
Single contained Material node that can specify visual attributes for lighting response (color types, transparency, etc.) applied to corresponding geometry.
SFNode [in, out] texture NULL [X3DTextureNode]
Single contained texture node (ImageTexture, MovieTexture, PixelTexture, MultiTexture) that maps image(s) to surface geometry.
Hints
- If texture node is NULL or unspecified, corresponding Shape geometry for this Appearance is not textured.
- X3D Scene Authoring Hints, Images
- 3D Architecture 18 Texturing component
- X3D Architecture 33 Texturing3D component
SFNode [in, out] textureTransform NULL [X3DTextureTransformNode]
Single contained TextureTransform node that defines 2D transformation applied to texture coordinates.
Hint
- If textureTransform array is empty, then this field has no effect.
MFNode [in, out] shaders [ ] [X3DShaderNode]
Zero or more contained programmable shader nodes (ComposedShader, PackagedShader, ProgramShader) that specify, in order of preference, author-programmed rendering characteristics.
Hint
SFNode [in, out] blendMode NULL [BlendMode] non standard
Single contained BlendMode node that defines blend mode properties.
SFNode [in, out] acousticProperties NULL [AcousticProperties]
Single contained acousticProperties node that can specify additional acoustic attributes applied to associated surface geometry.
Description
Hints
- Insert a Shape node before adding geometry or Appearance. Interchange profile hint: only Material and ImageTexture children are allowed.
- DEF/USE copies of a single node can provide a similar “look + feel” style for related shapes in a scene.
- Advanced uses can contain MultiTexture, MultiTextureTransform/TextureTransformMatrix3D/TextureTransform3D, ComposedShader/PackagedShader/ProgramShader, ComposedTexture3D/ImageTexture3D/PixelTexture3D, or ComposedCubeMapTexture/GeneratedCubeMapTexture/ImageCubeMapTexture.