mirror of
https://gitlab.com/kicad/code/kicad.git
synced 2025-09-14 18:23:15 +02:00
bf60482b5c
On platforms with limited framebuffer attachments, like GC7000L driven by the open source etnaviv driver, we can still use GPU acceleration by drawing directly to the main buffer. EDA_DRAW_PANEL_GAL::onPaint checks if an overlay target is available in the GAL, and if not, redraws the whole view if the overlay target should be dirty. Clearing of the overlay target is a no-op if there is no overlay buffer. Signed-off-by: Lukas F. Hartmann <lukas@mntre.com>
494 lines
17 KiB
C++
494 lines
17 KiB
C++
/*
|
|
* This program source code file is part of KICAD, a free EDA CAD application.
|
|
*
|
|
* Copyright (C) 2012 Torsten Hueter, torstenhtr <at> gmx.de
|
|
* Copyright (C) 2020 Kicad Developers, see AUTHORS.txt for contributors.
|
|
* Copyright (C) 2013-2017 CERN
|
|
* @author Maciej Suminski <maciej.suminski@cern.ch>
|
|
*
|
|
* Graphics Abstraction Layer (GAL) for OpenGL
|
|
*
|
|
* 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, you may find one here:
|
|
* http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
|
|
* or you may search the http://www.gnu.org website for the version 2 license,
|
|
* or you may write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
|
|
*/
|
|
|
|
#ifndef OPENGLGAL_H_
|
|
#define OPENGLGAL_H_
|
|
|
|
// GAL imports
|
|
#include <gal/graphics_abstraction_layer.h>
|
|
#include <gal/gal_display_options.h>
|
|
#include <gal/opengl/shader.h>
|
|
#include <gal/opengl/vertex_manager.h>
|
|
#include <gal/opengl/vertex_item.h>
|
|
#include <gal/opengl/cached_container.h>
|
|
#include <gal/opengl/noncached_container.h>
|
|
#include <gal/opengl/opengl_compositor.h>
|
|
#include <gal/hidpi_gl_canvas.h>
|
|
|
|
#include <unordered_map>
|
|
#include <boost/smart_ptr/shared_array.hpp>
|
|
#include <memory>
|
|
|
|
#ifndef CALLBACK
|
|
#define CALLBACK
|
|
#endif
|
|
|
|
struct bitmap_glyph;
|
|
|
|
namespace KIGFX
|
|
{
|
|
class SHADER;
|
|
class GL_BITMAP_CACHE;
|
|
|
|
/**
|
|
* @brief Class OpenGL_GAL is the OpenGL implementation of the Graphics Abstraction Layer.
|
|
*
|
|
* This is a direct OpenGL-implementation and uses low-level graphics primitives like triangles
|
|
* and quads. The purpose is to provide a fast graphics interface, that takes advantage of modern
|
|
* graphics card GPUs. All methods here benefit thus from the hardware acceleration.
|
|
*/
|
|
class OPENGL_GAL : public GAL, public HIDPI_GL_CANVAS
|
|
{
|
|
public:
|
|
/**
|
|
* @brief Constructor OPENGL_GAL
|
|
*
|
|
* @param aParent is the wxWidgets immediate wxWindow parent of this object.
|
|
*
|
|
* @param aMouseListener is the wxEvtHandler that should receive the mouse events,
|
|
* this can be can be any wxWindow, but is often a wxFrame container.
|
|
*
|
|
* @param aPaintListener is the wxEvtHandler that should receive the paint
|
|
* event. This can be any wxWindow, but is often a derived instance
|
|
* of this class or a containing wxFrame. The "paint event" here is
|
|
* a wxCommandEvent holding EVT_GAL_REDRAW, as sent by PostPaint().
|
|
*
|
|
* @param aName is the name of this window for use by wxWindow::FindWindowByName()
|
|
*/
|
|
OPENGL_GAL( GAL_DISPLAY_OPTIONS& aDisplayOptions, wxWindow* aParent,
|
|
wxEvtHandler* aMouseListener = nullptr, wxEvtHandler* aPaintListener = nullptr,
|
|
const wxString& aName = wxT( "GLCanvas" ) );
|
|
|
|
~OPENGL_GAL();
|
|
|
|
/**
|
|
* @brief Checks OpenGL features
|
|
* @param aOptions
|
|
* @return wxEmptyString if OpenGL 2.1 or greater is available, otherwise returns error message
|
|
*/
|
|
static wxString CheckFeatures( GAL_DISPLAY_OPTIONS& aOptions );
|
|
|
|
bool IsOpenGlEngine() override { return true; }
|
|
|
|
/// @copydoc GAL::IsInitialized()
|
|
bool IsInitialized() const override
|
|
{
|
|
// is*Initialized flags, but it is enough for OpenGL to show up
|
|
return IsShownOnScreen() && !GetClientRect().IsEmpty();
|
|
}
|
|
|
|
///> @copydoc GAL::IsVisible()
|
|
bool IsVisible() const override
|
|
{
|
|
return IsShownOnScreen() && !GetClientRect().IsEmpty();
|
|
}
|
|
|
|
// ---------------
|
|
// Drawing methods
|
|
// ---------------
|
|
|
|
/// @copydoc GAL::DrawLine()
|
|
void DrawLine( const VECTOR2D& aStartPoint, const VECTOR2D& aEndPoint ) override;
|
|
|
|
/// @copydoc GAL::DrawSegment()
|
|
void DrawSegment( const VECTOR2D& aStartPoint, const VECTOR2D& aEndPoint,
|
|
double aWidth ) override;
|
|
|
|
/// @copydoc GAL::DrawCircle()
|
|
void DrawCircle( const VECTOR2D& aCenterPoint, double aRadius ) override;
|
|
|
|
/// @copydoc GAL::DrawArc()
|
|
void DrawArc( const VECTOR2D& aCenterPoint, double aRadius,
|
|
double aStartAngle, double aEndAngle ) override;
|
|
|
|
/// @copydoc GAL::DrawArcSegment()
|
|
void DrawArcSegment( const VECTOR2D& aCenterPoint, double aRadius,
|
|
double aStartAngle, double aEndAngle, double aWidth ) override;
|
|
|
|
/// @copydoc GAL::DrawRectangle()
|
|
void DrawRectangle( const VECTOR2D& aStartPoint, const VECTOR2D& aEndPoint ) override;
|
|
|
|
/// @copydoc GAL::DrawPolyline()
|
|
void DrawPolyline( const std::deque<VECTOR2D>& aPointList ) override;
|
|
void DrawPolyline( const VECTOR2D aPointList[], int aListSize ) override;
|
|
void DrawPolyline( const SHAPE_LINE_CHAIN& aLineChain ) override;
|
|
|
|
/// @copydoc GAL::DrawPolygon()
|
|
void DrawPolygon( const std::deque<VECTOR2D>& aPointList ) override;
|
|
void DrawPolygon( const VECTOR2D aPointList[], int aListSize ) override;
|
|
void DrawPolygon( const SHAPE_POLY_SET& aPolySet ) override;
|
|
void DrawPolygon( const SHAPE_LINE_CHAIN& aPolySet ) override;
|
|
|
|
/// @copydoc GAL::DrawCurve()
|
|
void DrawCurve( const VECTOR2D& startPoint, const VECTOR2D& controlPointA,
|
|
const VECTOR2D& controlPointB, const VECTOR2D& endPoint,
|
|
double aFilterValue = 0.0 ) override;
|
|
|
|
/// @copydoc GAL::DrawBitmap()
|
|
void DrawBitmap( const BITMAP_BASE& aBitmap ) override;
|
|
|
|
/// @copydoc GAL::BitmapText()
|
|
void BitmapText( const wxString& aText, const VECTOR2D& aPosition,
|
|
double aRotationAngle ) override;
|
|
|
|
/// @copydoc GAL::DrawGrid()
|
|
void DrawGrid() override;
|
|
|
|
// --------------
|
|
// Screen methods
|
|
// --------------
|
|
|
|
/// @brief Resizes the canvas.
|
|
void ResizeScreen( int aWidth, int aHeight ) override;
|
|
|
|
/// @brief Shows/hides the GAL canvas
|
|
bool Show( bool aShow ) override;
|
|
|
|
/// @copydoc GAL::Flush()
|
|
void Flush() override;
|
|
|
|
/// @copydoc GAL::ClearScreen()
|
|
void ClearScreen( ) override;
|
|
|
|
// --------------
|
|
// Transformation
|
|
// --------------
|
|
|
|
/// @copydoc GAL::Transform()
|
|
void Transform( const MATRIX3x3D& aTransformation ) override;
|
|
|
|
/// @copydoc GAL::Rotate()
|
|
void Rotate( double aAngle ) override;
|
|
|
|
/// @copydoc GAL::Translate()
|
|
void Translate( const VECTOR2D& aTranslation ) override;
|
|
|
|
/// @copydoc GAL::Scale()
|
|
void Scale( const VECTOR2D& aScale ) override;
|
|
|
|
/// @copydoc GAL::Save()
|
|
void Save() override;
|
|
|
|
/// @copydoc GAL::Restore()
|
|
void Restore() override;
|
|
|
|
// --------------------------------------------
|
|
// Group methods
|
|
// ---------------------------------------------
|
|
|
|
/// @copydoc GAL::BeginGroup()
|
|
int BeginGroup() override;
|
|
|
|
/// @copydoc GAL::EndGroup()
|
|
void EndGroup() override;
|
|
|
|
/// @copydoc GAL::DrawGroup()
|
|
void DrawGroup( int aGroupNumber ) override;
|
|
|
|
/// @copydoc GAL::ChangeGroupColor()
|
|
void ChangeGroupColor( int aGroupNumber, const COLOR4D& aNewColor ) override;
|
|
|
|
/// @copydoc GAL::ChangeGroupDepth()
|
|
void ChangeGroupDepth( int aGroupNumber, int aDepth ) override;
|
|
|
|
/// @copydoc GAL::DeleteGroup()
|
|
void DeleteGroup( int aGroupNumber ) override;
|
|
|
|
/// @copydoc GAL::ClearCache()
|
|
void ClearCache() override;
|
|
|
|
// --------------------------------------------------------
|
|
// Handling the world <-> screen transformation
|
|
// --------------------------------------------------------
|
|
|
|
/// @copydoc GAL::SetTarget()
|
|
void SetTarget( RENDER_TARGET aTarget ) override;
|
|
|
|
/// @copydoc GAL::GetTarget()
|
|
RENDER_TARGET GetTarget() const override;
|
|
|
|
/// @copydoc GAL::ClearTarget()
|
|
void ClearTarget( RENDER_TARGET aTarget ) override;
|
|
|
|
/// @copydoc GAL::HasTarget()
|
|
virtual bool HasTarget( RENDER_TARGET aTarget ) override;
|
|
|
|
/// @copydoc GAL::SetNegativeDrawMode()
|
|
void SetNegativeDrawMode( bool aSetting ) override {}
|
|
|
|
void ComputeWorldScreenMatrix() override;
|
|
|
|
// -------
|
|
// Cursor
|
|
// -------
|
|
|
|
/// @copydoc GAL::DrawCursor()
|
|
void DrawCursor( const VECTOR2D& aCursorPosition ) override;
|
|
|
|
/**
|
|
* @brief Function PostPaint
|
|
* posts an event to m_paint_listener. A post is used so that the actual drawing
|
|
* function can use a device context type that is not specific to the wxEVT_PAINT event,
|
|
* just by changing the PostPaint code.
|
|
*/
|
|
void PostPaint( wxPaintEvent& aEvent );
|
|
|
|
void SetMouseListener( wxEvtHandler* aMouseListener )
|
|
{
|
|
mouseListener = aMouseListener;
|
|
}
|
|
|
|
void SetPaintListener( wxEvtHandler* aPaintListener )
|
|
{
|
|
paintListener = aPaintListener;
|
|
}
|
|
|
|
void EnableDepthTest( bool aEnabled = false ) override;
|
|
|
|
///< Parameters passed to the GLU tesselator
|
|
typedef struct
|
|
{
|
|
/// Manager used for storing new vertices
|
|
VERTEX_MANAGER* vboManager;
|
|
|
|
/// Intersect points, that have to be freed after tessellation
|
|
std::deque< boost::shared_array<GLdouble> >& intersectPoints;
|
|
} TessParams;
|
|
|
|
private:
|
|
/// Super class definition
|
|
typedef GAL super;
|
|
|
|
static const int CIRCLE_POINTS = 64; ///< The number of points for circle approximation
|
|
static const int CURVE_POINTS = 32; ///< The number of points for curve approximation
|
|
|
|
static wxGLContext* glMainContext; ///< Parent OpenGL context
|
|
wxGLContext* glPrivContext; ///< Canvas-specific OpenGL context
|
|
static int instanceCounter; ///< GL GAL instance counter
|
|
wxEvtHandler* mouseListener;
|
|
wxEvtHandler* paintListener;
|
|
|
|
static GLuint fontTexture; ///< Bitmap font texture handle (shared)
|
|
|
|
// Vertex buffer objects related fields
|
|
typedef std::unordered_map< unsigned int, std::shared_ptr<VERTEX_ITEM> > GROUPS_MAP;
|
|
GROUPS_MAP groups; ///< Stores informations about VBO objects (groups)
|
|
unsigned int groupCounter; ///< Counter used for generating keys for groups
|
|
VERTEX_MANAGER* currentManager; ///< Currently used VERTEX_MANAGER (for storing VERTEX_ITEMs)
|
|
VERTEX_MANAGER* cachedManager; ///< Container for storing cached VERTEX_ITEMs
|
|
VERTEX_MANAGER* nonCachedManager; ///< Container for storing non-cached VERTEX_ITEMs
|
|
VERTEX_MANAGER* overlayManager; ///< Container for storing overlaid VERTEX_ITEMs
|
|
|
|
// Framebuffer & compositing
|
|
OPENGL_COMPOSITOR* compositor; ///< Handles multiple rendering targets
|
|
unsigned int mainBuffer; ///< Main rendering target
|
|
unsigned int overlayBuffer; ///< Auxiliary rendering target (for menus etc.)
|
|
RENDER_TARGET currentTarget; ///< Current rendering target
|
|
|
|
// Shader
|
|
SHADER* shader; ///< There is only one shader used for different objects
|
|
|
|
// Internal flags
|
|
bool isFramebufferInitialized; ///< Are the framebuffers initialized?
|
|
static bool isBitmapFontLoaded; ///< Is the bitmap font texture loaded?
|
|
bool isBitmapFontInitialized; ///< Is the shader set to use bitmap fonts?
|
|
bool isInitialized; ///< Basic initialization flag, has to be done
|
|
///< when the window is visible
|
|
bool isGrouping; ///< Was a group started?
|
|
bool isContextLocked; ///< Used for assertion checking
|
|
int lockClientCookie;
|
|
GLint ufm_worldPixelSize;
|
|
GLint ufm_screenPixelSize;
|
|
GLint ufm_pixelSizeMultiplier;
|
|
|
|
std::unique_ptr<GL_BITMAP_CACHE> bitmapCache;
|
|
|
|
void lockContext( int aClientCookie ) override;
|
|
|
|
void unlockContext( int aClientCookie ) override;
|
|
|
|
/// @copydoc GAL::BeginUpdate()
|
|
void beginUpdate() override;
|
|
|
|
/// @copydoc GAL::EndUpdate()
|
|
void endUpdate() override;
|
|
|
|
/// @copydoc GAL::BeginDrawing()
|
|
void beginDrawing() override;
|
|
|
|
/// @copydoc GAL::EndDrawing()
|
|
void endDrawing() override;
|
|
|
|
///< Update handler for OpenGL settings
|
|
bool updatedGalDisplayOptions( const GAL_DISPLAY_OPTIONS& aOptions ) override;
|
|
|
|
// Polygon tesselation
|
|
/// The tessellator
|
|
GLUtesselator* tesselator;
|
|
/// Storage for intersecting points
|
|
std::deque< boost::shared_array<GLdouble> > tessIntersects;
|
|
|
|
/**
|
|
* @brief Draw a quad for the line.
|
|
*
|
|
* @param aStartPoint is the start point of the line.
|
|
* @param aEndPoint is the end point of the line.
|
|
*/
|
|
void drawLineQuad( const VECTOR2D& aStartPoint, const VECTOR2D& aEndPoint );
|
|
|
|
/**
|
|
* @brief Draw a semicircle. Depending on settings (isStrokeEnabled & isFilledEnabled) it runs
|
|
* the proper function (drawStrokedSemiCircle or drawFilledSemiCircle).
|
|
*
|
|
* @param aCenterPoint is the center point.
|
|
* @param aRadius is the radius of the semicircle.
|
|
* @param aAngle is the angle of the semicircle.
|
|
*
|
|
*/
|
|
void drawSemiCircle( const VECTOR2D& aCenterPoint, double aRadius, double aAngle );
|
|
|
|
/**
|
|
* @brief Draw a filled semicircle.
|
|
*
|
|
* @param aCenterPoint is the center point.
|
|
* @param aRadius is the radius of the semicircle.
|
|
* @param aAngle is the angle of the semicircle.
|
|
*
|
|
*/
|
|
void drawFilledSemiCircle( const VECTOR2D& aCenterPoint, double aRadius, double aAngle );
|
|
|
|
/**
|
|
* @brief Draw a stroked semicircle.
|
|
*
|
|
* @param aCenterPoint is the center point.
|
|
* @param aRadius is the radius of the semicircle.
|
|
* @param aAngle is the angle of the semicircle.
|
|
*
|
|
*/
|
|
void drawStrokedSemiCircle( const VECTOR2D& aCenterPoint, double aRadius, double aAngle );
|
|
|
|
/**
|
|
* @brief Generic way of drawing a polyline stored in different containers.
|
|
* @param aPointGetter is a function to obtain coordinates of n-th vertex.
|
|
* @param aPointCount is the number of points to be drawn.
|
|
*/
|
|
void drawPolyline( const std::function<VECTOR2D (int)>& aPointGetter, int aPointCount );
|
|
|
|
/**
|
|
* @brief Draws a filled polygon. It does not need the last point to have the same coordinates
|
|
* as the first one.
|
|
* @param aPoints is the vertices data (3 coordinates: x, y, z).
|
|
* @param aPointCount is the number of points.
|
|
*/
|
|
void drawPolygon( GLdouble* aPoints, int aPointCount );
|
|
|
|
/**
|
|
* @brief Draws a set of polygons with a cached triangulation. Way faster than drawPolygon.
|
|
*/
|
|
void drawTriangulatedPolyset( const SHAPE_POLY_SET& aPoly );
|
|
|
|
|
|
/**
|
|
* @brief Draws a single character using bitmap font.
|
|
* Its main purpose is to be used in BitmapText() function.
|
|
*
|
|
* @param aChar is the character to be drawn.
|
|
* @return Width of the drawn glyph.
|
|
*/
|
|
int drawBitmapChar( unsigned long aChar );
|
|
|
|
/**
|
|
* @brief Draws an overbar over the currently drawn text.
|
|
* Its main purpose is to be used in BitmapText() function.
|
|
* This method requires appropriate scaling to be applied (as is done in BitmapText() function).
|
|
* The current X coordinate will be the overbar ending.
|
|
*
|
|
* @param aLength is the width of the overbar.
|
|
* @param aHeight is the height for the overbar.
|
|
*/
|
|
void drawBitmapOverbar( double aLength, double aHeight );
|
|
|
|
/**
|
|
* @brief Computes a size of text drawn using bitmap font with current text setting applied.
|
|
*
|
|
* @param aText is the text to be drawn.
|
|
* @return Pair containing text bounding box and common Y axis offset. The values are expressed
|
|
* as a number of pixels on the bitmap font texture and need to be scaled before drawing.
|
|
*/
|
|
std::pair<VECTOR2D, float> computeBitmapTextSize( const UTF8& aText ) const;
|
|
|
|
// Event handling
|
|
/**
|
|
* @brief This is the OnPaint event handler.
|
|
*
|
|
* @param aEvent is the OnPaint event.
|
|
*/
|
|
void onPaint( wxPaintEvent& aEvent );
|
|
|
|
/**
|
|
* @brief Skip the mouse event to the parent.
|
|
*
|
|
* @param aEvent is the mouse event.
|
|
*/
|
|
void skipMouseEvent( wxMouseEvent& aEvent );
|
|
|
|
/**
|
|
* @brief Blits cursor into the current screen.
|
|
*/
|
|
void blitCursor();
|
|
|
|
/**
|
|
* @brief Returns a valid key that can be used as a new group number.
|
|
*
|
|
* @return An unique group number that is not used by any other group.
|
|
*/
|
|
unsigned int getNewGroupNumber();
|
|
|
|
/**
|
|
* @brief Compute the angle step when drawing arcs/circles approximated with lines.
|
|
*/
|
|
double calcAngleStep( double aRadius ) const
|
|
{
|
|
// Bigger arcs need smaller alpha increment to make them look smooth
|
|
return std::min( 1e6 / aRadius, 2.0 * M_PI / CIRCLE_POINTS );
|
|
}
|
|
|
|
double getWorldPixelSize() const;
|
|
|
|
VECTOR2D getScreenPixelSize() const;
|
|
|
|
/**
|
|
* @brief Basic OpenGL initialization and feature checks
|
|
* @throw std::runtime_error if any of the OpenGL feature checks failed
|
|
*/
|
|
void init();
|
|
};
|
|
} // namespace KIGFX
|
|
|
|
#endif // OPENGLGAL_H_
|