Fix more broken Doxygen comment specifiers.
This commit is contained in:
parent
5a90643b8b
commit
4619d5e112
|
@ -2,7 +2,7 @@
|
|||
* This program source code file is part of KiCad, a free EDA CAD application.
|
||||
*
|
||||
* Copyright (C) 2018 Jean-Pierre Charras, jaen-pierre.charras@gipsa-lab.inpg.com
|
||||
* Copyright (C) 2007-2018 KiCad Developers, see AUTHORS.txt for contributors.
|
||||
* Copyright (C) 2007-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
|
||||
|
@ -38,8 +38,7 @@ class REPORTER;
|
|||
|
||||
|
||||
/**
|
||||
* DISPLAY_FOOTPRINTS_FRAME
|
||||
* is used to display footprints.
|
||||
* Display footprints.
|
||||
*/
|
||||
class DISPLAY_FOOTPRINTS_FRAME : public PCB_BASE_FRAME
|
||||
{
|
||||
|
@ -54,18 +53,17 @@ public:
|
|||
void ReCreateOptToolbar() override;
|
||||
|
||||
/**
|
||||
* Function InitDisplay
|
||||
* Refresh the full display for this frame:
|
||||
* Set the title, the status line and redraw the canvas
|
||||
* Must be called after the footprint to display is modifed
|
||||
* Must be called after the footprint to display is modified
|
||||
*/
|
||||
void InitDisplay();
|
||||
|
||||
///> @copydoc PCB_BASE_FRAME::GetModel()
|
||||
///< @copydoc PCB_BASE_FRAME::GetModel()
|
||||
BOARD_ITEM_CONTAINER* GetModel() const override;
|
||||
|
||||
/**
|
||||
* update the gal canvas (view, colors ...)
|
||||
* Update the gal canvas (view, colors ...).
|
||||
*/
|
||||
void updateView();
|
||||
|
||||
|
@ -76,22 +74,20 @@ public:
|
|||
|
||||
MAGNETIC_SETTINGS* GetMagneticItemsSettings() override;
|
||||
|
||||
///> @copydoc EDA_DRAW_FRAME::UpdateMsgPanel()
|
||||
///< @copydoc EDA_DRAW_FRAME::UpdateMsgPanel()
|
||||
void UpdateMsgPanel() override;
|
||||
|
||||
COLOR_SETTINGS* GetColorSettings() const override;
|
||||
|
||||
/**
|
||||
* Function GetGridColor() , virtual
|
||||
* @return the color of the grid
|
||||
* @return the color of the grid.
|
||||
*/
|
||||
COLOR4D GetGridColor() override;
|
||||
|
||||
FOOTPRINT* GetFootprint( const wxString& aFootprintName, REPORTER& aReporter );
|
||||
|
||||
/* SaveCopyInUndoList() virtual
|
||||
* currently: do nothing in CvPcb.
|
||||
* but but be defined because it is a pure virtual in PCB_BASE_FRAME
|
||||
/**
|
||||
* Does nothing in CvPcb but defined because it is a pure virtual in #PCB_BASE_FRAME.
|
||||
*/
|
||||
void SaveCopyInUndoList( EDA_ITEM* aItemToCopy, UNDO_REDO aTypeCommand = UNDO_REDO::UNSPECIFIED,
|
||||
const wxPoint& aTransformPoint = wxPoint( 0, 0 ) ) override
|
||||
|
@ -100,13 +96,14 @@ public:
|
|||
|
||||
|
||||
/**
|
||||
* Function SaveCopyInUndoList (overloaded).
|
||||
* Creates a new entry in undo list of commands.
|
||||
* add a list of pickers to handle a list of items
|
||||
* @param aItemsList = the list of items modified by the command to undo
|
||||
* @param aTypeCommand = command type (see enum UNDO_REDO)
|
||||
* @param aTransformPoint = the reference point of the transformation,
|
||||
* for commands like move
|
||||
* Create a new entry in undo list of commands.
|
||||
*
|
||||
* Add a list of pickers to handle a list of items.
|
||||
*
|
||||
* @param aItemsList is the list of items modified by the command to undo
|
||||
* @param aTypeCommand is command type (see enum UNDO_REDO)
|
||||
* @param aTransformPoint is the reference point of the transformation,
|
||||
* for commands like move
|
||||
*/
|
||||
void SaveCopyInUndoList( const PICKED_ITEMS_LIST& aItemsList, UNDO_REDO aTypeCommand,
|
||||
const wxPoint& aTransformPoint = wxPoint( 0, 0 ) ) override
|
||||
|
|
|
@ -2,7 +2,7 @@
|
|||
* This program source code file is part of KiCad, a free EDA CAD application.
|
||||
*
|
||||
* Copyright (C) 2013-2016 CERN
|
||||
* Copyright (C) 2018-2019 KiCad Developers, see AUTHORS.txt for contributors.
|
||||
* Copyright (C) 2018-2021 KiCad Developers, see AUTHORS.txt for contributors.
|
||||
* @author Maciej Suminski <maciej.suminski@cern.ch>
|
||||
*
|
||||
* This program is free software; you can redistribute it and/or
|
||||
|
@ -32,10 +32,10 @@
|
|||
class TOOL_ACTION;
|
||||
|
||||
/**
|
||||
* CVPCB_ACTIONS
|
||||
* Gather all the actions that are shared by tools.
|
||||
*
|
||||
* Gathers all the actions that are shared by tools. The instance of CVPCB_ACTIONS is created
|
||||
* inside of ACTION_MANAGER object that registers the actions.
|
||||
* The instance of CVPCB_ACTIONS is created inside of ACTION_MANAGER object that registers
|
||||
* the actions.
|
||||
*/
|
||||
class CVPCB_ACTIONS : public ACTIONS
|
||||
{
|
||||
|
@ -70,7 +70,7 @@ public:
|
|||
static TOOL_ACTION filterFPbyPin;
|
||||
static TOOL_ACTION FilterFPbyLibrary;
|
||||
|
||||
///> @copydoc COMMON_ACTIONS::TranslateLegacyId()
|
||||
///< @copydoc COMMON_ACTIONS::TranslateLegacyId()
|
||||
virtual OPT<TOOL_EVENT> TranslateLegacyId( int aId ) override { return OPT<TOOL_EVENT>(); }
|
||||
};
|
||||
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
/*
|
||||
* This program source code file is part of KiCad, a free EDA CAD application.
|
||||
*
|
||||
* Copyright (C) 2018-2019 KiCad Developers, see AUTHORS.txt for contributors.
|
||||
* Copyright (C) 2018-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
|
||||
|
@ -29,8 +29,6 @@
|
|||
|
||||
|
||||
/**
|
||||
* CVPCB_FOOTPRINT_VIEWER_SELECTION_TOOL
|
||||
*
|
||||
* Selection tool for the footprint viewer in cvpcb.
|
||||
*/
|
||||
class CVPCB_FOOTPRINT_VIEWER_SELECTION_TOOL : public TOOL_INTERACTIVE
|
||||
|
@ -46,8 +44,6 @@ public:
|
|||
void Reset( RESET_REASON aReason ) override;
|
||||
|
||||
/**
|
||||
* Function Main()
|
||||
*
|
||||
* The main loop.
|
||||
*/
|
||||
int Main( const TOOL_EVENT& aEvent );
|
||||
|
@ -69,7 +65,7 @@ public:
|
|||
*/
|
||||
int UpdateMenu( const TOOL_EVENT& aEvent );
|
||||
|
||||
///> Sets up handlers for various events.
|
||||
///< Sets up handlers for various events.
|
||||
void setTransitions() override;
|
||||
|
||||
private:
|
||||
|
|
|
@ -2,6 +2,8 @@
|
|||
* This program source code file is part of KiCad, a free EDA CAD application.
|
||||
*
|
||||
* Copyright (C) 2018 CERN
|
||||
* Copyright (C) 2021 KiCad Developers, see AUTHORS.txt for contributors.
|
||||
*
|
||||
* @author Maciej Suminski <maciej.suminski@cern.ch>
|
||||
*
|
||||
* This program is free software; you can redistribute it and/or
|
||||
|
@ -32,11 +34,11 @@
|
|||
#include <memory>
|
||||
|
||||
/**
|
||||
* Class handling a Bill of Material output generator.
|
||||
* Bill of material output generator.
|
||||
*
|
||||
* A Material output generator is an external application called by Eeschema to create
|
||||
* a BOM from our intermediate xml netlist.
|
||||
* A generator can be a script or an executable that can read the intermediate xml netlist
|
||||
* file and generates a output (the BOM file)
|
||||
* a BOM from our intermediate XML netlist. A generator can be a script or an executable
|
||||
* that can read the intermediate XML netlist file and generates a output (the BOM file)
|
||||
*/
|
||||
class BOM_GENERATOR_HANDLER
|
||||
{
|
||||
|
@ -44,25 +46,24 @@ public:
|
|||
typedef std::unique_ptr<BOM_GENERATOR_HANDLER> PTR;
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
* @param aFile is path to the plugin file.
|
||||
*/
|
||||
BOM_GENERATOR_HANDLER( const wxString& aFile );
|
||||
|
||||
/**
|
||||
* Returns true if the plugin is ready to work, i.e. if the plugin file
|
||||
* is found an readable
|
||||
* Return true if the plugin is ready to work, i.e. if the plugin file is found and readable.
|
||||
*/
|
||||
bool IsOk() { return m_isOk; }
|
||||
|
||||
/**
|
||||
* Returns true if a file name matches a recognized plugin format.
|
||||
* Return true if a file name matches a recognized plugin format.
|
||||
*
|
||||
* @param aFile is path to the plugin file.
|
||||
*/
|
||||
static bool IsValidGenerator( const wxString& aFile );
|
||||
|
||||
/**
|
||||
* Returns plugin description stored in the plugin header file (if available).
|
||||
* Return plugin description stored in the plugin header file (if available).
|
||||
*/
|
||||
const wxString& GetInfo() const
|
||||
{
|
||||
|
@ -70,7 +71,7 @@ public:
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns the file name of the plugin.
|
||||
* Return the file name of the plugin.
|
||||
*/
|
||||
const wxFileName& GetFile() const
|
||||
{
|
||||
|
@ -78,7 +79,7 @@ public:
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns the customisable plugin name.
|
||||
* Return the customisable plugin name.
|
||||
*/
|
||||
const wxString& GetName() const
|
||||
{
|
||||
|
@ -86,7 +87,8 @@ public:
|
|||
}
|
||||
|
||||
/**
|
||||
* Sets the customisable plugin name.
|
||||
* Set the customisable plugin name.
|
||||
*
|
||||
* @param aName is the new name.
|
||||
*/
|
||||
void SetName( const wxString& aName )
|
||||
|
@ -95,7 +97,7 @@ public:
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns the command to execute the plugin.
|
||||
* Return the command to execute the plugin.
|
||||
*/
|
||||
const wxString& GetCommand() const
|
||||
{
|
||||
|
@ -103,7 +105,7 @@ public:
|
|||
}
|
||||
|
||||
/**
|
||||
* Sets the command to execute the plugin.
|
||||
* Set the command to execute the plugin.
|
||||
*/
|
||||
void SetCommand( const wxString& aCommand )
|
||||
{
|
||||
|
@ -120,27 +122,28 @@ public:
|
|||
|
||||
protected:
|
||||
/**
|
||||
* Reads the plugin file header.
|
||||
* Read the plugin file header.
|
||||
*
|
||||
* @param aEndSection is a string marking end of the header.
|
||||
*/
|
||||
wxString readHeader( const wxString& aEndSection );
|
||||
|
||||
///> true if the plugin is working (i.e. if the plugin file exists and was read
|
||||
///< true if the plugin is working (i.e. if the plugin file exists and was read
|
||||
bool m_isOk;
|
||||
|
||||
///> Path to the plugin
|
||||
///< Path to the plugin
|
||||
const wxFileName m_file;
|
||||
|
||||
///> User customisable name
|
||||
///< User customisable name
|
||||
wxString m_name;
|
||||
|
||||
///> Command to execute the plugin
|
||||
///< Command to execute the plugin
|
||||
wxString m_cmd;
|
||||
|
||||
///> Description of the plugin (normally from the plugin header)
|
||||
///< Description of the plugin (normally from the plugin header)
|
||||
wxString m_info;
|
||||
|
||||
///> Plugin specific options
|
||||
///< Plugin specific options
|
||||
wxArrayString m_options;
|
||||
};
|
||||
|
||||
|
|
|
@ -5,6 +5,7 @@
|
|||
* This program source code file is part of KiCad, a free EDA CAD application.
|
||||
*
|
||||
* Copyright (C) 2020 CERN
|
||||
* Copyright (C) 2021 KiCad Developers, see AUTHORS.txt for contributors.
|
||||
*
|
||||
* @author Wayne Stambaugh <stambaughw@gmail.com>
|
||||
*
|
||||
|
@ -63,7 +64,7 @@ protected:
|
|||
checkAll( false );
|
||||
}
|
||||
|
||||
///> Selects or deselects all fields in the listbox widget
|
||||
///< Select or deselect all fields in the listbox widget
|
||||
void checkAll( bool aCheck );
|
||||
|
||||
private:
|
||||
|
@ -77,7 +78,7 @@ private:
|
|||
SCH_COMPONENT* m_symbol;
|
||||
MODE m_mode;
|
||||
|
||||
///> Set of field names that should have values updated
|
||||
///< Set of field names that should have values updated
|
||||
std::set<wxString> m_updateFields;
|
||||
};
|
||||
|
||||
|
|
|
@ -2,6 +2,8 @@
|
|||
* This program source code file is part of KiCad, a free EDA CAD application.
|
||||
*
|
||||
* Copyright (C) 2016-2017 CERN
|
||||
* Copyright (C) 2021 KiCad Developers, see AUTHORS.txt for contributors.
|
||||
*
|
||||
* @author Maciej Suminski <maciej.suminski@cern.ch>
|
||||
*
|
||||
* This program is free software; you can redistribute it and/or
|
||||
|
@ -45,30 +47,35 @@ public:
|
|||
|
||||
private:
|
||||
/**
|
||||
* Parse a string describing a power source, so appropriate settings are checked in the dialog
|
||||
* Parse a string describing a power source, so appropriate settings are checked in the dialog.
|
||||
*
|
||||
* @param aModel contains the string to be parse (e.g. sin(0 1 10k))
|
||||
* @return True if the input string was parsed without errors.
|
||||
*/
|
||||
bool parsePowerSource( const wxString& aModel );
|
||||
|
||||
/**
|
||||
* Generates a string to describe power source parameters, basing on the current selection.
|
||||
* Generate a string to describe power source parameters, basing on the current selection.
|
||||
*
|
||||
* If there are missing fields, it will not modify the target string.
|
||||
*
|
||||
* @param aTarget is the destination for the generated string.
|
||||
* @return True if the string was saved successfully.
|
||||
*/
|
||||
bool generatePowerSource( wxString& aTarget ) const;
|
||||
|
||||
/**
|
||||
* Loads a list of components (.model and .subckt) from a spice library
|
||||
* file and adds them to a combo box.
|
||||
* Load a list of components (.model and .subckt) from a spice library file and add them to
|
||||
* a combo box.
|
||||
*
|
||||
* @param aComboBox is the target combo box
|
||||
* @param aFilePath is path to the library file
|
||||
*/
|
||||
void loadLibrary( const wxString& aFilePath );
|
||||
|
||||
/**
|
||||
* Returns or creates a field in the edited schematic fields vector.
|
||||
* Return or create a field in the edited schematic fields vector.
|
||||
*
|
||||
* @param aFieldType is an SPICE_FIELD enum value.
|
||||
* @return Requested field.
|
||||
*/
|
||||
|
@ -76,7 +83,8 @@ private:
|
|||
LIB_FIELD& getLibField( int aFieldType );
|
||||
|
||||
/**
|
||||
* Adds a value to the PWL values list.
|
||||
* Add a value to the PWL values list.
|
||||
*
|
||||
* @param aTime is the time value.
|
||||
* @param aValue is the source value at the given time.
|
||||
* @return True if request has completed successfully, false if the data is invalid.
|
||||
|
@ -88,7 +96,7 @@ private:
|
|||
|
||||
// The default dialog Validate() calls the validators of all widgets.
|
||||
// This is not what we want; We want only validators of the selected page
|
||||
// of the notbooks. So disable the wxDialog::Validate(), and let our
|
||||
// of the notebooks. So disable the wxDialog::Validate(), and let our
|
||||
// TransferDataFromWindow doing the job.
|
||||
virtual bool Validate() override
|
||||
{
|
||||
|
@ -105,7 +113,7 @@ private:
|
|||
}
|
||||
|
||||
/**
|
||||
* Initializes the internal settings
|
||||
* Initialize the internal settings.
|
||||
*/
|
||||
void Init();
|
||||
|
||||
|
@ -122,26 +130,26 @@ private:
|
|||
void onRandomSourceType( wxCommandEvent& event ) override;
|
||||
void onTypeSelected( wxCommandEvent& event ) override;
|
||||
|
||||
///> Edited component
|
||||
///< Edited component
|
||||
SCH_COMPONENT& m_component;
|
||||
|
||||
///> Fields from the component properties dialog
|
||||
///< Fields from the component properties dialog
|
||||
std::vector<SCH_FIELD>* m_schfields;
|
||||
std::vector<LIB_FIELD>* m_libfields;
|
||||
bool m_useSchFields;
|
||||
|
||||
///> Temporary field values
|
||||
///< Temporary field values
|
||||
std::map<int, wxString> m_fieldsTmp;
|
||||
|
||||
struct MODEL
|
||||
{
|
||||
///> Line number in the library file
|
||||
///< Line number in the library file
|
||||
int line;
|
||||
|
||||
///> Type of the device
|
||||
///< Type of the device
|
||||
SPICE_PRIMITIVE model;
|
||||
|
||||
///> Convert string to model
|
||||
///< Convert string to model
|
||||
static SPICE_PRIMITIVE parseModelType( const wxString& aValue );
|
||||
|
||||
MODEL( int aLine, enum SPICE_PRIMITIVE aModel )
|
||||
|
@ -150,10 +158,10 @@ private:
|
|||
}
|
||||
};
|
||||
|
||||
///> Models available in the selected library file
|
||||
///< Models available in the selected library file
|
||||
std::map<wxString, MODEL> m_models;
|
||||
|
||||
///> Column identifiers for PWL power source value list
|
||||
///< Column identifiers for PWL power source value list
|
||||
long m_pwlTimeCol, m_pwlValueCol;
|
||||
|
||||
SPICE_VALIDATOR m_spiceValidator;
|
||||
|
|
|
@ -3,7 +3,7 @@
|
|||
*
|
||||
* Copyright (C) 1992-2013 jp.charras at wanadoo.fr
|
||||
* Copyright (C) 2013 SoftPLC Corporation, Dick Hollenbeck <dick@softplc.com>
|
||||
* Copyright (C) 1992-2017 KiCad Developers
|
||||
* Copyright (C) 1992-2021 KiCad Developers
|
||||
*
|
||||
* This program is free software; you can redistribute it and/or
|
||||
* modify it under the terms of the GNU General Public License
|
||||
|
@ -34,8 +34,8 @@ class PROJECT;
|
|||
|
||||
/// Flags for Spice netlist generation (can be combined)
|
||||
enum SPICE_NETLIST_OPTIONS {
|
||||
NET_ADJUST_INCLUDE_PATHS = 8, // use full paths for included files (if they are in search path)
|
||||
NET_ADJUST_PASSIVE_VALS = 16, // reformat passive component values (e.g. 1M -> 1Meg)
|
||||
NET_ADJUST_INCLUDE_PATHS = 8, // use full paths for included files (if they are in search path)
|
||||
NET_ADJUST_PASSIVE_VALS = 16, // reformat passive component values (e.g. 1M -> 1Meg)
|
||||
NET_ALL_FLAGS = 0xffff
|
||||
};
|
||||
|
||||
|
@ -48,7 +48,7 @@ enum SPICE_FIELD {
|
|||
SF_END // sentinel
|
||||
};
|
||||
|
||||
///> Basic Spice component primitives
|
||||
///< Basic Spice component primitives
|
||||
enum SPICE_PRIMITIVE {
|
||||
SP_UNKNOWN = ' ',
|
||||
SP_RESISTOR = 'R',
|
||||
|
@ -63,40 +63,40 @@ enum SPICE_PRIMITIVE {
|
|||
SP_ISOURCE = 'I'
|
||||
};
|
||||
|
||||
/// @todo add NET_ADJUST_INCLUDE_PATHS & NET_ADJUST_PASSIVE_VALS checkboxes in the netlist export dialog
|
||||
/// @todo add NET_ADJUST_INCLUDE_PATHS & NET_ADJUST_PASSIVE_VALS checkboxes in the netlist
|
||||
/// export dialog.
|
||||
|
||||
/**
|
||||
* @brief Structure to represent a schematic component in the Spice simulation.
|
||||
* Structure to represent a schematic component in the Spice simulation.
|
||||
*/
|
||||
struct SPICE_ITEM
|
||||
{
|
||||
///> Schematic component represented by this SPICE_ITEM.
|
||||
///< Schematic component represented by this SPICE_ITEM.
|
||||
SCH_COMPONENT* m_parent;
|
||||
|
||||
///> Spice primitive type (@see SPICE_PRIMITIVE).
|
||||
///< Spice primitive type (@see SPICE_PRIMITIVE).
|
||||
wxChar m_primitive;
|
||||
|
||||
///> Library model (for semiconductors and subcircuits), component value (for passive components)
|
||||
///> or voltage/current (for sources).
|
||||
///< Library model (for semiconductors and subcircuits), component value (for passive
|
||||
///< components) or voltage/current (for sources).
|
||||
wxString m_model;
|
||||
|
||||
///>
|
||||
///<
|
||||
wxString m_refName;
|
||||
|
||||
///> Flag to indicate whether the component should be used in simulation.
|
||||
///< Flag to indicate whether the component should be used in simulation.
|
||||
bool m_enabled;
|
||||
|
||||
///> Array containing Standard Pin Name
|
||||
///< Array containing Standard Pin Name
|
||||
std::vector<wxString> m_pins;
|
||||
|
||||
///> Numeric indices into m_SortedComponentPinList
|
||||
///< Numeric indices into m_SortedComponentPinList
|
||||
std::vector<int> m_pinSequence;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* NETLIST_EXPORTER_PSPICE
|
||||
* generates a PSPICE compatible netlist
|
||||
* Generate a PSPICE compatible netlist.
|
||||
*/
|
||||
class NETLIST_EXPORTER_PSPICE : public NETLIST_EXPORTER_BASE
|
||||
{
|
||||
|
@ -112,11 +112,11 @@ public:
|
|||
|
||||
typedef std::list<SPICE_ITEM> SPICE_ITEM_LIST;
|
||||
|
||||
///> Net name to circuit node number mapping
|
||||
///< Net name to circuit node number mapping
|
||||
typedef std::map<wxString, int> NET_INDEX_MAP;
|
||||
|
||||
/**
|
||||
* @brief Returns list of items representing schematic components in the Spice world.
|
||||
* Return list of items representing schematic components in the Spice world.
|
||||
*/
|
||||
const SPICE_ITEM_LIST& GetSpiceItems() const
|
||||
{
|
||||
|
@ -124,7 +124,7 @@ public:
|
|||
}
|
||||
|
||||
/**
|
||||
* @brief Returns name of Spice device corresponding to a schematic component.
|
||||
* Return name of Spice device corresponding to a schematic component.
|
||||
*
|
||||
* @param aComponent is the component reference.
|
||||
* @return Spice device name or empty string if there is no such component in the netlist. The
|
||||
|
@ -135,16 +135,15 @@ public:
|
|||
wxString GetSpiceDevice( const wxString& aComponent ) const;
|
||||
|
||||
/**
|
||||
* Function WriteNetlist
|
||||
* writes to specified output file
|
||||
* Write to specified output file
|
||||
*/
|
||||
bool WriteNetlist( const wxString& aOutFileName, unsigned aNetlistOptions ) override;
|
||||
|
||||
///> @copydoc NETLIST_EXPORTER_BASE::Format()
|
||||
///< @copydoc NETLIST_EXPORTER_BASE::Format()
|
||||
bool Format( OUTPUTFORMATTER* aFormatter, unsigned aCtl );
|
||||
|
||||
/**
|
||||
* @brief Processes the netlist to create net mapping and a list of SPICE_ITEMs.
|
||||
* Process the netlist to create net mapping and a list of SPICE_ITEMs.
|
||||
* It is automatically called by WriteNetlist(), but might be used separately,
|
||||
* if only net mapping and the list of SPICE_ITEMs are required.
|
||||
* @return True if successful.
|
||||
|
@ -153,15 +152,14 @@ public:
|
|||
|
||||
|
||||
/**
|
||||
* @brief some chars are not accepted in netnames in spice netlists.
|
||||
* for instance '(' and ')'
|
||||
* ReplaceForbiddenChars replace these chars by an underscore.
|
||||
* @param aNetName = the netname to modify.
|
||||
* Replace illegal spice net name characters with an underscore.
|
||||
*
|
||||
* @param aNetName is the net name to modify.
|
||||
*/
|
||||
static void ReplaceForbiddenChars( wxString& aNetName );
|
||||
|
||||
/**
|
||||
* @brief Returns a map of circuit nodes to net names.
|
||||
* Return a map of circuit nodes to net names.
|
||||
*/
|
||||
const NET_INDEX_MAP& GetNetIndexMap() const
|
||||
{
|
||||
|
@ -169,7 +167,7 @@ public:
|
|||
}
|
||||
|
||||
/**
|
||||
* @brief Returns a vector of component field names related to Spice simulation.
|
||||
* Return a vector of component field names related to Spice simulation.
|
||||
*/
|
||||
static const std::vector<wxString>& GetSpiceFields()
|
||||
{
|
||||
|
@ -177,7 +175,7 @@ public:
|
|||
}
|
||||
|
||||
/**
|
||||
* @brief Returns a string used for a particular component field related to Spice simulation.
|
||||
* Return a string used for a particular component field related to Spice simulation.
|
||||
*/
|
||||
static const wxString& GetSpiceFieldName( SPICE_FIELD aField )
|
||||
{
|
||||
|
@ -185,22 +183,23 @@ public:
|
|||
}
|
||||
|
||||
/**
|
||||
* @brief Retrieves either the requested field value or the default value.
|
||||
* Retrieve either the requested field value or the default value.
|
||||
*/
|
||||
static wxString GetSpiceField( SPICE_FIELD aField, SCH_COMPONENT* aComponent, unsigned aCtl );
|
||||
|
||||
/**
|
||||
* @brief Retrieves the default value for a given field.
|
||||
* Retrieve the default value for a given field.
|
||||
*/
|
||||
static wxString GetSpiceFieldDefVal( SPICE_FIELD aField, SCH_COMPONENT* aComponent, unsigned aCtl );
|
||||
static wxString GetSpiceFieldDefVal( SPICE_FIELD aField, SCH_COMPONENT* aComponent,
|
||||
unsigned aCtl );
|
||||
|
||||
/**
|
||||
* Updates the vector of Spice directives placed in the schematics.
|
||||
* Update the vector of Spice directives placed in the schematics.
|
||||
*/
|
||||
void UpdateDirectives( unsigned aCtl );
|
||||
|
||||
/**
|
||||
* @brief Returnss a vector of Spice directives found in the schematics.
|
||||
* Return a vector of Spice directives found in the schematics.
|
||||
*/
|
||||
const std::vector<wxString> GetDirectives() const
|
||||
{
|
||||
|
@ -208,7 +207,7 @@ public:
|
|||
}
|
||||
|
||||
/**
|
||||
* @brief Convertes typical boolean string values (no/yes, true/false, 1/0) to a boolean value.
|
||||
* Convert typical boolean string values (no/yes, true/false, 1/0) to a boolean value.
|
||||
*/
|
||||
static bool StringToBool( const wxString& aStr )
|
||||
{
|
||||
|
@ -223,24 +222,24 @@ public:
|
|||
|
||||
protected:
|
||||
/**
|
||||
* @brief Saves the Spice directives.
|
||||
* Save the Spice directives.
|
||||
*/
|
||||
virtual void writeDirectives( OUTPUTFORMATTER* aFormatter, unsigned aCtl ) const;
|
||||
|
||||
private:
|
||||
///> Spice simulation title found in the processed schematic sheet
|
||||
///< Spice simulation title found in the processed schematic sheet
|
||||
wxString m_title;
|
||||
|
||||
///> Spice directives found in the processed schematic sheet
|
||||
///< Spice directives found in the processed schematic sheet
|
||||
std::vector<wxString> m_directives;
|
||||
|
||||
///> Libraries used by the simulated circuit
|
||||
///< Libraries used by the simulated circuit
|
||||
std::set<wxString> m_libraries;
|
||||
|
||||
///> Maps circuit nodes to net names
|
||||
///< Map circuit nodes to net names
|
||||
NET_INDEX_MAP m_netMap;
|
||||
|
||||
///> List of items representing schematic components in the Spice world
|
||||
///< List of items representing schematic components in the Spice world
|
||||
SPICE_ITEM_LIST m_spiceItems;
|
||||
|
||||
// Component fields that are processed during netlist export & simulation
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
/*
|
||||
* This program source code file is part of KiCad, a free EDA CAD application.
|
||||
*
|
||||
* Copyright (C) 2019 KiCad Developers, see AUTHORS.txt for contributors.
|
||||
* Copyright (C) 2019-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
|
||||
|
@ -54,11 +54,11 @@ public:
|
|||
protected:
|
||||
virtual void onPaint( wxPaintEvent& WXUNUSED( aEvent ) ) override;
|
||||
|
||||
///> @copydoc EDA_DRAW_PANEL_GAL::OnShow()
|
||||
///< @copydoc EDA_DRAW_PANEL_GAL::OnShow()
|
||||
void OnShow() override;
|
||||
|
||||
void setDefaultLayerOrder(); ///> Reassigns layer order to the initial settings.
|
||||
void setDefaultLayerDeps(); ///> Sets rendering targets & dependencies for layers.
|
||||
void setDefaultLayerOrder(); ///< Reassign layer order to the initial settings.
|
||||
void setDefaultLayerDeps(); ///< Set rendering targets & dependencies for layers.
|
||||
};
|
||||
|
||||
#endif // __SCH_DRAW_PANEL_H
|
||||
|
|
|
@ -2,7 +2,7 @@
|
|||
* This program source code file is part of KiCad, a free EDA CAD application.
|
||||
*
|
||||
* Copyright (C) 2017 CERN
|
||||
* Copyright (C) 2017-2020 Kicad Developers, see AUTHORS.txt for contributors.
|
||||
* Copyright (C) 2017-2021 Kicad Developers, see AUTHORS.txt for contributors.
|
||||
*
|
||||
* @author Alejandro García Montoro <alejandro.garciamontoro@gmail.com>
|
||||
* @author Maciej Suminski <maciej.suminski@cern.ch>
|
||||
|
@ -66,7 +66,7 @@
|
|||
|
||||
|
||||
// Eagle schematic axes are aligned with x increasing left to right and Y increasing bottom to top
|
||||
// Kicad schematic axes are aligned with x increasing left to right and Y increasing top to bottom.
|
||||
// KiCad schematic axes are aligned with x increasing left to right and Y increasing top to bottom.
|
||||
|
||||
using namespace std;
|
||||
|
||||
|
@ -87,7 +87,8 @@ static const std::map<wxString, ELECTRICAL_PINTYPE> pinDirectionsMap = {
|
|||
|
||||
|
||||
/**
|
||||
* Provides an easy access to the children of an XML node via their names.
|
||||
* Provide an easy access to the children of an XML node via their names.
|
||||
*
|
||||
* @param aCurrentNode is a pointer to a wxXmlNode, whose children will be mapped.
|
||||
* @param aName the name of the specific child names to be counted.
|
||||
* @return number of children with the give node name.
|
||||
|
@ -113,7 +114,7 @@ static int countChildren( wxXmlNode* aCurrentNode, const wxString& aName )
|
|||
}
|
||||
|
||||
|
||||
///> Computes a bounding box for all items in a schematic sheet
|
||||
///< Compute a bounding box for all items in a schematic sheet
|
||||
static EDA_RECT getSheetBbox( SCH_SHEET* aSheet )
|
||||
{
|
||||
EDA_RECT bbox;
|
||||
|
@ -125,7 +126,7 @@ static EDA_RECT getSheetBbox( SCH_SHEET* aSheet )
|
|||
}
|
||||
|
||||
|
||||
///> Extracts the net name part from a pin name (e.g. return 'GND' for pin named 'GND@2')
|
||||
///< Extract the net name part from a pin name (e.g. return 'GND' for pin named 'GND@2')
|
||||
static inline wxString extractNetName( const wxString& aPinName )
|
||||
{
|
||||
return aPinName.BeforeFirst( '@' );
|
||||
|
@ -183,8 +184,8 @@ void SCH_EAGLE_PLUGIN::loadLayerDefs( wxXmlNode* aLayers )
|
|||
for( const auto& elayer : eagleLayers )
|
||||
{
|
||||
/**
|
||||
* Layers in Kicad schematics are not actually layers, but abstract groups mainly used to
|
||||
* decide item colours.
|
||||
* Layers in KiCad schematics are not actually layers, but abstract groups mainly used to
|
||||
* decide item colors.
|
||||
*
|
||||
* <layers>
|
||||
* <layer number="90" name="Modules" color="5" fill="1" visible="yes" active="yes"/>
|
||||
|
@ -223,7 +224,7 @@ SCH_LAYER_ID SCH_EAGLE_PLUGIN::kiCadLayer( int aEagleLayer )
|
|||
}
|
||||
|
||||
|
||||
// Return the kicad component orientation based on eagle rotation degrees.
|
||||
// Return the KiCad component orientation based on eagle rotation degrees.
|
||||
static COMPONENT_ORIENTATION_T kiCadComponentRotation( float eagleDegrees )
|
||||
{
|
||||
int roti = int( eagleDegrees );
|
||||
|
@ -464,7 +465,7 @@ SCH_SHEET* SCH_EAGLE_PLUGIN::Load( const wxString& aFileName, SCHEMATIC* aSchema
|
|||
libTable->Format( &formatter, 0 );
|
||||
}
|
||||
|
||||
// Relaod the symbol library table.
|
||||
// Reload the symbol library table.
|
||||
m_schematic->Prj().SetElem( PROJECT::ELEM_SYMBOL_LIB_TABLE, NULL );
|
||||
m_schematic->Prj().SchSymbolLibTable();
|
||||
}
|
||||
|
@ -861,7 +862,7 @@ void SCH_EAGLE_PLUGIN::loadSegments(
|
|||
// wxCHECK( screen, [>void<] );
|
||||
while( currentSegment )
|
||||
{
|
||||
bool labelled = false; // has a label been added to this continously connected segment
|
||||
bool labelled = false; // has a label been added to this continuously connected segment
|
||||
NODE_MAP segmentChildren = MapChildren( currentSegment );
|
||||
SCH_LINE* firstWire = nullptr;
|
||||
m_segments.emplace_back();
|
||||
|
@ -941,7 +942,7 @@ void SCH_EAGLE_PLUGIN::loadSegments(
|
|||
segmentAttribute = segmentAttribute->GetNext();
|
||||
}
|
||||
|
||||
// Add a small label to the net segment if it hasn't been labelled already
|
||||
// Add a small label to the net segment if it hasn't been labeled already
|
||||
// this preserves the named net feature of Eagle schematics.
|
||||
if( !labelled && firstWire )
|
||||
{
|
||||
|
@ -1028,7 +1029,8 @@ SCH_TEXT* SCH_EAGLE_PLUGIN::loadLabel( wxXmlNode* aLabelNode, const wxString& aN
|
|||
|
||||
if( elabel.rot )
|
||||
{
|
||||
label->SetLabelSpinStyle( (LABEL_SPIN_STYLE::SPIN) ( KiROUND( elabel.rot->degrees / 90 ) % 4 ) );
|
||||
label->SetLabelSpinStyle(
|
||||
(LABEL_SPIN_STYLE::SPIN) ( KiROUND( elabel.rot->degrees / 90 ) % 4 ) );
|
||||
|
||||
if( elabel.rot->mirror )
|
||||
{
|
||||
|
@ -1095,7 +1097,7 @@ void SCH_EAGLE_PLUGIN::loadInstance( wxXmlNode* aInstanceNode )
|
|||
// Find the part in the list for the sheet.
|
||||
// Assign the component its value from the part entry
|
||||
// Calculate the unit number from the gate entry of the instance
|
||||
// Assign the the LIB_ID from deviceset and device names
|
||||
// Assign the the LIB_ID from device set and device names
|
||||
|
||||
auto part_it = m_partlist.find( einstance.part.Upper() );
|
||||
|
||||
|
@ -1319,7 +1321,7 @@ EAGLE_LIBRARY* SCH_EAGLE_PLUGIN::loadLibrary(
|
|||
symbolNode = symbolNode->GetNext();
|
||||
}
|
||||
|
||||
// Loop through the devicesets and load each of them
|
||||
// Loop through the device sets and load each of them
|
||||
wxXmlNode* devicesetNode = getChildrenNodes( libraryChildren, "devicesets" );
|
||||
|
||||
while( devicesetNode )
|
||||
|
@ -1989,7 +1991,7 @@ void SCH_EAGLE_PLUGIN::addBusEntries()
|
|||
// Add bus entry symbols
|
||||
// TODO: Cleanup this function and break into pieces
|
||||
|
||||
// for each wire segment, compare each end with all busess.
|
||||
// for each wire segment, compare each end with all busses.
|
||||
// If the wire end is found to end on a bus segment, place a bus entry symbol.
|
||||
|
||||
for( auto it1 = m_currentSheet->GetScreen()->Items().OfType( SCH_LINE_T ).begin();
|
||||
|
@ -2190,7 +2192,7 @@ void SCH_EAGLE_PLUGIN::addBusEntries()
|
|||
// If wire end is above the bus,
|
||||
if( lineend.y < busstart.y )
|
||||
{
|
||||
// Test for bus existance to the left of the wire
|
||||
// Test for bus existence to the left of the wire
|
||||
if( TestSegmentHit(
|
||||
linestart + wxPoint( -100, 0 ), busstart, busend, 0 ) )
|
||||
{
|
||||
|
@ -2222,7 +2224,7 @@ void SCH_EAGLE_PLUGIN::addBusEntries()
|
|||
}
|
||||
else // wire end is below the bus.
|
||||
{
|
||||
// Test for bus existance to the left of the wire
|
||||
// Test for bus existence to the left of the wire
|
||||
if( TestSegmentHit(
|
||||
linestart + wxPoint( -100, 0 ), busstart, busend, 0 ) )
|
||||
{
|
||||
|
@ -2261,7 +2263,7 @@ void SCH_EAGLE_PLUGIN::addBusEntries()
|
<