com.jme3.scene.CenterQuad Maven / Gradle / Ivy
Show all versions of jme3-vr 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;
import com.jme3.export.InputCapsule;
import com.jme3.export.JmeExporter;
import com.jme3.export.JmeImporter;
import com.jme3.export.OutputCapsule;
import com.jme3.scene.VertexBuffer.Type;
import java.io.IOException;
/**
* A static, indexed, Triangles-mode mesh for an axis-aligned rectangle in the
* X-Y plane.
*
* The rectangle extends from (-width/2, -height/2, 0) to
* (width/2, height/2, 0) with normals set to (0,0,1).
*
*
This differs from com.jme3.scene.shape.Quad because it puts
* (0,0,0) at the rectangle's center instead of in a corner.
*
* @author Kirill Vainer
* @deprecated use com.jme3.scene.shape.CenterQuad
*/
@Deprecated
public class CenterQuad extends Mesh {
public static CenterQuad UnitQuad = new CenterQuad(0.5f, 0.5f);
public static Mesh CenterSplitQuad;
private float width;
private float height;
/**
* Create a quad with the given width and height. The quad
* is always created in the XY plane.
*
* @param width The X extent or width
* @param height The Y extent or width
*/
public CenterQuad(float width, float height){
updateGeometry(width, height);
}
/**
* Create a quad with the given width and height. The quad
* is always created in the XY plane.
*
* @param width The X extent or width
* @param height The Y extent or width
* @param flipCoords If true, the texture coordinates will be flipped
* along the Y axis.
*/
public CenterQuad(float width, float height, boolean flipCoords){
updateGeometry(width, height, flipCoords);
this.setStatic();
}
/**
* For serialization only. Do not use.
*/
protected CenterQuad() {
}
public float getHeight() {
return height;
}
public float getWidth() {
return width;
}
public void updateGeometry(float width, float height){
updateGeometry(width, height, false);
}
public void updateGeometry(float width, float height, boolean flipCoords) {
this.width = width;
this.height = height;
setBuffer(Type.Position, 3, new float[]{-width/2, -height/2, 0,
width/2, -height/2, 0,
width/2, height/2, 0,
-width/2, height/2, 0
});
if (flipCoords){
setBuffer(Type.TexCoord, 2, new float[]{0, 1,
1, 1,
1, 0,
0, 0});
}else{
setBuffer(Type.TexCoord, 2, new float[]{0, 0,
1, 0,
1, 1,
0, 1});
}
setBuffer(Type.Normal, 3, new float[]{0, 0, 1,
0, 0, 1,
0, 0, 1,
0, 0, 1});
if (height < 0){
setBuffer(Type.Index, 3, new short[]{0, 2, 1,
0, 3, 2});
}else{
setBuffer(Type.Index, 3, new short[]{0, 1, 2,
0, 2, 3});
}
updateBound();
}
/**
* De-serializes from the specified importer, for example when loading from
* a J3O file.
*
* @param importer the importer to use (not null)
* @throws IOException from the importer
*/
@Override
public void read(JmeImporter importer) throws IOException {
super.read(importer);
InputCapsule capsule = importer.getCapsule(this);
width = capsule.readFloat("width", 0f);
height = capsule.readFloat("height", 0f);
}
/**
* Serializes to the specified exporter, for example when saving to a J3O
* file. The current instance is unaffected.
*
* @param exporter the exporter to use (not null)
* @throws IOException from the exporter
*/
@Override
public void write(JmeExporter exporter) throws IOException {
super.write(exporter);
OutputCapsule capsule = exporter.getCapsule(this);
capsule.write(width, "width", 0f);
capsule.write(height, "height", 0f);
}
}