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 |
---|---|---|---|---|---|---|
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. | ||
lit | SFBool | inputOutput | TRUE | Specifies whether the Shape is lit. | ||
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. | ||
coord | SFNode | inputOutput | Coordinate | Coordinate node specifiying the vertices used by the geometry. | ||
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. | ||
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". | ||
texCoord | SFNode | inputOutput | TextureCoordinateBase | If not NULL, it shall contain a TextureCoordinate node. | ||
fogCoord | SFNode | inputOutput | FogCoordinate | If not NULL, it shall contain a FogCoordinate node. | ||
attrib | MFNode | inputOutput | VertexAttribute | If the "attrib" field is not empty it shall contain a list of per-vertex attribute information for programmable shaders | ||
normalPerVertex | SFBool | initializeOnly | TRUE | Whether Normal node is applied per vertex (true) or per polygon (false). | ||
colorPerVertex | SFBool | initializeOnly | TRUE | Whether Color node is applied per vertex (true) or per polygon (false). | ||
ccw | SFBool | initializeOnly | TRUE | ccw = counterclockwise: ordering of vertex coordinates orientation. Hint: "ccw" false can reverse solid (backface culling) and normal-vector orientation. | ||
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. | |
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! | ||
showNormalLength | SFFloat | inputOutput | 0 | [0, Inf) | Length of normals. If zero (default), normals are not shown. | |
resolution | SFFloat | inputOutput | 1 | factor for subdivision of mesh | ||
multiResolutionLevel | SFInt32 | initializeOnly | 1 | resolution level in progressive mesh | ||
invalidateVolume | SFBool | inputOutput | FALSE | set volume invalid | ||
normalUpdateMode | SFString | initializeOnly | nice | none; fast; nice | force update of normals; nice update is with creaseAngle, fast is without | |
cacheMode | SFString | initializeOnly | auto | auto; dlist; vbo; off | controls the creation of geo cache objects; auto is vbo or dlist for dynamic objects | |
optimizationMode | MFString | inputOutput | auto | auto; all, none, sharedVertex; stripFan; vertexResort; reduceIndexSize; singleIndex | optimization mode settings; used leading +/- to switch modes on and off | |
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 | ||
metadata | SFNode | inputOutput | MetadataObject | container for payload metadata inside MetadataSet element |