SDL_gpu_shapes.c File Reference

#include "SDL_gpu.h"
#include "SDL_gpu_RendererImpl.h"
#include <string.h>

Go to the source code of this file.

Macros
#define	CHECK_RENDERER()
#define	CHECK_RENDERER_1(ret)

Functions
float	GPU_SetLineThickness (float thickness)
float	GPU_GetLineThickness (void)
void	GPU_Pixel (GPU_Target *target, float x, float y, SDL_Color color)
void	GPU_Line (GPU_Target *target, float x1, float y1, float x2, float y2, SDL_Color color)
void	GPU_Arc (GPU_Target *target, float x, float y, float radius, float start_angle, float end_angle, SDL_Color color)
void	GPU_ArcFilled (GPU_Target *target, float x, float y, float radius, float start_angle, float end_angle, SDL_Color color)
void	GPU_Circle (GPU_Target *target, float x, float y, float radius, SDL_Color color)
void	GPU_CircleFilled (GPU_Target *target, float x, float y, float radius, SDL_Color color)
void	GPU_Ellipse (GPU_Target *target, float x, float y, float rx, float ry, float degrees, SDL_Color color)
void	GPU_EllipseFilled (GPU_Target *target, float x, float y, float rx, float ry, float degrees, SDL_Color color)
void	GPU_Sector (GPU_Target *target, float x, float y, float inner_radius, float outer_radius, float start_angle, float end_angle, SDL_Color color)
void	GPU_SectorFilled (GPU_Target *target, float x, float y, float inner_radius, float outer_radius, float start_angle, float end_angle, SDL_Color color)
void	GPU_Tri (GPU_Target *target, float x1, float y1, float x2, float y2, float x3, float y3, SDL_Color color)
void	GPU_TriFilled (GPU_Target *target, float x1, float y1, float x2, float y2, float x3, float y3, SDL_Color color)
void	GPU_Rectangle (GPU_Target *target, float x1, float y1, float x2, float y2, SDL_Color color)
void	GPU_Rectangle2 (GPU_Target *target, GPU_Rect rect, SDL_Color color)
void	GPU_RectangleFilled (GPU_Target *target, float x1, float y1, float x2, float y2, SDL_Color color)
void	GPU_RectangleFilled2 (GPU_Target *target, GPU_Rect rect, SDL_Color color)
void	GPU_RectangleRound (GPU_Target *target, float x1, float y1, float x2, float y2, float radius, SDL_Color color)
void	GPU_RectangleRound2 (GPU_Target *target, GPU_Rect rect, float radius, SDL_Color color)
void	GPU_RectangleRoundFilled (GPU_Target *target, float x1, float y1, float x2, float y2, float radius, SDL_Color color)
void	GPU_RectangleRoundFilled2 (GPU_Target *target, GPU_Rect rect, float radius, SDL_Color color)
void	GPU_Polygon (GPU_Target *target, unsigned int num_vertices, float *vertices, SDL_Color color)
void	GPU_PolygonFilled (GPU_Target *target, unsigned int num_vertices, float *vertices, SDL_Color color)

Macro Definition Documentation

CHECK_RENDERER

#define CHECK_RENDERER

(

)

Value:

GPU_Renderer* renderer = GPU_GetCurrentRenderer(); \
if(renderer == NULL) \
    return;

Definition at line 5 of file SDL_gpu_shapes.c.

CHECK_RENDERER_1

#define CHECK_RENDERER_1

(

ret

)

Value:

GPU_Renderer* renderer = GPU_GetCurrentRenderer(); \
if(renderer == NULL) \
    return ret;

Definition at line 10 of file SDL_gpu_shapes.c.

Function Documentation

GPU_Arc()

void GPU_Arc	(	GPU_Target *	target,
		float	x,
		float	y,
		float	radius,
		float	start_angle,
		float	end_angle,
		SDL_Color	color
	)

Renders a colored arc curve (circle segment).

Parameters

target	The destination render target
x	x-coord of center point
y	y-coord of center point
radius	The radius of the circle / distance from the center point that rendering will occur
start_angle	The angle to start from, in degrees. Measured clockwise from the positive x-axis.
end_angle	The angle to end at, in degrees. Measured clockwise from the positive x-axis.
color	The color of the shape to render

Definition at line 41 of file SDL_gpu_shapes.c.

GPU_ArcFilled()

void GPU_ArcFilled	(	GPU_Target *	target,
		float	x,
		float	y,
		float	radius,
		float	start_angle,
		float	end_angle,
		SDL_Color	color
	)

Renders a colored filled arc (circle segment / pie piece).

Parameters

target	The destination render target
x	x-coord of center point
y	y-coord of center point
radius	The radius of the circle / distance from the center point that rendering will occur
start_angle	The angle to start from, in degrees. Measured clockwise from the positive x-axis.
end_angle	The angle to end at, in degrees. Measured clockwise from the positive x-axis.
color	The color of the shape to render

Definition at line 48 of file SDL_gpu_shapes.c.

GPU_Circle()

void GPU_Circle	(	GPU_Target *	target,
		float	x,
		float	y,
		float	radius,
		SDL_Color	color
	)

Renders a colored circle outline.

Parameters

target	The destination render target
x	x-coord of center point
y	y-coord of center point
radius	The radius of the circle / distance from the center point that rendering will occur
color	The color of the shape to render

Definition at line 54 of file SDL_gpu_shapes.c.

GPU_CircleFilled()

void GPU_CircleFilled	(	GPU_Target *	target,
		float	x,
		float	y,
		float	radius,
		SDL_Color	color
	)

Renders a colored filled circle.

Parameters

target	The destination render target
x	x-coord of center point
y	y-coord of center point
radius	The radius of the circle / distance from the center point that rendering will occur
color	The color of the shape to render

Definition at line 60 of file SDL_gpu_shapes.c.

GPU_Ellipse()

void GPU_Ellipse	(	GPU_Target *	target,
		float	x,
		float	y,
		float	rx,
		float	ry,
		float	degrees,
		SDL_Color	color
	)

Renders a colored ellipse outline.

Parameters

target	The destination render target
x	x-coord of center point
y	y-coord of center point
rx	x-radius of ellipse
ry	y-radius of ellipse
degrees	The angle to rotate the ellipse
color	The color of the shape to render

Definition at line 66 of file SDL_gpu_shapes.c.

GPU_EllipseFilled()

void GPU_EllipseFilled	(	GPU_Target *	target,
		float	x,
		float	y,
		float	rx,
		float	ry,
		float	degrees,
		SDL_Color	color
	)

Renders a colored filled ellipse.

Parameters

target	The destination render target
x	x-coord of center point
y	y-coord of center point
rx	x-radius of ellipse
ry	y-radius of ellipse
degrees	The angle to rotate the ellipse
color	The color of the shape to render

Definition at line 72 of file SDL_gpu_shapes.c.

GPU_GetLineThickness()

float GPU_GetLineThickness

(

void

)

Returns the current line thickness value.

Definition at line 22 of file SDL_gpu_shapes.c.

GPU_Line()

void GPU_Line	(	GPU_Target *	target,
		float	x1,
		float	y1,
		float	x2,
		float	y2,
		SDL_Color	color
	)

Renders a colored line.

Parameters

target	The destination render target
x1	x-coord of starting point
y1	y-coord of starting point
x2	x-coord of ending point
y2	y-coord of ending point
color	The color of the shape to render

Definition at line 34 of file SDL_gpu_shapes.c.

GPU_Polygon()

void GPU_Polygon	(	GPU_Target *	target,
		unsigned int	num_vertices,
		float *	vertices,
		SDL_Color	color
	)

Renders a colored polygon outline. The vertices are expected to define a convex polygon.

Parameters

target	The destination render target
num_vertices	Number of vertices (x and y pairs)
vertices	An array of vertex positions stored as interlaced x and y coords, e.g. {x1, y1, x2, y2, ...}
color	The color of the shape to render

Definition at line 150 of file SDL_gpu_shapes.c.

GPU_PolygonFilled()

void GPU_PolygonFilled	(	GPU_Target *	target,
		unsigned int	num_vertices,
		float *	vertices,
		SDL_Color	color
	)

Renders a colored filled polygon. The vertices are expected to define a convex polygon.

Parameters

target	The destination render target
num_vertices	Number of vertices (x and y pairs)
vertices	An array of vertex positions stored as interlaced x and y coords, e.g. {x1, y1, x2, y2, ...}
color	The color of the shape to render

Definition at line 156 of file SDL_gpu_shapes.c.

GPU_Rectangle()

void GPU_Rectangle	(	GPU_Target *	target,
		float	x1,
		float	y1,
		float	x2,
		float	y2,
		SDL_Color	color
	)

Renders a colored rectangle outline.

Parameters

target	The destination render target
x1	x-coord of top-left corner
y1	y-coord of top-left corner
x2	x-coord of bottom-right corner
y2	y-coord of bottom-right corner
color	The color of the shape to render

Definition at line 102 of file SDL_gpu_shapes.c.

GPU_Rectangle2()

void GPU_Rectangle2	(	GPU_Target *	target,
		GPU_Rect	rect,
		SDL_Color	color
	)

Renders a colored rectangle outline.

Parameters

target	The destination render target
rect	The rectangular area to draw
color	The color of the shape to render

Definition at line 108 of file SDL_gpu_shapes.c.

GPU_RectangleFilled()

void GPU_RectangleFilled	(	GPU_Target *	target,
		float	x1,
		float	y1,
		float	x2,
		float	y2,
		SDL_Color	color
	)

Renders a colored filled rectangle.

Parameters

target	The destination render target
x1	x-coord of top-left corner
y1	y-coord of top-left corner
x2	x-coord of bottom-right corner
y2	y-coord of bottom-right corner
color	The color of the shape to render

Definition at line 114 of file SDL_gpu_shapes.c.

GPU_RectangleFilled2()

void GPU_RectangleFilled2	(	GPU_Target *	target,
		GPU_Rect	rect,
		SDL_Color	color
	)

Renders a colored filled rectangle.

Parameters

target	The destination render target
rect	The rectangular area to draw
color	The color of the shape to render

Definition at line 120 of file SDL_gpu_shapes.c.

GPU_RectangleRound()

void GPU_RectangleRound	(	GPU_Target *	target,
		float	x1,
		float	y1,
		float	x2,
		float	y2,
		float	radius,
		SDL_Color	color
	)

Renders a colored rounded (filleted) rectangle outline.

Parameters

target	The destination render target
x1	x-coord of top-left corner
y1	y-coord of top-left corner
x2	x-coord of bottom-right corner
y2	y-coord of bottom-right corner
radius	The radius of the corners
color	The color of the shape to render

Definition at line 126 of file SDL_gpu_shapes.c.

GPU_RectangleRound2()

void GPU_RectangleRound2	(	GPU_Target *	target,
		GPU_Rect	rect,
		float	radius,
		SDL_Color	color
	)

Renders a colored rounded (filleted) rectangle outline.

Parameters

target	The destination render target
rect	The rectangular area to draw
radius	The radius of the corners
color	The color of the shape to render

Definition at line 132 of file SDL_gpu_shapes.c.

GPU_RectangleRoundFilled()

void GPU_RectangleRoundFilled	(	GPU_Target *	target,
		float	x1,
		float	y1,
		float	x2,
		float	y2,
		float	radius,
		SDL_Color	color
	)

Renders a colored filled rounded (filleted) rectangle.

Parameters

target	The destination render target
x1	x-coord of top-left corner
y1	y-coord of top-left corner
x2	x-coord of bottom-right corner
y2	y-coord of bottom-right corner
radius	The radius of the corners
color	The color of the shape to render

Definition at line 138 of file SDL_gpu_shapes.c.

GPU_RectangleRoundFilled2()

void GPU_RectangleRoundFilled2	(	GPU_Target *	target,
		GPU_Rect	rect,
		float	radius,
		SDL_Color	color
	)

Renders a colored filled rounded (filleted) rectangle.

Parameters

target	The destination render target
rect	The rectangular area to draw
radius	The radius of the corners
color	The color of the shape to render

Definition at line 144 of file SDL_gpu_shapes.c.

GPU_Sector()

void GPU_Sector	(	GPU_Target *	target,
		float	x,
		float	y,
		float	inner_radius,
		float	outer_radius,
		float	start_angle,
		float	end_angle,
		SDL_Color	color
	)

Renders a colored annular sector outline (ring segment).

Parameters

target	The destination render target
x	x-coord of center point
y	y-coord of center point
inner_radius	The inner radius of the ring
outer_radius	The outer radius of the ring
start_angle	The angle to start from, in degrees. Measured clockwise from the positive x-axis.
end_angle	The angle to end at, in degrees. Measured clockwise from the positive x-axis.
color	The color of the shape to render

Definition at line 78 of file SDL_gpu_shapes.c.

GPU_SectorFilled()

void GPU_SectorFilled	(	GPU_Target *	target,
		float	x,
		float	y,
		float	inner_radius,
		float	outer_radius,
		float	start_angle,
		float	end_angle,
		SDL_Color	color
	)

Renders a colored filled annular sector (ring segment).

Parameters

target	The destination render target
x	x-coord of center point
y	y-coord of center point
inner_radius	The inner radius of the ring
outer_radius	The outer radius of the ring
start_angle	The angle to start from, in degrees. Measured clockwise from the positive x-axis.
end_angle	The angle to end at, in degrees. Measured clockwise from the positive x-axis.
color	The color of the shape to render

Definition at line 84 of file SDL_gpu_shapes.c.

GPU_SetLineThickness()

float GPU_SetLineThickness

(

float

thickness

)

Sets the thickness of lines for the current context.

Parameters

thickness

New line thickness in pixels measured across the line. Default is 1.0f.

Returns

The old thickness value

Definition at line 16 of file SDL_gpu_shapes.c.

GPU_Tri()

void GPU_Tri	(	GPU_Target *	target,
		float	x1,
		float	y1,
		float	x2,
		float	y2,
		float	x3,
		float	y3,
		SDL_Color	color
	)

Renders a colored triangle outline.

Parameters

target	The destination render target
x1	x-coord of first point
y1	y-coord of first point
x2	x-coord of second point
y2	y-coord of second point
x3	x-coord of third point
y3	y-coord of third point
color	The color of the shape to render

Definition at line 90 of file SDL_gpu_shapes.c.

GPU_TriFilled()

void GPU_TriFilled	(	GPU_Target *	target,
		float	x1,
		float	y1,
		float	x2,
		float	y2,
		float	x3,
		float	y3,
		SDL_Color	color
	)

Renders a colored filled triangle.

Parameters

target	The destination render target
x1	x-coord of first point
y1	y-coord of first point
x2	x-coord of second point
y2	y-coord of second point
x3	x-coord of third point
y3	y-coord of third point
color	The color of the shape to render

Definition at line 96 of file SDL_gpu_shapes.c.