Wraps the OpenGL function glDrawPixels(). More...

#include <DrawPixels.hpp>

Inheritance diagram for vl::DrawPixels:

Classes
class	Pixels
	Represents a bitmap to be drawn on the screen. More...
Public Member Functions
	DrawPixels ()
void	computeBounds_Implementation ()
void	render_Implementation (const Actor actor, const Shader shader, const Camera camera, OpenGLContext gl_context) const
	Renders the bitamps.
const Collection< Pixels > *	draws () const
Collection< Pixels > *	draws ()
void	deletePixelBufferObjects ()
	deallocate PBOs
void	releaseImages ()
	Iterates on the Pixels objects and sets their Image references to NULL.
bool	generatePixelBufferObjects (EBufferObjectUsage usage, bool discard_local_storage)
	generates PBOs only for Pixels objects without a PBO handle
void	setUsePixelBufferObject (bool use_pbo)
bool	usePixelBufferObject () const
virtual void	updateDirtyBufferObject (EBufferObjectUpdateMode)
	Uploads the data stored in the local buffers on the GPU memory.
virtual void	deleteBufferObject ()
	Destroys the BufferObject (vertex buffer objects) associated to this a Renderable.
Protected Attributes
Collection< Pixels >	mDraws
bool	mUsePixelBufferObject

Detailed Description

Wraps the OpenGL function glDrawPixels().

Bind it to an Actor in order to render one or more bitmaps on the screen. DrawPixels supports multiple bitmaps, can draw a subsection of a bitmap, and supports also PBOs (GL_EXT_pixel_buffer_object). See also DrawPixels::Pixels.

Note:: If the given Actor has an associated transform the bitmap position will follow it.

Remarks:: Be aware that depth test, stencil test, alpha test, clipping planes etc. can affect the rendering of the bitmap. Since this function uses the glRasterPos OpenGL function lighting, texturing and the current color might affect the rendering. For more information look at the glRasterPos documentation.

Definition at line 60 of file DrawPixels.hpp.

Constructor & Destructor Documentation

DrawPixels::DrawPixels ( )

Definition at line 112 of file DrawPixels.cpp.

References mDraws, mUsePixelBufferObject, and vl::Object::setAutomaticDelete().

Member Function Documentation

void vl::DrawPixels::computeBounds_Implementation ( ) [inline, virtual]

Implements vl::Renderable.

Definition at line 134 of file DrawPixels.hpp.

void DrawPixels::render_Implementation	(	const Actor *	actor,
		const Shader *	shader,
		const Camera *	camera,
		OpenGLContext *	gl_context
	)		const `[virtual]`

Renders the bitamps.

If camera != NULL and actor != NULL and actor->transform() != NULL then the bitmaps position will follow the Actor's Transform. The renderer parameter is ignored.

Implements vl::Renderable.

Definition at line 118 of file DrawPixels.cpp.

References vl::DrawPixels::Pixels::align(), vl::AlignHCenter, vl::AlignRight, vl::AlignTop, vl::AlignVCenter, vl::Collection< T >::at(), vl::Image::byteAlignment(), draws(), vl::Image::format(), vl::BufferObject::handle(), vl::Viewport::height(), vl::DrawPixels::Pixels::image(), vl::Image::isValid(), mDraws, vl::DrawPixels::Pixels::mPosition, vl::DrawPixels::Pixels::mSize, vl::DrawPixels::Pixels::mStart, vl::ImagePBO::pixelBufferObject(), vl::Image::pixels(), vl::Camera::project(), vl::Collection< T >::size(), vl::Actor::transform(), vl::Image::type(), vl::Camera::viewport(), VL_CHECK, VL_CHECK_OGL, vl::Image::width(), vl::Viewport::width(), vl::Transform::worldMatrix(), vl::Vector4< T_Scalar >::x(), vl::Vector2< T_Scalar >::x(), vl::Viewport::x(), vl::Vector4< T_Scalar >::y(), vl::Vector2< T_Scalar >::y(), and vl::Viewport::y().