com.bonzaiengine.renderer

Class Shapes

java.lang.Object

com.bonzaiengine.renderer.Shapes

public final class Shapes
extends java.lang.Object

Utility to display simple shapes (box, sphere, cylinder, ...).

Example usage:

renderOnce(gl, createBox(null, box, true, Vec3.one, lightsOrNull), lightsOrNull)

drawCapsule(gl, capsule, 10, true, false, Color4.white, lightsOrNull)

For advanced uses, Batch can be used with create*** methods to render multiple times a shape, apply advanced material and more.

See Also:

Batch

Method Summary

Modifier and Type	Method and Description
static Batch	createAxis(Batch dstBatchOrNull, float length) Draw an axis system made of 3 lines : red line: x axis green line: y axis blue line: z axis
static Batch	createBoundingVolume(Batch dstBatchOrNull, IVolume<?> bv, boolean line, int subdivisions, Lights<?> lights)
static Batch	createBox(Batch dstBatchOrNull, Box bb, boolean fill, Vec3 uvArea, Lights<?> lights) Draw a box
static Batch	createCapsule(Batch dstBatchOrNull, Capsule capsule, int slices, boolean fill, boolean hasUv, Lights<?> lights) Draw a capsule
static Batch	createCircle(Batch dstBatchOrNull, float radius, int slices, boolean fill, int dir, Vec3 center, boolean hasUv, Lights<?> lights) Draw a circle wit axis along y
static Batch	createCylinder(Batch dstBatchOrNull, Cylinder cylinder, int slices, boolean fill, boolean closed, boolean hasUv, Lights<?> lights)
static Batch	createCylinder(Batch dstBatchOrNull, Vec3 position, float baseRadius, float topRadius, float height, int slices, boolean fill, boolean closed, boolean hasUv, Lights<?> lights) Draw a cylinder with axis along Y ========================================================================= Copyright (c) 2002-2008 LWJGL Project All rights reserved.
static Batch	createEllipse(Batch dstBatchOrNull, float radiusX, float radiusY, int slices, boolean fill, Vec3 center, boolean hasUv, Lights<?> lights) Draw an Ellipse along z plane Num indices: fill ?
static Batch	createFrustum(Mat4x4 proj, Mat4x4 view)
static Batch	createGridY(Batch dstBatchOrNull, float sizeX, float sizeZ, int numX, int numZ, float uRepeat, float vRepeat, Vec3 position, boolean fill) Num indices: (numX * numZ * 4) + (numX * 2) + (numZ * 2) Num vertices: (numX + 1) * (numZ + 1)
static Batch	createLine(Batch dstBatchOrNull, Vec3 pos1, Vec3 pos2)
static Batch	createPoint(Batch dstBatchOrNull, Vec3 pos)
static Batch	createQuadY(Batch dstBatchOrNull, float sizeX, float sizeZ, float uRepeat, float vRepeat, Vec3 position, boolean hasUv, Lights<?> lights) Draw a Rectangle on the z plane at the (x, y, z) position Texture is repeted on the rectangle nbTextRepetition times.
static Batch	createQuadYLine(Batch dstBatchOrNull, float sizeX, float sizeZ, Vec3 position) Num indices: 5 Num vertices: 4
static Batch	createQuadZ(Batch dstBatchOrNull, float sizeX, float sizeY, float uRepeat, float vRepeat, Vec3 position, boolean hasUv, Lights<?> lights) Draw a Rectangle on the z plane at the (x, y, z) position Texture is repeated on the rectangle nbTextRepetition times.
static Batch	createQuadZLine(Batch dstBatchOrNull, float sizeX, float sizeY, Vec3 position) Num indices: 5 Num vertices: 4
static Batch	createSphere(Batch dstBatchOrNull, Sphere sphere, int slices, int stacks, boolean fill, boolean hasUv, Lights<?> lights) Draw a sphere with texture coordinates and normals
static void	drawSkybox(IGL gl, float size, Vec3 position, TextureID skyboxTexID) Draw a skybox.
static void	putBox(Batch batch, Box bb, boolean fill, Vec3 uvArea, byte[] color, Lights<?> lights)
static void	putCircle(Batch batch, float radius, int slices, boolean fill, int dir, Vec3 center)
static void	putCylinder(Batch batch, Vec3 position, float baseRadius, float topRadius, float height, int slices, boolean fill, boolean closed)
static void	putLine(Batch batch, Vec3 pos1, Vec3 pos2, byte[] color)
static void	putSphere(Batch batch, Vec3 position, float radius, int slices, int stacks, boolean fill, boolean half, boolean halfBot, byte[] color)
static void	renderOnce(IGL gl, Batch batch, Color4 color, Lights<?> lights)
static void	renderOnce(IGL gl, Batch batch, Lights<?> lights)
static void	renderOnce(Renderer renderer, Batch batch)
static void	renderOnce(Renderer renderer, Batch batch, Lights<?> lights)
static void	reserveBox(Batch batch, boolean fill, Vec3 uvArea, Lights<?> lights)
static void	reserveCircle(Batch batch, int slices, boolean fill)
static void	reserveCylinder(Batch batch, int slices, boolean fill, boolean closed)
static void	reserveLine(Batch batch)
static void	reserveSphere(Batch batch, int slices, int stacks, boolean fill, boolean half)

Methods inherited from class java.lang.Object

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

Method Detail

renderOnce

public static void renderOnce(IGL gl,
                              Batch batch,
                              Lights<?> lights)

renderOnce

public static void renderOnce(IGL gl,
                              Batch batch,
                              Color4 color,
                              Lights<?> lights)

renderOnce

public static void renderOnce(Renderer renderer,
                              Batch batch)

renderOnce

public static void renderOnce(Renderer renderer,
                              Batch batch,
                              Lights<?> lights)

createQuadZ

public static Batch createQuadZ(Batch dstBatchOrNull,
                                float sizeX,
                                float sizeY,
                                float uRepeat,
                                float vRepeat,
                                Vec3 position,
                                boolean hasUv,
                                Lights<?> lights)

Draw a Rectangle on the z plane at the (x, y, z) position
Texture is repeated on the rectangle nbTextRepetition times.
Num indices: 6
Num vertices: 4

Parameters:

sizeX - width of the rectangle

sizeY - height of the rectangle

uRepeat - number of repetition of the texture on the u axis

vRepeat - number of repetition of the texture on the v axis

position - optional (can be null)

createQuadZLine

public static Batch createQuadZLine(Batch dstBatchOrNull,
                                    float sizeX,
                                    float sizeY,
                                    Vec3 position)

Num indices: 5
Num vertices: 4

createQuadY

public static Batch createQuadY(Batch dstBatchOrNull,
                                float sizeX,
                                float sizeZ,
                                float uRepeat,
                                float vRepeat,
                                Vec3 position,
                                boolean hasUv,
                                Lights<?> lights)

Draw a Rectangle on the z plane at the (x, y, z) position
Texture is repeted on the rectangle nbTextRepetition times.

Num indices: 6
Num vertices: 4

Parameters:

sizeX - width of the rectangle

sizeZ - height of the rectangle

uRepeat - number of repetition of the texture on the u axis

vRepeat - number of repetition of the texture on the v axis

position - optional (can be null)

createQuadYLine

public static Batch createQuadYLine(Batch dstBatchOrNull,
                                    float sizeX,
                                    float sizeZ,
                                    Vec3 position)

Num indices: 5
Num vertices: 4

createGridY

public static Batch createGridY(Batch dstBatchOrNull,
                                float sizeX,
                                float sizeZ,
                                int numX,
                                int numZ,
                                float uRepeat,
                                float vRepeat,
                                Vec3 position,
                                boolean fill)

Num indices: (numX * numZ * 4) + (numX * 2) + (numZ * 2)
Num vertices: (numX + 1) * (numZ + 1)

createPoint

public static Batch createPoint(Batch dstBatchOrNull,
                                Vec3 pos)

createLine

public static Batch createLine(Batch dstBatchOrNull,
                               Vec3 pos1,
                               Vec3 pos2)

reserveLine

public static void reserveLine(Batch batch)

putLine

public static void putLine(Batch batch,
                           Vec3 pos1,
                           Vec3 pos2,
                           byte[] color)

createBoundingVolume

public static Batch createBoundingVolume(Batch dstBatchOrNull,
                                         IVolume<?> bv,
                                         boolean line,
                                         int subdivisions,
                                         Lights<?> lights)

createBox

public static Batch createBox(Batch dstBatchOrNull,
                              Box bb,
                              boolean fill,
                              Vec3 uvArea,
                              Lights<?> lights)

Draw a box

reserveBox

public static void reserveBox(Batch batch,
                              boolean fill,
                              Vec3 uvArea,
                              Lights<?> lights)

putBox

public static void putBox(Batch batch,
                          Box bb,
                          boolean fill,
                          Vec3 uvArea,
                          byte[] color,
                          Lights<?> lights)

drawSkybox

public static void drawSkybox(IGL gl,
                              float size,
                              Vec3 position,
                              TextureID skyboxTexID)

Draw a skybox. The texture show be a cube map texture.

Parameters:

size - size of the skybox

skyboxTexID - texture ID of a cub map texture Num indices:36
Num vertices:24

createAxis

public static Batch createAxis(Batch dstBatchOrNull,
                               float length)

Draw an axis system made of 3 lines :
red line: x axis
green line: y axis
blue line: z axis

createFrustum

public static Batch createFrustum(Mat4x4 proj,
                                  Mat4x4 view)

createSphere

public static Batch createSphere(Batch dstBatchOrNull,
                                 Sphere sphere,
                                 int slices,
                                 int stacks,
                                 boolean fill,
                                 boolean hasUv,
                                 Lights<?> lights)

Draw a sphere with texture coordinates and normals

reserveSphere

public static void reserveSphere(Batch batch,
                                 int slices,
                                 int stacks,
                                 boolean fill,
                                 boolean half)

putSphere

public static void putSphere(Batch batch,
                             Vec3 position,
                             float radius,
                             int slices,
                             int stacks,
                             boolean fill,
                             boolean half,
                             boolean halfBot,
                             byte[] color)

createCircle

public static Batch createCircle(Batch dstBatchOrNull,
                                 float radius,
                                 int slices,
                                 boolean fill,
                                 int dir,
                                 Vec3 center,
                                 boolean hasUv,
                                 Lights<?> lights)

Draw a circle wit axis along y

reserveCircle

public static void reserveCircle(Batch batch,
                                 int slices,
                                 boolean fill)

putCircle

public static void putCircle(Batch batch,
                             float radius,
                             int slices,
                             boolean fill,
                             int dir,
                             Vec3 center)

createEllipse

public static Batch createEllipse(Batch dstBatchOrNull,
                                  float radiusX,
                                  float radiusY,
                                  int slices,
                                  boolean fill,
                                  Vec3 center,
                                  boolean hasUv,
                                  Lights<?> lights)

Draw an Ellipse along z plane Num indices: fill ? (slices + 2) : (slices + 2) + 2
Num vertices: (slices + 1) * 3

createCylinder

public static Batch createCylinder(Batch dstBatchOrNull,
                                   Cylinder cylinder,
                                   int slices,
                                   boolean fill,
                                   boolean closed,
                                   boolean hasUv,
                                   Lights<?> lights)

createCylinder

public static Batch createCylinder(Batch dstBatchOrNull,
                                   Vec3 position,
                                   float baseRadius,
                                   float topRadius,
                                   float height,
                                   int slices,
                                   boolean fill,
                                   boolean closed,
                                   boolean hasUv,
                                   Lights<?> lights)

Draw a cylinder with axis along Y ========================================================================= Copyright (c) 2002-2008 LWJGL Project 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 'LWJGL' 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.

reserveCylinder

public static void reserveCylinder(Batch batch,
                                   int slices,
                                   boolean fill,
                                   boolean closed)

putCylinder

public static void putCylinder(Batch batch,
                               Vec3 position,
                               float baseRadius,
                               float topRadius,
                               float height,
                               int slices,
                               boolean fill,
                               boolean closed)

createCapsule

public static Batch createCapsule(Batch dstBatchOrNull,
                                  Capsule capsule,
                                  int slices,
                                  boolean fill,
                                  boolean hasUv,
                                  Lights<?> lights)

Draw a capsule