org.jfree.chart3d.graphics3d.World Maven / Gradle / Ivy
/* ===========================================================
* Orson Charts : a 3D chart library for the Java(tm) platform
* ===========================================================
*
* (C)opyright 2013-2022, by David Gilbert. All rights reserved.
*
* https://github.com/jfree/orson-charts
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see > objects;
/**
* Creates a new empty world.
*/
public World() {
this.objects = new java.util.TreeMap<>();
this.objects.put(DEFAULT_PARTITION_KEY, new ArrayList<>());
setSunSource(new Point3D(2, -1, 10));
}
/**
* Returns the x-component of the sunlight vector.
*
* @return The x-component of the sunlight vector.
*/
public double getSunX() {
return this.sunX;
}
/**
* Returns the y-component of the sunlight vector.
*
* @return The y-component of the sunlight vector.
*/
public double getSunY() {
return this.sunY;
}
/**
* Returns the z-component of the sunlight vector.
*
* @return The z-component of the sunlight vector.
*/
public double getSunZ() {
return this.sunZ;
}
/**
* Sets the light source point.
*
* @param x the x-coordinate.
* @param y the y-coordinate.
* @param z the z-coordinate.
*
* @since 1.2
*/
public final void setSunSource(double x, double y, double z) {
setSunSource(new Point3D(x, y, z));
}
/**
* Sets the light source point.
*
* @param p the point ({@code null} not permitted).
*
* @since 1.2
*/
public final void setSunSource(Point3D p) {
Args.nullNotPermitted(p, "p");
Point3D normal = Utils3D.normalise(p);
this.sunX = normal.getX();
this.sunY = normal.getY();
this.sunZ = normal.getZ();
}
/**
* Adds an object to the world in the default partition.
*
* @param object the object ({@code null} not permitted).
*/
public void add(Object3D object) {
// defer argument checking
add(DEFAULT_PARTITION_KEY, object);
}
/**
* Adds an object to a specific partition.
*
* @param partition the partition ({@code null} not permitted).
* @param object the object ({@code null} not permitted).
*
* @since 1.2
*/
public void add(String partition, Object3D object) {
Args.nullNotPermitted(partition, "partition");
Args.nullNotPermitted(object, "object");
List list = this.objects.get(partition);
if (list == null) {
list = new ArrayList<>();
this.objects.put(partition, list);
}
list.add(object);
}
/**
* Adds a collection of objects to the world (in the default
* partition).
*
* @param objects the objects ({@code null} not permitted).
*/
public void addAll(Collection objects) {
Args.nullNotPermitted(objects, "objects");
for (Object3D object : objects) {
add(object);
}
}
/**
* Clears any objects belonging to the specified partition.
*
* @param partitionKey the partition key ({@code null} not permitted).
*
* @since 1.2
*/
public void clear(String partitionKey) {
Args.nullNotPermitted(partitionKey, "partitionKey");
this.objects.put(partitionKey, null);
}
/**
* Returns the total number of vertices for all objects in this world.
*
* @return The total number of vertices.
*/
public int getVertexCount() {
int count = 0;
for (Entry> entry : this.objects.entrySet()) {
List objs = entry.getValue();
for (Object3D object: objs) {
count += object.getVertexCount();
}
}
return count;
}
/**
* Returns an array containing the vertices for all objects in this
* world, transformed to eye coordinates.
*
* @param vp the view point ({@code null} not permitted).
*
* @return The eye coordinates.
*/
public Point3D[] calculateEyeCoordinates(ViewPoint3D vp) {
Point3D[] result = new Point3D[getVertexCount()];
int index = 0;
for (Entry> entry : this.objects.entrySet()) {
List objs = entry.getValue();
for (Object3D object : objs) {
Point3D[] vertices = object.calculateEyeCoordinates(vp);
System.arraycopy(vertices, 0, result, index, vertices.length);
index = index + vertices.length;
}
}
return result;
}
/**
* Calculates the projected points in 2D-space for all the vertices of the
* objects in the world.
*
* @param vp the view point ({@code null} not permitted).
* @param d the distance.
*
* @return The projected points.
*/
public Point2D[] calculateProjectedPoints(ViewPoint3D vp, double d) {
Point2D[] result = new Point2D[getVertexCount()];
int index = 0;
for (Entry> entry : this.objects.entrySet()) {
List objs = entry.getValue();
for (Object3D object : objs) {
Point2D[] pts = object.calculateProjectedPoints(vp, d);
System.arraycopy(pts, 0, result, index, pts.length);
index = index + pts.length;
}
}
return result;
}
/**
* Fetches the faces for all the objects in this world, updating the
* offset to match the current position.
*
* @return A list of faces.
*/
public List getFaces() {
List result = new java.util.ArrayList<>();
int offset = 0;
for (Entry> entry : this.objects.entrySet()) {
List objs = entry.getValue();
for (Object3D object : objs) {
for (Face f : object.getFaces()) {
f.setOffset(offset);
}
offset += object.getVertexCount();
result.addAll(object.getFaces());
}
}
return result;
}
/**
* Returns a newly created list containing all the objects in the world
* model.
*
* @return The list of objects.
*
* @since 1.2
*/
public List getObjects() {
List result = new ArrayList<>();
for (Entry> entry : this.objects.entrySet()) {
List objs = entry.getValue();
result.addAll(objs);
}
return result;
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy