Home Appearance
X_ite
Cancel

Appearance

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

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.

Example

This post is licensed under CC BY 4.0 by the author.