kicad/include/undo_redo_container.h

340 lines
12 KiB
C
Raw Normal View History

2009-07-23 15:49:39 +00:00
/*
* This program source code file is part of KiCad, a free EDA CAD application.
2009-07-23 15:49:39 +00:00
*
* Copyright (C) 2009 jean-pierre.charras@gipsa-lab.inpg.fr
* Copyright (C) 2011 Wayne Stambaugh <stambaughw@verizon.net>
* Copyright (C) 2009 KiCad Developers, see change_log.txt for contributors.
2009-07-23 15:49:39 +00:00
*
* 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 _CLASS_UNDOREDO_CONTAINER_H
#define _CLASS_UNDOREDO_CONTAINER_H
#include <vector>
#include <eda_item.h>
class PICKED_ITEMS_LIST;
class BASE_SCREEN;
2009-07-23 15:49:39 +00:00
/**
* Undo Redo considerations:
2009-07-23 15:49:39 +00:00
* Basically we have 3 cases
* New item
* Deleted item
* Modified item
* there is also a specific case in Eeschema, when wires are modified
2009-07-23 15:49:39 +00:00
* If an item is modified, a copy of the "old" item parameters value is held.
* When an item is deleted or added (new item) the pointer points the item, and there is
* no other copy.
*/
/* Type of undo/redo operations
* each type must be redo/undone by a specific operation
*/
2020-08-26 18:04:32 +00:00
enum class UNDO_REDO {
UNSPECIFIED = 0, // illegal
CHANGED, // params of items have a value changed: undo is made by exchange
// values with a copy of these values
NEWITEM, // new item, undo by changing in deleted
DELETED, // deleted item, undo by changing in deleted
MOVED, // moved item, undo by move it
MIRRORED_X, // mirrored item, undo by mirror X
MIRRORED_Y, // mirrored item, undo by mirror Y
ROTATED, // Rotated item (counterclockwise), undo by rotating it
ROTATED_CLOCKWISE, // Rotated item (clockwise), undo by rotating it
FLIPPED, // flipped (board items only), undo by flipping it
2020-10-31 01:27:16 +00:00
LIBEDIT, // Specific to the component editor (symbol_editor creates a full copy
2020-08-26 18:04:32 +00:00
// of the current component when changed)
LIB_RENAME, // As LIBEDIT, but old copy should be removed from library
EXCHANGE_T, // Use for changing the schematic text type where swapping
// data structure is insufficient to restore the change.
DRILLORIGIN, // origin changed (like CHANGED, contains the origin and a copy)
GRIDORIGIN, // origin changed (like CHANGED, contains the origin and a copy)
PAGESETTINGS, // page settings or title block changes
GROUP,
UNGROUP
};
2009-07-23 15:49:39 +00:00
class ITEM_PICKER
{
2012-02-05 13:02:46 +00:00
private:
2020-11-14 18:11:28 +00:00
STATUS_FLAGS m_pickerFlags; /* a copy of m_flags member. useful in mode/drag
2012-02-05 13:02:46 +00:00
* undo/redo commands */
2020-11-14 18:11:28 +00:00
UNDO_REDO m_undoRedoStatus; /* type of operation to undo/redo for this item */
2012-02-05 13:02:46 +00:00
EDA_ITEM* m_pickedItem; /* Pointer on the schematic or board item that is concerned
* (picked), or in undo redo commands, the copy of an
* edited item. */
2012-02-05 13:02:46 +00:00
KICAD_T m_pickedItemType; /* type of schematic or board item that is concerned */
2018-04-08 10:28:59 +00:00
EDA_ITEM* m_link; /* Pointer on another item. Used in undo redo command
* used when a duplicate exists i.e. when an item is
* modified, and the copy of initial item exists (the
* duplicate) m_Item points the duplicate (i.e the old
* copy of an active item) and m_Link points the active
* item in schematic */
2009-07-23 15:49:39 +00:00
BASE_SCREEN* m_screen; /* For new and deleted items the screen the item should
* be added to/removed from. */
public:
2020-08-26 18:04:32 +00:00
// ITEM_PICKER( EDA_ITEM* aItem = NULL, UNDO_REDO aStatus = UNSPECIFIED );
ITEM_PICKER();
2020-08-26 18:04:32 +00:00
ITEM_PICKER( BASE_SCREEN* aScreen, EDA_ITEM* aItem, UNDO_REDO aStatus = UNDO_REDO::UNSPECIFIED );
2012-02-05 13:02:46 +00:00
EDA_ITEM* GetItem() const { return m_pickedItem; }
void SetItem( EDA_ITEM* aItem )
{
m_pickedItem = aItem;
m_pickedItemType = aItem ? aItem->Type() : TYPE_NOT_INIT;
}
KICAD_T GetItemType() const { return m_pickedItemType; }
2020-08-26 18:04:32 +00:00
void SetStatus( UNDO_REDO aStatus ) { m_undoRedoStatus = aStatus; }
2020-08-26 18:04:32 +00:00
UNDO_REDO GetStatus() const { return m_undoRedoStatus; }
void SetFlags( STATUS_FLAGS aFlags ) { m_pickerFlags = aFlags; }
STATUS_FLAGS GetFlags() const { return m_pickerFlags; }
2012-02-05 13:02:46 +00:00
void SetLink( EDA_ITEM* aItem ) { m_link = aItem; }
2012-02-05 13:02:46 +00:00
EDA_ITEM* GetLink() const { return m_link; }
BASE_SCREEN* GetScreen() const { return m_screen; }
2009-07-23 15:49:39 +00:00
};
/**
* PICKED_ITEMS_LIST
2009-07-23 15:49:39 +00:00
* is a holder to handle information on schematic or board items.
* The information held is a pointer on each item, and the command made.
*/
class PICKED_ITEMS_LIST
{
public:
2020-08-26 18:04:32 +00:00
UNDO_REDO m_Status; /* info about operation to undo/redo for this item. can be
* UNSPECIFIED */
wxPoint m_TransformPoint; /* used to undo redo command by the same command: usually
* need to know the rotate point or the move vector */
2009-07-23 15:49:39 +00:00
private:
std::vector <ITEM_PICKER> m_ItemsList;
public:
PICKED_ITEMS_LIST();
~PICKED_ITEMS_LIST();
2009-08-06 07:11:04 +00:00
/**
* Function PushItem
* pushes \a aItem to the top of the list
* @param aItem Picker to push on to the list.
2009-08-06 07:11:04 +00:00
*/
void PushItem( const ITEM_PICKER& aItem );
2009-08-06 07:11:04 +00:00
/**
* Function PopItem
* @return The picker removed from the top of the list.
2009-08-06 07:11:04 +00:00
*/
2009-07-23 15:49:39 +00:00
ITEM_PICKER PopItem();
/**
* Function IsItemInList
* @return True if \a aItem is found in the pick list.
*/
bool ContainsItem( const EDA_ITEM* aItem ) const;
/**
* Function FindItem
* @return Index of the searched item. If the item is not stored in the list, negative value
* is returned.
*/
int FindItem( const EDA_ITEM* aItem ) const;
2010-11-12 15:17:10 +00:00
/**
* Function ClearItemsList
* deletes only the list of pickers, NOT the picked data itself.
*/
void ClearItemsList();
2009-07-23 15:49:39 +00:00
2010-11-12 15:17:10 +00:00
/**
* Function ClearListAndDeleteItems
* deletes the list of pickers, AND the data pointed by m_PickedItem or
* m_PickedItemLink, according to the type of undo/redo command recorded
*/
void ClearListAndDeleteItems();
2010-11-12 15:17:10 +00:00
/**
* Function GetCount
* @return The count of pickers stored in this list.
2009-08-06 07:11:04 +00:00
*/
unsigned GetCount() const
2009-07-23 15:49:39 +00:00
{
return m_ItemsList.size();
}
2010-11-12 15:17:10 +00:00
/**
* Function ReversePickersListOrder
* reverses the order of pickers stored in this list.
* <p>
* This is useful when pop a list from Undo to Redo (and vice-versa) because
* sometimes undo (or redo) a command needs to keep the order of successive
* changes. Obviously, undo and redo are in reverse order
2009-08-08 06:07:08 +00:00
*/
void ReversePickersListOrder();
2009-07-23 15:49:39 +00:00
2010-11-12 15:17:10 +00:00
/**
* Function GetItemWrapper
* @return The picker of a picked item.
* @param aIdx Index of the picker in the picked list
* if this picker does not exist, a picker is returned,
* with its members set to 0 or NULL
*/
ITEM_PICKER GetItemWrapper( unsigned int aIdx ) const;
2010-11-12 15:17:10 +00:00
/**
* Function GetPickedItem
* @return A pointer to the picked item
* @param aIdx Index of the picked item in the picked list
*/
EDA_ITEM* GetPickedItem( unsigned int aIdx ) const;
/**
* Function GetScreenForItem
* @return A pointer to the picked item's sceen
* @param aIdx Index of the picked item in the picked list
*/
BASE_SCREEN* GetScreenForItem( unsigned int aIdx ) const;
2010-11-12 15:17:10 +00:00
/**
* Function GetPickedItemLink
* @return link of the picked item, or null if does not exist
* @param aIdx Index of the picked item in the picked list
*/
EDA_ITEM* GetPickedItemLink( unsigned int aIdx ) const;
2010-11-12 15:17:10 +00:00
/**
* Function GetPickedItemStatus
* @return The type of undo/redo operation associated to the picked item,
2020-08-26 18:04:32 +00:00
* or UNSPECIFIED if does not exist
* @param aIdx Index of the picked item in the picked list
*/
2020-08-26 18:04:32 +00:00
UNDO_REDO GetPickedItemStatus( unsigned int aIdx ) const;
2010-11-12 15:17:10 +00:00
/**
* Function GetPickerFlags
* returns the value of the picker flag.
* @param aIdx Index of the picker in the picked list
* @return The value stored in the picker, if the picker exists, or 0 if does not exist
*/
STATUS_FLAGS GetPickerFlags( unsigned aIdx ) const;
2010-11-12 15:17:10 +00:00
/**
* Function SetPickedItem
* @param aItem A pointer to the item to pick
* @param aIdx Index of the picker in the picked list
* @return True if the picker exists or false if does not exist
*/
bool SetPickedItem( EDA_ITEM* aItem, unsigned aIdx );
2010-11-12 15:17:10 +00:00
/**
* Function SetPickedItem
* @param aItem A pointer to the item to pick
* @param aStatus The type of undo/redo operation associated to the item to pick
* @param aIdx Index of the picker in the picked list
* @return True if the picker exists or false if does not exist
*/
2020-08-26 18:04:32 +00:00
bool SetPickedItem( EDA_ITEM* aItem, UNDO_REDO aStatus, unsigned aIdx );
2010-11-12 15:17:10 +00:00
/**
* Function SetPickedItemLink
* set the link associated to a given picked item.
* @param aLink = the link to the item associated to the picked item
* @param aIdx = index of the picker in the picked list
* @return true if the picker exists, or false if does not exist
*/
bool SetPickedItemLink( EDA_ITEM* aLink, unsigned aIdx );
2010-11-12 15:17:10 +00:00
/**
* Function SetPickedItemStatus
* sets the type of undo/redo operation for a given picked item.
* @param aStatus The type of undo/redo operation associated to the picked item
* @param aIdx Index of the picker in the picked list
* @return True if the picker exists or false if does not exist
*/
2020-08-26 18:04:32 +00:00
bool SetPickedItemStatus( UNDO_REDO aStatus, unsigned aIdx );
2010-11-12 15:17:10 +00:00
/**
* Function SetPickerFlags
2020-11-14 18:11:28 +00:00
* set the flags of the picker (usually to the picked item m_flags value)
* @param aFlags The flag value to save in picker
* @param aIdx Index of the picker in the picked list
* @return True if the picker exists or false if does not exist
*/
bool SetPickerFlags( STATUS_FLAGS aFlags, unsigned aIdx );
2010-11-12 15:17:10 +00:00
/**
* Function RemovePicker
* removes one entry (one picker) from the list of picked items.
* @param aIdx Index of the picker in the picked list
* @return True if ok or false if did not exist
*/
bool RemovePicker( unsigned aIdx );
2010-11-12 15:17:10 +00:00
/**
* Function CopyList
* copies all data from aSource to the list.
* Items picked are not copied. just pointer in them are copied
* @param aSource The list of items to copy to the list.
*/
void CopyList( const PICKED_ITEMS_LIST& aSource );
2009-07-23 15:49:39 +00:00
};
2009-07-23 15:49:39 +00:00
/**
* UNDO_REDO_CONTAINER
2009-07-23 15:49:39 +00:00
* is a holder to handle alist of undo (or redo) command.
* this class handles a list of ITEM_PICKER (each manage one schematic or board item).
*/
class UNDO_REDO_CONTAINER
{
public:
std::vector <PICKED_ITEMS_LIST*> m_CommandsList; // the list of possible undo/redo commands
2009-07-23 15:49:39 +00:00
public:
UNDO_REDO_CONTAINER();
~UNDO_REDO_CONTAINER();
void PushCommand( PICKED_ITEMS_LIST* aCommand );
2009-07-23 15:49:39 +00:00
PICKED_ITEMS_LIST* PopCommand();
void ClearCommandList();
2009-07-23 15:49:39 +00:00
};
#endif // _CLASS_UNDOREDO_CONTAINER_H