kicad/pcbnew/tools/zone_create_helper.h

145 lines
4.2 KiB
C++

/*
* This program source code file is part of KiCad, a free EDA CAD application.
*
* Copyright (C) 2017-2019 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
*/
#ifndef TOOLS_ZONE_CREATE_HELPER__H_
#define TOOLS_ZONE_CREATE_HELPER__H_
#include <preview_items/polygon_geom_manager.h>
#include <preview_items/polygon_item.h>
#include <tools/drawing_tool.h>
namespace KIGFX
{
class VIEW;
}
/**
* This class is an adjuct helper to the DRAWING_TOOL interactive
* tool, which handles incoming geometry changes from a
* POLYGON_GEOM_MANAGER and translates that into a ZONE_CONTAINER
* based on given parameters
*/
class ZONE_CREATE_HELPER : public POLYGON_GEOM_MANAGER::CLIENT
{
public:
/**
* Parameters used to fully describe a zone creation process
*/
struct PARAMS
{
///> Should create a keepout zone?
bool m_keepout;
///> Layer to begin drawing
PCB_LAYER_ID m_layer;
///> The zone mode to operate in
ZONE_MODE m_mode;
///> Zone settings source (for similar and cutout zones)
ZONE_CONTAINER* m_sourceZone;
///> Zone leader mode
POLYGON_GEOM_MANAGER::LEADER_MODE m_leaderMode;
};
/**
* @param aTool the DRAWING_TOOL to provide the zone tool to
* @param aParams the parameters to use to guide the zone creation
*/
ZONE_CREATE_HELPER( DRAWING_TOOL& aTool, PARAMS& aParams );
~ZONE_CREATE_HELPER();
/*
* Interface for receiving POLYGON_GEOM_MANAGER update
*/
void OnGeometryChange( const POLYGON_GEOM_MANAGER& aMgr ) override;
bool OnFirstPoint( POLYGON_GEOM_MANAGER& aMgr ) override;
void OnComplete( const POLYGON_GEOM_MANAGER& aMgr ) override;
/**
* Function createNewZone()
*
* Prompt the user for new zone settings, and create a new zone with
* those settings
*
* @param aKeepout should the zone be a keepout
* @return the new zone, can be null if the user aborted
*/
std::unique_ptr<ZONE_CONTAINER> createNewZone( bool aKeepout );
/**
* Function createZoneFromExisting
*
* Create a new zone with the settings from an existing zone
*
* @param aSrcZone the zone to copy settings from
* @return the new zone
*/
std::unique_ptr<ZONE_CONTAINER> createZoneFromExisting( const ZONE_CONTAINER& aSrcZone );
/**
* Function performZoneCutout()
*
* Cut one zone out of another one (i.e. subtraction) and
* update the zone.
*
* @param aZone the zone to removed area from
* @param aCutout the area to remove
*/
void performZoneCutout( ZONE_CONTAINER& aZone, ZONE_CONTAINER& aCutout );
/**
* Commit the current zone-in-progress to the BOARD. This might
* be adding a new zone, or modifying an existing zone with a
* cutout, depending on parameters.
*
* @param aZone - the drawn zone outline to commit
*/
void commitZone( std::unique_ptr<ZONE_CONTAINER> aZone );
private:
DRAWING_TOOL& m_tool;
///> Parameters of the zone to be drawn
PARAMS& m_params;
///> The preview item to display
KIGFX::PREVIEW::POLYGON_ITEM m_previewItem;
///> view that show the preview item
KIGFX::VIEW& m_parentView;
///> The zone-in-progress
std::unique_ptr<ZONE_CONTAINER> m_zone;
};
#endif /* __DRAWING_TOOL_H */