68                                        const wxPoint& aPosition, 
const wxSize& aSize,
 
   70        wxScrolledCanvas( aParentWindow, aWindowId, aPosition, aSize ),
 
   92    SetDoubleBuffered( 
false );
 
   96    if( 
Pgm().GetCommonSettings()->m_Appearance.show_scrollbars )
 
   97        ShowScrollbars( wxSHOW_SB_ALWAYS, wxSHOW_SB_ALWAYS );
 
   99        ShowScrollbars( wxSHOW_SB_NEVER, wxSHOW_SB_NEVER );
 
  101    SetLayoutDirection( wxLayout_LeftToRight );
 
  108        wxWindow* ancestor = aParentWindow->GetParent();
 
  111            ancestor = ancestor->GetParent();
 
  118    SetBackgroundStyle( wxBG_STYLE_CUSTOM );
 
  120    EnableScrolling( 
false, 
false ); 
 
  130    const wxEventType events[] = {
 
  158    for( wxEventType eventType : events )
 
 
  189    wxScrolledCanvas::SetFocus();
 
 
  205    std::lock_guard<std::mutex> lock( 
m_refreshMutex, std::adopt_lock );
 
  210    if( !
m_gal->IsInitialized() || !
m_gal->IsVisible() || 
m_gal->IsContextLocked() )
 
  227    if( 
Pgm().GetCommonSettings()->m_Appearance.show_scrollbars )
 
  232    ( *m_PaintEventCounter )++;
 
  242    PROF_TIMER cntCtxDestroy(
"view-context-destroy");
 
  245    bool isDirty = 
false;
 
  257        catch( std::out_of_range& err )
 
  261            wxLogTrace( 
traceDrawPanel, wxS( 
"Out of Range error: %s" ), err.what() );
 
  287                m_gal->ClearScreen();
 
  294                    m_gal->ClearScreen();
 
  311            cntCtxDestroy.
Start();
 
  315        cntCtxDestroy.
Stop();
 
  317    catch( std::exception& err )
 
  324                                _( 
"Could not use OpenGL, falling back to software rendering" ),
 
  325                                wxString( err.what() ) );
 
 
  358    if( 
m_gal->IsContextLocked() )
 
  362    wxSize                    clientSize = GetClientSize();
 
  369    clientSize.x = std::max( 10, clientSize.x + 1 );
 
  370    clientSize.y = std::max( 10, clientSize.y + 1 );
 
  375        bottom = 
m_view->ToWorld( 
m_gal->GetScreenPixelSize(), 
true );
 
  377    m_gal->ResizeScreen( clientSize.GetX(), clientSize.GetY() );
 
  381        if( infobar && infobar->
IsLocked() )
 
  383            VECTOR2D halfScreen( std::ceil( 0.5 * clientSize.x ), std::ceil( 0.5 * clientSize.y ) );
 
  384            m_view->SetCenter( bottom - 
m_view->ToWorld( halfScreen, 
false ) );
 
 
  465    m_view->UpdateAllLayersColor();
 
 
  472    m_view->SetTopLayer( aLayer );
 
  473    m_view->UpdateAllLayersOrder();
 
 
  484    bool     grid_visibility = 
m_gal ? 
m_gal->GetGridVisibility() : 
true;
 
  500            if( errormsg.empty() )
 
  511                            _( 
"Could not use OpenGL, falling back to software rendering" ),
 
  541    catch( std::runtime_error& err )
 
  556    wxSize clientSize = GetClientSize();
 
  557    clientSize.x = std::max( 10, clientSize.x );
 
  558    clientSize.y = std::max( 10, clientSize.y );
 
  559    m_gal->ResizeScreen( clientSize.GetX(), clientSize.GetY() );
 
  561    if( grid_size.
x > 0 && grid_size.
y > 0 )
 
  562        m_gal->SetGridSize( grid_size );
 
  564    m_gal->SetGridVisibility( grid_visibility );
 
 
  604    timeLimit = std::clamp( timeLimit, 3LL, 150LL );
 
  606    if( endDelta > timeLimit )
 
 
  681    m_gal->SetNativeCursorStyle( aCursor, hidpi );
 
 
BASE_SCREEN class implementation.
 
VECTOR2D m_ScrollCenter
Current scroll center point in logical units.
 
Class to handle configuration and automatic determination of the DPI scale to use for canvases.
 
double GetContentScaleFactor() const override
Get the content scale factor, which may be different from the scale factor on some platforms.
 
WX_INFOBAR * GetInfoBar()
 
The base class for create windows for drawing purpose.
 
virtual BASE_SCREEN * GetScreen() const
Return a pointer to a BASE_SCREEN or one of its derivatives.
 
std::unique_ptr< PROF_COUNTER > m_PaintEventCounter
 
EDA_DRAW_FRAME * m_edaFrame
Parent EDA_DRAW_FRAME (if available)
 
void onLostFocus(wxFocusEvent &aEvent)
 
static constexpr GAL_TYPE GAL_FALLBACK
 
std::unique_ptr< KIGFX::PAINTER > m_painter
Contains information about how to draw items using GAL.
 
void onSize(wxSizeEvent &aEvent)
 
bool m_needIdleRefresh
True when canvas needs to be refreshed from idle handler.
 
bool IsDialogPreview() const
 
virtual void SetHighContrastLayer(int aLayer)
Take care of display settings for the given layer to be displayed in high contrast mode.
 
bool m_stealsFocus
Flag to indicate whether the panel should take focus at certain times (when moused over,...
 
KIGFX::GAL_DISPLAY_OPTIONS & m_options
 
void StopDrawing()
Prevent the GAL canvas from further drawing until it is recreated or StartDrawing() is called.
 
static KIGFX::VC_SETTINGS GetVcSettings()
Gets a populated View Controls settings object dervived from our program settings.
 
virtual void SetTopLayer(int aLayer)
Move the selected layer to the top, so it is displayed above all others.
 
void ClearDebugOverlay()
Clear the contents of the debug overlay and removes it from the VIEW.
 
virtual KIGFX::VIEW * GetView() const
Return a pointer to the #VIEW instance used in the panel.
 
void ForceRefresh()
Force a redraw.
 
bool m_drawing
True if GAL is currently redrawing the view.
 
KIGFX::GAL * m_gal
Interface for drawing objects on a 2D-surface.
 
EDA_DRAW_PANEL_GAL(wxWindow *aParentWindow, wxWindowID aWindowId, const wxPoint &aPosition, const wxSize &aSize, KIGFX::GAL_DISPLAY_OPTIONS &aOptions, GAL_TYPE aGalType=GAL_TYPE_OPENGL)
Create a drawing panel that is contained inside aParentWindow.
 
void onRefreshTimer(wxTimerEvent &aEvent)
 
void SetCurrentCursor(KICURSOR aCursor)
Set the current cursor shape for this panel.
 
virtual void onPaint(wxPaintEvent &WXUNUSED(aEvent))
 
bool m_lostFocus
Flag to indicate that focus should be regained on the next mouse event.
 
virtual void OnShow()
Called when the window is shown for the first time.
 
std::shared_ptr< KIGFX::VIEW_OVERLAY > m_debugOverlay
Optional overlay for drawing transient debug objects.
 
virtual void Refresh(bool aEraseBackground=true, const wxRect *aRect=nullptr) override
 
wxTimer m_refreshTimer
Timer to prevent too-frequent refreshing.
 
TOOL_DISPATCHER * m_eventDispatcher
Processes and forwards events to tools.
 
wxWindow * m_parent
Pointer to the parent window.
 
wxLongLong m_lastRepaintStart
Timestamp of the last repaint start.
 
@ GAL_TYPE_OPENGL
OpenGL implementation.
 
@ GAL_TYPE_CAIRO
Cairo implementation.
 
@ GAL_TYPE_NONE
GAL not used (the legacy wxDC engine is used)
 
KIGFX::VIEW * m_view
Stores view settings (scale, center, etc.) and items to be drawn.
 
bool m_MouseCapturedLost
used on wxMSW: true after a wxEVT_MOUSE_CAPTURE_LOST was received false after the mouse is recaptured...
 
KIGFX::WX_VIEW_CONTROLS * m_viewControls
Control for VIEW (moving, zooming, etc.)
 
void onIdle(wxIdleEvent &aEvent)
 
void SetEventDispatcher(TOOL_DISPATCHER *aEventDispatcher)
Set a dispatcher that processes events and forwards them to tools.
 
void onEnter(wxMouseEvent &aEvent)
 
void RequestRefresh()
Make sure a refresh gets done on the next idle event if it hasn't already.
 
std::mutex m_refreshMutex
Blocks multiple calls to the draw.
 
virtual bool SwitchBackend(GAL_TYPE aGalType)
Switch method of rendering graphics.
 
void StartDrawing()
Begin drawing if it was stopped previously.
 
wxLongLong m_lastRepaintEnd
Timestamp of the last repaint end.
 
void OnEvent(wxEvent &aEvent)
Used to forward events to the canvas from popups, etc.
 
bool m_drawingEnabled
Flag that determines if VIEW may use GAL for redrawing the screen.
 
std::shared_ptr< KIGFX::VIEW_OVERLAY > DebugOverlay()
Create an overlay for rendering debug graphics.
 
bool DoRePaint()
Repaint the canvas, and fix scrollbar cursors.
 
void onShowEvent(wxShowEvent &aEvent)
 
GAL_TYPE m_backend
Currently used GAL.
 
EDA_DRAW_FRAME * GetParentEDAFrame() const
Returns parent EDA_DRAW_FRAME, if available or NULL otherwise.
 
Abstract interface for drawing on a 2D-surface.
 
OpenGL implementation of the Graphics Abstraction Layer.
 
static wxString CheckFeatures(GAL_DISPLAY_OPTIONS &aOptions)
Checks OpenGL features.
 
Container for all the knowledge about how graphical objects are drawn on any output surface/device.
 
void ClearHighContrastLayers()
Clear the list of active layers.
 
virtual const COLOR4D & GetGridColor()=0
Return current grid color settings.
 
virtual const COLOR4D & GetBackgroundColor() const =0
Return current background color settings.
 
void SetLayerIsHighContrast(int aLayerId, bool aEnabled=true)
Set the specified layer as high-contrast.
 
virtual const COLOR4D & GetCursorColor()=0
Return current cursor color settings.
 
const VECTOR2D & GetCenter() const
Return the center point of this VIEW (in world space coordinates).
 
static const wxEventType EVT_REFRESH_MOUSE
Event that forces mouse move event in the dispatcher (eg.
 
virtual COMMON_SETTINGS * GetCommonSettings() const
 
A small class to help profiling.
 
void Stop()
Save the time when this function was called, and set the counter stane to stop.
 
void Start()
Start or restart the counter.
 
RAII class that sets an value at construction and resets it to the original value at destruction.
 
A modified version of the wxInfoBar class that allows us to:
 
bool IsLocked()
Returns true if the infobar is being updated.
 
void DisplayInfoMessage(wxWindow *aParent, const wxString &aMessage, const wxString &aExtraInfo)
Display an informational message box with aMessage.
 
void DisplayErrorMessage(wxWindow *aParent, const wxString &aText, const wxString &aExtraInfo)
Display an error message with aMessage.
 
This file is part of the common library.
 
static const wxChar traceDrawPanel[]
Flag to enable drawing panel debugging output.
 
const wxChar *const traceGalProfile
Flag to enable debug output of GAL performance profiling.
 
This file contains miscellaneous commonly used macros and functions.
 
#define KI_FALLTHROUGH
The KI_FALLTHROUGH macro is to be used when switch statement cases should purposely fallthrough from ...
 
@ TARGET_NONCACHED
Auxiliary rendering target (noncached)
 
@ TARGET_CACHED
Main rendering target (cached)
 
@ TARGET_OVERLAY
Items that may change while the view stays the same (noncached)
 
KICOMMON_API bool IsInputControlFocused(wxWindow *aFocus=nullptr)
Check if a input control has focus.
 
KICOMMON_API bool IsModalDialogFocused()
 
void Refresh()
Update the board display after modifying it by a python script (note: it is automatically called by a...
 
PGM_BASE & Pgm()
The global program "get" accessor.
 
Structure to keep VIEW_CONTROLS settings for easy store/restore operations.
 
MOUSE_DRAG_ACTION m_dragLeft
 
bool m_horizontalPan
Enable horizontal panning with the horizontal scroll/trackpad input.
 
bool m_scrollReversePanH
Whether to invert the scroll wheel movement for horizontal pan.
 
bool m_autoPanSettingEnabled
Flag for turning on autopanning.
 
bool m_focusFollowSchPcb
Flag for automatic focus switching between Schematic and PCB editors.
 
float m_autoPanAcceleration
How fast does panning accelerate when approaching the window boundary.
 
MOUSE_DRAG_ACTION m_dragMiddle
 
int m_zoomSpeed
Zoom speed for the non-accelerating zoom controller.
 
int m_scrollModifierZoom
What modifier key to enable zoom with the (vertical) scroll wheel.
 
int m_scrollModifierPanH
What modifier key to enable horizontal pan with the (vertical) scroll wheel.
 
bool m_warpCursor
If the cursor is allowed to be warped.
 
MOUSE_DRAG_ACTION m_dragRight
 
bool m_scrollReverseZoom
Whether to invert the scroll wheel movement for zoom.
 
int m_motionPanModifier
What modifier key pans the view when the mouse moves with it held.
 
bool m_zoomAcceleration
Enable the accelerating zoom controller.
 
bool m_zoomSpeedAuto
When true, ignore zoom_speed and pick a platform-specific default.
 
int m_scrollModifierPanV
What modifier key to enable vertical with the (vertical) scroll wheel.
 
wxString result
Test unit parsing edge cases and error handling.
 
wxLogTrace helper definitions.
 
#define KI_TRACE(aWhat,...)
 
VECTOR2< double > VECTOR2D
 
VECTOR2I ToVECTOR2I(const wxSize &aSize)
 
WX_VIEW_CONTROLS class definition.