RenderingContext

public void bindTarget(
    RenderTarget target
)

Binds a render target to this context to receive the output image. If no render target is specified, the target will be set to the screen. Binding render targets is an advanced feature which is usually not needed in a game.

target

The render target, or null to switch to screen rendering

public void clear(
    float r,
    float g,
    float b
)

Clears the the current render target and fills it with the specified color.

r	Red component of the clear color
g	Green component of the clear color
b	Blue component of the clear color

public float getHeight()

Gets the logical height of the context. Artenus unifies provides uniform graphics on various screen sizes. The logical screen dimensions are device-independent.

The height in texels

public float getMatrix()

Gets the current transformation matrix that is used for drawing. This is a low-level method and is usually not needed for a game.

The transformation matrix

public int getScreenHeight()

Gets the real and unscaled height of the rendering area, which is normally the screen height in a full-screen application.

The height of the rendering area

public int getScreenWidth()

Gets the real and unscaled width of the rendering area, which is normally the screen width in a full-screen application.

The width of the rendering area

public ShaderProgram getShader()

Gets the shader program currently assigned to the rendering context.

The active shader program

public float getWidth()

Gets the logical width of the context. Artenus unifies provides uniform graphics on various screen sizes. The logical screen dimensions are device-independent.

The width in texels

public void identity()

Sets the current matrix to identity, canceling any previous transformation. Calling this method is useful only in rare cases. It is normally enough to use the matrix stack to revert transformations.

public void popMatrix()

Pops the matrix at the top of the transformation matrix stack. The effective matrix will be the one underneath. Calling this method when there is only one matrix in the stack has no effect, and does not throw any exceptions.

You need to be careful to pop as many matrices as you push. The framework and all renderables share the same rendering context. An imbalanced stack usage may cause unexpected rendering results.

public void pushMatrix()

Pushes a matrix on top of the transformation matrix stack. Subsequent transformation calls will only affect the top of the stack, leaving the rest of the matrices in the stack intact.

public void pushMatrix(
    float[] mat
)

Pushes a pre-computed matrix on top of the transformation matrix stack. The argument can be the return value of getMatrix().

mat	The new transformation matrix

public void rect()

Draws the default rectangular primitive with the given state of the rendering context. It is up to the shader program to decide where and how this rectangle is drawn, given the state of the rendering context.

public void rotate(
    float angle
)

Rotates the current matrix with the given angle.

angle

Rotation angle in degrees

public void scale(
    float x,
    float y
)

Scales the current matrix with given factors.

x	Scaling factor along the x axis
y	Scaling factor along the y axis

public void setColorFilter(
    float r,
    float g,
    float b,
    float a
)

Sets the color filter for the given context. The behavior of this method depends on the shader program. But all shader programs in Artenus are required to accept color filters in some way.

r	The red component of the color filter
g	The green component of the color filter
b	The blue component of the color filter
a	The alpha component of the color filter, which determines the transparency

public void setShader(
    ShaderProgram shader
)

Sets the shader program for the rendering context. All graphical method calls after calling this method will work with the shader specified. Using this method correctly is crucial to compatibility with the framework. The following are the rules that apply to all renderables using this method:

• All renderables need to set the program shader before drawing anything.
• Some aspects of the rendering context are reset after setting a shader, so it is recommended to be the first call in render(RenderingContext, int).
• If the render method is called with FLAG_PRESERVE_SHADER_PROGRAM filter, no shader program should be applied. The system uses this flag to render objects in plain graphics, for effects or touch maps. Setting a shader when this flag is on causes instability in the system.
• As all renderables are required to set their own shader programs in the beginning of the rendering process, there is no need to reset the program when rendering is finished.

shader

The shader program, or null to use the default program

public void translate(
    float x,
    float y
)

Translates the current matrix the given distance.

x	The distance along the x axis
y	The distance along the y axis