WSGLCacheCapacityExceededException Class Reference

Exception class for when a WSGLBufferObjectCache's size is exceeded during memory allocation. More...

#include <Rendering/OpenGL/wsglbufferobjectcache.h>

Public Member Functions
	WSGLCacheCapacityExceededException (size_t bytesRequested, size_t bytesAvailable)
QString	getMessage () const noexcept

Detailed Description

This exception can only occur if there aren't enough 'expired' cache items in the cache, usually a sign of trying to draw too much data at the same time. There are two approaches to avoiding the problem:

• Ensure that buffer objects are managed such that only the available memory is used. For example; only keep pointers to on-screen models, or models of the appropriate resolution.
• Use a WSGLBufferObjectCache with unlimited capacity (capacity = 0). This will allow any number of items to be kept in the cache, but performance may degrade significantly once the capacity is exceeded.

If this exception occurs during a call to /ref WSGLBufferObjectCacheItem::allocate no memory will have been allocated for the buffer object.

Constructor & Destructor Documentation

WSGLCacheCapacityExceededException()

WSGLCacheCapacityExceededException	(	size_t	bytesRequested,
		size_t	bytesAvailable
	)

Constructs a new cache capacity exception.

Parameters

bytesRequested	The number of bytes that were requested for allocation.
bytesAvailable	The number of bytes that were actually available in the cache.

Member Function Documentation

getMessage()

QString getMessage ( ) const

noexcept

Return the details about the exception in string form.