eda_draw_frame.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2009 Jean-Pierre Charras, [email protected]
 * Copyright (C) 2011 Wayne Stambaugh <[email protected]>
 * Copyright The 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, see <https://www.gnu.org/licenses/>.
 */
 
#ifndef DRAW_FRAME_H_
#define DRAW_FRAME_H_
 
#include <api/plugin_action_scope.h>
#include <eda_base_frame.h>
#include <kiway_player.h>
#include <gal/gal_display_options.h>
#include <gal_display_options_common.h>
#include <gal/color4d.h>
#include <class_draw_panel_gal.h>
#include <kiid.h>
#include <hotkeys_basic.h>
#include <lib_id.h>
#include <tool/arc_draw_mode.h>
 
#include <set>
 
struct EDA_SEARCH_DATA;
struct PLUGIN_ACTION;
class LIB_TREE;
class EDA_ITEM;
class ACTION_TOOLBAR;
class GRID_HELPER;
class COLOR_SETTINGS;
class LOCKFILE;
class TOOL_MENU;
class APP_SETTINGS_BASE;
class wxFindReplaceData;
class SEARCH_PANE;
class HOTKEY_CYCLE_POPUP;
class PROPERTIES_PANEL;
class NET_INSPECTOR_PANEL;
class GIT_COMMIT_PANE;
enum class BITMAP_TYPE;
class FILEDLG_HOOK_NEW_LIBRARY;
 
namespace KIGFX
{
    class GAL_DISPLAY_OPTIONS;
    class RENDER_SETTINGS;
}
 
using KIGFX::COLOR4D;
using KIGFX::RENDER_SETTINGS;
 
#define LIB_EDIT_FRAME_NAME           wxT( "LibeditFrame" )
#define LIB_VIEW_FRAME_NAME           wxT( "ViewlibFrame" )
#define SCH_EDIT_FRAME_NAME           wxT( "SchematicFrame" )
#define SYMBOL_CHOOSER_FRAME_NAME     wxT( "SymbolChooserFrame" )
#define PL_EDITOR_FRAME_NAME          wxT( "PlEditorFrame" )
#define FOOTPRINT_WIZARD_FRAME_NAME   wxT( "FootprintWizard" )
#define FOOTPRINT_CHOOSER_FRAME_NAME  wxT( "FootprintChooserFrame" )
#define FOOTPRINT_EDIT_FRAME_NAME     wxT( "ModEditFrame" )
#define FOOTPRINT_VIEWER_FRAME_NAME   wxT( "ModViewFrame" )
#define PCB_EDIT_FRAME_NAME           wxT( "PcbFrame" )
 

class EDA_DRAW_FRAME : public KIWAY_PLAYER
{
public:
    EDA_DRAW_FRAME( KIWAY* aKiway, wxWindow* aParent, FRAME_T aFrameType, const wxString& aTitle,
                    const wxPoint& aPos, const wxSize& aSize, long aStyle,
                    const wxString& aFrameName, const EDA_IU_SCALE& aIuScale );
 
    ~EDA_DRAW_FRAME();

    bool LockFile( const wxString& aFileName );

    void ReleaseFile();
 
    EDA_SEARCH_DATA& GetFindReplaceData();
    wxArrayString& GetFindHistoryList() { return m_findStringHistoryList; }
    wxArrayString& GetReplaceHistoryList() { return m_replaceStringHistoryList; }
 
    virtual void SetPageSettings( const PAGE_INFO& aPageSettings ) = 0;
    virtual const PAGE_INFO& GetPageSettings() const = 0;

    virtual const VECTOR2I GetPageSizeIU() const = 0;

    bool GetShowPolarCoords() const { return m_polarCoords; }
    void SetShowPolarCoords( bool aShow ) { m_polarCoords = aShow; }
 
    void ToggleUserUnits() override;

    void GetUnitPair( EDA_UNITS& aPrimaryUnit, EDA_UNITS& aSecondaryUnits ) override;

    virtual const VECTOR2I& GetGridOrigin() const = 0;
    virtual void            SetGridOrigin( const VECTOR2I& aPosition ) = 0;
 
    virtual std::unique_ptr<GRID_HELPER> MakeGridHelper();

    VECTOR2I GetNearestGridPosition( const VECTOR2I& aPosition ) const;

    VECTOR2I GetNearestHalfGridPosition( const VECTOR2I& aPosition ) const;
 
    virtual const TITLE_BLOCK& GetTitleBlock() const = 0;
    virtual void SetTitleBlock( const TITLE_BLOCK& aTitleBlock ) = 0;
 
    // the background color of the draw canvas:
    // Virtual because some frames can have a specific way to get/set the bg color
    virtual COLOR4D GetDrawBgColor() const { return m_drawBgColor; }
    virtual void SetDrawBgColor( const COLOR4D& aColor) { m_drawBgColor= aColor ; }

    virtual COLOR_SETTINGS* GetColorSettings( bool aForceRefresh = false ) const;

    bool LibraryFileBrowser( const wxString& aTitle, bool doOpen, wxFileName& aFilename,
                             const wxString& wildcard, const wxString& ext, bool isDirectory,
                             FILEDLG_HOOK_NEW_LIBRARY* aFileDlgHook = nullptr );
 
    void CommonSettingsChanged( int aFlags ) override;
 
    virtual wxString GetScreenDesc() const;
    virtual wxString GetFullScreenDesc() const;

    virtual BASE_SCREEN* GetScreen() const  { return m_currentScreen; }
 
    void EraseMsgBox();
 
    // Toolbar-related functions
    virtual void ReCreateHToolbar() { };
    virtual void ReCreateVToolbar() { };
    virtual void ReCreateLeftToolbar() { };
    virtual void ReCreateAuxiliaryToolbar() { }
 
    /*
     * These 4 functions provide a basic way to show/hide grid and /get/set grid color.
     *
     * These parameters are saved in KiCad config for each main frame.
     */
    bool IsGridVisible();
    virtual void SetGridVisibility( bool aVisible );
 
    bool         IsGridOverridden();
    virtual void SetGridOverrides( bool aOverride );
 
    virtual COLOR4D GetGridColor() { return m_gridColor; }
    virtual void SetGridColor( const COLOR4D& aColor ) { m_gridColor = aColor; }

    void OnSelectGrid( wxCommandEvent& event );

    void UpdateGridSelectBox();

    void OnUpdateSelectGrid( wxUpdateUIEvent& aEvent );

    void OnUpdateSelectZoom( wxUpdateUIEvent& aEvent );

    void SyncZoomSelectBox();

    void UpdateZoomSelectBox();

    const wxString GetZoomLevelIndicator() const;

    virtual void OnSelectZoom( wxCommandEvent& event );

    virtual void OnSize( wxSizeEvent& event ) override;
 
    void OnMove( wxMoveEvent& aEvent ) override;

    virtual void HardRedraw();

    virtual void Zoom_Automatique( bool aWarpPointer );

    void FocusOnLocation( const VECTOR2I& aPos, bool aAllowScroll = true );

    virtual void FocusOnItem( EDA_ITEM* aItem, bool aAllowScroll = true ) {}
 
    virtual void ClearFocus() { FocusOnItem( nullptr ); }

    void AddStandardSubMenus( TOOL_MENU& aMenu );

    void PrintDrawingSheet( const RENDER_SETTINGS* aSettings, BASE_SCREEN* aScreen,
                            const std::map<wxString, wxString>* aProperties, double aMils2Iu,
                            const wxString& aFilename,
                            const wxString& aSheetLayer = wxEmptyString );
 
    void DisplayToolMsg( const wxString& msg ) override;
 
    void DisplayConstraintsMsg( const wxString& msg );

    virtual void OnPageSettingsChange() {}

    wxStatusBar* OnCreateStatusBar( int number, long style, wxWindowID id,
                                    const wxString& name ) override;

    void UpdateStatusBar() override;

    void DisplayUnitsMsg();

    virtual void DisplayGridMsg();
 
    bool GetOverrideLocks() const;
 
    void LoadSettings( APP_SETTINGS_BASE* aCfg ) override;
    void SaveSettings( APP_SETTINGS_BASE* aCfg ) override;

    void AppendMsgPanel( const wxString& aTextUpper, const wxString& aTextLower, int aPadding = 6 );

    virtual void ClearMsgPanel();

    void SetMsgPanel( const std::vector< MSG_PANEL_ITEM >& aList );
    void SetMsgPanel( EDA_ITEM* aItem );

    void SetMsgPanel( const wxString& aTextUpper, const wxString& aTextLower, int aPadding = 6 );

    virtual void UpdateMsgPanel();
 
    virtual LIB_TREE* GetLibTree() const { return nullptr; }
    virtual LIB_ID GetTargetLibId() const { return LIB_ID(); }
 
    virtual bool IsLibraryTreeShown() const { return false; }
    virtual void ToggleLibraryTree() {};
    virtual void FocusLibraryTreeInput() {};
 
    PROPERTIES_PANEL* GetPropertiesPanel() { return m_propertiesPanel; }
 
    virtual void UpdateProperties();
 
    virtual void ToggleProperties() {}
 
    static const wxString PropertiesPaneName() { return wxS( "PropertiesManager" ); }
 
    static const wxString NetInspectorPanelName() { return wxS( "NetInspector" ); }
 
 
    void ToggleGitCommitPane();

    void RefreshGitCommitPane();
 
    bool IsGitCommitPaneShown();
 
    static const wxString DesignBlocksPaneName() { return wxS( "DesignBlocks" ); }
 
    static const wxString RemoteSymbolPaneName() { return wxS( "RemoteSymbol" ); }
 
    static const wxString AppearancePanelName() { return wxS( "LayersManager" ); }

    virtual EDA_ITEM* ResolveItem( const KIID& aId, bool aAllowNullptrReturn = false ) const
    {
        return nullptr;
    }

    virtual void ActivateGalCanvas();

    virtual void SwitchCanvas( EDA_DRAW_PANEL_GAL::GAL_TYPE aCanvasType );

    static void SetCanvasFailed( EDA_DRAW_PANEL_GAL::GAL_TYPE aCanvas ) { m_failedCanvases.insert( aCanvas ); }
 
    static bool CanvasFailed( EDA_DRAW_PANEL_GAL::GAL_TYPE aCanvas ) { return m_failedCanvases.contains( aCanvas ); }

    virtual EDA_DRAW_PANEL_GAL* GetCanvas() const { return m_canvas; }
    void SetCanvas( EDA_DRAW_PANEL_GAL* aPanel ) { m_canvas = aPanel; }
 
    wxWindow* GetToolCanvas() const override { return GetCanvas(); }
 
    void ClearToolbarControl( int aId ) override;

    GAL_DISPLAY_OPTIONS_IMPL& GetGalDisplayOptions() { return m_galDisplayOptions; }
 
    void RefreshCanvas() override
    {
        GetCanvas()->Refresh();
    }

    virtual const BOX2I GetDocumentExtents( bool aIncludeAllVisible = true ) const;

    void ShowChangedLanguage() override;
 
    HOTKEY_CYCLE_POPUP* GetHotkeyPopup() { return m_hotkeyPopup; }
 
    virtual void CreateHotkeyPopup();
 

    bool SaveCanvasImageToFile( const wxString& aFileName, BITMAP_TYPE aBitmapType );

    virtual void OnApiPluginInvoke( wxCommandEvent& aEvent );
 
    virtual PLUGIN_ACTION_SCOPE PluginActionScope() const { return PLUGIN_ACTION_SCOPE::INVALID; }
 
    static bool IsPluginActionButtonVisible( const PLUGIN_ACTION& aAction,
                                             APP_SETTINGS_BASE* aCfg );

    static std::vector<const PLUGIN_ACTION*> GetOrderedPluginActions( PLUGIN_ACTION_SCOPE aScope,
                                                                      APP_SETTINGS_BASE* aCfg );

    size_t AddApiPluginMenuItems( ACTION_MENU* aMenu );

    virtual void AddApiPluginTools( ACTION_TOOLBAR* aToolbar );
 
    DECLARE_EVENT_TABLE()
 
protected:
    void configureToolbars() override;
 
    virtual void SetScreen( BASE_SCREEN* aScreen )  { m_currentScreen = aScreen; }
 
    void unitsChangeRefresh() override;
 
    void setupUIConditions() override;

    virtual const TOOL_ACTION* drawArcAction( ARC_DRAW_MODE aMode ) const { return nullptr; }

    void setArcModeConditions( const TOOL_ACTION& aDrawArc, const std::function<bool( const SELECTION& )>& aEnable );
 
    void syncToolbarSelections() override;
 
    void setupUnits( APP_SETTINGS_BASE* aCfg );
 
    void updateStatusBarWidths();
 
    std::vector<wxWindow*> findDialogs();

    virtual void resolveCanvasType();

    EDA_DRAW_PANEL_GAL::GAL_TYPE loadCanvasTypeSetting();

    bool saveCanvasTypeSetting( EDA_DRAW_PANEL_GAL::GAL_TYPE aCanvasType );

    virtual void handleActivateEvent( wxActivateEvent& aEvent );
    void onActivate( wxActivateEvent& aEvent );
 
    wxSocketServer*             m_socketServer;

    std::unique_ptr<LOCKFILE> m_file_checker;
 
    COLOR4D              m_gridColor;         // Grid color
    COLOR4D              m_drawBgColor;       // The background color of the draw canvas; BLACK for
                                              // Pcbnew, BLACK or WHITE for Eeschema
    int                  m_undoRedoCountMax;  // Default Undo/Redo command Max depth, to be handed
                                              // to screens
    bool                 m_polarCoords;       // For those frames that support polar coordinates
 
    // Show the drawing sheet (border & title block).
    bool                 m_showBorderAndTitleBlock;
 
    wxChoice*            m_gridSelectBox;
    wxChoice*            m_zoomSelectBox;
    int                  m_zoomCustomEntry; // index of the non-preset zoom entry, or wxNOT_FOUND
    wxCheckBox*          m_overrideLocksCb;
 
    std::unique_ptr<EDA_SEARCH_DATA> m_findReplaceData;
    wxArrayString        m_findStringHistoryList;
    wxArrayString        m_replaceStringHistoryList;
 
    EDA_MSG_PANEL*       m_messagePanel;
    int                  m_msgFrameHeight;
 
    COLOR_SETTINGS*      m_colorSettings;
    SEARCH_PANE*         m_searchPane;
    PROPERTIES_PANEL*    m_propertiesPanel;
    NET_INSPECTOR_PANEL* m_netInspectorPanel;
    GIT_COMMIT_PANE*     m_gitCommitPane;
 
    HOTKEY_CYCLE_POPUP* m_hotkeyPopup;

    EDA_DRAW_PANEL_GAL::GAL_TYPE    m_canvasType;

    static std::set<EDA_DRAW_PANEL_GAL::GAL_TYPE> m_failedCanvases;
 
private:
    BASE_SCREEN*                m_currentScreen;      
    EDA_DRAW_PANEL_GAL*         m_canvas;

    GAL_DISPLAY_OPTIONS_IMPL  m_galDisplayOptions;
 
    int m_lastToolbarIconSize;
};
 
#endif  // DRAW_FRAME_H_