org.mini2Dx.core.graphics

Class Graphics

java.lang.Object

org.mini2Dx.core.graphics.Graphics

public class Graphics
extends java.lang.Object

Implements graphics rendering functionality

Constructor Summary

Constructors

Constructor and Description
Graphics(com.badlogic.gdx.graphics.g2d.SpriteBatch spriteBatch, com.badlogic.gdx.graphics.g2d.PolygonSpriteBatch polygonSpriteBatch, com.badlogic.gdx.graphics.glutils.ShapeRenderer shapeRenderer)

Method Summary

Methods

Modifier and Type	Method and Description
void	clearBlendFunction() Resets the blend function to its default
void	clearScaling() Resets scaling back to default values
void	clearShaderProgram() Clears the ShaderProgram applied to this instance
void	disableBlending() Disables blending during rendering
void	drawCircle(float centerX, float centerY, int radius) Draws a circle to the window in the current Color with the set line height
void	drawLineSegment(float x1, float y1, float x2, float y2) Renders a line segment to the window in the current Color with the set line height
void	drawNinePatch(com.badlogic.gdx.scenes.scene2d.utils.NinePatchDrawable ninePatchDrawable, float x, float y, float width, float height) Draws a NinePatchDrawable to screen
void	drawNinePatch(NinePatch ninePatch, float x, float y, float width, float height) Draws a NinePatch to screen
void	drawParticleEffect(ParticleEffect effect) Draws a ParticleEffect or PooledParticleEffect to screen
void	drawPolygon(float[] vertices) Draws a polygon to the window in the current Color
void	drawRect(float x, float y, float width, float height) Renders a rectangle to the window in the current Color with the set line height
void	drawShape(Shape shape) Draws an instance of Shape
void	drawSprite(Sprite sprite) Draws a Sprite with all transformations applied to this graphics context
void	drawSprite(Sprite sprite, float x, float y) Draws a Sprite at the given coordinates with all transformations applied to this graphics context
void	drawSpriteCache(com.badlogic.gdx.graphics.g2d.SpriteCache spriteCache, int cacheId) Draws a SpriteCache
void	drawStage(com.badlogic.gdx.scenes.scene2d.Stage stage) Draws an instance of a LibGDX Stage
void	drawString(java.lang.String text, float x, float y) Draws a string to the window
void	drawString(java.lang.String text, float x, float y, float targetWidth) Draws a string to the window, automatically wrapping it within a specified width
void	drawString(java.lang.String text, float x, float y, float targetWidth, int horizontalAlign) Draws a string to the window, automatically wrapping it within a specified width and aligning it to the left, center or right of the width
void	drawTexture(com.badlogic.gdx.graphics.Texture texture, float x, float y) Draws a texture to this graphics context
void	drawTexture(com.badlogic.gdx.graphics.Texture texture, float x, float y, boolean flipY) Draws a texture to this graphics context
void	drawTexture(com.badlogic.gdx.graphics.Texture texture, float x, float y, float width, float height) Draws a texture to this graphics context
void	drawTexture(com.badlogic.gdx.graphics.Texture texture, float x, float y, float width, float height, boolean flipY)
void	drawTextureRegion(TextureRegion textureRegion, float x, float y) Draws a texture region to this graphics context
void	drawTextureRegion(TextureRegion textureRegion, float x, float y, float width, float height) Draws a texture region to this graphics context
void	drawTriangle(float x1, float y1, float x2, float y2, float x3, float y3) Draws a triangle to the window in the current Color
void	enableBlending() Enables blending during rendering
void	fillCircle(float centerX, float centerY, int radius) Fills a circle to the window in the current Color
void	fillPolygon(float[] vertices, short[] triangles) Fills a polygon to the window in the current Color
void	fillRect(float x, float y, float width, float height) Fills a rectangle to the window in the current Color
void	fillShape(Shape shape) Fills an instance of Shape
void	fillTriangle(float x1, float y1, float x2, float y2, float x3, float y3) Draws a triangle to the window in the current Color
void	flush() Immediately flushes everything rendered rather than waiting until the end of rendering
com.badlogic.gdx.graphics.Color	getBackgroundColor() Returns the background Color
com.badlogic.gdx.graphics.Color	getColor() Returns the Color to draw shapes with
com.badlogic.gdx.graphics.g2d.BitmapFont	getFont() Returns the BitmapFont to draw Strings with
int	getLineHeight() Returns the line height used
com.badlogic.gdx.math.Matrix4	getProjectionMatrix()
float	getRotation()
float	getRotationX()
float	getRotationY()
float	getScaleX()
float	getScaleY()
com.badlogic.gdx.graphics.glutils.ShaderProgram	getShaderProgram() Returns the currently applied ShaderProgram
com.badlogic.gdx.graphics.Color	getTint() Returns the Color tint being applied to all draw operations
float	getTranslationX()
float	getTranslationY()
float	getViewportHeight() Returns the height of the viewport height
float	getViewportWidth() Returns the width of the viewport width
float	getWindowHeight() Returns the height of the window height
float	getWindowWidth() Returns the width of the window width
void	postRender() Called by mini2Dx after rendering
void	preRender(int gameWidth, int gameHeight) Called by mini2Dx before rendering begins
Rectangle	removeClip() Removes the applied clip
void	removeTint() Removes the tinting Color
void	rotate(float degrees, float x, float y) Rotates the canvas by the provided degrees around the provided point
void	scale(float scaleX, float scaleY) Scales the canvas (multiplies scale value)
void	setBackgroundColor(com.badlogic.gdx.graphics.Color backgroundColor) Sets the background Color to be used
void	setBlendFunction(int srcFunc, int dstFunc) Sets the blend function to be applied OpenGL Blend Function Cheatsheet
void	setClip(float x, float y, float width, float height) Sets the graphics context clip.
void	setClip(Rectangle clip) Sets the graphics context clip.
void	setColor(com.badlogic.gdx.graphics.Color color) Sets the Color to draw shapes with
void	setFont(com.badlogic.gdx.graphics.g2d.BitmapFont font) Sets the BitmapFont to draw Strings with
void	setLineHeight(int lineHeight) Sets the line height to be used
void	setRotation(float degrees, float x, float y) Sets the canvas rotation around a provided point
void	setScale(float scaleX, float scaleY) Sets the canvas scale
void	setShaderProgram(com.badlogic.gdx.graphics.glutils.ShaderProgram shaderProgram) Applies a ShaderProgram to this instance
void	setTint(com.badlogic.gdx.graphics.Color tint) Sets the Color to apply to draw operations
void	setTranslation(float translateX, float translateY) Sets the translation coordinates
java.lang.String	toString()
void	translate(float translateX, float translateY) Moves the graphics context by a certain amount of the X and Y axis

Methods inherited from class java.lang.Object

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

Constructor Detail

Graphics

public Graphics(com.badlogic.gdx.graphics.g2d.SpriteBatch spriteBatch,
        com.badlogic.gdx.graphics.g2d.PolygonSpriteBatch polygonSpriteBatch,
        com.badlogic.gdx.graphics.glutils.ShapeRenderer shapeRenderer)

Method Detail

preRender

public void preRender(int gameWidth,
             int gameHeight)

Called by mini2Dx before rendering begins

Parameters:

gameWidth - The current game window width

gameHeight - The current game window height

postRender

public void postRender()

Called by mini2Dx after rendering

drawLineSegment

public void drawLineSegment(float x1,
                   float y1,
                   float x2,
                   float y2)

Renders a line segment to the window in the current Color with the set line height

Parameters:

x1 - X coordinate of point A

y1 - Y coordinate of point A

x2 - X coordinate of point B

y2 - Y coordinate of point B

drawRect

public void drawRect(float x,
            float y,
            float width,
            float height)

Renders a rectangle to the window in the current Color with the set line height

Parameters:

x - The x coordinate to render at

y - The y coordinate to render at

width - The width of the rectangle

height - The height of the rectangle

fillRect

public void fillRect(float x,
            float y,
            float width,
            float height)

Fills a rectangle to the window in the current Color

Parameters:

x - The x coordinate to render at

y - The y coordinate to render at

width - The width of the rectangle

height - The height of the rectangle

drawCircle

public void drawCircle(float centerX,
              float centerY,
              int radius)

Draws a circle to the window in the current Color with the set line height

Parameters:

centerX - The x coordinate of the center of the circle

centerY - The y coordinate of the center of the circle

radius - The radius of the circle

fillCircle

public void fillCircle(float centerX,
              float centerY,
              int radius)

Fills a circle to the window in the current Color

Parameters:

centerX - The x coordinate of the center of the circle

centerY - The y coordinate of the center of the circle

radius - The radius of the circle

drawTriangle

public void drawTriangle(float x1,
                float y1,
                float x2,
                float y2,
                float x3,
                float y3)

Draws a triangle to the window in the current Color

Parameters:

x1 - The x coordinate of the first point

y1 - The y coordinate of the first point

x2 - The x coordinate of the second point

y2 - The y coordinate of the second point

x3 - The x coordinate of the third point

y3 - The y coordinate of the third point

fillTriangle

public void fillTriangle(float x1,
                float y1,
                float x2,
                float y2,
                float x3,
                float y3)

Draws a triangle to the window in the current Color

Parameters:

x1 - The x coordinate of the first point

y1 - The y coordinate of the first point

x2 - The x coordinate of the second point

y2 - The y coordinate of the second point

x3 - The x coordinate of the third point

y3 - The y coordinate of the third point

drawPolygon

public void drawPolygon(float[] vertices)

Draws a polygon to the window in the current Color

Parameters:

vertices - The vertices of the polygon in format x1,y1,x2,y2,x3,y3,etc.

fillPolygon

public void fillPolygon(float[] vertices,
               short[] triangles)

Fills a polygon to the window in the current Color

Parameters:

vertices - The vertices of the polygon in format x1,y1,x2,y2,x3,y3,etc.

triangles - The indices in the vertices parameter that make up the triangles of the polygon

drawString

public void drawString(java.lang.String text,
              float x,
              float y)

Draws a string to the window

Parameters:

text - The String to draw

x - The x coordinate to draw at

y - The y coordinate to draw at

drawString

public void drawString(java.lang.String text,
              float x,
              float y,
              float targetWidth)

Draws a string to the window, automatically wrapping it within a specified width

Parameters:

text - The String to draw

x - The x coordinate to draw at

y - The y coordinate to draw at

targetWidth - The width to render the String at. Note: The string will automatically wrapped if it is longer.

drawString

public void drawString(java.lang.String text,
              float x,
              float y,
              float targetWidth,
              int horizontalAlign)

Draws a string to the window, automatically wrapping it within a specified width and aligning it to the left, center or right of the width

Parameters:

text - The String to draw

x - The x coordinate to draw at

y - The y coordinate to draw at

targetWidth - The width to render the String at. Note: The string will automatically wrapped if it is longer.

horizontalAlign - The horizontal alignment. Note: Use Align to retrieve the appropriate value.

drawTexture

public void drawTexture(com.badlogic.gdx.graphics.Texture texture,
               float x,
               float y)

Draws a texture to this graphics context

Parameters:

texture - The Texture to draw

x - The x coordinate to draw at

y - The y coordinate to draw at

drawTexture

public void drawTexture(com.badlogic.gdx.graphics.Texture texture,
               float x,
               float y,
               boolean flipY)

Draws a texture to this graphics context

Parameters:

texture - The Texture to draw

x - The x coordinate to draw at

y - The y coordinate to draw at

flipY - True if the texture should be flipped vertically

drawTexture

public void drawTexture(com.badlogic.gdx.graphics.Texture texture,
               float x,
               float y,
               float width,
               float height)

Draws a texture to this graphics context

Parameters:

texture - The Texture to draw

x - The x coordinate to draw at

y - The y coordinate to draw at

width - The width to draw the texture (this can stretch/shrink the texture if not matching the texture's width)

height - The height to draw the texture (this can stretch/shrink the texture if not matching the texture's height)

drawTexture

public void drawTexture(com.badlogic.gdx.graphics.Texture texture,
               float x,
               float y,
               float width,
               float height,
               boolean flipY)

Parameters:

texture - The Texture to draw

x - The x coordinate to draw at

y - The y coordinate to draw at

width - The width to draw the texture (this can stretch/shrink the texture if not matching the texture's width)

height - The height to draw the texture (this can stretch/shrink the texture if not matching the texture's height)

flipY - True if the texture should be flipped vertically

drawTextureRegion

public void drawTextureRegion(TextureRegion textureRegion,
                     float x,
                     float y)

Draws a texture region to this graphics context

Parameters:

textureRegion - The TextureRegion to draw

x - The x coordinate to draw at

y - The y coordinate to draw at

drawTextureRegion

public void drawTextureRegion(TextureRegion textureRegion,
                     float x,
                     float y,
                     float width,
                     float height)

Draws a texture region to this graphics context

Parameters:

textureRegion - The TextureRegion to draw

x - The x coordinate to draw at

y - The y coordinate to draw at

width - The width to draw the region (this can stretch/shrink the texture if not matching the region's width)

height - The height to draw the region (this can stretch/shrink the texture if not matching the region's height)

drawShape

public void drawShape(Shape shape)

Draws an instance of Shape

Parameters:

shape - The implementation of Shape to draw

fillShape

public void fillShape(Shape shape)

Fills an instance of Shape

Parameters:

shape - The implementation of Shape to fill

drawSprite

public void drawSprite(Sprite sprite)

Draws a Sprite with all transformations applied to this graphics context

Parameters:

sprite - The Sprite to draw

drawSprite

public void drawSprite(Sprite sprite,
              float x,
              float y)

Draws a Sprite at the given coordinates with all transformations applied to this graphics context

Parameters:

sprite - The Sprite to draw

x - The x coordinate to render at

y - The y coordinate to render at

drawSpriteCache

public void drawSpriteCache(com.badlogic.gdx.graphics.g2d.SpriteCache spriteCache,
                   int cacheId)

Draws a SpriteCache

Parameters:

spriteCache - The SpriteCache to draw

cacheId - The cacheId to draw

drawStage

public void drawStage(com.badlogic.gdx.scenes.scene2d.Stage stage)

Draws an instance of a LibGDX Stage

Parameters:

stage - The Stage to be drawn to screen

drawParticleEffect

public void drawParticleEffect(ParticleEffect effect)

Draws a ParticleEffect or PooledParticleEffect to screen

Parameters:

effect - The effect to be drawn

drawNinePatch

public void drawNinePatch(NinePatch ninePatch,
                 float x,
                 float y,
                 float width,
                 float height)

Draws a NinePatch to screen

Parameters:

ninePatch - The NinePatch to be drawn

x - The x coordinate to draw at

y - The y coordiante to draw at

width - The width to apply to the NinePatch

height - The height to apply to the NinePatch

drawNinePatch

public void drawNinePatch(com.badlogic.gdx.scenes.scene2d.utils.NinePatchDrawable ninePatchDrawable,
                 float x,
                 float y,
                 float width,
                 float height)

Draws a NinePatchDrawable to screen

Parameters:

ninePatchDrawable - The NinePatchDrawable to be drawn

x - The x coordinate to draw at

y - The y coordiante to draw at

width - The width to apply to the NinePatchDrawable

height - The height to apply to the NinePatchDrawable

rotate

public void rotate(float degrees,
          float x,
          float y)

Rotates the canvas by the provided degrees around the provided point

Parameters:

degrees - The degree value in a clockwise direction

x - The x coordinate to rotate around

y - The y coordinate to rotate around

setRotation

public void setRotation(float degrees,
               float x,
               float y)

Sets the canvas rotation around a provided point

Parameters:

degrees - The degree value in a clockwise direction

x - The x coordinate to rotate around

y - The y coordinate to rotate around

scale

public void scale(float scaleX,
         float scaleY)

Scales the canvas (multiplies scale value)

Parameters:

scaleX - Scaling along the X axis

scaleY - Scaling along the Y axis

setScale

public void setScale(float scaleX,
            float scaleY)

Sets the canvas scale

Parameters:

scaleX - Scaling along the X axis

scaleY - Scaling along the Y axis

clearScaling

public void clearScaling()

Resets scaling back to default values

translate

public void translate(float translateX,
             float translateY)

Moves the graphics context by a certain amount of the X and Y axis

Parameters:

translateX - The x axis translation

translateY - The y axis translation

setTranslation

public void setTranslation(float translateX,
                  float translateY)

Sets the translation coordinates

Parameters:

translateX - The x axis translation

translateY - The y axis translation

setClip

public void setClip(float x,
           float y,
           float width,
           float height)

Sets the graphics context clip. Only pixels within this area will be rendered

Parameters:

x - The x coordinate the clip begins at

y - The y coordinate the clip begins at

width - The width of the clip

height - The height of the clip

setClip

public void setClip(Rectangle clip)

Sets the graphics context clip. Only pixels within this area will be rendered

Parameters:

clip - The clip area

removeClip

public Rectangle removeClip()

Removes the applied clip

setTint

public void setTint(com.badlogic.gdx.graphics.Color tint)

Sets the Color to apply to draw operations

Parameters:

tint - The Color to tint with

setFont

public void setFont(com.badlogic.gdx.graphics.g2d.BitmapFont font)

Sets the BitmapFont to draw Strings with

Parameters:

font - A non-null instance of BitmapFont

removeTint

public void removeTint()

Removes the tinting Color

enableBlending

public void enableBlending()

Enables blending during rendering

disableBlending

public void disableBlending()

Disables blending during rendering

setShaderProgram

public void setShaderProgram(com.badlogic.gdx.graphics.glutils.ShaderProgram shaderProgram)

Applies a ShaderProgram to this instance

Parameters:

shaderProgram - The ShaderProgram to apply

getShaderProgram

public com.badlogic.gdx.graphics.glutils.ShaderProgram getShaderProgram()

Returns the currently applied ShaderProgram

Returns:

clearShaderProgram

public void clearShaderProgram()

Clears the ShaderProgram applied to this instance

setBlendFunction

public void setBlendFunction(int srcFunc,
                    int dstFunc)

Sets the blend function to be applied OpenGL Blend Function Cheatsheet

Parameters:

srcFunc - Source GL function

dstFunc - Destination GL function

clearBlendFunction

public void clearBlendFunction()

Resets the blend function to its default

flush

public void flush()

Immediately flushes everything rendered rather than waiting until the end of rendering

getLineHeight

public int getLineHeight()

Returns the line height used

Returns:

A value greater than 0

setLineHeight

public void setLineHeight(int lineHeight)

Sets the line height to be used

Parameters:

lineHeight - A value greater than 0

getColor

public com.badlogic.gdx.graphics.Color getColor()

Returns the Color to draw shapes with

Returns:

A non-null value

setColor

public void setColor(com.badlogic.gdx.graphics.Color color)

Sets the Color to draw shapes with

Parameters:

color -

getBackgroundColor

public com.badlogic.gdx.graphics.Color getBackgroundColor()

Returns the background Color

Returns:

A non-null value

setBackgroundColor

public void setBackgroundColor(com.badlogic.gdx.graphics.Color backgroundColor)

Sets the background Color to be used

getFont

public com.badlogic.gdx.graphics.g2d.BitmapFont getFont()

Returns the BitmapFont to draw Strings with

Returns:

15pt Arial font by default unless setFont() is called

getTint

public com.badlogic.gdx.graphics.Color getTint()

Returns the Color tint being applied to all draw operations

Returns:

getScaleX

public float getScaleX()

getScaleY

public float getScaleY()

getTranslationX

public float getTranslationX()

getTranslationY

public float getTranslationY()

getRotation

public float getRotation()

getRotationX

public float getRotationX()

getRotationY

public float getRotationY()

getProjectionMatrix

public com.badlogic.gdx.math.Matrix4 getProjectionMatrix()

getWindowWidth

public float getWindowWidth()

Returns the width of the window width

Returns:

getWindowHeight

public float getWindowHeight()

Returns the height of the window height

Returns:

getViewportWidth

public float getViewportWidth()

Returns the width of the viewport width

Returns:

getViewportHeight

public float getViewportHeight()

Returns the height of the viewport height

Returns:

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object