#include "rs_mesh.rsh"
#include "rs_program.rsh"

Functions
void	rsgBindProgramFragment (rs_program_fragment pf)
void	rsgBindProgramStore (rs_program_store ps)
void	rsgBindProgramVertex (rs_program_vertex pv)
void	rsgBindProgramRaster (rs_program_raster pr)
void	rsgBindSampler (rs_program_fragment, uint slot, rs_sampler)
void	rsgBindTexture (rs_program_fragment, uint slot, rs_allocation)
void	rsgProgramVertexLoadProjectionMatrix (const rs_matrix4x4 *proj)
void	rsgProgramVertexLoadModelMatrix (const rs_matrix4x4 *model)
void	rsgProgramVertexLoadTextureMatrix (const rs_matrix4x4 *tex)
void	rsgProgramVertexGetProjectionMatrix (rs_matrix4x4 *proj)
void	rsgProgramFragmentConstantColor (rs_program_fragment pf, float r, float g, float b, float a)
void	rsgBindConstant (rs_program_fragment ps, uint slot, rs_allocation c)
void	rsgBindConstant (rs_program_vertex pv, uint slot, rs_allocation c)
uint	rsgGetWidth (void)
uint	rsgGetHeight (void)
void	rsgAllocationSyncAll (rs_allocation alloc)
void	rsgDrawRect (float x1, float y1, float x2, float y2, float z)
void	rsgDrawQuad (float x1, float y1, float z1, float x2, float y2, float z2, float x3, float y3, float z3, float x4, float y4, float z4)
void	rsgDrawQuadTexCoords (float x1, float y1, float z1, float u1, float v1, float x2, float y2, float z2, float u2, float v2, float x3, float y3, float z3, float u3, float v3, float x4, float y4, float z4, float u4, float v4)
void	rsgDrawSpriteScreenspace (float x, float y, float z, float w, float h)
void	rsgDrawMesh (rs_mesh ism)
void	rsgDrawMesh (rs_mesh ism, uint primitiveIndex)
void	rsgDrawMesh (rs_mesh ism, uint primitiveIndex, uint start, uint len)
void	rsgClearColor (float r, float g, float b, float a)
void	rsgClearDepth (float value)
void	rsgDrawText (const char *, int x, int y)
void	rsgDrawText (rs_allocation, int x, int y)
void	rsgBindFont (rs_font font)
void	rsgFontColor (float r, float g, float b, float a)
void	rsgMeasureText (const char , int left, int right, int top, int *bottom)
void	rsgMeasureText (rs_allocation, int left, int right, int top, int bottom)
void	rsgMeshComputeBoundingBox (rs_mesh mesh, float minX, float minY, float minZ, float maxX, float maxY, float maxZ)
static __inline__ void	rsgMeshComputeBoundingBox (rs_mesh mesh, float3 bBoxMin, float3 bBoxMax)

Detailed Description

Renderscript graphics API.

A set of graphics functions used by Renderscript.

Definition in file rs_graphics.rsh.

Function Documentation

void rsgAllocationSyncAll ( rs_allocation alloc )

Sync the contents of an allocation from its SCRIPT memory space to its HW memory spaces.

Parameters:

alloc

void rsgBindConstant	(	rs_program_fragment	ps,
		uint	slot,
		rs_allocation	c
	)

Bind a new Allocation object to a ProgramFragment. The Allocation must be a valid constant input for the Program.

Parameters:

ps	program object
slot	index of the constant buffer on the program
c	constants to bind

void rsgBindConstant	(	rs_program_vertex	pv,
		uint	slot,
		rs_allocation	c
	)

Bind a new Allocation object to a ProgramVertex. The Allocation must be a valid constant input for the Program.

Parameters:

pv	program object
slot	index of the constant buffer on the program
c	constants to bind

void rsgBindFont ( rs_font font )

Binds the font object to be used for all subsequent font rendering calls

Parameters:

font	object to bind

void rsgBindProgramFragment ( rs_program_fragment pf )

Bind a new ProgramFragment to the rendering context.

Parameters:

pf

void rsgBindProgramRaster ( rs_program_raster pr )

Bind a new ProgramRaster to the rendering context.

Parameters:

pr

void rsgBindProgramStore ( rs_program_store ps )

Bind a new ProgramStore to the rendering context.

Parameters:

ps

void rsgBindProgramVertex ( rs_program_vertex pv )

Bind a new ProgramVertex to the rendering context.

Parameters:

pv

void rsgBindSampler	(	rs_program_fragment	,
		uint	slot,
		rs_sampler
	)

Bind a new Sampler object to a ProgramFragment. The sampler will operate on the texture bound at the matching slot.

Parameters:

slot

void rsgBindTexture	(	rs_program_fragment	,
		uint	slot,
		rs_allocation
	)

Bind a new Allocation object to a ProgramFragment. The Allocation must be a valid texture for the Program. The sampling of the texture will be controled by the Sampler bound at the matching slot.

Parameters:

slot

void rsgClearColor	(	float	r,
		float	g,
		float	b,
		float	a
	)

Clears the rendering surface to the specified color.

Parameters:

r
g
b
a

void rsgClearDepth ( float value )

Clears the depth suface to the specified value.

void rsgDrawMesh ( rs_mesh ism )

Draw a mesh using the current context state. The whole mesh is rendered.

Parameters:

ism

void rsgDrawMesh	(	rs_mesh	ism,
		uint	primitiveIndex
	)

Draw part of a mesh using the current context state.

Parameters:

ism	mesh object to render
primitiveIndex	for meshes that contain multiple primitive groups this parameter specifies the index of the group to draw.

void rsgDrawMesh	(	rs_mesh	ism,
		uint	primitiveIndex,
		uint	start,
		uint	len
	)

Draw specified index range of part of a mesh using the current context state.

Parameters:

ism	mesh object to render
primitiveIndex	for meshes that contain multiple primitive groups this parameter specifies the index of the group to draw.
start	starting index in the range
len	number of indices to draw

void rsgDrawQuad	(	float	x1,
		float	y1,
		float	z1,
		float	x2,
		float	y2,
		float	z2,
		float	x3,
		float	y3,
		float	z3,
		float	x4,
		float	y4,
		float	z4
	)

Low performance utility function for drawing a simple quad. Not intended for drawing large quantities of geometry.

Parameters:

x1
y1
z1
x2
y2
z2
x3
y3
z3
x4
y4
z4

void rsgDrawQuadTexCoords	(	float	x1,
		float	y1,
		float	z1,
		float	u1,
		float	v1,
		float	x2,
		float	y2,
		float	z2,
		float	u2,
		float	v2,
		float	x3,
		float	y3,
		float	z3,
		float	u3,
		float	v3,
		float	x4,
		float	y4,
		float	z4,
		float	u4,
		float	v4
	)

Low performance utility function for drawing a textured quad. Not intended for drawing large quantities of geometry.

Parameters:

x1
y1
z1
u1
v1
x2
y2
z2
u2
v2
x3
y3
z3
u3
v3
x4
y4
z4
u4
v4

void rsgDrawRect	(	float	x1,
		float	y1,
		float	x2,
		float	y2,
		float	z
	)

Low performance utility function for drawing a simple rectangle. Not intended for drawing large quantities of geometry.

Parameters:

x1
y1
x2
y2
z

void rsgDrawSpriteScreenspace	(	float	x,
		float	y,
		float	z,
		float	w,
		float	h
	)

Low performance function for drawing rectangles in screenspace. This function uses the default passthough ProgramVertex. Any bound ProgramVertex is ignored. This function has considerable overhead and should not be used for drawing in shipping applications.

Parameters:

x
y
z
w
h

void rsgDrawText	(	const char *	,
		int	x,
		int	y
	)

Draws text given a string and location

void rsgDrawText	(	rs_allocation	,
		int	x,
		int	y
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

void rsgFontColor	(	float	r,
		float	g,
		float	b,
		float	a
	)

Sets the font color for all subsequent rendering calls

Parameters:

r	red component
g	green component
b	blue component
a	alpha component

uint rsgGetHeight ( void )

Get the height of the current rendering surface.

Returns:: uint

uint rsgGetWidth ( void )

Get the width of the current rendering surface.

Returns:: uint

void rsgMeasureText	(	const char *	,
		int *	left,
		int *	right,
		int *	top,
		int *	bottom
	)

Returns the bounding box of the text relative to (0, 0) Any of left, right, top, bottom could be NULL

void rsgMeasureText	(	rs_allocation	,
		int *	left,
		int *	right,
		int *	top,
		int *	bottom
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

void rsgMeshComputeBoundingBox	(	rs_mesh	mesh,
		float *	minX,
		float *	minY,
		float *	minZ,
		float *	maxX,
		float *	maxY,
		float *	maxZ
	)

Computes an axis aligned bounding box of a mesh object

static __inline__ void rsgMeshComputeBoundingBox	(	rs_mesh	mesh,
		float3 *	bBoxMin,
		float3 *	bBoxMax
	)		`[static]`

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 409 of file rs_graphics.rsh.

void rsgProgramFragmentConstantColor	(	rs_program_fragment	pf,
		float	r,
		float	g,
		float	b,
		float	a
	)

Set the constant color for a fixed function emulation program.

Parameters:

pf
r
g
b
a

void rsgProgramVertexGetProjectionMatrix ( rs_matrix4x4 * proj )

Get the projection matrix for a currently bound fixed function vertex program. Calling this function with a custom vertex shader would result in an error.

Parameters:

proj	matrix to store the current projection matrix into

void rsgProgramVertexLoadModelMatrix ( const rs_matrix4x4 * model )

Load the model matrix for a currently bound fixed function vertex program. Calling this function with a custom vertex shader would result in an error.

Parameters:

model model matrix

void rsgProgramVertexLoadProjectionMatrix ( const rs_matrix4x4 * proj )

Load the projection matrix for a currently bound fixed function vertex program. Calling this function with a custom vertex shader would result in an error.

Parameters:

proj	projection matrix

void rsgProgramVertexLoadTextureMatrix ( const rs_matrix4x4 * tex )

Load the texture matrix for a currently bound fixed function vertex program. Calling this function with a custom vertex shader would result in an error.

Parameters:

tex	texture matrix

Functions

Detailed Description

Function Documentation