public class SoVRMLElevationGrid extends SoVRMLGridShape
<font color="#0000FF">NOTE:</font> This class does not exist in Open Inventor 10.0 and later.
This section describes the expected behavior of the node in a conforming VRML97 browser application. In some cases, the application is responsible for implementing portions of the expected behavior. Open Inventor viewer classes and IVF classes implement some of the application behaviors.
This section may reference portions of the VRML97 specification that are not present in this help file. The complete VRML97 spec is available at
The SoVRMLElevationGrid node specifies a uniform rectangular grid of varying height in the XZ plane of the local coordinate system. The geometry is described by a scalar array of height values that specify the height of a rectangular surface above each point of the grid.
The xDimension and zDimension fields indicate the number of divisions of the grid height array in the X and Z directions. Both xDimension and zDimension must be > 1. The vertex locations for the rectangles are defined by the height field and the xSpacing and zSpacing fields:
Thus, the vertex corresponding to the point, P[ i, j], on the grid is placed at:
where 0<i< xDimension and 0<j< zDimension .P[i,j].x = @I xSpacing @i * i P[i,j].y = @I height @i[ i + j * @I zDimension @i] P[i,j].z = @I zSpacing @i * j
The set_height eventIn allows the height MFFloat field to be changed to allow animated SoVRMLElevationGrids.
The default texture coordinates range from [0,0] at the first vertex to [1,1] at the last vertex. The S texture coordinate will be aligned with X, and the T texture coordinate with Z.
The colorPerVertex field determines whether colors (if specified in the color field) should be applied to each vertex or each quadrilateral of the SoVRMLElevationGrid. If colorPerVertex is false and the color field is not NULL, then the color field must contain a Color node containing at least ( xDimension-1) *( zDimension-1) colors. If colorPerVertex is true and the color field is not NULL, then the color field must contain a Color node containing at least xDimension * zDimension colors.
See the "Concepts - Geometry" for a description of the ccw, solid, and creaseAngle fields.
By default, the rectangles are defined with a counterclockwise ordering, so the Y component of the normal is positive. Setting the ccw field to false reverses the normal direction. Backface culling is enabled when the ccw field and the solid field are both true (the default).
NOTE: An elevation grid may not render or pick correctly if any of its polygons are self-intersecting or non-planar.
File format/default:
VRMLElevationGrid {
| color | NULL |
| normal | NULL |
| texCoord | NULL |
| height | [] |
| ccw | true |
| colorPerVertex | true |
| creaseAngle | 0 |
| normalPerVertex | true |
| solid | true |
| xDimension | 0 |
| xSpacing | 0.0 |
| zDimension | 0 |
| zSpacing | 0.0 |
| metadata | NULL |
Action behavior:
SoGLRenderAction, SoRayPickAction, SoGetBoundingBoxAction, SoCallbackAction
Deprecated since Open Inventor 9500
SoShape.ShapeTypesInventor.ConstructorCommand| Modifier and Type | Field and Description |
|---|---|
SoSFBool |
ccw
Deprecated.
Indicates whether the vertices are ordered in a counterclockwise direction when viewed from the outside (true) or in a clockwise direction (false).
|
SoSFFloat |
creaseAngle
Deprecated.
Indicates the minimum angle (in radians) between two adjacent face normals required to form a sharp crease at the edge when default normals are computed and used.
|
SoSFBool |
solid
Deprecated.
If you know that the shape encloses a volume, set this value to true.
|
color, colorPerVertex, height, normal, normalPerVertex, texCoord, xDimension, xSpacing, zDimension, zSpacingmetadataboundingBoxIgnoring, LINES, POINTS, POLYGONS, TEXTVERBOSE_LEVEL, ZeroHandle| Constructor and Description |
|---|
SoVRMLElevationGrid()
Deprecated.
Constructor.
|
getShapeType, isPrimitiveRestartAvailable, isPrimitiveRestartAvailableaffectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, writecopyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaultsdispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizablegetAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreadspublic final SoSFBool ccw
public final SoSFBool solid
public final SoSFFloat creaseAngle
Generated on January 23, 2025, Copyright © Thermo Fisher Scientific. All rights reserved. http://www.openinventor.com