All Superinterfaces:: X3DBoundedObject, X3DChildNode, X3DNode

All Known Implementing Classes:: NurbsSet

public interface NurbsSet extends X3DChildNode, X3DBoundedObject

NurbsSet collects a set of NurbsSurface nodes into a common group and treats NurbsSurface set as a unit during tessellation, thereby enforcing tessellation continuity along borders.

Warning: this is an abstract interface that cannot be instantiated as a concrete object. Java programmers typically only need to use concrete objects provided by the org.web3d.x3d.jsail classes. X3D node tooltip: [X3DChildNode,X3DBoundedObject] NurbsSet collects a set of NurbsSurface nodes into a common group and treats NurbsSurface set as a unit during tessellation, thereby enforcing tessellation continuity along borders. Warning: geometry represented in children of this node shall not be directly rendered. It is an informational node only. Warning: Surfaces not represented elsewhere in transformation hierarchy shall not be rendered. Hint: USE nodes for geometry ensure renderable versions occur elsewhere in the model. The bounds information is provided for optimization purposes only. A browser may choose to use this information about when to apply trimming or smooth tessellation between patches based on the bounds information. *

Package hint: This interface is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI).

See Also:

Method Summary

Modifier and Type

Method

Description

void

addGeometry(X3DNode[] newValue)

Add array of child geometry nodes to array of existing nodes (if any).

float[]

getBboxCenter()

Provide array of 3-tuple float results from initializeOnly SFVec3f field named bboxCenter.

boolean

getBboxDisplay()

Provide boolean value from inputOutput SFBool field named bboxDisplay.

float[]

getBboxSize()

Provide array of 3-tuple float results within allowed range of [0,infinity), or default value [-1 -1 -1], from initializeOnly SFVec3f field named bboxSize.

X3DNode[]

getGeometry()

Provide array of org.web3d.x3d.sai.Core.X3DNode results (using an array consisting of properly typed nodes or ProtoInstances) from inputOutput MFNode field geometry.

X3DMetadataObject

getMetadata()

Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.

float

getTessellationScale()

Provide float value within allowed range of (0,infinity) from inputOutput SFFloat field named tessellationScale.

boolean

getVisible()

Provide boolean value from inputOutput SFBool field named visible.

NurbsSet

setBboxCenter(float[] newValue)

Accessor method to assign 3-tuple float array to initializeOnly SFVec3f field named bboxCenter.

NurbsSet

setBboxDisplay(boolean newValue)

Accessor method to assign boolean value to inputOutput SFBool field named bboxDisplay.

NurbsSet

setBboxSize(float[] newValue)

Accessor method to assign 3-tuple float array to initializeOnly SFVec3f field named bboxSize.

void

setGeometry(X3DNode newValue)

Set single child geometry node, replacing prior array of existing nodes (if any).

NurbsSet

setGeometry(X3DNode[] newValue)

Accessor method to assign org.web3d.x3d.sai.Core.X3DNode array (using an array consisting of properly typed nodes or ProtoInstances) to inputOutput MFNode field geometry.

NurbsSet

setMetadata(X3DMetadataObject newValue)

Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.

NurbsSet

setTessellationScale(float newValue)

Accessor method to assign float value to inputOutput SFFloat field named tessellationScale.

NurbsSet

setVisible(boolean newValue)

Accessor method to assign boolean value to inputOutput SFBool field named visible.

Method Details
- getBboxCenter
  
  float[] getBboxCenter()
  
  Provide array of 3-tuple float results from initializeOnly SFVec3f field named bboxCenter.
  
  Tooltip: Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system. Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size. Hint: X3D Architecture, 10.2.2 Bounding boxes <a href="https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#BoundingBoxes" target="_blank">https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#BoundingBoxes</a> Hint: X3D Architecture, 10.3.1 X3DBoundedObject <a href="https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#X3DBoundedObject" target="_blank">https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#X3DBoundedObject</a> *
  
  Specified by:
  
  getBboxCenter in interface X3DBoundedObject
  
  Returns:
  
  value of bboxCenter field
- setBboxCenter
  
  NurbsSet setBboxCenter(float[] newValue)
  
  Accessor method to assign 3-tuple float array to initializeOnly SFVec3f field named bboxCenter.
  
  Tooltip: Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system. Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size. Hint: X3D Architecture, 10.2.2 Bounding boxes <a href="https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#BoundingBoxes" target="_blank">https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#BoundingBoxes</a> Hint: X3D Architecture, 10.3.1 X3DBoundedObject <a href="https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#X3DBoundedObject" target="_blank">https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#X3DBoundedObject</a> *
  
  Specified by:
  
  setBboxCenter in interface X3DBoundedObject
  
  Parameters:
  
  newValue - is new value for the bboxCenter field.
  
  Returns:
  
  NurbsSet - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
- getBboxDisplay
  
  boolean getBboxDisplay()
  
  Provide boolean value from inputOutput SFBool field named bboxDisplay.
  
  Tooltip: Whether to display bounding box for associated geometry, aligned with world coordinates. Hint: the bounding box is displayed regardless of whether contained content is visible. *
  
  Specified by:
  
  getBboxDisplay in interface X3DBoundedObject
  
  Returns:
  
  value of bboxDisplay field
- setBboxDisplay
  
  NurbsSet setBboxDisplay(boolean newValue)
  
  Accessor method to assign boolean value to inputOutput SFBool field named bboxDisplay.
  
  Tooltip: Whether to display bounding box for associated geometry, aligned with world coordinates. Hint: the bounding box is displayed regardless of whether contained content is visible. *
  
  Specified by:
  
  setBboxDisplay in interface X3DBoundedObject
  
  Parameters:
  
  newValue - is new value for the bboxDisplay field.
  
  Returns:
  
  NurbsSet - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
- getBboxSize
  
  float[] getBboxSize()
  
  Provide array of 3-tuple float results within allowed range of [0,infinity), or default value [-1 -1 -1], from initializeOnly SFVec3f field named bboxSize.
  
  Tooltip: or [0,+infinity) Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint. Hint: can be useful for collision computations or inverse-kinematics (IK) engines. Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size. Hint: X3D Architecture, 10.2.2 Bounding boxes <a href="https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#BoundingBoxes" target="_blank">https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#BoundingBoxes</a> Hint: X3D Architecture, 10.3.1 X3DBoundedObject <a href="https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#X3DBoundedObject" target="_blank">https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#X3DBoundedObject</a> *
  
  Specified by:
  
  getBboxSize in interface X3DBoundedObject
  
  Returns:
  
  value of bboxSize field
- setBboxSize
  
  NurbsSet setBboxSize(float[] newValue)
  
  Accessor method to assign 3-tuple float array to initializeOnly SFVec3f field named bboxSize.
  
  Tooltip: or [0,+infinity) Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint. Hint: can be useful for collision computations or inverse-kinematics (IK) engines. Hint: precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size. Hint: X3D Architecture, 10.2.2 Bounding boxes <a href="https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#BoundingBoxes" target="_blank">https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#BoundingBoxes</a> Hint: X3D Architecture, 10.3.1 X3DBoundedObject <a href="https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#X3DBoundedObject" target="_blank">https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/grouping.html#X3DBoundedObject</a> *
  
  Specified by:
  
  setBboxSize in interface X3DBoundedObject
  
  Parameters:
  
  newValue - is new value for the bboxSize field.
  
  Returns:
  
  NurbsSet - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
- getGeometry
  X3DNode[] getGeometry()
  
  Provide array of org.web3d.x3d.sai.Core.X3DNode results (using an array consisting of properly typed nodes or ProtoInstances) from inputOutput MFNode field geometry.
  
  Tooltip: [NurbsPatchSurface|NurbsTrimmedSurface] The children form a closed loop with first point of first child repeated as last point of last child, and the last point of a segment repeated as first point of the consecutive one. Hint: children nodes are listed in consecutive order according to topology of the contour. Warning: geometry represented in children of this node shall not be directly rendered. It is an informational node only. Warning: Surfaces not represented elsewhere in transformation hierarchy shall not be rendered. Hint: utilizing USE nodes for geometry can ensure that rendered geometry occurs elsewhere in the model. *
  
  Warning: according to X3D Unified Object Model (X3DUOM), acceptable node types are limited to X3DParametricGeometryNode.
  
  Returns:
  
  value of geometry field
  
  See Also:
  
  X3DParametricGeometryNode
- setGeometry
  
  NurbsSet setGeometry(X3DNode[] newValue)
  
  Accessor method to assign org.web3d.x3d.sai.Core.X3DNode array (using an array consisting of properly typed nodes or ProtoInstances) to inputOutput MFNode field geometry.
  
  Tooltip: [NurbsPatchSurface|NurbsTrimmedSurface] The children form a closed loop with first point of first child repeated as last point of last child, and the last point of a segment repeated as first point of the consecutive one. Hint: children nodes are listed in consecutive order according to topology of the contour. Warning: geometry represented in children of this node shall not be directly rendered. It is an informational node only. Warning: Surfaces not represented elsewhere in transformation hierarchy shall not be rendered. Hint: utilizing USE nodes for geometry can ensure that rendered geometry occurs elsewhere in the model. *
  
  Note: according to X3D Unified Object Model (X3DUOM), acceptable node types are limited to X3DParametricGeometryNode.
  
  Parameters:
  
  newValue - is new value for the geometry field.
  
  Returns:
  
  NurbsSet - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
- addGeometry
  
  void addGeometry(X3DNode[] newValue)
  
  Add array of child geometry nodes to array of existing nodes (if any).
  
  Note: according to X3D Unified Object Model (X3DUOM), acceptable node types are limited to X3DParametricGeometryNode.
  
  Parameters:
  
  newValue - is new value array to be appended the geometry field.
- setGeometry
  
  void setGeometry(X3DNode newValue)
  
  Set single child geometry node, replacing prior array of existing nodes (if any).
  
  Parameters:
  
  newValue - is new node for the geometry field
- getMetadata
  X3DMetadataObject getMetadata()
  
  Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.
  
  Tooltip: [X3DMetadataObject] Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node. Hint: X3D Architecture 7.2.4 Metadata <a href="https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/core.html#Metadata" target="_blank">https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/core.html#Metadata</a> *
  
  Specified by:
  
  getMetadata in interface X3DChildNode
  
  Specified by:
  
  getMetadata in interface X3DNode
  
  Returns:
  
  value of metadata field
  
  See Also:
  
  X3D Scene Authoring Hints: Metadata Nodes
- setMetadata
  NurbsSet setMetadata(X3DMetadataObject newValue)
  
  Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.
  
  Tooltip: [X3DMetadataObject] Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node. Hint: X3D Architecture 7.2.4 Metadata <a href="https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/core.html#Metadata" target="_blank">https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS//Part01/components/core.html#Metadata</a> *
  
  Specified by:
  
  setMetadata in interface X3DChildNode
  
  Specified by:
  
  setMetadata in interface X3DNode
  
  Parameters:
  
  newValue - is new value for the metadata field.
  
  Returns:
  
  NurbsSet - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
  
  See Also:
  
  X3D Scene Authoring Hints: Metadata Nodes
- getTessellationScale
  
  float getTessellationScale()
  
  Provide float value within allowed range of (0,infinity) from inputOutput SFFloat field named tessellationScale.
  
  Tooltip: scale for surface tessellation in children NurbsSurface nodes. *
  
  Returns:
  
  value of tessellationScale field
- setTessellationScale
  
  NurbsSet setTessellationScale(float newValue)
  
  Accessor method to assign float value to inputOutput SFFloat field named tessellationScale.
  
  Tooltip: scale for surface tessellation in children NurbsSurface nodes. *
  
  Parameters:
  
  newValue - is new value for the tessellationScale field.
  
  Returns:
  
  NurbsSet - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).
- getVisible
  
  boolean getVisible()
  
  Provide boolean value from inputOutput SFBool field named visible.
  
  Tooltip: Whether or not renderable content within this node is visually displayed. Hint: the visible field has no effect on animation behaviors, event passing or other non-visual characteristics. Hint: content must be visible to be collidable and to be pickable. *
  
  Specified by:
  
  getVisible in interface X3DBoundedObject
  
  Returns:
  
  value of visible field
- setVisible
  
  NurbsSet setVisible(boolean newValue)
  
  Accessor method to assign boolean value to inputOutput SFBool field named visible.
  
  Tooltip: Whether or not renderable content within this node is visually displayed. Hint: the visible field has no effect on animation behaviors, event passing or other non-visual characteristics. Hint: content must be visible to be collidable and to be pickable. *
  
  Specified by:
  
  setVisible in interface X3DBoundedObject
  
  Parameters:
  
  newValue - is new value for the visible field.
  
  Returns:
  
  NurbsSet - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

Interface NurbsSet

Method Summary

Method Details

getBboxCenter

setBboxCenter

getBboxDisplay

setBboxDisplay

getBboxSize

setBboxSize

getGeometry

setGeometry

addGeometry

setGeometry

getMetadata

setMetadata

getTessellationScale

setTessellationScale

getVisible

setVisible