/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2015-2016 Mario Luzeiro * Copyright (C) 1992-2021 KiCad Developers, see AUTHORS.txt for contributors. * * 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 "eda_3d_viewer_frame.h" #include #include <3d_viewer_id.h> #include <3d_viewer/tools/eda_3d_actions.h> #include <3d_viewer/tools/eda_3d_controller.h> #include <3d_viewer/tools/eda_3d_conditions.h> #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #if defined( KICAD_USE_3DCONNEXION ) #include <3d_navlib/nl_3d_viewer_plugin.h> #endif /** * Flag to enable 3D viewer main frame window debug tracing. * * Use "KI_TRACE_EDA_3D_VIEWER" to enable. * * @ingroup trace_env_vars */ const wxChar* EDA_3D_VIEWER_FRAME::m_logTrace = wxT( "KI_TRACE_EDA_3D_VIEWER" ); BEGIN_EVENT_TABLE( EDA_3D_VIEWER_FRAME, EDA_BASE_FRAME ) EVT_ACTIVATE( EDA_3D_VIEWER_FRAME::OnActivate ) EVT_SET_FOCUS( EDA_3D_VIEWER_FRAME::OnSetFocus ) EVT_TOOL_RANGE( ID_START_COMMAND_3D, ID_MENU_COMMAND_END, EDA_3D_VIEWER_FRAME::Process_Special_Functions ) EVT_MENU( wxID_CLOSE, EDA_3D_VIEWER_FRAME::Exit3DFrame ) EVT_MENU( ID_RENDER_CURRENT_VIEW, EDA_3D_VIEWER_FRAME::OnRenderEngineSelection ) EVT_MENU( ID_DISABLE_RAY_TRACING, EDA_3D_VIEWER_FRAME::OnDisableRayTracing ) EVT_CLOSE( EDA_3D_VIEWER_FRAME::OnCloseWindow ) END_EVENT_TABLE() EDA_3D_VIEWER_FRAME::EDA_3D_VIEWER_FRAME( KIWAY* aKiway, PCB_BASE_FRAME* aParent, const wxString& aTitle, long style ) : KIWAY_PLAYER( aKiway, aParent, FRAME_PCB_DISPLAY3D, aTitle, wxDefaultPosition, wxDefaultSize, style, QUALIFIED_VIEWER3D_FRAMENAME( aParent ) ), m_mainToolBar( nullptr ), m_canvas( nullptr ), m_currentCamera( m_trackBallCamera ), m_trackBallCamera( 2 * RANGE_SCALE_3D ), m_spaceMouse( nullptr ) { wxLogTrace( m_logTrace, "EDA_3D_VIEWER_FRAME::EDA_3D_VIEWER_FRAME %s", aTitle ); m_disable_ray_tracing = false; m_aboutTitle = _( "KiCad 3D Viewer" ); // Give it an icon wxIcon icon; icon.CopyFromBitmap( KiBitmap( BITMAPS::icon_3d ) ); SetIcon( icon ); // Create the status line static const int status_dims[4] = { -1, 170, 130, 130 }; wxStatusBar *status_bar = CreateStatusBar( arrayDim( status_dims ) ); SetStatusWidths( arrayDim( status_dims ), status_dims ); SETTINGS_MANAGER& mgr = Pgm().GetSettingsManager(); EDA_3D_VIEWER_SETTINGS* cfg = mgr.GetAppSettings(); ANTIALIASING_MODE aaMode = static_cast( cfg->m_Render.opengl_AA_mode ); m_canvas = new EDA_3D_CANVAS( this, OGL_ATT_LIST::GetAttributesList( aaMode ), m_boardAdapter, m_currentCamera, Prj().Get3DCacheManager() ); LoadSettings( cfg ); loadCommonSettings(); // Create the manager m_toolManager = new TOOL_MANAGER; m_toolManager->SetEnvironment( GetBoard(), nullptr, nullptr, cfg, this ); m_actions = new EDA_3D_ACTIONS(); m_toolDispatcher = new TOOL_DISPATCHER( m_toolManager ); m_canvas->SetEventDispatcher( m_toolDispatcher ); // Register tools m_toolManager->RegisterTool( new COMMON_CONTROL ); m_toolManager->RegisterTool( new EDA_3D_CONTROLLER ); m_toolManager->InitTools(); setupUIConditions(); if( EDA_3D_CONTROLLER* ctrlTool = GetToolManager()->GetTool() ) ctrlTool->SetRotationIncrement( cfg->m_Camera.rotation_increment ); // Run the viewer control tool, it is supposed to be always active m_toolManager->InvokeTool( "3DViewer.Control" ); CreateMenuBar(); ReCreateMainToolbar(); m_infoBar = new WX_INFOBAR( this, &m_auimgr ); m_auimgr.SetManagedWindow( this ); m_auimgr.AddPane( m_mainToolBar, EDA_PANE().HToolbar().Name( "MainToolbar" ).Top().Layer( 6 ) ); m_auimgr.AddPane( m_infoBar, EDA_PANE().InfoBar().Name( "InfoBar" ).Top().Layer(1) ); m_auimgr.AddPane( m_canvas, EDA_PANE().Canvas().Name( "DrawFrame" ).Center() ); // Call Update() to fix all pane default sizes, especially the "InfoBar" pane before // hiding it. m_auimgr.Update(); // We don't want the infobar displayed right away m_auimgr.GetPane( "InfoBar" ).Hide(); m_auimgr.Update(); m_canvas->SetInfoBar( m_infoBar ); m_canvas->SetStatusBar( status_bar ); #if defined( KICAD_USE_3DCONNEXION ) try { m_spaceMouse = new NL_3D_VIEWER_PLUGIN( m_canvas ); } catch( const std::system_error& e ) { wxLogTrace( wxT( "KI_TRACE_NAVLIB" ), e.what() ); } #endif // Fixes bug in Windows (XP and possibly others) where the canvas requires the focus // in order to receive mouse events. Otherwise, the user has to click somewhere on // the canvas before it will respond to mouse wheel events. m_canvas->SetFocus(); } EDA_3D_VIEWER_FRAME::~EDA_3D_VIEWER_FRAME() { #if defined( KICAD_USE_3DCONNEXION ) if( m_spaceMouse != nullptr ) { delete m_spaceMouse; } #endif m_canvas->SetEventDispatcher( nullptr ); m_auimgr.UnInit(); // m_canvas delete will be called by wxWidget manager //delete m_canvas; //m_canvas = nullptr; } void EDA_3D_VIEWER_FRAME::setupUIConditions() { EDA_BASE_FRAME::setupUIConditions(); ACTION_MANAGER* mgr = m_toolManager->GetActionManager(); EDA_3D_CONDITIONS cond( &m_boardAdapter ); // Helper to define check conditions #define GridSizeCheck( x ) ACTION_CONDITIONS().Check( cond.GridSize( x ) ) auto raytracing = [this]( const SELECTION& aSel ) { return m_boardAdapter.m_Cfg->m_Render.engine != RENDER_ENGINE::OPENGL; }; auto showTH = [this]( const SELECTION& aSel ) { return m_boardAdapter.m_Cfg->m_Render.show_footprints_normal; }; auto showSMD = [this]( const SELECTION& aSel ) { return m_boardAdapter.m_Cfg->m_Render.show_footprints_insert; }; auto showVirtual = [this]( const SELECTION& aSel ) { return m_boardAdapter.m_Cfg->m_Render.show_footprints_virtual; }; auto showBBoxes = [this]( const SELECTION& aSel ) { return m_boardAdapter.m_Cfg->m_Render.opengl_show_model_bbox; }; auto showAxes = [this]( const SELECTION& aSel ) { return m_boardAdapter.m_Cfg->m_Render.show_axis; }; auto ortho = [this]( const SELECTION& ) { return m_currentCamera.GetProjection() == PROJECTION_TYPE::ORTHO; }; RegisterUIUpdateHandler( ID_RENDER_CURRENT_VIEW, ACTION_CONDITIONS().Check( raytracing ) ); mgr->SetConditions( EDA_3D_ACTIONS::showTHT, ACTION_CONDITIONS().Check( showTH ) ); mgr->SetConditions( EDA_3D_ACTIONS::showSMD, ACTION_CONDITIONS().Check( showSMD ) ); mgr->SetConditions( EDA_3D_ACTIONS::showVirtual, ACTION_CONDITIONS().Check( showVirtual ) ); mgr->SetConditions( EDA_3D_ACTIONS::showBBoxes, ACTION_CONDITIONS().Check( showBBoxes ) ); mgr->SetConditions( EDA_3D_ACTIONS::showAxis, ACTION_CONDITIONS().Check( showAxes ) ); mgr->SetConditions( EDA_3D_ACTIONS::noGrid, GridSizeCheck( GRID3D_TYPE::NONE ) ); mgr->SetConditions( EDA_3D_ACTIONS::show10mmGrid, GridSizeCheck( GRID3D_TYPE::GRID_10MM ) ); mgr->SetConditions( EDA_3D_ACTIONS::show5mmGrid, GridSizeCheck( GRID3D_TYPE::GRID_5MM ) ); mgr->SetConditions( EDA_3D_ACTIONS::show2_5mmGrid, GridSizeCheck( GRID3D_TYPE::GRID_2P5MM ) ); mgr->SetConditions( EDA_3D_ACTIONS::show1mmGrid, GridSizeCheck( GRID3D_TYPE::GRID_1MM ) ); mgr->SetConditions( EDA_3D_ACTIONS::toggleOrtho, ACTION_CONDITIONS().Check( ortho ) ); #undef FlagCheck #undef GridSizeCheck } void EDA_3D_VIEWER_FRAME::ReloadRequest() { // This will schedule a request to load later if( m_canvas ) m_canvas->ReloadRequest( GetBoard(), Prj().Get3DCacheManager() ); } void EDA_3D_VIEWER_FRAME::NewDisplay( bool aForceImmediateRedraw ) { ReloadRequest(); // After the ReloadRequest call, the refresh often takes a bit of time, // and it is made here only on request. if( aForceImmediateRedraw ) m_canvas->Refresh(); } void EDA_3D_VIEWER_FRAME::Redraw() { // Only update in OpenGL for an interactive interaction if( m_boardAdapter.m_Cfg->m_Render.engine == RENDER_ENGINE::OPENGL ) m_canvas->Request_refresh( true ); } void EDA_3D_VIEWER_FRAME::refreshRender() { if( m_boardAdapter.m_Cfg->m_Render.engine == RENDER_ENGINE::OPENGL ) m_canvas->Request_refresh(); else NewDisplay( true ); } void EDA_3D_VIEWER_FRAME::Exit3DFrame( wxCommandEvent &event ) { wxLogTrace( m_logTrace, "EDA_3D_VIEWER_FRAME::Exit3DFrame" ); Close( true ); } void EDA_3D_VIEWER_FRAME::OnCloseWindow( wxCloseEvent &event ) { wxLogTrace( m_logTrace, "EDA_3D_VIEWER_FRAME::OnCloseWindow" ); if( m_canvas ) m_canvas->Close(); // m_canvas delete will be called by wxWidget manager //delete m_canvas; //m_canvas = nullptr; Destroy(); event.Skip( true ); } void EDA_3D_VIEWER_FRAME::Process_Special_Functions( wxCommandEvent &event ) { int id = event.GetId(); bool isChecked = event.IsChecked(); wxLogTrace( m_logTrace, "EDA_3D_VIEWER_FRAME::Process_Special_Functions id %d isChecked %d", id, isChecked ); if( m_canvas == nullptr ) return; switch( id ) { case ID_RELOAD3D_BOARD: NewDisplay( true ); break; case ID_TOOL_SCREENCOPY_TOCLIBBOARD: case ID_MENU_SCREENCOPY_PNG: case ID_MENU_SCREENCOPY_JPEG: takeScreenshot( event ); return; case ID_MENU3D_RESET_DEFAULTS: { auto cfg = Pgm().GetSettingsManager().GetAppSettings(); cfg->ResetToDefaults(); LoadSettings( cfg ); // Tell canvas that we (may have) changed the render engine RenderEngineChanged(); NewDisplay( true ); } return; default: wxFAIL_MSG( "Invalid event in EDA_3D_VIEWER_FRAME::Process_Special_Functions()" ); return; } } void EDA_3D_VIEWER_FRAME::OnRenderEngineSelection( wxCommandEvent &event ) { RENDER_ENGINE old_engine = m_boardAdapter.m_Cfg->m_Render.engine; if( old_engine == RENDER_ENGINE::OPENGL ) m_boardAdapter.m_Cfg->m_Render.engine = RENDER_ENGINE::RAYTRACING; else m_boardAdapter.m_Cfg->m_Render.engine = RENDER_ENGINE::OPENGL; wxLogTrace( m_logTrace, "EDA_3D_VIEWER_FRAME::OnRenderEngineSelection type %s ", m_boardAdapter.m_Cfg->m_Render.engine == RENDER_ENGINE::RAYTRACING ? "raytracing" : "realtime" ); if( old_engine != m_boardAdapter.m_Cfg->m_Render.engine ) RenderEngineChanged(); } void EDA_3D_VIEWER_FRAME::OnDisableRayTracing( wxCommandEvent& aEvent ) { wxLogTrace( m_logTrace, "EDA_3D_VIEWER_FRAME::%s disabling ray tracing.", __WXFUNCTION__ ); m_disable_ray_tracing = true; m_boardAdapter.m_Cfg->m_Render.engine = RENDER_ENGINE::OPENGL; } void EDA_3D_VIEWER_FRAME::OnActivate( wxActivateEvent &aEvent ) { wxLogTrace( m_logTrace, "EDA_3D_VIEWER_FRAME::OnActivate" ); if( aEvent.GetActive() && m_canvas ) { // Reload data if 3D frame shows a board, // because it can be changed since last frame activation if( m_canvas->IsReloadRequestPending() ) m_canvas->Request_refresh(); // Activates again the focus of the canvas so it will catch mouse and key events m_canvas->SetFocus(); } #if defined( KICAD_USE_3DCONNEXION ) if( m_spaceMouse != nullptr ) { m_spaceMouse->SetFocus( aEvent.GetActive() ); } #endif aEvent.Skip(); // required under wxMAC } void EDA_3D_VIEWER_FRAME::OnSetFocus( wxFocusEvent& aEvent ) { // Activates again the focus of the canvas so it will catch mouse and key events if( m_canvas ) m_canvas->SetFocus(); aEvent.Skip(); } void EDA_3D_VIEWER_FRAME::LoadSettings( APP_SETTINGS_BASE *aCfg ) { EDA_BASE_FRAME::LoadSettings( aCfg ); EDA_3D_VIEWER_SETTINGS* cfg = dynamic_cast( aCfg ); wxASSERT( cfg ); wxLogTrace( m_logTrace, "EDA_3D_VIEWER_FRAME::LoadSettings" ); if( cfg ) { m_boardAdapter.m_Cfg = cfg; // When opening the 3D viewer, we use the opengl mode, not the ray tracing engine // because the ray tracing is very time consumming, and can be seen as not working // (freeze window) with large boards. #if 0 RENDER_ENGINE engine = static_cast( cfg->m_Render.engine ); wxLogTrace( m_logTrace, engine == RENDER_ENGINE::RAYTRACING ? "EDA_3D_VIEWER_FRAME::LoadSettings render setting Ray Trace" : "EDA_3D_VIEWER_FRAME::LoadSettings render setting OpenGL" ); #else m_boardAdapter.m_Cfg->m_Render.engine = RENDER_ENGINE::OPENGL; #endif m_canvas->SetAnimationEnabled( cfg->m_Camera.animation_enabled ); m_canvas->SetMovingSpeedMultiplier( cfg->m_Camera.moving_speed_multiplier ); m_canvas->SetProjectionMode( cfg->m_Camera.projection_mode ); #undef TRANSFER_SETTING } } void EDA_3D_VIEWER_FRAME::SaveSettings( APP_SETTINGS_BASE *aCfg ) { auto cfg = Pgm().GetSettingsManager().GetAppSettings(); EDA_BASE_FRAME::SaveSettings( cfg ); wxLogTrace( m_logTrace, "EDA_3D_VIEWER_FRAME::SaveSettings" ); wxLogTrace( m_logTrace, m_boardAdapter.m_Cfg->m_Render.engine == RENDER_ENGINE::RAYTRACING ? "EDA_3D_VIEWER_FRAME::SaveSettings render setting Ray Trace" : "EDA_3D_VIEWER_FRAME::SaveSettings render setting OpenGL" ); if( cfg ) { cfg->m_Camera.animation_enabled = m_canvas->GetAnimationEnabled(); cfg->m_Camera.moving_speed_multiplier = m_canvas->GetMovingSpeedMultiplier(); cfg->m_Camera.projection_mode = m_canvas->GetProjectionMode(); if( EDA_3D_CONTROLLER* ctrlTool = GetToolManager()->GetTool() ) cfg->m_Camera.rotation_increment = ctrlTool->GetRotationIncrement(); } } void EDA_3D_VIEWER_FRAME::CommonSettingsChanged( bool aEnvVarsChanged, bool aTextVarsChanged ) { wxLogTrace( m_logTrace, "EDA_3D_VIEWER_FRAME::CommonSettingsChanged" ); // Regen menu bars, etc EDA_BASE_FRAME::CommonSettingsChanged( aEnvVarsChanged, aTextVarsChanged ); // There is no base class that handles toolbars for this frame ReCreateMainToolbar(); loadCommonSettings(); LoadSettings( Pgm().GetSettingsManager().GetAppSettings() ); NewDisplay( true ); } void EDA_3D_VIEWER_FRAME::takeScreenshot( wxCommandEvent& event ) { wxString fullFileName; bool fmt_is_jpeg = false; if( event.GetId() == ID_MENU_SCREENCOPY_JPEG ) fmt_is_jpeg = true; if( event.GetId() != ID_TOOL_SCREENCOPY_TOCLIBBOARD ) { // Remember path between saves during this session only. const wxString wildcard = fmt_is_jpeg ? JpegFileWildcard() : PngFileWildcard(); const wxString ext = fmt_is_jpeg ? JpegFileExtension : PngFileExtension; // First time path is set to the project path. if( !m_defaultSaveScreenshotFileName.IsOk() ) m_defaultSaveScreenshotFileName = Parent()->Prj().GetProjectFullName(); m_defaultSaveScreenshotFileName.SetExt( ext ); wxFileDialog dlg( this, _( "3D Image File Name" ), m_defaultSaveScreenshotFileName.GetPath(), m_defaultSaveScreenshotFileName.GetFullName(), wildcard, wxFD_SAVE | wxFD_OVERWRITE_PROMPT ); if( dlg.ShowModal() == wxID_CANCEL ) return; m_defaultSaveScreenshotFileName = dlg.GetPath(); if( m_defaultSaveScreenshotFileName.GetExt().IsEmpty() ) m_defaultSaveScreenshotFileName.SetExt( ext ); fullFileName = m_defaultSaveScreenshotFileName.GetFullPath(); wxFileName fn = fullFileName; if( !fn.IsDirWritable() ) { wxString msg; msg.Printf( _( "Insufficient permissions to save file '%s'." ), fullFileName ); wxMessageBox( msg, _( "Error" ), wxOK | wxICON_ERROR, this ); return; } // Be sure the screen area destroyed by the file dialog is redrawn // before making a screen copy. // Without this call, under Linux the screen refresh is made to late. wxYield(); } // Be sure we have the latest 3D view (remember 3D view is buffered) m_canvas->Request_refresh( true ); wxYield(); // Build image from the 3D buffer wxWindowUpdateLocker noUpdates( this ); wxImage screenshotImage; if( m_canvas ) m_canvas->GetScreenshot( screenshotImage ); if( event.GetId() == ID_TOOL_SCREENCOPY_TOCLIBBOARD ) { wxBitmap bitmap( screenshotImage ); wxLogNull doNotLog; // disable logging of failed clipboard actions if( wxTheClipboard->Open() ) { wxBitmapDataObject* dobjBmp = new wxBitmapDataObject( bitmap ); if( !wxTheClipboard->SetData( dobjBmp ) ) wxMessageBox( _( "Failed to copy image to clipboard" ) ); wxTheClipboard->Flush(); /* the data in clipboard will stay * available after the application exits */ wxTheClipboard->Close(); } } else { if( !screenshotImage.SaveFile( fullFileName, fmt_is_jpeg ? wxBITMAP_TYPE_JPEG : wxBITMAP_TYPE_PNG ) ) wxMessageBox( _( "Can't save file" ) ); screenshotImage.Destroy(); } } void EDA_3D_VIEWER_FRAME::RenderEngineChanged() { wxLogTrace( m_logTrace, "EDA_3D_VIEWER_FRAME::RenderEngineChanged()" ); if( m_canvas ) m_canvas->RenderEngineChanged(); } void EDA_3D_VIEWER_FRAME::loadCommonSettings() { wxCHECK_RET( m_canvas, "Cannot load settings to null canvas" ); COMMON_SETTINGS* settings = Pgm().GetCommonSettings(); const DPI_SCALING dpi{ settings, this }; m_canvas->SetScaleFactor( dpi.GetScaleFactor() ); // TODO(JE) use all control options m_boardAdapter.m_MousewheelPanning = settings->m_Input.scroll_modifier_zoom != 0; }