javafx.scene.shape

Class Shape3D

java.lang.Object

Node

javafx.scene.shape.Shape3D

Direct Known Subclasses:

Box, Cylinder, MeshView, Sphere

public abstract class Shape3D
extends Node

The Shape3D base class provides definitions of common properties for objects that represent some form of 3D geometric shape. These properties include:

• The Material to be applied to the fillable interior of the shape or the outline of the shape (see setMaterial(Material)).
• The draw model properties that defines how to render its geometry (see setDrawMode(javafx.scene.shape.DrawMode)).
• The face culling properties that defines which face to cull (see setCullFace(javafx.scene.shape.CullFace)).

Note that this is a conditional feature. See ConditionalFeature.SCENE3D for more information.

An application should not extend the Shape3D class directly. Doing so may lead to an UnsupportedOperationException being thrown.

Since:

JavaFX 8.0

Property Summary

Type	Property and Description
<any>	cullFace Defines the cullFace this Shape3D.
<any>	drawMode Defines the draw mode used to render this Shape3D.
<any>	material Defines the material this Shape3D.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	Shape3D.Key Used by the caching mechanism to compare between instances of the same shape.

Field Summary

Fields

Modifier and Type	Field and Description
private <any>	cullFace Defines the cullFace this Shape3D.
private static PhongMaterial	DEFAULT_MATERIAL
private <any>	drawMode Defines the draw mode used to render this Shape3D.
(package private) Shape3D.Key	key
(package private) PredefinedMeshManager	manager
private <any>	material Defines the material this Shape3D.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Shape3D()

Method Summary

Modifier and Type	Method and Description
<any>	cullFaceProperty() Defines the cullFace this Shape3D.
private boolean	doComputeContains(double localX, double localY)
private BaseBounds	doComputeGeomBounds(BaseBounds bounds, BaseTransform tx)
private void	doUpdatePeer()
<any>	drawModeProperty() Defines the draw mode used to render this Shape3D.
CullFace	getCullFace() Gets the value of the property cullFace.
DrawMode	getDrawMode() Gets the value of the property drawMode.
Material	getMaterial() Gets the value of the property material.
<any>	materialProperty() Defines the material this Shape3D.
void	setCullFace(CullFace value) Sets the value of the property cullFace.
void	setDrawMode(DrawMode value) Sets the value of the property drawMode.
void	setMaterial(Material value) Sets the value of the property material.

Methods inherited from class java.lang.Object

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

Property Detail

material

public final <any> materialProperty

Defines the material this Shape3D. The default material is null. If Material is null, a PhongMaterial with a diffuse color of Color.LIGHTGRAY is used for rendering.

See Also:

getMaterial(), setMaterial(Material)

drawMode

public final <any> drawModeProperty

Defines the draw mode used to render this Shape3D. DrawMode.LINE is not available on embedded platforms. If drawMode is set to DrawMode.LINE on an embedded platform the default value of DrawMode.FILL will be used instead.

See Also:

getDrawMode(), setDrawMode(DrawMode)

cullFace

public final <any> cullFaceProperty

Defines the cullFace this Shape3D.

See Also:

getCullFace(), setCullFace(CullFace)

Field Detail

DEFAULT_MATERIAL

private static final PhongMaterial DEFAULT_MATERIAL

manager

PredefinedMeshManager manager

key

Shape3D.Key key

material

private <any> material

Defines the material this Shape3D. The default material is null. If Material is null, a PhongMaterial with a diffuse color of Color.LIGHTGRAY is used for rendering.

drawMode

private <any> drawMode

Defines the draw mode used to render this Shape3D. DrawMode.LINE is not available on embedded platforms. If drawMode is set to DrawMode.LINE on an embedded platform the default value of DrawMode.FILL will be used instead.

cullFace

private <any> cullFace

Defines the cullFace this Shape3D.

Constructor Detail

Shape3D

protected Shape3D()

Method Detail

setMaterial

public final void setMaterial(Material value)

Sets the value of the property material.

getMaterial

public final Material getMaterial()

Gets the value of the property material.

materialProperty

public final <any> materialProperty()

Defines the material this Shape3D. The default material is null. If Material is null, a PhongMaterial with a diffuse color of Color.LIGHTGRAY is used for rendering.

See Also:

getMaterial(), setMaterial(Material)

setDrawMode

public final void setDrawMode(DrawMode value)

Sets the value of the property drawMode.

getDrawMode

public final DrawMode getDrawMode()

Gets the value of the property drawMode.

drawModeProperty

public final <any> drawModeProperty()

Defines the draw mode used to render this Shape3D. DrawMode.LINE is not available on embedded platforms. If drawMode is set to DrawMode.LINE on an embedded platform the default value of DrawMode.FILL will be used instead.

See Also:

getDrawMode(), setDrawMode(DrawMode)

setCullFace

public final void setCullFace(CullFace value)

Sets the value of the property cullFace.

getCullFace

public final CullFace getCullFace()

Gets the value of the property cullFace.

cullFaceProperty

public final <any> cullFaceProperty()

Defines the cullFace this Shape3D.

See Also:

getCullFace(), setCullFace(CullFace)

doComputeGeomBounds

private BaseBounds doComputeGeomBounds(BaseBounds bounds,
                                       BaseTransform tx)

doComputeContains

private boolean doComputeContains(double localX,
                                  double localY)

doUpdatePeer

private void doUpdatePeer()