Package nl.colorize.multimedialib.renderer.teavm

Class ThreeGraphics

java.lang.Object

nl.colorize.multimedialib.renderer.teavm.ThreeGraphics

All Implemented Interfaces:

TeaGraphics, StageSubscriber, StageVisitor

@Beta
public class ThreeGraphics
extends Object
implements TeaGraphics, StageSubscriber

Uses the Three.js JavaScript library to render 3D graphics. This requires the browser to support WebGL.

Three.js does not support 2D graphics very well, so when using both 2D and 3D graphics, the 2D part is delegated to a separate canvas overlay that is displayed on top of the 3D graphics. Updating the 2D graphics overlay is then delegated to HtmlCanvasGraphics.

Constructor Summary

Constructors

Constructor	Description
ThreeGraphics()

Method Summary

Modifier and Type	Method	Description
boolean	castPickRay(Point2D canvasPosition, Box area)
Mesh	createMesh(Shape3D shape, ColorRGB color)
void	drawBackground(ColorRGB color)
void	drawCircle(Primitive graphic, Circle circle, Transform globalTransform)
void	drawLight(Light light, Transform3D globalTransform)
void	drawLine(Primitive graphic, Line line, Transform globalTransform)
void	drawMesh(Mesh mesh, Transform3D globalTransform)
void	drawPolygon(Primitive graphic, Polygon polygon, Transform globalTransform)
void	drawRect(Primitive graphic, Rect rect, Transform globalTransform)
void	drawSegmentedLine(Primitive graphic, SegmentedLine line, Transform globalTransform)
void	drawSprite(Sprite sprite, Transform globalTransform)
void	drawText(Text text, Transform globalTransform)
void	finalize3D(Stage stage)	Called after all 3D nodes on the stage have been visited, but before the 2D nodes are visited.
int	getDisplayHeight()
int	getDisplayWidth()
GraphicsMode	getGraphicsMode()
void	init(SceneContext context)
void	onNodeAdded(Group parent, StageNode3D node)
void	onNodeRemoved(Group parent, StageNode3D node)
void	prepareStage(Stage stage)	Prepares visiting the stage.
Point2D	project(Point3D position)
boolean	shouldVisitAllNodes()	Indicates whether this visitor should visit all graphics, or only graphics that are currently visible.
void	visitContainer(Container container, Transform globalTransform)
void	visitGroup(Group group, Transform3D globalTransform)

Methods inherited from class java.lang.Object

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

Methods inherited from interface nl.colorize.multimedialib.stage.StageSubscriber

onNodeAdded, onNodeRemoved

Methods inherited from interface nl.colorize.multimedialib.stage.StageVisitor

finalize2D

Methods inherited from interface nl.colorize.multimedialib.renderer.teavm.TeaGraphics

getDevicePixelRatio

Constructor Details

ThreeGraphics

public ThreeGraphics()

Method Details

init

public void init(SceneContext context)

Specified by:

init in interface TeaGraphics

getDisplayWidth

public int getDisplayWidth()

Specified by:

getDisplayWidth in interface TeaGraphics

getDisplayHeight

public int getDisplayHeight()

Specified by:

getDisplayHeight in interface TeaGraphics

onNodeAdded

public void onNodeAdded(Group parent,
 StageNode3D node)

Specified by:

onNodeAdded in interface StageSubscriber

onNodeRemoved

public void onNodeRemoved(Group parent,
 StageNode3D node)

Specified by:

onNodeRemoved in interface StageSubscriber

prepareStage

public void prepareStage(Stage stage)

Description copied from interface: StageVisitor

Prepares visiting the stage. This method is called before any of the stage's graphics are visited. It can be used to add initialization logic that should be performed before any graphics can be drawn.

Specified by:

prepareStage in interface StageVisitor

shouldVisitAllNodes

public boolean shouldVisitAllNodes()

Description copied from interface: StageVisitor

Indicates whether this visitor should visit all graphics, or only graphics that are currently visible.

Specified by:

shouldVisitAllNodes in interface StageVisitor

visitContainer

public void visitContainer(Container container,
 Transform globalTransform)

Specified by:

visitContainer in interface StageVisitor

drawBackground

public void drawBackground(ColorRGB color)

Specified by:

drawBackground in interface StageVisitor

drawSprite

public void drawSprite(Sprite sprite,
 Transform globalTransform)

Specified by:

drawSprite in interface StageVisitor

drawLine

public void drawLine(Primitive graphic,
 Line line,
 Transform globalTransform)

Specified by:

drawLine in interface StageVisitor

drawSegmentedLine

public void drawSegmentedLine(Primitive graphic,
 SegmentedLine line,
 Transform globalTransform)

Specified by:

drawSegmentedLine in interface StageVisitor

drawRect

public void drawRect(Primitive graphic,
 Rect rect,
 Transform globalTransform)

Specified by:

drawRect in interface StageVisitor

drawCircle

public void drawCircle(Primitive graphic,
 Circle circle,
 Transform globalTransform)

Specified by:

drawCircle in interface StageVisitor

drawPolygon

public void drawPolygon(Primitive graphic,
 Polygon polygon,
 Transform globalTransform)

Specified by:

drawPolygon in interface StageVisitor

drawText

public void drawText(Text text,
 Transform globalTransform)

Specified by:

drawText in interface StageVisitor

visitGroup

public void visitGroup(Group group,
 Transform3D globalTransform)

Specified by:

visitGroup in interface StageVisitor

drawMesh

public void drawMesh(Mesh mesh,
 Transform3D globalTransform)

Specified by:

drawMesh in interface StageVisitor

drawLight

public void drawLight(Light light,
 Transform3D globalTransform)

Specified by:

drawLight in interface StageVisitor

createMesh

public Mesh createMesh(Shape3D shape,
 ColorRGB color)

Specified by:

createMesh in interface TeaGraphics

project

public Point2D project(Point3D position)

Specified by:

project in interface TeaGraphics

castPickRay

public boolean castPickRay(Point2D canvasPosition,
 Box area)

Specified by:

castPickRay in interface TeaGraphics

finalize3D

public void finalize3D(Stage stage)

Description copied from interface: StageVisitor

Called after all 3D nodes on the stage have been visited, but before the 2D nodes are visited. This allows renders that support both 2D and 3D graphics to switch from rendering 3D graphics to rendering 2D graphics. This is an optional method, the default implementation is empty.

Specified by:

finalize3D in interface StageVisitor

getGraphicsMode

public GraphicsMode getGraphicsMode()

Specified by:

getGraphicsMode in interface TeaGraphics