Package org.web3d.x3d.sai.Geometry2D

Interface Polyline2D

All Superinterfaces:

X3DGeometryNode, X3DNode

All Known Implementing Classes:

Polyline2D

public interface Polyline2D
extends X3DGeometryNode

Polyline2D is a geometry node that defines a connected set of vertices in a contiguous set of line segments in X-Y plane.

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. Polyline2D node tooltip: [X3DGeometryNode] Polyline2D is a geometry node that defines a connected set of vertices in a contiguous set of line segments in X-Y plane.

• Hint: Material emissiveColor in corresponding Appearance is used for rendering lines.
• Warning: lines are not lit, are not texture-mapped, and do not participate in collision detection.
• Warning: use a different Material emissiveColor than the Background color, otherwise geometry is invisible.
• Hint: adding LineProperties to the corresponding Appearance node can modify the rendering style of these lines.
• Hint: insert a Shape node before adding geometry or Appearance. Examples: X3D Example Archives, X3D for Web Authors, Chapter 10 Geometry 2D https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter10Geometry2D

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

See Also:

• SAI Java Specification
• X3D Abstract Specification: Polyline2D
• X3D Tooltips: Polyline2D
• X3D Scene Authoring Hints

Method Summary

Modifier and Type	Method	Description
float[]	getLineSegments()	Provide array of 2-tuple float results from initializeOnly MFVec2f field named lineSegments.
X3DMetadataObject	getMetadata()	Provide org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) from inputOutput SFNode field metadata.
Polyline2D	setLineSegments(float[] newValue)	Accessor method to assign 2-tuple float array to initializeOnly MFVec2f field named lineSegments.
Polyline2D	setMetadata(X3DMetadataObject newValue)	Accessor method to assign org.web3d.x3d.sai.Core.X3DMetadataObject instance (using a properly typed node) to inputOutput SFNode field metadata.

Method Details

getLineSegments

float[] getLineSegments()

Provide array of 2-tuple float results from initializeOnly MFVec2f field named lineSegments.

Tooltip: Coordinates of vertices connected into contiguous Polyline2D.

• Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, avoiding the need for potentially expensive tessellation at run time.
• Hint: for size animation, modify the scale of a parent/ancestor Transform node instead.

Returns:

value of lineSegments field

setLineSegments

Polyline2D setLineSegments(float[] newValue)

Accessor method to assign 2-tuple float array to initializeOnly MFVec2f field named lineSegments.

Tooltip: Coordinates of vertices connected into contiguous Polyline2D.

• Warning: simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, avoiding the need for potentially expensive tessellation at run time.
• Hint: for size animation, modify the scale of a parent/ancestor Transform node instead.

Parameters:

newValue - is new value for the lineSegments field.

Returns:

Polyline2D - namely this same object to allow sequential method pipelining (i.e. consecutive method invocations on the same object).

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 https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS /Part01/components/core.html#Metadata

Specified by:

getMetadata in interface X3DGeometryNode

Specified by:

getMetadata in interface X3DNode

Returns:

value of metadata field

See Also:

• X3D Scene Authoring Hints: Metadata Nodes

setMetadata

Polyline2D 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 https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS /Part01/components/core.html#Metadata

Specified by:

setMetadata in interface X3DGeometryNode

Specified by:

setMetadata in interface X3DNode

Parameters:

newValue - is new value for the metadata field.

Returns:

Polyline2D - 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