142 lines
4.1 KiB
C++
142 lines
4.1 KiB
C++
/*
|
|
* This program source code file is part of KiCad, a free EDA CAD application.
|
|
*
|
|
* Copyright (C) 2017 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
|
|
DRAWING_TOOL::ZONE_MODE m_mode;
|
|
|
|
///> Zone settings source (for similar and cutout zones)
|
|
ZONE_CONTAINER* m_sourceZone;
|
|
};
|
|
|
|
/**
|
|
* @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, const 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
|
|
const 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 */
|