com.openinventor.inventor.vrmlnodes

Class SoVRMLCone

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.inventor.nodes.SoShape

com.openinventor.inventor.vrmlnodes.SoVRMLGeometry

com.openinventor.inventor.vrmlnodes.SoVRMLCone

All Implemented Interfaces:

SafeDisposable

Deprecated.

As of Open Inventor 9500 See documentation for more details

public class SoVRMLCone
extends SoVRMLGeometry

Cone shape node. See the VRML97 Specification, below.

<font color="#0000FF">NOTE:</font> This class does not exist in Open Inventor 10.0 and later.

OpenGL vertex arrays are used if they are available and if the environment variable IV_NO_VERTEX_ARRAY is not set.

VRML97 SPECIFICATION

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 http://www.web3d.org.

The SoVRMLCone node specifies a cone which is centered in the local coordinate system and whose central axis is aligned with the local Y-axis. The bottonRadius field specifies the radius of the cone's base, and the height field specifies the height of the cone from the center of the base to the apex. By default, the cone has a radius of 1.0 at the bottom and a height of 2.0, with its apex at y=1 and its bottom at y=-1. Both bottomRadius and height must be greater than 0.0.

The side field specifies whether sides of the cone are created, and the bottom field specifies whether the bottom cap of the cone is created. A value of true specifies that this part of the cone exists, while a value of false specifies that this part does not exist (not rendered). Parts with field values of false are not collided with during collision detection.

When a texture is applied to the sides of the cone, the texture wraps counterclockwise (from above) starting at the back of the cone. The texture has a vertical seam at the back in the YZ plane, from the apex (0, height/2, 0) to the point (0, 0, -r). For the bottom cap, a circle is cut out of the unit texture square centered at (0, -height/2, 0) with dimensions (2 * bottomRadius) by (2 * bottomRadius) . The bottom cap texture appears right side up when the top of the cone is rotated towards the -Z axis. SoVRMLTextureTransform affects the texture coordinates of the SoVRMLCone.

The SoVRMLCone geometry is considered to be solid and thus requires outside faces only. When viewed from the inside the results are undefined.

File format/default:

VRMLCone {

bottomRadius	1
height	2
side	true
bottom	true
solid	true
metadata	NULL

}

eventIn

SoSFNode

set_metadata

eventOut

SoSFNode

metadata_changed

Action behavior:

SoGLRenderAction, SoRayPickAction, SoGetBoundingBoxAction, SoCallbackAction
Deprecated since Open Inventor 9500
The VRML API is no longer supported. See section http://oivdoc95.vsg3d.com/content/compatibility-notes-4#Deprecation of the Reference Manual.

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoShape

SoShape.ShapeTypes

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
SoSFBool	bottom Deprecated. Specifies whether the bottom cap of the cone is created.
SoSFFloat	bottomRadius Deprecated. Specifies the radius of the base circle; value must be greater than 0.0.
SoSFFloat	height Deprecated. Specifies the cone's height; value must be greater than 0.0.
SoSFBool	side Deprecated. Specifies whether the sides of the cone are created.
SoSFBool	solid Deprecated. Determines whether the cone is visible when viewed from the inside.

Fields inherited from class com.openinventor.inventor.vrmlnodes.SoVRMLGeometry

metadata

Fields inherited from class com.openinventor.inventor.nodes.SoShape

boundingBoxIgnoring, LINES, POINTS, POLYGONS, TEXT

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoVRMLCone() Deprecated. Constructor.

Method Summary

Methods inherited from class com.openinventor.inventor.nodes.SoShape

getShapeType, isPrimitiveRestartAvailable, isPrimitiveRestartAvailable

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, 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, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

bottomRadius

public final SoSFFloat bottomRadius

Deprecated.

Specifies the radius of the base circle; value must be greater than 0.0.

height

public final SoSFFloat height

Deprecated.

Specifies the cone's height; value must be greater than 0.0.

side

public final SoSFBool side

Deprecated.

Specifies whether the sides of the cone are created.

bottom

public final SoSFBool bottom

Deprecated.

Specifies whether the bottom cap of the cone is created.

solid

public final SoSFBool solid

Deprecated.

Determines whether the cone is visible when viewed from the inside.

Since:

Open Inventor 5.0 NOTE 2: This field is not compatible with VRML97. If you specify a non-default value for this field, when this node is written to a VRML file, the file will contain this incompatible field and standard VRML97 file readers will not be able to read it.

Constructor Detail

SoVRMLCone

public SoVRMLCone()

Deprecated.

Constructor.