opengl_compositor.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2013-2017 CERN
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 *
 * @author Maciej Suminski <[email protected]>
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

 
#include <gal/opengl/opengl_compositor.h>
#include <gal/opengl/utils.h>
 
#include <gal/color4d.h>
 
#include <glsl_xor_diff_frag.h>
#include <glsl_xor_diff_vert.h>
 
#include <cassert>
#include <memory>
#include <stdexcept>
#include <wx/log.h>
#include <wx/debug.h>
 
// Trace mask for XOR/difference mode debugging
static const wxChar* const traceGalXorMode = wxT( "KICAD_GAL_XOR_MODE" );
 
using namespace KIGFX;
 
OPENGL_COMPOSITOR::OPENGL_COMPOSITOR() :
        m_initialized( false ),
        m_curBuffer( 0 ),
        m_mainFbo( 0 ),
        m_depthBuffer( 0 ),
        m_curFbo( DIRECT_RENDERING ),
        m_currentAntialiasingMode( GAL_ANTIALIASING_MODE::AA_NONE ),
        m_differenceShader( 0 ),
        m_diffSrcTexUniform( -1 ),
        m_diffDstTexUniform( -1 ),
        m_differenceShaderInitialized( false )
{
    m_antialiasing = std::make_unique<ANTIALIASING_NONE>( this );
}
 
 
OPENGL_COMPOSITOR::~OPENGL_COMPOSITOR()
{
    if( m_initialized )
    {
        try
        {
            clean();
        }
        catch( const std::runtime_error& exc )
        {
            wxLogError( wxT( "Run time exception `%s` occurred in OPENGL_COMPOSITOR destructor." ),
                        exc.what() );
        }
    }
}
 
 
void OPENGL_COMPOSITOR::SetAntialiasingMode( GAL_ANTIALIASING_MODE aMode )
{
    m_currentAntialiasingMode = aMode;
 
    if( m_initialized )
        clean();
}
 
 
GAL_ANTIALIASING_MODE OPENGL_COMPOSITOR::GetAntialiasingMode() const
{
    return m_currentAntialiasingMode;
}
 
 
void OPENGL_COMPOSITOR::Initialize()
{
    if( m_initialized )
        return;
 
    switch( m_currentAntialiasingMode )
    {
    case GAL_ANTIALIASING_MODE::AA_FAST:
        m_antialiasing = std::make_unique<ANTIALIASING_SMAA>( this );
        break;
    case GAL_ANTIALIASING_MODE::AA_HIGHQUALITY:
        m_antialiasing = std::make_unique<ANTIALIASING_SUPERSAMPLING>( this );
        break;
    default:
        m_antialiasing = std::make_unique<ANTIALIASING_NONE>( this );
        break;
    }
 
    VECTOR2I dims = m_antialiasing->GetInternalBufferSize();
    assert( dims.x != 0 && dims.y != 0 );
 
    GLint maxBufSize;
    glGetIntegerv( GL_MAX_RENDERBUFFER_SIZE, &maxBufSize );
 
    if( dims.x < 0 || dims.y < 0 || dims.x > maxBufSize || dims.y >= maxBufSize )
        throw std::runtime_error( "Requested render buffer size is not supported" );
 
    // We need framebuffer objects for drawing the screen contents
    // Generate framebuffer and a depth buffer
    glGenFramebuffers( 1, &m_mainFbo );
    checkGlError( "generating framebuffer", __FILE__, __LINE__ );
    bindFb( m_mainFbo );
 
    // Allocate memory for the depth buffer
    // Attach the depth buffer to the framebuffer
    glGenRenderbuffers( 1, &m_depthBuffer );
    checkGlError( "generating renderbuffer", __FILE__, __LINE__ );
    glBindRenderbuffer( GL_RENDERBUFFER, m_depthBuffer );
    checkGlError( "binding renderbuffer", __FILE__, __LINE__ );
 
    glRenderbufferStorage( GL_RENDERBUFFER, GL_DEPTH24_STENCIL8, dims.x, dims.y );
    checkGlError( "creating renderbuffer storage", __FILE__, __LINE__ );
    glFramebufferRenderbuffer( GL_FRAMEBUFFER, GL_DEPTH_STENCIL_ATTACHMENT,
                               GL_RENDERBUFFER, m_depthBuffer );
    checkGlError( "attaching renderbuffer", __FILE__, __LINE__ );
 
    // Unbind the framebuffer, so by default all the rendering goes directly to the display
    bindFb( DIRECT_RENDERING );
 
    m_initialized = true;
 
    m_antialiasing->Init();
}
 
 
void OPENGL_COMPOSITOR::Resize( unsigned int aWidth, unsigned int aHeight )
{
    if( m_initialized )
        clean();
 
    m_antialiasing->OnLostBuffers();
 
    m_width = aWidth;
    m_height = aHeight;
}
 
 
unsigned int OPENGL_COMPOSITOR::CreateBuffer()
{
    return m_antialiasing->CreateBuffer();
}
 
 
unsigned int OPENGL_COMPOSITOR::CreateBuffer( VECTOR2I aDimensions )
{
    assert( m_initialized );
 
    int maxBuffers, maxTextureSize;
 
    // Get the maximum number of buffers
    glGetIntegerv( GL_MAX_COLOR_ATTACHMENTS, (GLint*) &maxBuffers );
 
    if( (int) usedBuffers() >= maxBuffers )
    {
        throw std::runtime_error( "Cannot create more framebuffers. OpenGL rendering backend requires at "
                                  "least 3 framebuffers. You may try to update/change your graphic drivers." );
    }
 
    glGetIntegerv( GL_MAX_TEXTURE_SIZE, (GLint*) &maxTextureSize );
 
    if( maxTextureSize < (int) aDimensions.x || maxTextureSize < (int) aDimensions.y )
    {
        throw std::runtime_error( "Requested texture size is not supported. Could not create a buffer." );
    }
 
    // GL_COLOR_ATTACHMENTn are consecutive integers
    GLuint attachmentPoint = GL_COLOR_ATTACHMENT0 + usedBuffers();
    GLuint textureTarget;
 
    // Generate the texture for the pixel storage
    glActiveTexture( GL_TEXTURE0 );
    glGenTextures( 1, &textureTarget );
    checkGlError( "generating framebuffer texture target", __FILE__, __LINE__ );
    glBindTexture( GL_TEXTURE_2D, textureTarget );
    checkGlError( "binding framebuffer texture target", __FILE__, __LINE__ );
 
    // Set texture parameters
    glTexEnvf( GL_TEXTURE_ENV, GL_TEXTURE_ENV_MODE, GL_MODULATE );
    glTexImage2D( GL_TEXTURE_2D, 0, GL_RGBA8, aDimensions.x, aDimensions.y, 0, GL_RGBA, GL_UNSIGNED_BYTE, nullptr );
    checkGlError( "creating framebuffer texture", __FILE__, __LINE__ );
    glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST );
    glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST );
 
    // Bind the texture to the specific attachment point, clear and rebind the screen
    bindFb( m_mainFbo );
    glFramebufferTexture2D( GL_FRAMEBUFFER, attachmentPoint, GL_TEXTURE_2D, textureTarget, 0 );
 
    // Check the status, exit if the framebuffer can't be created
    GLenum status = glCheckFramebufferStatus( GL_FRAMEBUFFER );
 
    if( status != GL_FRAMEBUFFER_COMPLETE )
    {
        switch( status )
        {
        case GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT:
            throw std::runtime_error( "The framebuffer attachment points are incomplete." );
 
        case GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT:
            throw std::runtime_error( "No images attached to the framebuffer." );
 
        case GL_FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER:
            throw std::runtime_error( "The framebuffer does not have at least one image attached to it." );
 
        case GL_FRAMEBUFFER_INCOMPLETE_READ_BUFFER:
            throw std::runtime_error( "The framebuffer read buffer is incomplete." );
 
        case GL_FRAMEBUFFER_UNSUPPORTED:
            throw std::runtime_error( "The combination of internal formats of the attached images violates "
                                      "an implementation-dependent set of restrictions." );
 
        case GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE:
            throw std::runtime_error( "GL_RENDERBUFFER_SAMPLES is not the same for all attached renderbuffers" );
 
        case GL_FRAMEBUFFER_INCOMPLETE_LAYER_TARGETS:
            throw std::runtime_error( "Framebuffer incomplete layer targets errors." );
 
        case GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS_EXT:
            throw std::runtime_error( "Framebuffer attachments have different dimensions" );
 
        default:
            throw std::runtime_error( "Unknown error occurred when creating the framebuffer." );
        }
    }
 
    ClearBuffer( COLOR4D::BLACK );
 
    // Return to direct rendering (we were asked only to create a buffer, not switch to one)
    bindFb( DIRECT_RENDERING );
 
    // Store the new buffer
    OPENGL_BUFFER buffer = { aDimensions, textureTarget, attachmentPoint };
    m_buffers.push_back( buffer );
 
    return usedBuffers();
}
 
 
GLenum OPENGL_COMPOSITOR::GetBufferTexture( unsigned int aBufferHandle )
{
    wxCHECK( aBufferHandle > 0 && aBufferHandle <= usedBuffers(), 0 );
    return m_buffers[aBufferHandle - 1].textureTarget;
}
 
 
void OPENGL_COMPOSITOR::SetBuffer( unsigned int aBufferHandle )
{
    wxCHECK( m_initialized && aBufferHandle <= usedBuffers(), /* void */ );
 
    // Either unbind the FBO for direct rendering, or bind the one with target textures
    bindFb( aBufferHandle == DIRECT_RENDERING ? DIRECT_RENDERING : m_mainFbo );
 
    // Switch the target texture
    if( m_curFbo != DIRECT_RENDERING )
    {
        m_curBuffer = aBufferHandle - 1;
        glDrawBuffer( m_buffers[m_curBuffer].attachmentPoint );
        checkGlError( "setting draw buffer", __FILE__, __LINE__ );
 
        glViewport( 0, 0, m_buffers[m_curBuffer].dimensions.x, m_buffers[m_curBuffer].dimensions.y );
    }
    else
    {
        glViewport( 0, 0, GetScreenSize().x, GetScreenSize().y );
    }
}
 
 
void OPENGL_COMPOSITOR::ClearBuffer( const COLOR4D& aColor )
{
    wxCHECK( m_initialized, /* void */ );
 
    glClearColor( aColor.r, aColor.g, aColor.b, m_curFbo == DIRECT_RENDERING ? 1.0f : 0.0f );
    glClear( GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT | GL_STENCIL_BUFFER_BIT );
}
 
 
VECTOR2I OPENGL_COMPOSITOR::GetScreenSize() const
{
    typedef VECTOR2I::coord_type coord_t;
    wxASSERT( m_width <= static_cast<unsigned int>( std::numeric_limits<coord_t>::max() ) );
    wxASSERT( m_height <= static_cast<unsigned int>( std::numeric_limits<coord_t>::max() ) );
 
    return { static_cast<coord_t>( m_width ), static_cast<coord_t>( m_height ) };
}
 
 
void OPENGL_COMPOSITOR::Begin()
{
    m_antialiasing->Begin();
}
 
 
void OPENGL_COMPOSITOR::DrawBuffer( unsigned int aBufferHandle )
{
    m_antialiasing->DrawBuffer( aBufferHandle );
}
 
 
void OPENGL_COMPOSITOR::DrawBuffer( unsigned int aSourceHandle, unsigned int aDestHandle )
{
    wxCHECK( m_initialized && aSourceHandle != 0 && aSourceHandle <= usedBuffers(), /* void */ );
    wxCHECK( aDestHandle <= usedBuffers(), /* void */ );
 
    // Switch to the destination buffer and blit the scene
    SetBuffer( aDestHandle );
 
    // Depth test has to be disabled to make transparency working
    glDisable( GL_DEPTH_TEST );
    glBlendFunc( GL_ONE, GL_ONE_MINUS_SRC_ALPHA );
 
    // Enable texturing and bind the main texture
    glEnable( GL_TEXTURE_2D );
    glBindTexture( GL_TEXTURE_2D, m_buffers[aSourceHandle - 1].textureTarget );
 
    // Draw a full screen quad with the texture
    glMatrixMode( GL_MODELVIEW );
    glPushMatrix();
    glLoadIdentity();
    glMatrixMode( GL_PROJECTION );
    glPushMatrix();
    glLoadIdentity();
 
    glBegin( GL_TRIANGLES );
    glTexCoord2f( 0.0f, 1.0f );
    glVertex2f( -1.0f, 1.0f );
    glTexCoord2f( 0.0f, 0.0f );
    glVertex2f( -1.0f, -1.0f );
    glTexCoord2f( 1.0f, 1.0f );
    glVertex2f( 1.0f, 1.0f );
 
    glTexCoord2f( 1.0f, 1.0f );
    glVertex2f( 1.0f, 1.0f );
    glTexCoord2f( 0.0f, 0.0f );
    glVertex2f( -1.0f, -1.0f );
    glTexCoord2f( 1.0f, 0.0f );
    glVertex2f( 1.0f, -1.0f );
    glEnd();
 
    glPopMatrix();
    glMatrixMode( GL_MODELVIEW );
    glPopMatrix();
}
 
 
void OPENGL_COMPOSITOR::Present()
{
    m_antialiasing->Present();
}
 
 
void OPENGL_COMPOSITOR::bindFb( unsigned int aFb )
{
    // Currently there are only 2 valid FBOs
    wxASSERT( aFb == DIRECT_RENDERING || aFb == m_mainFbo );
 
    // Another canvas' teardown can run inside this context and rebind, so a cached value
    // here can claim a binding that the context no longer has
    glBindFramebuffer( GL_FRAMEBUFFER, aFb );
    checkGlError( "switching framebuffer", __FILE__, __LINE__ );
    m_curFbo = aFb;
}
 
 
void OPENGL_COMPOSITOR::clean()
{
    wxCHECK( m_initialized, /* void */ );
 
    bindFb( DIRECT_RENDERING );
 
    for( const OPENGL_BUFFER& buffer : m_buffers )
        glDeleteTextures( 1, &buffer.textureTarget );
 
    m_buffers.clear();
 
    if( glDeleteFramebuffers )
        glDeleteFramebuffers( 1, &m_mainFbo );
 
    if( glDeleteRenderbuffers )
        glDeleteRenderbuffers( 1, &m_depthBuffer );
 
    // Clean up difference shader
    if( m_differenceShaderInitialized && m_differenceShader != 0 )
    {
        glDeleteProgram( m_differenceShader );
        m_differenceShader = 0;
        m_differenceShaderInitialized = false;
    }
 
    m_initialized = false;
}
 
 
void OPENGL_COMPOSITOR::Abandon()
{
    m_buffers.clear();
    m_mainFbo = 0;
    m_depthBuffer = 0;
    m_differenceShader = 0;
    m_differenceShaderInitialized = false;
    m_initialized = false;
}
 
 
int OPENGL_COMPOSITOR::GetAntialiasSupersamplingFactor() const
{
    switch ( m_currentAntialiasingMode )
    {
    case GAL_ANTIALIASING_MODE::AA_HIGHQUALITY: return 2;
    default:                                      return 1;
    }
}
 
 
VECTOR2D OPENGL_COMPOSITOR::GetAntialiasRenderingOffset() const
{
    switch( m_currentAntialiasingMode )
    {
    case GAL_ANTIALIASING_MODE::AA_HIGHQUALITY: return VECTOR2D( 0.5, -0.5 );
    default:                                      return VECTOR2D( 0, 0 );
    }
}
 
 
bool OPENGL_COMPOSITOR::initDifferenceShader()
{
    wxLogTrace( traceGalXorMode, wxT( "initDifferenceShader() called, initialized=%d" ),
                m_differenceShaderInitialized );
 
    if( m_differenceShaderInitialized )
    {
        wxLogTrace( traceGalXorMode, wxT( "initDifferenceShader(): already initialized, returning" ) );
        return true;
    }
 
    const char* vertexShaderSrc = BUILTIN_SHADERS::glsl_xor_diff_vert.c_str();
    const char* fragmentShaderSrc = BUILTIN_SHADERS::glsl_xor_diff_frag.c_str();
 
    wxLogTrace( traceGalXorMode, wxT( "initDifferenceShader(): creating shaders" ) );
    wxLogTrace( traceGalXorMode, wxT( "Vertex shader source:\n%s" ), vertexShaderSrc );
    wxLogTrace( traceGalXorMode, wxT( "Fragment shader source:\n%s" ), fragmentShaderSrc );
 
    GLuint vertexShader = glCreateShader( GL_VERTEX_SHADER );
    GLuint fragmentShader = glCreateShader( GL_FRAGMENT_SHADER );
 
    wxLogTrace( traceGalXorMode, wxT( "initDifferenceShader(): vertexShader=%u, fragmentShader=%u" ),
                vertexShader, fragmentShader );
 
    // Compile vertex shader
    glShaderSource( vertexShader, 1, &vertexShaderSrc, nullptr );
    glCompileShader( vertexShader );
 
    GLint compiled;
    glGetShaderiv( vertexShader, GL_COMPILE_STATUS, &compiled );
 
    wxLogTrace( traceGalXorMode, wxT( "initDifferenceShader(): vertex shader compile status=%d" ), compiled );
 
    if( !compiled )
    {
        GLint logLen;
        glGetShaderiv( vertexShader, GL_INFO_LOG_LENGTH, &logLen );
 
        if( logLen > 0 )
        {
            char* log = new char[logLen];
            glGetShaderInfoLog( vertexShader, logLen, nullptr, log );
            wxLogTrace( traceGalXorMode, wxT( "Vertex shader compile error:\n%s" ), log );
            delete[] log;
        }
 
        glDeleteShader( vertexShader );
        glDeleteShader( fragmentShader );
        return false;
    }
 
    // Compile fragment shader
    glShaderSource( fragmentShader, 1, &fragmentShaderSrc, nullptr );
    glCompileShader( fragmentShader );
 
    glGetShaderiv( fragmentShader, GL_COMPILE_STATUS, &compiled );
 
    wxLogTrace( traceGalXorMode, wxT( "initDifferenceShader(): fragment shader compile status=%d" ), compiled );
 
    if( !compiled )
    {
        GLint logLen;
        glGetShaderiv( fragmentShader, GL_INFO_LOG_LENGTH, &logLen );
 
        if( logLen > 0 )
        {
            char* log = new char[logLen];
            glGetShaderInfoLog( fragmentShader, logLen, nullptr, log );
            wxLogTrace( traceGalXorMode, wxT( "Fragment shader compile error:\n%s" ), log );
            delete[] log;
        }
 
        glDeleteShader( vertexShader );
        glDeleteShader( fragmentShader );
        return false;
    }
 
    // Create and link program
    m_differenceShader = glCreateProgram();
    wxLogTrace( traceGalXorMode, wxT( "initDifferenceShader(): created program=%u" ), m_differenceShader );
 
    glAttachShader( m_differenceShader, vertexShader );
    glAttachShader( m_differenceShader, fragmentShader );
    glLinkProgram( m_differenceShader );
 
    GLint linked;
    glGetProgramiv( m_differenceShader, GL_LINK_STATUS, &linked );
 
    wxLogTrace( traceGalXorMode, wxT( "initDifferenceShader(): link status=%d" ), linked );
 
    // Clean up shader objects (they're now part of the program)
    glDeleteShader( vertexShader );
    glDeleteShader( fragmentShader );
 
    if( !linked )
    {
        GLint logLen;
        glGetProgramiv( m_differenceShader, GL_INFO_LOG_LENGTH, &logLen );
 
        if( logLen > 0 )
        {
            char* log = new char[logLen];
            glGetProgramInfoLog( m_differenceShader, logLen, nullptr, log );
            wxLogTrace( traceGalXorMode, wxT( "Shader program link error:\n%s" ), log );
            delete[] log;
        }
 
        glDeleteProgram( m_differenceShader );
        m_differenceShader = 0;
        return false;
    }
 
    // Get uniform locations
    m_diffSrcTexUniform = glGetUniformLocation( m_differenceShader, "srcTex" );
    m_diffDstTexUniform = glGetUniformLocation( m_differenceShader, "dstTex" );
 
    wxLogTrace( traceGalXorMode, wxT( "initDifferenceShader(): srcTexUniform=%d, dstTexUniform=%d" ),
                m_diffSrcTexUniform, m_diffDstTexUniform );
 
    m_differenceShaderInitialized = true;
    wxLogTrace( traceGalXorMode, wxT( "initDifferenceShader(): SUCCESS" ) );
    return true;
}
 
 
void OPENGL_COMPOSITOR::drawFullScreenQuad()
{
    glMatrixMode( GL_MODELVIEW );
    glPushMatrix();
    glLoadIdentity();
    glMatrixMode( GL_PROJECTION );
    glPushMatrix();
    glLoadIdentity();
 
    glBegin( GL_TRIANGLES );
    glTexCoord2f( 0.0f, 1.0f );
    glVertex2f( -1.0f, 1.0f );
    glTexCoord2f( 0.0f, 0.0f );
    glVertex2f( -1.0f, -1.0f );
    glTexCoord2f( 1.0f, 1.0f );
    glVertex2f( 1.0f, 1.0f );
 
    glTexCoord2f( 1.0f, 1.0f );
    glVertex2f( 1.0f, 1.0f );
    glTexCoord2f( 0.0f, 0.0f );
    glVertex2f( -1.0f, -1.0f );
    glTexCoord2f( 1.0f, 0.0f );
    glVertex2f( 1.0f, -1.0f );
    glEnd();
 
    glPopMatrix();
    glMatrixMode( GL_MODELVIEW );
    glPopMatrix();
}
 
 
void OPENGL_COMPOSITOR::DrawBufferDifference( unsigned int aSourceHandle, unsigned int aDestHandle )
{
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference() called: src=%u, dst=%u" ),
                aSourceHandle, aDestHandle );
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): initialized=%d, usedBuffers=%u" ),
                m_initialized, usedBuffers() );
 
    wxCHECK( m_initialized && aSourceHandle != 0 && aSourceHandle <= usedBuffers(), /* void */ );
    wxCHECK( aDestHandle != 0 && aDestHandle <= usedBuffers(), /* void */ );
 
    // Initialize shader on first use
    if( !initDifferenceShader() )
    {
        wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): shader init FAILED, falling back" ) );
        // Fallback to regular DrawBuffer if shader fails
        DrawBuffer( aSourceHandle, aDestHandle );
        return;
    }
 
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): shader initialized OK" ) );
 
    // Get the texture targets directly from the buffers
    GLuint srcTexture = m_buffers[aSourceHandle - 1].textureTarget;
    GLuint dstTexture = m_buffers[aDestHandle - 1].textureTarget;
 
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): srcTexture=%u, dstTexture=%u" ),
                srcTexture, dstTexture );
 
    // We only need to copy the destination since we're writing to it.
    // The source can be read directly via texture sampling
    VECTOR2I dims = m_buffers[aDestHandle - 1].dimensions;
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): buffer dims=%dx%d" ), dims.x, dims.y );
 
    // Create temp texture for destination copy (we can't read and write same texture)
    GLuint dstTempTex;
    glGenTextures( 1, &dstTempTex );
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): created dstTempTex=%u" ), dstTempTex );
 
    glActiveTexture( GL_TEXTURE1 );
    glBindTexture( GL_TEXTURE_2D, dstTempTex );
    glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST );
    glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST );
    glTexImage2D( GL_TEXTURE_2D, 0, GL_RGBA8, dims.x, dims.y, 0, GL_RGBA, GL_UNSIGNED_BYTE, nullptr );
    checkGlError( "allocating dst temp texture", __FILE__, __LINE__ );
 
    // Copy destination buffer to temp texture
    bindFb( m_mainFbo );
    GLenum destAttachment = m_buffers[aDestHandle - 1].attachmentPoint;
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): dest attachment point=0x%X" ), destAttachment );
 
    glReadBuffer( destAttachment );
    checkGlError( "setting read buffer for dst copy", __FILE__, __LINE__ );
 
    glCopyTexSubImage2D( GL_TEXTURE_2D, 0, 0, 0, 0, 0, dims.x, dims.y );
    checkGlError( "copying dest to temp texture", __FILE__, __LINE__ );
 
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): copied dest buffer to dstTempTex" ) );
 
    // Set up for rendering with difference shader
    SetBuffer( aDestHandle );
    glDisable( GL_DEPTH_TEST );
    glDisable( GL_BLEND );
 
    // Use the difference shader
    glUseProgram( m_differenceShader );
    checkGlError( "using difference shader program", __FILE__, __LINE__ );
 
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): activated shader program=%u" ),
                m_differenceShader );
 
    // Bind source texture to unit 0
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): binding srcTexture=%u to unit 0" ), srcTexture );
 
    glActiveTexture( GL_TEXTURE0 );
    glBindTexture( GL_TEXTURE_2D, srcTexture );
    glUniform1i( m_diffSrcTexUniform, 0 );
    checkGlError( "binding source texture for XOR mode", __FILE__, __LINE__ );
 
    // Bind destination copy to unit 1
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): binding dstTempTex=%u to unit 1" ), dstTempTex );
 
    glActiveTexture( GL_TEXTURE1 );
    glBindTexture( GL_TEXTURE_2D, dstTempTex );
    glUniform1i( m_diffDstTexUniform, 1 );
    checkGlError( "binding dest texture for XOR mode", __FILE__, __LINE__ );
 
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): drawing fullscreen quad" ) );
 
    // Important: Set GL_TEXTURE0 as active before drawing so that glTexCoord2f
    // sets gl_MultiTexCoord0 (which the vertex shader reads), not gl_MultiTexCoord1
    glActiveTexture( GL_TEXTURE0 );
 
    // Draw the fullscreen quad
    drawFullScreenQuad();
    checkGlError( "drawing fullscreen quad for XOR mode", __FILE__, __LINE__ );
 
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): cleanup" ) );
 
    // Cleanup
    glUseProgram( 0 );
    glDeleteTextures( 1, &dstTempTex );
 
    glActiveTexture( GL_TEXTURE0 );
    glEnable( GL_BLEND );
    glBlendFunc( GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA );
 
    wxLogTrace( traceGalXorMode, wxT( "DrawBufferDifference(): COMPLETE" ) );
}