com.simsilica.lemur.geom

Class TbtQuad

java.lang.Object

com.jme3.scene.Mesh

com.simsilica.lemur.geom.TbtQuad

All Implemented Interfaces:

com.jme3.export.Savable, com.jme3.util.clone.JmeCloneable, java.lang.Cloneable

public class TbtQuad
extends com.jme3.scene.Mesh
implements java.lang.Cloneable

A three-by-three quad that can stretch textures in useful ways. The vertexes are arranged with the 10 outer vertexes first and then the 4 inner vertexes.

The texture is split up into a three-by-three grid in this fashion:

    +---+--------------+-------+
    |   |    <----->   |       |
 y2 +---+--------------+-------+
    |   |              |       |
    | ^ |       ^      |   ^   |
    | | |       |      |   |   |
    | | |    <----->   |   |   |
    | | |       |      |   |   |
    | v |       v      |   v   |
    |   |              |       |
 y1 +---+--------------+-------+
    |   |    <----->   |       |
    +---+--------------+-------+
       x1             x2
 

Arrows indicate the direction in which each grid cell will stretch to fill the area given by the component.
All coordinates are relative to the lower-left border.

Common pitfalls

• Placing controls on a fractional coordinate. This usually happens when centering controls.
• Having a contrast at the border between stretched and unstretched texture zone (e.g. a black border and a white center). Stretching involves interpolating colors with the neighbouring pixels (i.e. you'll get a black-to-white color gradient).
  The easiest workaround is to make the border one pixel wider so that the contrast will be safely inside the unstretched area.
• Using a texture that is larger than the quad.

Nested Class Summary

Nested classes/interfaces inherited from class com.jme3.scene.Mesh

com.jme3.scene.Mesh.Mode

Constructor Summary

Constructors

Constructor and Description
TbtQuad(float width, float height)
TbtQuad(float width, float height, int x1, int y1, int x2, int y2, int imageWidth, int imageHeight, float imageScale)

Method Summary

Modifier and Type	Method and Description
TbtQuad	clone()
com.jme3.math.Vector2f	getSize()
protected void	refreshGeometry()
void	updateSize(float width, float height)

Methods inherited from class com.jme3.scene.Mesh

clearBuffer, clearCollisionData, cloneFields, cloneForAnim, collideWith, createCollisionData, deepClone, extractVertexData, generateBindPose, getBound, getBuffer, getBufferList, getBuffers, getElementLengths, getFloatBuffer, getId, getIndexBuffer, getIndicesAsList, getInstanceCount, getLineWidth, getLodLevel, getMaxNumWeights, getMode, getModeStart, getNumLodLevels, getPatchVertexCount, getPointSize, getShortBuffer, getTriangle, getTriangle, getTriangle, getTriangleCount, getTriangleCount, getVertexCount, isAnimated, jmeClone, prepareForAnim, read, scaleTextureCoordinates, setBound, setBuffer, setBuffer, setBuffer, setBuffer, setBuffer, setBuffer, setBuffer, setBuffer, setBuffer, setBuffer, setDynamic, setElementLengths, setId, setInterleaved, setLineWidth, setLodLevels, setMaxNumWeights, setMode, setModeStart, setPatchVertexCount, setPointSize, setStatic, setStreamed, updateBound, updateCounts, write

Methods inherited from class java.lang.Object

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

Constructor Detail

TbtQuad

public TbtQuad(float width,
               float height)

TbtQuad

public TbtQuad(float width,
               float height,
               int x1,
               int y1,
               int x2,
               int y2,
               int imageWidth,
               int imageHeight,
               float imageScale)

Method Detail

clone

public TbtQuad clone()

Overrides:

clone in class com.jme3.scene.Mesh

getSize

public com.jme3.math.Vector2f getSize()

updateSize

public void updateSize(float width,
                       float height)

refreshGeometry

protected void refreshGeometry()