gl::PixelBuffer< T > Class Template Reference

Wrapper around a pixel buffer. More...

#include <GLUtil.hh>

Inheritance diagram for gl::PixelBuffer< T >:

Public Member Functions
	PixelBuffer ()=default
	PixelBuffer (PixelBuffer &&other) noexcept
PixelBuffer &	operator= (PixelBuffer &&other) noexcept
void	setImage (GLuint width, GLuint height)
	Sets the image for this buffer.
void	bind () const
	Bind this PixelBuffer.
void	unbind () const
	Unbind this buffer.
T *	getOffset (GLuint x, GLuint y)
	Gets a pointer relative to the start of this buffer.
T *	mapWrite ()
	Maps the contents of this buffer into memory.
void	unmap () const
	Unmaps the contents of this buffer.

Detailed Description

template<typename T>
class gl::PixelBuffer< T >

Wrapper around a pixel buffer.

The pixel buffer will be allocated in VRAM if possible, in main RAM otherwise. The pixel type is templatized T.

Note: openGL ES 2.0 does not yet support this. So for now we always use the fallback implementation, maybe we can re-enable this when we switch to openGL ES 3.0.

Definition at line 154 of file GLUtil.hh.

Constructor & Destructor Documentation

PixelBuffer() [1/2]

template<typename T >

gl::PixelBuffer< T >::PixelBuffer ( )

default

PixelBuffer() [2/2]

template<typename T >

gl::PixelBuffer< T >::PixelBuffer ( PixelBuffer< T > &&  other )

noexcept

Definition at line 235 of file GLUtil.hh.

Member Function Documentation

bind()

template<typename T >

void gl::PixelBuffer< T >::bind

(

)

const

Bind this PixelBuffer.

Must be called before the methods getOffset() or mapWrite() are used. (Is a wrapper around glBindBuffer).

Definition at line 273 of file GLUtil.hh.

Referenced by openmsx::GLHQLiteScaler::uploadBlock(), and openmsx::GLHQScaler::uploadBlock().

getOffset()

template<typename T >

T * gl::PixelBuffer< T >::getOffset	(	GLuint	x,
		GLuint	y
	)

Gets a pointer relative to the start of this buffer.

You must not dereference this pointer, but you can pass it to glTexImage etc when this buffer is bound as the source.

Precondition

This PixelBuffer must be bound (see bind()) before calling this method.

Definition at line 289 of file GLUtil.hh.

Referenced by openmsx::GLHQLiteScaler::uploadBlock(), and openmsx::GLHQScaler::uploadBlock().

mapWrite()

template<typename T >

T * gl::PixelBuffer< T >::mapWrite

(

)

Maps the contents of this buffer into memory.

The returned buffer is write-only (reading could be very slow or even result in a segfault).

Returns

Pointer through which you can write pixels to this buffer, or 0 if the buffer could not be mapped.

Precondition

This PixelBuffer must be bound (see bind()) before calling this method.

Definition at line 302 of file GLUtil.hh.

Referenced by openmsx::GLHQLiteScaler::uploadBlock(), and openmsx::GLHQScaler::uploadBlock().

operator=()

template<typename T >

PixelBuffer< T > & gl::PixelBuffer< T >::operator= ( PixelBuffer< T > &&  other )

noexcept

Definition at line 245 of file GLUtil.hh.

setImage()

template<typename T >

void gl::PixelBuffer< T >::setImage	(	GLuint	width,
		GLuint	height
	)

Sets the image for this buffer.

TODO: Actually, only image size for now; later, if we need it, image data too.

Definition at line 255 of file GLUtil.hh.

Referenced by openmsx::GLHQLiteScaler::GLHQLiteScaler(), and openmsx::GLHQScaler::GLHQScaler().

unbind()

template<typename T >

void gl::PixelBuffer< T >::unbind

(

)

const

Unbind this buffer.

Definition at line 281 of file GLUtil.hh.

Referenced by openmsx::GLHQLiteScaler::uploadBlock(), and openmsx::GLHQScaler::uploadBlock().

unmap()

template<typename T >

void gl::PixelBuffer< T >::unmap

(

)

const

Unmaps the contents of this buffer.

After this call, you must no longer use the pointer returned by mapWrite.

Definition at line 313 of file GLUtil.hh.

Referenced by openmsx::GLHQLiteScaler::uploadBlock(), and openmsx::GLHQScaler::uploadBlock().

---

The documentation for this class was generated from the following file:

• GLUtil.hh