Base class for all render targets (window, texture, ...) More...

#include <gf/RenderTarget.h>

Inheritance diagram for gf::RenderTarget:

Public Member Functions
	RenderTarget ()=default
	Default constructor. More...

virtual	~RenderTarget ()
	Destructor. More...

	RenderTarget (const RenderTarget &)=delete
	Deleted copy constructor. More...

RenderTarget &	operator= (const RenderTarget &)=delete
	Deleted copy assignment. More...

virtual Vector2u	getSize () const =0
	Return the size of the rendering region of the target. More...

Drawing commands
bool	getScissorTest ()
	Tell if the scissor test is enabled. More...

void	setScissorTest (bool scissor=true)
	Enable or disable the scissor test. More...

RectI	getScissoBox ()
	Get the current scissor box. More...

void	setScissorBox (const RectI &box)
	Define the scissor box. More...

void	clear (const Color4f &color)
	Clear the entire target with a single color. More...

void	clear ()
	Clear the entire target. More...

RangeF	getAliasedLineWidthRange () const
	Get the range for aliased line width. More...

float	getLineWidth () const
	Get the line width. More...

void	draw (const Vertex *vertices, std::size_t count, PrimitiveType type, const RenderStates &states=RenderStates())
	Draw primitives defined by an array of vertices. More...

void	draw (const Vertex vertices, const uint16_t indices, std::size_t count, PrimitiveType type, const RenderStates &states=RenderStates())
	Draw primitives defined by an array of vertices and their indices. More...

void	draw (const Vertex vertices, int first, const std::size_t *count, std::size_t primcount, PrimitiveType type, const RenderStates &states=RenderStates())
	Draw primitives defined by an array of vertices. More...

void	draw (const Vertex vertices, const uint16_t indices, const std::size_t count, std::size_t primcount, PrimitiveType type, const RenderStates &states=RenderStates())
	Draw primitives defined by an array of vertices and their indices. More...

void	draw (const VertexBuffer &buffer, const RenderStates &states=RenderStates())
	Draw a vertex buffer to the render target. More...

void	draw (Drawable &drawable, const RenderStates &states=RenderStates())
	Draw a drawable object to the render target. More...

View management
void	setView (const View &view)
	Change the current active view. More...

const View &	getView () const
	Get the view currently in use in the render target. More...

RectI	getViewport (const View &view) const
	Get the viewport of a view, applied to this render target. More...

Vector2f	mapPixelToCoords (Vector2i point, const View &view) const
	Convert a point from target coordinates to world coordinates. More...

Vector2f	mapPixelToCoords (Vector2i point) const
	Convert a point from target coordinates to world coordinates, using the current view. More...

Vector2i	mapCoordsToPixel (Vector2f point, const View &view) const
	Convert a point from world coordinates to target coordinates. More...

Vector2i	mapCoordsToPixel (Vector2f point) const
	Convert a point from world coordinates to target coordinates, using the current view. More...

Protected Member Functions
void	initialize ()
	Performs the common initialization step after creation. More...

Image	captureFramebuffer (unsigned name) const
	Capture the given framebuffer. More...

Detailed Description

Base class for all render targets (window, texture, ...)

gf::RenderTarget defines the common behavior of all the 2D render targets usable in the graphics module. It makes it possible to draw 2D entities like sprites, shapes, text without using any OpenGL command directly.

A gf::RenderTarget is also able to use views (gf::View), which are a kind of 2D cameras. With views you can globally scroll, rotate or zoom everything that is drawn, without having to transform every single entity. See the documentation of gf::View for more details and sample pieces of code about this class.

See also: gf::RenderWindow, gf::RenderTexture, gf::View

Constructor & Destructor Documentation

gf::RenderTarget::RenderTarget ( )

default

Default constructor.

virtual gf::RenderTarget::~RenderTarget ( )

virtual

Destructor.

gf::RenderTarget::RenderTarget ( const RenderTarget & )

delete

Deleted copy constructor.

Member Function Documentation

Image gf::RenderTarget::captureFramebuffer ( unsigned name ) const

protected

Capture the given framebuffer.

Parameters

name	The name of the framebuffer

void gf::RenderTarget::clear ( const Color4f & color )

Clear the entire target with a single color.

This function is usually called once every frame, to clear the previous contents of the target.

Parameters

color Fill color to use to clear the render target

void gf::RenderTarget::clear ( )

Clear the entire target.

This function is usually called once every frame, to clear the previous contents of the target.

The color used to clear the target is the last color passed to the other version of clear().

void gf::RenderTarget::draw	(	const Vertex *	vertices,
		std::size_t	count,
		PrimitiveType	type,
		const RenderStates &	states = `RenderStates()`
	)

Draw primitives defined by an array of vertices.

Parameters

vertices	Pointer to the vertices
count	Number of vertices in the array
type	Type of primitives to draw
states	Render states to use for drawing

void gf::RenderTarget::draw	(	const Vertex *	vertices,
		const uint16_t *	indices,
		std::size_t	count,
		PrimitiveType	type,
		const RenderStates &	states = `RenderStates()`
	)

Draw primitives defined by an array of vertices and their indices.

Parameters

vertices	Pointer to the vertices
indices	Pointer to the indices
count	Number of indices in the array
type	Type of primitives to draw
states	Render states to use for drawing

void gf::RenderTarget::draw	(	const Vertex *	vertices,
		int *	first,
		const std::size_t *	count,
		std::size_t	primcount,
		PrimitiveType	type,
		const RenderStates &	states = `RenderStates()`
	)

Draw primitives defined by an array of vertices.

Parameters

vertices	Pointer to the vertices
first	Array of starting indices
count	Array of number of vertices
primcount	Number of elements in `first` and `count`
type	Type of primitives to draw
states	Render states to use for drawing

void gf::RenderTarget::draw	(	const Vertex *	vertices,
		const uint16_t **	indices,
		const std::size_t *	count,
		std::size_t	primcount,
		PrimitiveType	type,
		const RenderStates &	states = `RenderStates()`
	)

Draw primitives defined by an array of vertices and their indices.

Parameters

vertices	Pointer to the vertices
indices	Array of pointers to the indices
count	Array of number of indices
primcount	Number of elements in `indices` and `count`
type	Type of primitives to draw
states	Render states to use for drawing

void gf::RenderTarget::draw	(	const VertexBuffer &	buffer,
		const RenderStates &	states = `RenderStates()`
	)

Draw a vertex buffer to the render target.

Parameters

buffer	A vertex buffer containing a geometry
states	Render states to use for drawing

void gf::RenderTarget::draw	(	Drawable &	drawable,
		const RenderStates &	states = `RenderStates()`
	)

Draw a drawable object to the render target.

Parameters

drawable	Object to draw
states	Render states to use for drawing

RangeF gf::RenderTarget::getAliasedLineWidthRange ( ) const

Get the range for aliased line width.

Returns: A range for the line width

See also: setLineWidth(), getLineWidth()

float gf::RenderTarget::getLineWidth ( ) const

Get the line width.

Returns: The current line width

See also: setLineWidth(), getAliasedLineWidthRange()

RectI gf::RenderTarget::getScissoBox ( )

Get the current scissor box.

Returns: The current scissor box

bool gf::RenderTarget::getScissorTest ( )

Tell if the scissor test is enabled.

Returns: True if the scissor test is enabled

virtual Vector2u gf::RenderTarget::getSize ( ) const

pure virtual

Return the size of the rendering region of the target.

Returns: Size in pixels

Implemented in gf::RenderTexture, gf::RenderPipeline, and gf::RenderWindow.

const View& gf::RenderTarget::getView ( ) const

inline

Get the view currently in use in the render target.

Returns: The view object that is currently used

See also: setView(), getDefaultView()

RectI gf::RenderTarget::getViewport ( const View & view ) const

Get the viewport of a view, applied to this render target.

The viewport is defined in the view as a ratio, this function simply applies this ratio to the current dimensions of the render target to calculate the pixels rectangle that the viewport actually covers in the target.

Parameters

view	The view for which we want to compute the viewport

Returns: Viewport rectangle, expressed in pixels

void gf::RenderTarget::initialize ( )

protected

Performs the common initialization step after creation.

The derived classes must call this function after the target is created and ready for drawing.

Vector2i gf::RenderTarget::mapCoordsToPixel	(	Vector2f	point,
		const View &	view
	)		const

Convert a point from world coordinates to target coordinates.

This function finds the pixel of the render target that matches the given 2D point. In other words, it goes through the same process as the graphics card, to compute the final position of a rendered point.

Initially, both coordinate systems (world units and target pixels) match perfectly. But if you define a custom view or resize your render target, this assertion is not true anymore, i.e. a point located at \((150, 75)\) in your 2D world may map to the pixel \((10, 50)\) of your render target – if the view is translated by \((140, 25)\).

This version uses a custom view for calculations, see the other overload of the function if you want to use the current view of the render target.

Parameters

point	Point to convert
view	The view to use for converting the point

Returns: The converted point, in target coordinates (pixels)

See also: mapPixelToCoords()

Vector2i gf::RenderTarget::mapCoordsToPixel ( Vector2f point ) const

Convert a point from world coordinates to target coordinates, using the current view.

This function is an overload of the mapCoordsToPixel function that implicitly uses the current view.

It is equivalent to:

target.mapCoordsToPixel(point, target.getView());

Parameters

point Point to convert

Returns: The converted point, in target coordinates (pixels)

See also: mapPixelToCoords()

Vector2f gf::RenderTarget::mapPixelToCoords	(	Vector2i	point,
		const View &	view
	)		const

Convert a point from target coordinates to world coordinates.

This function finds the 2D position that matches the given pixel of the render target. In other words, it does the inverse of what the graphics card does, to find the initial position of a rendered pixel.

Initially, both coordinate systems (world units and target pixels) match perfectly. But if you define a custom view or resize your render target, this assertion is not true anymore, i.e. a point located at \((10, 50)\) in your render target may map to the point \((150, 75)\) in your 2D world – if the view is translated by \((140, 25)\).

For windows, this function is typically used to find which point (or object) is located below the mouse cursor.

This version uses a custom view for calculations, see the other overload of the function if you want to use the current view of the render target.

Parameters

point	Pixel to convert
view	The view to use for converting the point

Returns: The converted point, in world coordinates

See also: mapCoordsToPixel()

Vector2f gf::RenderTarget::mapPixelToCoords ( Vector2i point ) const

Convert a point from target coordinates to world coordinates, using the current view.

This function is an overload of the mapPixelToCoords() function that implicitly uses the current view.

It is equivalent to:

target.mapPixelToCoords(point, target.getView());

Parameters

point Pixel to convert

Returns: The converted point, in world coordinates

See also: mapCoordsToPixel()

RenderTarget& gf::RenderTarget::operator= ( const RenderTarget & )

delete

Deleted copy assignment.

void gf::RenderTarget::setScissorBox ( const RectI & box )

Define the scissor box.

Parameters

box	The scissor box

void gf::RenderTarget::setScissorTest ( bool scissor = true )

Enable or disable the scissor test.

Parameters

scissor True to enable, false to disable the test

void gf::RenderTarget::setView ( const View & view )

inline

Change the current active view.

The view is like a 2D camera, it controls which part of the 2D scene is visible, and how it is viewed in the render target.

The new view will affect everything that is drawn, until another view is set.

The render target keeps its own copy of the view object, so it is not necessary to keep the original one alive after calling this function.

To restore the original view of the target, you can pass the result of getDefaultView() to this function.

Parameters

view	New view to use

See also: getView(), getDefaultView()

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation