instantreality 1.0

Component:
Geometry3D
Status:
fully implemented
Structure type:
concrete
Standard:
Avalon

FaceSet

The FaceSet node represents a 3D geometry formed by constructing faces from 3D vertices specified in the "vertexCount" field. Number of vertices in the "vertexCount" field shall be [3,inf)

Inheritance

Code

XML encoding
<FaceSet vertexCount=''
lit='TRUE'
convex='TRUE'
normalPerVertex='TRUE'
colorPerVertex='TRUE'
ccw='TRUE'
creaseAngle='0'
solid='TRUE'
showNormalLength='0'
resolution='1'
multiResolutionLevel='1'
invalidateVolume='FALSE'
normalUpdateMode='nice'
cacheMode='auto'
optimizationMode='auto'
logFeature=''
 />
Classic encoding
FaceSet {
	vertexCount []
	lit TRUE
	convex TRUE
	normalPerVertex TRUE
	colorPerVertex TRUE
	ccw TRUE
	creaseAngle 0
	solid TRUE
	showNormalLength 0
	resolution 1
	multiResolutionLevel 1
	invalidateVolume FALSE
	normalUpdateMode "nice"
	cacheMode "auto"
	optimizationMode ["auto"]
	logFeature [""]
}

Interface

Filter: X3D only | Avalon only | All
id Name DataType PartType Default ValueType Description
SFString cacheMode SFString initializeOnly auto auto; dlist; vbo; off controls the creation of geo cache objects; auto is vbo or dlist for dynamic objects
SFBool ccw SFBool initializeOnly TRUE ccw = counterclockwise: ordering of vertex coordinates orientation. Hint: "ccw" false can reverse solid (backface culling) and normal-vector orientation.
SFBool colorPerVertex SFBool initializeOnly TRUE Whether Color node is applied per vertex (true) or per polygon (false).
SFBool convex SFBool initializeOnly TRUE Specifies whether all polygons in a shape are convex. A convex polygon is planar, does not intersect itself, and has all interior angles less then; 180 degrees. Warning: Non planar and self intersecting polygons may produce undefined results even if the convex field is FALSE.
SFFloat creaseAngle SFFloat initializeOnly 0 [0, Inf) "creaseAngle" defines angle (in radians) for determining whether adjacent polygons are drawn with sharp edges or smooth shading. If angle between normals of two adjacent polygons is less than "creaseAngle", smooth shading is rendered across the shared line segment. Interchange profile hint: only 0 and radians supported. Hint: creaseAngle=0 means render all edges sharply, creaseAngle=3.14 means render all edges smoothly.
SFInt32 multiResolutionLevel SFInt32 initializeOnly 1 resolution level in progressive mesh
SFBool normalPerVertex SFBool initializeOnly TRUE Whether Normal node is applied per vertex (true) or per polygon (false).
SFString normalUpdateMode SFString initializeOnly nice none; fast; nice force update of normals; nice update is with creaseAngle, fast is without
SFBool solid SFBool initializeOnly TRUE Setting "solid" true means draw only one side of polygons (backface culling on), setting "solid" false means draw both sides of polygons (backface culling off). Warning: default value true can completely hide geometry if viewed from wrong side!
MFNode attrib MFNode inputOutput VertexAttribute If the "attrib" field is not empty it shall contain a list of per-vertex attribute information for programmable shaders
SFNode color SFNode inputOutput Color If NULL the geometry is rendered using the Material and texture defined in the Appearance node. If not NULL the field shall contain a Color node whose colours are applied depending on the value of "colorPerVertex".
SFNode coord SFNode inputOutput Coordinate Coordinate node specifiying the vertices used by the geometry.
SFNode fogCoord SFNode inputOutput FogCoordinate If not NULL, it shall contain a FogCoordinate node.
SFBool invalidateVolume SFBool inputOutput FALSE set volume invalid
SFBool lit SFBool inputOutput TRUE Specifies whether the Shape is lit.
MFString logFeature MFString inputOutput state, child, parent, route, eventIn, eventOut controls the logging of changes, state: log state changes (e.g. live), child: log child add/remove, parent: log parent add/remove, route: log route add/remove; eventIn: log receiving of events, eventOut: log sending of events: guiView, runtime system should create node-view, guiEdit: runtime system should create node-editeverything: log everything
SFNode metadata SFNode inputOutput MetadataObject container for payload metadata inside MetadataSet element
SFNode normal SFNode inputOutput Normal If not NULL, it shall contain a Normal node whose normals are applied to the vertices or faces of the geometry.
MFString optimizationMode MFString inputOutput auto auto; all, none, sharedVertex; stripFan; vertexResort; reduceIndexSize; singleIndex optimization mode settings; used leading +/- to switch modes on and off
SFFloat resolution SFFloat inputOutput 1 factor for subdivision of mesh
SFFloat showNormalLength SFFloat inputOutput 0 [0, Inf) Length of normals. If zero (default), normals are not shown.
SFNode texCoord SFNode inputOutput TextureCoordinateBase If not NULL, it shall contain a TextureCoordinate node.
MFInt32 vertexCount MFInt32 inputOutput [3, inf) Describes how many vertices are to be used in each face from the coordinate field. Coordinates are assigned to each face by taking vertexCount[n] vertices from the coordinate field.