kicad/pcbnew/array_creator.cpp

200 lines
7.3 KiB
C++
Raw Normal View History

/*
* This program source code file is part of KiCad, a free EDA CAD application.
*
* Created on: 11 Mar 2016, author John Beard
2021-07-19 23:56:05 +00:00
* Copyright (C) 2016-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 "array_creator.h"
#include <array_pad_name_provider.h>
2016-06-21 15:06:28 +00:00
#include <board_commit.h>
#include <pcb_group.h>
#include <pad_naming.h>
#include <dialogs/dialog_create_array.h>
/**
* Transform a #BOARD_ITEM from the given #ARRAY_OPTIONS and an index into the array.
*
* @param aArrOpts The array options that describe the array
* @param aIndex The index in the array of this item
* @param aItem The item to transform
*/
static void TransformItem( const ARRAY_OPTIONS& aArrOpts, int aIndex, BOARD_ITEM& aItem )
{
const ARRAY_OPTIONS::TRANSFORM transform = aArrOpts.GetTransform( aIndex, aItem.GetPosition() );
aItem.Move( (wxPoint) transform.m_offset );
aItem.Rotate( aItem.GetPosition(), transform.m_rotation * 10 );
}
void ARRAY_CREATOR::Invoke()
{
// bail out if no items
if( m_selection.Size() == 0 )
return;
2020-11-13 15:15:52 +00:00
FOOTPRINT* const fp = m_isFootprintEditor ? m_parent.GetBoard()->GetFirstFootprint() : nullptr;
2020-11-13 02:57:11 +00:00
const bool enableArrayNumbering = m_isFootprintEditor;
const wxPoint rotPoint = (wxPoint) m_selection.GetCenter();
std::unique_ptr<ARRAY_OPTIONS> array_opts;
DIALOG_CREATE_ARRAY dialog( &m_parent, array_opts, enableArrayNumbering, rotPoint );
int ret = dialog.ShowModal();
2021-07-19 23:56:05 +00:00
if( ret != wxID_OK || array_opts == nullptr )
2016-06-21 15:06:28 +00:00
return;
BOARD_COMMIT commit( &m_parent );
2020-11-13 02:57:11 +00:00
ARRAY_PAD_NAME_PROVIDER pad_name_provider( fp, *array_opts );
for ( int i = 0; i < m_selection.Size(); ++i )
{
BOARD_ITEM* item = static_cast<BOARD_ITEM*>( m_selection[ i ] );
2020-11-13 02:57:11 +00:00
if( item->Type() == PCB_PAD_T && !m_isFootprintEditor )
{
2020-11-13 02:57:11 +00:00
// If it is not the footprint editor, then duplicate the parent footprint instead
2020-11-13 15:15:52 +00:00
item = static_cast<FOOTPRINT*>( item )->GetParent();
}
2016-06-21 15:06:28 +00:00
// The first item in list is the original item. We do not modify it
for( int ptN = 0; ptN < array_opts->GetArraySize(); ptN++ )
{
BOARD_ITEM* this_item = nullptr;
if( ptN == 0 )
{
// the first point: we don't own this or add it, but
// we might still modify it (position or label)
this_item = item;
}
2016-06-21 15:06:28 +00:00
else
{
2020-11-13 02:57:11 +00:00
if( m_isFootprintEditor )
{
2020-11-13 02:57:11 +00:00
// Don't bother incrementing pads: the footprint won't update until commit,
// so we can only do this once
this_item = fp->DuplicateItem( item );
}
else
{
2020-02-20 12:11:04 +00:00
switch( item->Type() )
{
2020-11-13 12:21:02 +00:00
case PCB_FOOTPRINT_T:
case PCB_SHAPE_T:
case PCB_TEXT_T:
2020-02-20 12:11:04 +00:00
case PCB_TRACE_T:
case PCB_ARC_T:
2020-02-20 12:11:04 +00:00
case PCB_VIA_T:
case PCB_DIM_ALIGNED_T:
2020-09-17 00:54:58 +00:00
case PCB_DIM_CENTER_T:
case PCB_DIM_ORTHOGONAL_T:
case PCB_DIM_LEADER_T:
case PCB_TARGET_T:
case PCB_ZONE_T:
this_item = item->Duplicate();
break;
case PCB_GROUP_T:
this_item = static_cast<PCB_GROUP*>( item )->DeepDuplicate();
2020-02-20 12:11:04 +00:00
break;
default:
// Silently drop other items (such as footprint texts) from duplication
break;
}
// PCB items keep the same numbering
// @TODO: renumber footprints if asked. This needs UI to enable.
// something like this, but needs a "block offset" to prevent
// multiple selections overlapping.
// if( this_item->Type() == PCB_FOOTPRINT_T )
2020-11-13 15:15:52 +00:00
// static_cast<FOOTPRINT&>( *new_item ).IncrementReference( ptN );
// @TODO: we should merge zones. This is a bit tricky, because
// the undo command needs saving old area, if it is merged.
}
if( this_item )
{
// Because aItem is/can be created from a selected item, and inherits from
// it this state, reset the selected stated of aItem:
this_item->ClearSelected();
if( this_item->Type() == PCB_GROUP_T )
{
static_cast<PCB_GROUP*>( this_item )->RunOnDescendants(
[&]( BOARD_ITEM* aItem )
{
aItem->ClearSelected();
commit.Add( aItem );
});
}
else if( this_item->Type() == PCB_FOOTPRINT_T )
{
2020-11-13 15:15:52 +00:00
static_cast<FOOTPRINT*>( this_item )->RunOnChildren(
[&]( BOARD_ITEM* aItem )
{
aItem->ClearSelected();
});
}
commit.Add( this_item );
}
2016-06-21 15:06:28 +00:00
}
// always transform the item
if( this_item )
2016-06-21 15:06:28 +00:00
{
commit.Modify( this_item );
TransformItem( *array_opts, ptN, *this_item );
2016-06-21 15:06:28 +00:00
}
2016-06-21 15:06:28 +00:00
// attempt to renumber items if the array parameters define
// a complete numbering scheme to number by (as opposed to
// implicit numbering by incrementing the items during creation
if( this_item && array_opts->ShouldNumberItems() )
2016-06-21 15:06:28 +00:00
{
// Renumber non-aperture pads.
if( this_item->Type() == PCB_PAD_T )
{
2020-11-12 22:30:02 +00:00
PAD& pad = static_cast<PAD&>( *this_item );
if( PAD_NAMING::PadCanHaveName( pad ) )
{
wxString newName = pad_name_provider.GetNextPadName();
pad.SetName( newName );
}
}
}
}
}
2016-06-21 15:06:28 +00:00
commit.Push( _( "Create an array" ) );
}