package visualiser.layout; import javafx.animation.AnimationTimer; import javafx.beans.property.ObjectProperty; import javafx.beans.property.SimpleObjectProperty; import javafx.beans.value.ChangeListener; import javafx.collections.ListChangeListener; import javafx.collections.ObservableList; import javafx.scene.*; import javafx.scene.input.PickResult; import javafx.scene.layout.Pane; import javafx.scene.paint.Color; import javafx.scene.shape.Shape3D; import javafx.scene.transform.Rotate; import javafx.scene.transform.Translate; import java.util.HashMap; import java.util.Map; /** * Control for rendering 3D objects visible through a PerspectiveCamera. Implements Adapter Pattern to * interface with camera, and allows clients to add shapes to the scene. All scenes contain sea plane and * sky box, whose textures are set with special methods. */ public class View3D extends Pane { /** * Container for group and camera */ private SubScene scene; /** * Observable list of renderable items */ private ObservableList items; /** * Map for selecting Subject3D from Shape3D */ private Map shapeMap; /** * Map for selecting Subject3D from source ID */ private Map sourceMap; /** * Subject tracked by camera */ private ObjectProperty target; /** * Rendering container for shapes */ private Group world; /** * Near limit of view frustum */ private double nearClip; /** * Far limit of view frustum */ private double farClip; /** * Camera origin */ private Translate pivot; /** * Distance of camera from pivot point */ private Translate distance; /** * Angle along ground between z-axis and camera */ private Rotate yaw; /** * Angle between ground plane and camera direction */ private Rotate pitch; /** * Animation loop for camera tracking */ private AnimationTimer trackBoat; /** * Distance to switch from third person to bird's eye */ private final double THIRD_PERSON_LIMIT = 100; /** * Distance to stop zoom */ private final double FIRST_PERSON_LIMIT = 2; /** * Default constructor for View3D. Sets up Scene and PerspectiveCamera. * @param fill whether or not to fill the background of the view. */ public View3D(boolean fill) { this.world = new Group(); this.shapeMap = new HashMap<>(); this.sourceMap = new HashMap<>(); this.target = new SimpleObjectProperty<>(null); this.scene = new SubScene(world, 300, 300); scene.widthProperty().bind(this.widthProperty()); scene.heightProperty().bind(this.heightProperty()); if (fill) { scene.setFill(new Color(0.2, 0.6, 1, 1)); } scene.setCamera(buildCamera()); this.getChildren().add(scene); } public View3D(){ this(true); } /** * Sets up camera view frustum and binds transformations * @return perspective camera */ private PerspectiveCamera buildCamera() { PerspectiveCamera camera = new PerspectiveCamera(true); // Set up view frustum nearClip = 0.1; farClip = 3000.0; camera.setNearClip(nearClip); camera.setFarClip(farClip); // Set up transformations pivot = new Translate(); distance = new Translate(); yaw = new Rotate(0, Rotate.Y_AXIS); pitch = new Rotate(0, Rotate.X_AXIS); camera.getTransforms().addAll(pivot, yaw, pitch, distance); return camera; } /** * Provide the list of subjects to be automatically added or removed from the view as the list * changes. * @param items list managed by client */ public void setItems(ObservableList items) { this.items = items; this.items.addListener((ListChangeListener) c -> { while(c.next()) { if (c.wasRemoved() || c.wasAdded()) { for (Subject3D shape : c.getRemoved()) { world.getChildren().remove(shape.getMesh()); shapeMap.remove(shape.getMesh()); sourceMap.remove(shape.getSourceID()); } for (Subject3D shape : c.getAddedSubList()) { world.getChildren().add(shape.getMesh()); shapeMap.put(shape.getMesh(), shape); sourceMap.put(shape.getSourceID(), shape); } } } }); } public Subject3D getShape(int sourceID) { return sourceMap.get(sourceID); } /** * Intercept mouse clicks on subjects in view. The applied listener cannot be removed. */ public void enableTracking() { scene.setOnMousePressed(e -> { PickResult result = e.getPickResult(); if(result != null && result.getIntersectedNode() != null && result.getIntersectedNode() instanceof Shape3D) { untrackSubject(); trackSubject(shapeMap.get(result.getIntersectedNode())); setThirdPerson(); } }); } public ObjectProperty targetProperty() { return target; } /** * Configures camera to third person view */ public void setThirdPerson() { this.setDistance(THIRD_PERSON_LIMIT / 2); this.setPitch(10); for(Subject3D item: items) { item.setScale(0.1); } } /** * Configures camera to bird's eye view */ public void setBirdsEye() { this.setYaw(0); this.setPitch(60); for(Subject3D item: items) { item.setScale(1); } } /** * Stop camera from following the last selected subject */ private void untrackSubject() { if(target.get() != null) { trackBoat.stop(); target.setValue(null); } } /** * Set camera to follow the selected subject * @param subject to track */ private void trackSubject(Subject3D subject) { target.set(subject); this.trackBoat = new AnimationTimer() { @Override public void handle(long now) { updatePivot(target.get().getPosition()); setYaw(target.get().getHeading().getAngle()); } }; trackBoat.start(); } public void setNearClip(double nearClip) { this.nearClip = nearClip; } public void setFarClip(double farClip) { this.farClip = farClip; } public Translate getPivot() { return pivot; } /** * Sets the coordinates of the camera pivot once. * @param pivot source of coordinates */ public void updatePivot(Translate pivot) { this.pivot.setX(pivot.getX()); this.pivot.setY(pivot.getY()); this.pivot.setZ(pivot.getZ()); } /** * Set distance of camera from pivot * @param distance in units */ public void setDistance(double distance) { this.distance.setZ(-distance); } /** * Adds delta to current distance and changes camera mode if applicable. * Third person limit specifies the distance at which a third person camera * switches to bird's-eye, remaining focused on the same position. * @param delta amount to change distance by */ public void updateDistance(double delta) { double distance = -this.distance.getZ() + delta; if(distance <= FIRST_PERSON_LIMIT) { this.setDistance(FIRST_PERSON_LIMIT); } else if(distance > THIRD_PERSON_LIMIT) { this.setDistance(distance); untrackSubject(); setBirdsEye(); } else { this.setDistance(distance); } } /** * Set angle of camera from z-axis along ground * @param yaw in degrees */ public void setYaw(double yaw) { this.yaw.setAngle(yaw); } /** * Set elevation of camera * @param pitch in degrees */ public void setPitch(double pitch) { this.pitch.setAngle(-pitch); } public void addAmbientLight(AmbientLight ambientLight) { this.world.getChildren().add(ambientLight); } public void addPointLight(PointLight pointLight) { this.world.getChildren().add(pointLight); } }