com.jme3.scene.shape.AbstractBox Maven / Gradle / Ivy
Show all versions of jme3-core Show documentation
/*
* Copyright (c) 2009-2021 jMonkeyEngine
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are
* met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* * Neither the name of 'jMonkeyEngine' nor the names of its contributors
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
package com.jme3.scene.shape;
import com.jme3.export.*;
import com.jme3.math.Vector3f;
import com.jme3.scene.Mesh;
import java.io.IOException;
/**
* An eight sided box.
*
* A {@code Box} is defined by a minimal point and a maximal point. The eight
* vertices that make the box are then computed, they are computed in such
* a way as to generate an axis-aligned box.
*
* This class does not control how the geometry data is generated, see {@link Box}
* for that.
*
* @author Ian Phillips
* @version $Revision: 4131 $, $Date: 2009-03-19 16:15:28 -0400 (Thu, 19 Mar 2009) $
*/
public abstract class AbstractBox extends Mesh {
public final Vector3f center = new Vector3f(0f, 0f, 0f);
public float xExtent, yExtent, zExtent;
public AbstractBox() {
super();
}
/**
* Gets the array or vectors representing the 8 vertices of the box.
*
* @return a newly created array of vertex vectors.
*/
protected final Vector3f[] computeVertices() {
Vector3f[] axes = {
Vector3f.UNIT_X.mult(xExtent),
Vector3f.UNIT_Y.mult(yExtent),
Vector3f.UNIT_Z.mult(zExtent)
};
return new Vector3f[] {
center.subtract(axes[0]).subtractLocal(axes[1]).subtractLocal(axes[2]),
center.add(axes[0]).subtractLocal(axes[1]).subtractLocal(axes[2]),
center.add(axes[0]).addLocal(axes[1]).subtractLocal(axes[2]),
center.subtract(axes[0]).addLocal(axes[1]).subtractLocal(axes[2]),
center.add(axes[0]).subtractLocal(axes[1]).addLocal(axes[2]),
center.subtract(axes[0]).subtractLocal(axes[1]).addLocal(axes[2]),
center.add(axes[0]).addLocal(axes[1]).addLocal(axes[2]),
center.subtract(axes[0]).addLocal(axes[1]).addLocal(axes[2])
};
}
/**
* Convert the indices into the list of vertices that define the box's geometry.
*/
protected abstract void doUpdateGeometryIndices();
/**
* Update the normals of each of the box's planes.
*/
protected abstract void doUpdateGeometryNormals();
/**
* Update the points that define the texture of the box.
*
* It's a one-to-one ratio, where each plane of the box has its own copy
* of the texture. That is, the texture is repeated one time for each face.
*/
protected abstract void doUpdateGeometryTextures();
/**
* Update the position of the vertices that define the box.
*
* These eight points are determined from the minimum and maximum point.
*/
protected abstract void doUpdateGeometryVertices();
/**
* Get the center point of this box.
*
* @return the pre-existing location vector (in mesh coordinates)
*/
public final Vector3f getCenter() {
return center;
}
/**
* Get the x-axis size (extent) of this box.
*
* @return the radius parallel to the X axis (in mesh units)
*/
public final float getXExtent() {
return xExtent;
}
/**
* Get the y-axis size (extent) of this box.
*
* @return the radius parallel to the Y axis (in mesh units)
*/
public final float getYExtent() {
return yExtent;
}
/**
* Get the z-axis size (extent) of this box.
*
* @return the radius parallel to the Z axis (in mesh units)
*/
public final float getZExtent() {
return zExtent;
}
/**
* Rebuilds the box after a property has been directly altered.
*
* For example, if you call {@code getXExtent().x = 5.0f} then you will
* need to call this method afterwards in order to update the box.
*/
public final void updateGeometry() {
doUpdateGeometryVertices();
doUpdateGeometryNormals();
doUpdateGeometryTextures();
doUpdateGeometryIndices();
setStatic();
}
/**
* Rebuilds this box based on a new set of parameters.
*
* Note that the actual sides will be twice the given extent values because
* the box extends in both directions from the center for each extent.
*
* @param center the center of the box.
* @param x the X extent of the box in each direction.
* @param y the Y extent of the box in each direction.
* @param z the Z extent of the box in each direction.
*/
public final void updateGeometry(Vector3f center, float x, float y, float z) {
if (center != null) {this.center.set(center); }
this.xExtent = x;
this.yExtent = y;
this.zExtent = z;
updateGeometry();
}
/**
* Rebuilds this box based on a new set of parameters.
*
* The box is updated so that the two opposite corners are {@code minPoint}
* and {@code maxPoint}, the other corners are created from those two positions.
*
* @param minPoint the new minimum point of the box.
* @param maxPoint the new maximum point of the box.
*/
public final void updateGeometry(Vector3f minPoint, Vector3f maxPoint) {
center.set(maxPoint).addLocal(minPoint).multLocal(0.5f);
float x = maxPoint.x - center.x;
float y = maxPoint.y - center.y;
float z = maxPoint.z - center.z;
updateGeometry(center, x, y, z);
}
@Override
public void read(JmeImporter importer) throws IOException {
super.read(importer);
InputCapsule capsule = importer.getCapsule(this);
xExtent = capsule.readFloat("xExtent", 0);
yExtent = capsule.readFloat("yExtent", 0);
zExtent = capsule.readFloat("zExtent", 0);
center.set((Vector3f) capsule.readSavable("center", Vector3f.ZERO.clone()));
}
@Override
public void write(JmeExporter e) throws IOException {
super.write(e);
OutputCapsule capsule = e.getCapsule(this);
capsule.write(xExtent, "xExtent", 0);
capsule.write(yExtent, "yExtent", 0);
capsule.write(zExtent, "zExtent", 0);
capsule.write(center, "center", Vector3f.ZERO);
}
}