Package org.web3d.x3d.sai

Interface Component

public interface Component

Abstract node interface, defined by X3D Java Scene Access Interface (SAI) Specification to support X3D Java interoperability.

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.
Package hint: This interface is defined by the X3D Java Language Binding Specification for the Scene Authoring Interface (SAI). Description of a single component.1188311883 A component description contains useful pieces of information about the requirements. Of primary importance is the specification component name and level. Additional information includes title and URL for the component provider.

See Also:

• SAI Java Specification: B.6.1 ComponentInfo
• X3D Abstract Specification: 7.2.5.4 COMPONENT statement
• X3D Tooltips: Component
• X3D Scene Authoring Hints

Method Summary

Modifier and Type	Method	Description
int	getLevel()	Get the level of the component.
String	getName()	Get the name of this component.
String	getProviderURL()	Get the URL of the provider.
String	getTitle()	Get the title of this component.
String	toX3DString()	Return a formatted string version of this component that conforms to the X3D specification for X3D file encoding.

Method Details

getName

String getName()

Get the name of this component.

Returns:

name The name of the component

getLevel

int getLevel()

Get the level of the component. A level is always greater than zero. The level information may represent one of two things, depending on how the component info was created. When created as part of a file that is requesting a specific level of support, the level will indicate the requested level, not the maximum available on the system. When this is returned from a query of the system to see what components are available then the level is maximum supported by the implementation.

Returns:

The level value for the component

getTitle

String getTitle()

Get the title of this component. This is a long-form version that can be used in a UI. If no title is set, will return null.

Returns:

The title string of the component

getProviderURL

String getProviderURL()

Get the URL of the provider. This is used for user interface information to point an end user at someone who has implemented this bit of functionality. It is not used by the system to download the component or its definition.

Returns:

The URL of the provider as a string

toX3DString

String toX3DString()

Return a formatted string version of this component that conforms to the X3D specification for X3D file encoding. The string will start with the COMPONENT keyword, as per specification.

Returns:

A correctly formatted string.