kicad/pcbnew/pcb_draw_panel_gal.h

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2014 CERN
 * @author Maciej Suminski <maciej.suminski@cern.ch>
 *
 * 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 PCB_DRAW_PANEL_GAL_H_
#define PCB_DRAW_PANEL_GAL_H_

#include <class_draw_panel_gal.h>
#include <layers_id_colors_and_visibility.h>
#include <common.h>

namespace KIGFX
{
    class WS_PROXY_VIEW_ITEM;
    class RATSNEST_VIEWITEM;
    class PCB_VIEW;
}
class COLORS_DESIGN_SETTINGS;

class PCB_DRAW_PANEL_GAL : public EDA_DRAW_PANEL_GAL
{
public:
    PCB_DRAW_PANEL_GAL( wxWindow* aParentWindow, wxWindowID aWindowId, const wxPoint& aPosition,
                        const wxSize& aSize, KIGFX::GAL_DISPLAY_OPTIONS& aOptions,
                        GAL_TYPE aGalType = GAL_TYPE_OPENGL );

    virtual ~PCB_DRAW_PANEL_GAL();

    /**
     * Function DisplayBoard
     * adds all items from the current board to the VIEW, so they can be displayed by GAL.
     * @param aBoard is the PCB to be loaded.
     */
    void DisplayBoard( BOARD* aBoard );

    /**
     * Function SetWorksheet
     * Sets (or updates) worksheet used by the draw panel.
     * @param aWorksheet is the worksheet to be used.
     *        The object is then owned by PCB_DRAW_PANEL_GAL.
     */
    void SetWorksheet( KIGFX::WS_PROXY_VIEW_ITEM* aWorksheet );

    /**
     * Function UseColorScheme
     * Applies layer color settings.
     * @param aSettings are the new settings.
     */
    void UseColorScheme( const COLORS_DESIGN_SETTINGS* aSettings );

    ///> @copydoc EDA_DRAW_PANEL_GAL::SetHighContrastLayer()
    virtual void SetHighContrastLayer( int aLayer ) override
    {
        SetHighContrastLayer( static_cast< PCB_LAYER_ID >( aLayer ) );
    }

    ///> SetHighContrastLayer(), with some extra smarts for PCB
    void SetHighContrastLayer( PCB_LAYER_ID aLayer );

    ///> @copydoc EDA_DRAW_PANEL_GAL::SetTopLayer()
    virtual void SetTopLayer( int aLayer ) override
    {
        SetTopLayer( static_cast< PCB_LAYER_ID >( aLayer ) );
    }

    ///> SetTopLayer(), with some extra smarts for PCB
    void SetTopLayer( PCB_LAYER_ID aLayer );

    /**
     * Function SyncLayersVisibility
     * Updates "visibility" property of each layer of a given BOARD.
     * @param aBoard contains layers visibility settings to be applied.
     */
    void SyncLayersVisibility( const BOARD* aBoard );

    ///> @copydoc EDA_DRAW_PANEL_GAL::GetMsgPanelInfo()
    void GetMsgPanelInfo( EDA_UNITS_T aUnits, std::vector<MSG_PANEL_ITEM>& aList ) override;

    ///> @copydoc EDA_DRAW_PANEL_GAL::OnShow()
    void OnShow() override;

    bool SwitchBackend( GAL_TYPE aGalType ) override;

    ///> Forces refresh of the ratsnest visual representation
    void RedrawRatsnest();

    ///> @copydoc EDA_DRAW_PANEL_GAL::GetDefaultViewBBox()
    BOX2I GetDefaultViewBBox() const override;

protected:

    KIGFX::PCB_VIEW* view() const;

    ///> Reassigns layer order to the initial settings.
    void setDefaultLayerOrder();

    ///> Sets rendering targets & dependencies for layers.
    void setDefaultLayerDeps();

    ///> Currently used worksheet
    std::unique_ptr<KIGFX::WS_PROXY_VIEW_ITEM> m_worksheet;

    ///> Ratsnest view item
    std::unique_ptr<KIGFX::RATSNEST_VIEWITEM> m_ratsnest;
};

#endif /* PCB_DRAW_PANEL_GAL_H_ */