/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2013-2017 CERN * Copyright (C) 2013-2020 KiCad Developers, see AUTHORS.txt for contributors. * @author Tomasz Wlostowski * @author Maciej Suminski * * 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 */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #ifdef PROFILE #include #endif /* PROFILE */ EDA_DRAW_PANEL_GAL::EDA_DRAW_PANEL_GAL( wxWindow* aParentWindow, wxWindowID aWindowId, const wxPoint& aPosition, const wxSize& aSize, KIGFX::GAL_DISPLAY_OPTIONS& aOptions, GAL_TYPE aGalType ) : wxScrolledCanvas( aParentWindow, aWindowId, aPosition, aSize ), m_edaFrame( nullptr ), m_gal( nullptr ), m_view( nullptr ), m_painter( nullptr ), m_viewControls( nullptr ), m_backend( GAL_TYPE_NONE ), m_options( aOptions ), m_eventDispatcher( nullptr ), m_lostFocus( false ), m_stealsFocus( true ) { m_parent = aParentWindow; m_currentKiCursor = KICURSOR::DEFAULT; SetCurrentCursor( KICURSOR::ARROW ); SetLayoutDirection( wxLayout_LeftToRight ); m_edaFrame = dynamic_cast( m_parent ); // If we're in a dialog, we have to go looking for our parent frame if( !m_edaFrame ) { wxWindow* ancestor = aParentWindow->GetParent(); while( ancestor && !dynamic_cast( ancestor ) ) ancestor = ancestor->GetParent(); if( ancestor ) m_edaFrame = dynamic_cast( ancestor ); } SwitchBackend( aGalType ); SetBackgroundStyle( wxBG_STYLE_CUSTOM ); ShowScrollbars( wxSHOW_SB_ALWAYS, wxSHOW_SB_ALWAYS ); EnableScrolling( false, false ); // otherwise Zoom Auto disables GAL canvas Connect( wxEVT_SIZE, wxSizeEventHandler( EDA_DRAW_PANEL_GAL::onSize ), NULL, this ); Connect( wxEVT_ENTER_WINDOW, wxMouseEventHandler( EDA_DRAW_PANEL_GAL::onEnter ), NULL, this ); Connect( wxEVT_KILL_FOCUS, wxFocusEventHandler( EDA_DRAW_PANEL_GAL::onLostFocus ), NULL, this ); Connect( wxEVT_SET_CURSOR, wxSetCursorEventHandler( EDA_DRAW_PANEL_GAL::onSetCursor ), NULL, this ); const wxEventType events[] = { // Binding both EVT_CHAR and EVT_CHAR_HOOK ensures that all key events, // especially special key like arrow keys, are handled by the GAL event dispatcher, // and not sent to GUI without filtering, because they have a default action (scroll) // that must not be called. wxEVT_LEFT_UP, wxEVT_LEFT_DOWN, wxEVT_LEFT_DCLICK, wxEVT_RIGHT_UP, wxEVT_RIGHT_DOWN, wxEVT_RIGHT_DCLICK, wxEVT_MIDDLE_UP, wxEVT_MIDDLE_DOWN, wxEVT_MIDDLE_DCLICK, wxEVT_MOTION, wxEVT_MOUSEWHEEL, wxEVT_CHAR, wxEVT_CHAR_HOOK, #if wxCHECK_VERSION( 3, 1, 0 ) || defined( USE_OSX_MAGNIFY_EVENT ) wxEVT_MAGNIFY, #endif KIGFX::WX_VIEW_CONTROLS::EVT_REFRESH_MOUSE }; for( wxEventType eventType : events ) Connect( eventType, wxEventHandler( EDA_DRAW_PANEL_GAL::OnEvent ), NULL, m_eventDispatcher ); m_pendingRefresh = false; m_drawing = false; m_drawingEnabled = false; // Set up timer that prevents too frequent redraw commands m_refreshTimer.SetOwner( this ); Connect( m_refreshTimer.GetId(), wxEVT_TIMER, wxTimerEventHandler( EDA_DRAW_PANEL_GAL::onRefreshTimer ), NULL, this ); // Set up timer to execute OnShow() method when the window appears on the screen m_onShowTimer.SetOwner( this ); Connect( m_onShowTimer.GetId(), wxEVT_TIMER, wxTimerEventHandler( EDA_DRAW_PANEL_GAL::onShowTimer ), NULL, this ); m_onShowTimer.Start( 10 ); } EDA_DRAW_PANEL_GAL::~EDA_DRAW_PANEL_GAL() { StopDrawing(); wxASSERT( !m_drawing ); delete m_viewControls; delete m_view; delete m_gal; } void EDA_DRAW_PANEL_GAL::SetFocus() { wxScrolledCanvas::SetFocus(); m_lostFocus = false; } void EDA_DRAW_PANEL_GAL::onPaint( wxPaintEvent& WXUNUSED( aEvent ) ) { DoRePaint(); } void EDA_DRAW_PANEL_GAL::DoRePaint() { // Repaint the canvas, and fix scrollbar cursors // Usually called by a OnPaint event, but because it does not use a wxPaintDC, // it can be called outside a wxPaintEvent. // Update current zoom settings if the canvas is managed by a EDA frame // (i.e. not by a preview panel in a dialog) if( !IsDialogPreview() && GetParentEDAFrame() && GetParentEDAFrame()->GetScreen() ) GetParentEDAFrame()->GetScreen()->m_ScrollCenter = GetView()->GetCenter(); m_viewControls->UpdateScrollbars(); if( !m_gal->IsVisible() ) return; m_pendingRefresh = false; if( m_drawing ) return; #ifdef PROFILE PROF_COUNTER totalRealTime; #endif /* PROFILE */ wxASSERT( m_painter ); m_drawing = true; KIGFX::RENDER_SETTINGS* settings = static_cast( m_painter->GetSettings() ); try { m_view->UpdateItems(); KIGFX::GAL_DRAWING_CONTEXT ctx( m_gal ); if( m_view->IsTargetDirty( KIGFX::TARGET_OVERLAY ) && !m_gal->HasTarget( KIGFX::TARGET_OVERLAY ) ) { m_view->MarkDirty(); } m_gal->SetClearColor( settings->GetBackgroundColor() ); m_gal->SetGridColor( settings->GetGridColor() ); m_gal->SetCursorColor( settings->GetCursorColor() ); // TODO: find why ClearScreen() must be called here in opengl mode // and only if m_view->IsDirty() in Cairo mode to avoid distaly artifacts // when moving the mouse cursor if( m_backend == GAL_TYPE_OPENGL ) m_gal->ClearScreen(); if( m_view->IsDirty() ) { if( m_backend != GAL_TYPE_OPENGL && // Already called in opengl m_view->IsTargetDirty( KIGFX::TARGET_NONCACHED ) ) m_gal->ClearScreen(); m_view->ClearTargets(); // Grid has to be redrawn only when the NONCACHED target is redrawn if( m_view->IsTargetDirty( KIGFX::TARGET_NONCACHED ) ) m_gal->DrawGrid(); m_view->Redraw(); } m_gal->DrawCursor( m_viewControls->GetCursorPosition() ); } catch( std::runtime_error& err ) { if( GAL_FALLBACK != m_backend ) { SwitchBackend( GAL_FALLBACK ); DisplayInfoMessage( m_parent, _( "Could not use OpenGL, falling back to software rendering" ), wxString( err.what() ) ); } else { // We're well and truly banjaxed if we get here without a fallback. DisplayInfoMessage( m_parent, _( "Could not use OpenGL" ), wxString( err.what() ) ); } } #ifdef PROFILE totalRealTime.Stop(); wxLogTrace( "GAL_PROFILE", "EDA_DRAW_PANEL_GAL::DoRePaint(): %.1f ms", totalRealTime.msecs() ); #endif /* PROFILE */ m_lastRefresh = wxGetLocalTimeMillis(); m_drawing = false; } void EDA_DRAW_PANEL_GAL::onSize( wxSizeEvent& aEvent ) { // If we get a second wx update call before the first finishes, don't crash if( m_gal->IsContextLocked() ) return; KIGFX::GAL_CONTEXT_LOCKER locker( m_gal ); wxSize clientSize = GetClientSize(); WX_INFOBAR* infobar = GetParentEDAFrame() ? GetParentEDAFrame()->GetInfoBar() : nullptr; if( VECTOR2I( clientSize ) == m_gal->GetScreenPixelSize() ) return; clientSize.x = std::max( 10, clientSize.x ); clientSize.y = std::max( 10, clientSize.y ); VECTOR2D bottom( 0, 0 ); if( m_view ) bottom = m_view->ToWorld( m_gal->GetScreenPixelSize(), true ); m_gal->ResizeScreen( clientSize.GetX(), clientSize.GetY() ); if( m_view ) { if( infobar && infobar->IsLocked() ) m_view->SetCenter( bottom - m_view->ToWorld( clientSize, false ) / 2.0 ); m_view->MarkTargetDirty( KIGFX::TARGET_CACHED ); m_view->MarkTargetDirty( KIGFX::TARGET_NONCACHED ); } } void EDA_DRAW_PANEL_GAL::Refresh( bool aEraseBackground, const wxRect* aRect ) { wxLongLong t = wxGetLocalTimeMillis(); wxLongLong delta = t - m_lastRefresh; // If it has been too long since the last frame (possible depending on platform timer latency), // just do a refresh. Otherwise, start the refresh timer if it hasn't already been started. // This ensures that we will render often enough but not too often. if( delta >= MinRefreshPeriod ) { if( !m_pendingRefresh ) ForceRefresh(); m_refreshTimer.Start( MinRefreshPeriod, true ); } else if( !m_refreshTimer.IsRunning() ) { m_refreshTimer.Start( ( MinRefreshPeriod - delta ).ToLong(), true ); } } void EDA_DRAW_PANEL_GAL::ForceRefresh() { //wxPaintEvent redrawEvent; //wxPostEvent( this, redrawEvent ); m_pendingRefresh = true; DoRePaint(); } void EDA_DRAW_PANEL_GAL::SetEventDispatcher( TOOL_DISPATCHER* aEventDispatcher ) { m_eventDispatcher = aEventDispatcher; const wxEventType eventTypes[] = { wxEVT_TOOL }; if( m_eventDispatcher ) { for( wxEventType type : eventTypes ) { m_parent->Connect( type, wxCommandEventHandler( TOOL_DISPATCHER::DispatchWxCommand ), NULL, m_eventDispatcher ); } } else { for( wxEventType type : eventTypes ) { // While loop is used to be sure that all event handlers are removed. while( m_parent->Disconnect( type, wxCommandEventHandler( TOOL_DISPATCHER::DispatchWxCommand ), NULL, m_eventDispatcher ) ); } } } void EDA_DRAW_PANEL_GAL::StartDrawing() { // Start querying GAL if it is ready m_refreshTimer.StartOnce( 100 ); } void EDA_DRAW_PANEL_GAL::StopDrawing() { m_drawingEnabled = false; Disconnect( wxEVT_PAINT, wxPaintEventHandler( EDA_DRAW_PANEL_GAL::onPaint ), NULL, this ); m_pendingRefresh = false; m_refreshTimer.Stop(); } void EDA_DRAW_PANEL_GAL::SetHighContrastLayer( int aLayer ) { // Set display settings for high contrast mode KIGFX::RENDER_SETTINGS* rSettings = m_view->GetPainter()->GetSettings(); SetTopLayer( aLayer ); rSettings->ClearHighContrastLayers(); rSettings->SetLayerIsHighContrast( aLayer ); m_view->UpdateAllLayersColor(); } void EDA_DRAW_PANEL_GAL::SetTopLayer( int aLayer ) { m_view->ClearTopLayers(); m_view->SetTopLayer( aLayer ); m_view->UpdateAllLayersOrder(); } bool EDA_DRAW_PANEL_GAL::SwitchBackend( GAL_TYPE aGalType ) { // Do not do anything if the currently used GAL is correct if( aGalType == m_backend && m_gal != NULL ) return true; VECTOR2D grid_size = m_gal ? m_gal->GetGridSize() : VECTOR2D(); bool grid_visibility = m_gal ? m_gal->GetGridVisibility() : true; bool result = true; // assume everything will be fine // Prevent refreshing canvas during backend switch StopDrawing(); KIGFX::GAL* new_gal = NULL; try { switch( aGalType ) { case GAL_TYPE_OPENGL: { wxString errormsg = KIGFX::OPENGL_GAL::CheckFeatures( m_options ); if( errormsg.empty() ) { new_gal = new KIGFX::OPENGL_GAL( m_options, this, this, this ); } else { if( GAL_FALLBACK != aGalType ) { aGalType = GAL_FALLBACK; DisplayInfoMessage( m_parent, _( "Could not use OpenGL, falling back to software rendering" ), errormsg ); new_gal = new KIGFX::CAIRO_GAL( m_options, this, this, this ); } else { // We're well and truly banjaxed if we get here without a fallback. DisplayInfoMessage( m_parent, _( "Could not use OpenGL" ), errormsg ); } } break; } case GAL_TYPE_CAIRO: new_gal = new KIGFX::CAIRO_GAL( m_options, this, this, this ); break; default: wxASSERT( false ); KI_FALLTHROUGH; // warn about unhandled GAL canvas type, but continue with the fallback option case GAL_TYPE_NONE: // KIGFX::GAL is a stub - it actually does cannot display anything, // but prevents code relying on GAL canvas existence from crashing new_gal = new KIGFX::GAL( m_options ); break; } } catch( std::runtime_error& err ) { // Create a dummy GAL new_gal = new KIGFX::GAL( m_options ); aGalType = GAL_TYPE_NONE; DisplayError( m_parent, wxString( err.what() ) ); result = false; } // trigger update of the gal options in case they differ // from the defaults m_options.NotifyChanged(); wxWindow* galWindow = dynamic_cast( new_gal ); if( galWindow ) { galWindow->Connect( wxEVT_SET_CURSOR, wxSetCursorEventHandler( EDA_DRAW_PANEL_GAL::onSetCursor ), NULL, this ); } delete m_gal; m_gal = new_gal; wxSize clientSize = GetClientSize(); clientSize.x = std::max( 10, clientSize.x ); clientSize.y = std::max( 10, clientSize.y ); m_gal->ResizeScreen( clientSize.GetX(), clientSize.GetY() ); if( grid_size.x > 0 && grid_size.y > 0 ) m_gal->SetGridSize( grid_size ); m_gal->SetGridVisibility( grid_visibility ); if( m_painter ) m_painter->SetGAL( m_gal ); if( m_view ) { m_view->SetGAL( m_gal ); // Note: OpenGL requires reverse draw order when draw priority is enabled m_view->ReverseDrawOrder( aGalType == GAL_TYPE_OPENGL ); } m_backend = aGalType; return result; } void EDA_DRAW_PANEL_GAL::OnEvent( wxEvent& aEvent ) { bool shouldSetFocus = m_lostFocus && m_stealsFocus && !KIUI::IsInputControlFocused() && !KIUI::IsModalDialogFocused(); #if defined( _WIN32 ) // Ensure we are the active foreground window before we attempt to steal focus // mouse events are generated on Win32 regardless if window is active shouldSetFocus = shouldSetFocus && ( m_edaFrame->GetHWND() == GetForegroundWindow() ); #endif if( shouldSetFocus ) SetFocus(); if( !m_eventDispatcher ) aEvent.Skip(); else m_eventDispatcher->DispatchWxEvent( aEvent ); Refresh(); } void EDA_DRAW_PANEL_GAL::onEnter( wxMouseEvent& aEvent ) { bool shouldSetFocus = m_stealsFocus && !KIUI::IsInputControlFocused() && !KIUI::IsModalDialogFocused(); #if defined( _WIN32 ) // Ensure we are the active foreground window before we attempt to steal focus // mouse events are generated on Win32 regardless if window is active shouldSetFocus = shouldSetFocus && ( m_edaFrame->GetHWND() == GetForegroundWindow() ); #endif // Getting focus is necessary in order to receive key events properly if( shouldSetFocus ) SetFocus(); aEvent.Skip(); } void EDA_DRAW_PANEL_GAL::onLostFocus( wxFocusEvent& aEvent ) { m_lostFocus = true; aEvent.Skip(); } void EDA_DRAW_PANEL_GAL::onRefreshTimer( wxTimerEvent& aEvent ) { if( !m_drawingEnabled ) { if( m_gal && m_gal->IsInitialized() ) { m_drawing = false; m_pendingRefresh = true; Connect( wxEVT_PAINT, wxPaintEventHandler( EDA_DRAW_PANEL_GAL::onPaint ), NULL, this ); m_drawingEnabled = true; } else { // Try again soon m_refreshTimer.StartOnce( 100 ); return; } } //wxPaintEvent redrawEvent; //wxPostEvent( this, redrawEvent ); DoRePaint(); } void EDA_DRAW_PANEL_GAL::onShowTimer( wxTimerEvent& aEvent ) { if( m_gal && m_gal->IsVisible() ) { m_onShowTimer.Stop(); OnShow(); } } void EDA_DRAW_PANEL_GAL::SetCurrentCursor( KICURSOR cursor ) { if( m_currentKiCursor == cursor ) return; m_currentCursor = CURSOR_STORE::GetCursor( cursor ); m_currentKiCursor = cursor; SetCursor( m_currentCursor ); } void EDA_DRAW_PANEL_GAL::onSetCursor( wxSetCursorEvent& event ) { event.SetCursor( m_currentCursor ); } std::shared_ptr EDA_DRAW_PANEL_GAL::DebugOverlay() { if( !m_debugOverlay ) { m_debugOverlay.reset( new KIGFX::VIEW_OVERLAY() ); m_view->Add( m_debugOverlay.get() ); } return m_debugOverlay; } void EDA_DRAW_PANEL_GAL::ClearDebugOverlay() { if( m_debugOverlay ) { m_view->Remove( m_debugOverlay.get() ); m_debugOverlay = nullptr; } }