def get_offscreen_fbo(width, height, msaa_samples=4):
fbo = Framebuffer()
# using None for the format specifier in Texture.create means we have to
# allocate memory ourselves, which is important here because we seem to
# need to pass nullptr to allocation routine's destination arg (why?).
if msaa_samples > 1:
fbo._colour_texture = Texture.create(
width,
height,
target=gl.GL_TEXTURE_2D_MULTISAMPLE,
internalformat=None)
gl.glTexImage2DMultisample(gl.GL_TEXTURE_2D_MULTISAMPLE, msaa_samples,
gl.GL_RGB, width, height, True)
else:
fbo._colour_texture = Texture.create(width,
height,
internalformat=None)
gl.glTexImage2D(gl.GL_TEXTURE_2D, 0, gl.GL_RGB, width, height, 0,
gl.GL_RGB, gl.GL_UNSIGNED_BYTE, None)
fbo.attach_texture(gl.GL_FRAMEBUFFER, gl.GL_COLOR_ATTACHMENT0,
fbo._colour_texture)
fbo._depth_rb = Renderbuffer(width,
height,
gl.GL_DEPTH_COMPONENT,
samples=msaa_samples)
fbo.attach_renderbuffer(gl.GL_FRAMEBUFFER, gl.GL_DEPTH_ATTACHMENT,
fbo._depth_rb)
assert fbo.is_complete, \
"FramebufferObject not complete after attaching all buffers (bug?); " \
f"status {{fbo.get_status()}}"
return fbo
def createTexImage2DMultisample(width,
height,
target=GL.GL_TEXTURE_2D_MULTISAMPLE,
samples=1,
internalFormat=GL.GL_RGBA8,
texParameters=()):
"""Create a 2D multisampled texture.
Parameters
----------
width : :obj:`int`
Texture width in pixels.
height : :obj:`int`
Texture height in pixels.
target : :obj:`int`
The target texture (e.g. GL_TEXTURE_2D_MULTISAMPLE).
samples : :obj:`int`
Number of samples for multi-sampling, should be >1 and power-of-two.
Work with one sample, but will raise a warning.
internalFormat : :obj:`int`
Internal format for texture data (e.g. GL_RGBA8, GL_R11F_G11F_B10F).
texParameters : :obj:`list` of :obj:`tuple` of :obj:`int`
Optional texture parameters specified as a list of tuples. These values
are passed to 'glTexParameteri'. Each tuple must contain a parameter
name and value. For example, texParameters=[(GL.GL_TEXTURE_MIN_FILTER,
GL.GL_LINEAR), (GL.GL_TEXTURE_MAG_FILTER, GL.GL_LINEAR)]
Returns
-------
:obj:`TexImage2DMultisample`
A TexImage2DMultisample descriptor.
"""
width = int(width)
height = int(height)
if width <= 0 or height <= 0:
raise ValueError("Invalid image dimensions {} x {}.".format(
width, height))
# determine if the 'samples' value is valid
maxSamples = getIntegerv(GL.GL_MAX_SAMPLES)
if (samples & (samples - 1)) != 0:
raise ValueError('Invalid number of samples, must be power-of-two.')
elif samples <= 0 or samples > maxSamples:
raise ValueError(
'Invalid number of samples, must be <{}.'.format(maxSamples))
colorTexId = GL.GLuint()
GL.glGenTextures(1, ctypes.byref(colorTexId))
GL.glBindTexture(target, colorTexId)
GL.glTexImage2DMultisample(target, samples, internalFormat, width, height,
GL.GL_TRUE)
# apply texture parameters
if texParameters:
for pname, param in texParameters:
GL.glTexParameteri(target, pname, param)
GL.glBindTexture(target, 0)
return TexImage2DMultisample(colorTexId, target, width, height,
internalFormat, samples, True, dict())
def create_frame_buffers(width, height, num_samples):
"""Create the frame buffer objects"""
from pyglet import gl
# Create a frame buffer (rendering target)
multi_fbo = gl.GLuint(0)
gl.glGenFramebuffers(1, byref(multi_fbo))
gl.glBindFramebuffer(gl.GL_FRAMEBUFFER, multi_fbo)
# The try block here is because some OpenGL drivers
# (Intel GPU drivers on macbooks in particular) do not
# support multisampling on frame buffer objects
try:
if not gl.gl_info.have_version(major=3, minor=2):
raise Exception('OpenGL version 3.2+ required for \
GL_TEXTURE_2D_MULTISAMPLE')
# Create a multisampled texture to render into
fbTex = gl.GLuint(0)
gl.glGenTextures(1, byref(fbTex))
gl.glBindTexture(gl.GL_TEXTURE_2D_MULTISAMPLE, fbTex)
gl.glTexImage2DMultisample(gl.GL_TEXTURE_2D_MULTISAMPLE, num_samples,
gl.GL_RGBA32F, width, height, True)
gl.glFramebufferTexture2D(gl.GL_FRAMEBUFFER, gl.GL_COLOR_ATTACHMENT0,
gl.GL_TEXTURE_2D_MULTISAMPLE, fbTex, 0)
# Attach a multisampled depth buffer to the FBO
depth_rb = gl.GLuint(0)
gl.glGenRenderbuffers(1, byref(depth_rb))
gl.glBindRenderbuffer(gl.GL_RENDERBUFFER, depth_rb)
gl.glRenderbufferStorageMultisample(gl.GL_RENDERBUFFER, num_samples,
gl.GL_DEPTH_COMPONENT, width,
height)
gl.glFramebufferRenderbuffer(gl.GL_FRAMEBUFFER, gl.GL_DEPTH_ATTACHMENT,
gl.GL_RENDERBUFFER, depth_rb)
except:
logger.debug('Falling back to non-multisampled frame buffer')
# Create a plain texture texture to render into
fbTex = gl.GLuint(0)
gl.glGenTextures(1, byref(fbTex))
gl.glBindTexture(gl.GL_TEXTURE_2D, fbTex)
gl.glTexImage2D(gl.GL_TEXTURE_2D, 0, gl.GL_RGBA, width, height, 0,
gl.GL_RGBA, gl.GL_FLOAT, None)
gl.glFramebufferTexture2D(gl.GL_FRAMEBUFFER, gl.GL_COLOR_ATTACHMENT0,
gl.GL_TEXTURE_2D, fbTex, 0)
# Attach depth buffer to FBO
depth_rb = gl.GLuint(0)
gl.glGenRenderbuffers(1, byref(depth_rb))
gl.glBindRenderbuffer(gl.GL_RENDERBUFFER, depth_rb)
gl.glRenderbufferStorage(gl.GL_RENDERBUFFER, gl.GL_DEPTH_COMPONENT,
width, height)
gl.glFramebufferRenderbuffer(gl.GL_FRAMEBUFFER, gl.GL_DEPTH_ATTACHMENT,
gl.GL_RENDERBUFFER, depth_rb)
# Sanity check
import pyglet
if pyglet.options['debug_gl']:
res = gl.glCheckFramebufferStatus(gl.GL_FRAMEBUFFER)
assert res == gl.GL_FRAMEBUFFER_COMPLETE
# Create the frame buffer used to resolve the final render
final_fbo = gl.GLuint(0)
gl.glGenFramebuffers(1, byref(final_fbo))
gl.glBindFramebuffer(gl.GL_FRAMEBUFFER, final_fbo)
# Create the texture used to resolve the final render
fbTex = gl.GLuint(0)
gl.glGenTextures(1, byref(fbTex))
gl.glBindTexture(gl.GL_TEXTURE_2D, fbTex)
gl.glTexImage2D(gl.GL_TEXTURE_2D, 0, gl.GL_RGBA, width, height, 0,
gl.GL_RGBA, gl.GL_FLOAT, None)
gl.glFramebufferTexture2D(gl.GL_FRAMEBUFFER, gl.GL_COLOR_ATTACHMENT0,
gl.GL_TEXTURE_2D, fbTex, 0)
import pyglet
if pyglet.options['debug_gl']:
res = gl.glCheckFramebufferStatus(gl.GL_FRAMEBUFFER)
assert res == gl.GL_FRAMEBUFFER_COMPLETE
# Enable depth testing
gl.glEnable(gl.GL_DEPTH_TEST)
# Unbind the frame buffer
gl.glBindFramebuffer(gl.GL_FRAMEBUFFER, 0)
return multi_fbo, final_fbo
def create_frame_buffers(width: int, height: int,
num_samples: int) -> Tuple[int, int]:
"""Create the frame buffer objects"""
# Create a frame buffer (rendering target)
multi_fbo = gl.GLuint(0)
gl.glGenFramebuffers(1, byref(multi_fbo))
gl.glBindFramebuffer(gl.GL_FRAMEBUFFER, multi_fbo)
# The try block here is because some OpenGL drivers
# (Intel GPU drivers on macbooks in particular) do not
# support multisampling on frame buffer objects
# noinspection PyBroadException
try:
# Create a multisampled texture to render into
fbTex = gl.GLuint(0)
gl.glGenTextures(1, byref(fbTex))
gl.glBindTexture(gl.GL_TEXTURE_2D_MULTISAMPLE, fbTex)
gl.glTexImage2DMultisample(gl.GL_TEXTURE_2D_MULTISAMPLE, num_samples,
gl.GL_RGBA32F, width, height, True)
gl.glFramebufferTexture2D(gl.GL_FRAMEBUFFER, gl.GL_COLOR_ATTACHMENT0,
gl.GL_TEXTURE_2D_MULTISAMPLE, fbTex, 0)
# Attach a multisampled depth buffer to the FBO
depth_rb = gl.GLuint(0)
gl.glGenRenderbuffers(1, byref(depth_rb))
gl.glBindRenderbuffer(gl.GL_RENDERBUFFER, depth_rb)
gl.glRenderbufferStorageMultisample(gl.GL_RENDERBUFFER, num_samples,
gl.GL_DEPTH_COMPONENT, width,
height)
gl.glFramebufferRenderbuffer(gl.GL_FRAMEBUFFER, gl.GL_DEPTH_ATTACHMENT,
gl.GL_RENDERBUFFER, depth_rb)
except BaseException as e:
# logger.warning(e=traceback.format_exc())
logger.debug("Falling back to non-multisampled frame buffer")
# Create a plain texture texture to render into
fbTex = gl.GLuint(0)
gl.glGenTextures(1, byref(fbTex))
gl.glBindTexture(gl.GL_TEXTURE_2D, fbTex)
gl.glTexImage2D(gl.GL_TEXTURE_2D, 0, gl.GL_RGBA, width, height, 0,
gl.GL_RGBA, gl.GL_FLOAT, None)
gl.glFramebufferTexture2D(gl.GL_FRAMEBUFFER, gl.GL_COLOR_ATTACHMENT0,
gl.GL_TEXTURE_2D, fbTex, 0)
# Attach depth buffer to FBO
depth_rb = gl.GLuint(0)
gl.glGenRenderbuffers(1, byref(depth_rb))
gl.glBindRenderbuffer(gl.GL_RENDERBUFFER, depth_rb)
gl.glRenderbufferStorage(gl.GL_RENDERBUFFER, gl.GL_DEPTH_COMPONENT,
width, height)
gl.glFramebufferRenderbuffer(gl.GL_FRAMEBUFFER, gl.GL_DEPTH_ATTACHMENT,
gl.GL_RENDERBUFFER, depth_rb)
# Sanity check
if pyglet.options["debug_gl"]:
res = gl.glCheckFramebufferStatus(gl.GL_FRAMEBUFFER)
assert res == gl.GL_FRAMEBUFFER_COMPLETE
# Create the frame buffer used to resolve the final render
final_fbo = gl.GLuint(0)
gl.glGenFramebuffers(1, byref(final_fbo))
gl.glBindFramebuffer(gl.GL_FRAMEBUFFER, final_fbo)
# Create the texture used to resolve the final render
fbTex = gl.GLuint(0)
gl.glGenTextures(1, byref(fbTex))
gl.glBindTexture(gl.GL_TEXTURE_2D, fbTex)
gl.glTexImage2D(gl.GL_TEXTURE_2D, 0, gl.GL_RGBA, width, height, 0,
gl.GL_RGBA, gl.GL_FLOAT, None)
gl.glFramebufferTexture2D(gl.GL_FRAMEBUFFER, gl.GL_COLOR_ATTACHMENT0,
gl.GL_TEXTURE_2D, fbTex, 0)
if pyglet.options["debug_gl"]:
res = gl.glCheckFramebufferStatus(gl.GL_FRAMEBUFFER)
assert res == gl.GL_FRAMEBUFFER_COMPLETE
# Enable depth testing
gl.glEnable(gl.GL_DEPTH_TEST)
# Unbind the frame buffer
gl.glBindFramebuffer(gl.GL_FRAMEBUFFER, 0)
return multi_fbo, final_fbo
