939 lines
28 KiB
C++
939 lines
28 KiB
C++
/*
|
|
* This program source code file is part of KiCad, a free EDA CAD application.
|
|
*
|
|
* Copyright (C) 2015 Jean-Pierre Charras, jp.charras at wanadoo.fr
|
|
* Copyright (C) 2004-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
|
|
*/
|
|
|
|
/*
|
|
* Fields are texts attached to a symbol, some of which have a special meaning.
|
|
* Fields 0 and 1 are very important: reference and value.
|
|
* Field 2 is used as default footprint name.
|
|
* Field 3 is used to point to a datasheet (usually a URL).
|
|
* Fields 4+ are user fields. They can be renamed and can appear in reports.
|
|
*/
|
|
|
|
#include <wx/log.h>
|
|
#include <wx/menu.h>
|
|
#include <common.h> // for ExpandTextVars
|
|
#include <eda_item.h>
|
|
#include <sch_edit_frame.h>
|
|
#include <plotters/plotter.h>
|
|
#include <bitmaps.h>
|
|
#include <core/kicad_algo.h>
|
|
#include <core/mirror.h>
|
|
#include <kiway.h>
|
|
#include <general.h>
|
|
#include <symbol_library.h>
|
|
#include <sch_symbol.h>
|
|
#include <sch_field.h>
|
|
#include <schematic.h>
|
|
#include <settings/color_settings.h>
|
|
#include <string_utils.h>
|
|
#include <trace_helpers.h>
|
|
#include <trigo.h>
|
|
#include <eeschema_id.h>
|
|
#include <tool/tool_manager.h>
|
|
#include <tools/ee_actions.h>
|
|
|
|
SCH_FIELD::SCH_FIELD( const VECTOR2I& aPos, int aFieldId, SCH_ITEM* aParent,
|
|
const wxString& aName ) :
|
|
SCH_ITEM( aParent, SCH_FIELD_T ),
|
|
EDA_TEXT( wxEmptyString ),
|
|
m_id( 0 ),
|
|
m_name( aName )
|
|
{
|
|
SetTextPos( aPos );
|
|
SetId( aFieldId ); // will also set the layer
|
|
SetVisible( false );
|
|
}
|
|
|
|
|
|
SCH_FIELD::~SCH_FIELD()
|
|
{
|
|
}
|
|
|
|
|
|
EDA_ITEM* SCH_FIELD::Clone() const
|
|
{
|
|
return new SCH_FIELD( *this );
|
|
}
|
|
|
|
|
|
void SCH_FIELD::SetId( int aId )
|
|
{
|
|
KICAD_T labelTypes[] = { SCH_LABEL_LOCATE_ANY_T, EOT };
|
|
|
|
m_id = aId;
|
|
|
|
if( m_parent && m_parent->Type() == SCH_SHEET_T )
|
|
{
|
|
switch( m_id )
|
|
{
|
|
case SHEETNAME: SetLayer( LAYER_SHEETNAME ); break;
|
|
case SHEETFILENAME: SetLayer( LAYER_SHEETFILENAME ); break;
|
|
default: SetLayer( LAYER_SHEETFIELDS ); break;
|
|
}
|
|
}
|
|
else if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
{
|
|
switch( m_id )
|
|
{
|
|
case REFERENCE_FIELD: SetLayer( LAYER_REFERENCEPART ); break;
|
|
case VALUE_FIELD: SetLayer( LAYER_VALUEPART ); break;
|
|
default: SetLayer( LAYER_FIELDS ); break;
|
|
}
|
|
}
|
|
else if( m_parent && m_parent->IsType( labelTypes ) )
|
|
{
|
|
// We can't use defined IDs for labels because there can be multiple net class
|
|
// assignments.
|
|
|
|
if( GetCanonicalName() == wxT( "Netclass" ) )
|
|
SetLayer( LAYER_NETCLASS_REFS );
|
|
else if( GetCanonicalName() == wxT( "Intersheetrefs" ) )
|
|
SetLayer( LAYER_INTERSHEET_REFS );
|
|
else
|
|
SetLayer( LAYER_FIELDS );
|
|
}
|
|
}
|
|
|
|
|
|
wxString SCH_FIELD::GetShownText( int aDepth ) const
|
|
{
|
|
KICAD_T labelTypes[] = { SCH_LABEL_LOCATE_ANY_T, EOT };
|
|
|
|
std::function<bool( wxString* )> symbolResolver =
|
|
[&]( wxString* token ) -> bool
|
|
{
|
|
if( token->Contains( ':' ) )
|
|
{
|
|
if( Schematic()->ResolveCrossReference( token, aDepth ) )
|
|
return true;
|
|
}
|
|
else
|
|
{
|
|
SCH_SYMBOL* parentSymbol = static_cast<SCH_SYMBOL*>( m_parent );
|
|
|
|
if( parentSymbol->ResolveTextVar( token, aDepth + 1 ) )
|
|
return true;
|
|
|
|
SCHEMATIC* schematic = parentSymbol->Schematic();
|
|
SCH_SHEET* sheet = schematic ? schematic->CurrentSheet().Last() : nullptr;
|
|
|
|
if( sheet && sheet->ResolveTextVar( token, aDepth + 1 ) )
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
};
|
|
|
|
std::function<bool( wxString* )> sheetResolver =
|
|
[&]( wxString* token ) -> bool
|
|
{
|
|
SCH_SHEET* sheet = static_cast<SCH_SHEET*>( m_parent );
|
|
return sheet->ResolveTextVar( token, aDepth + 1 );
|
|
};
|
|
|
|
std::function<bool( wxString* )> labelResolver =
|
|
[&]( wxString* token ) -> bool
|
|
{
|
|
SCH_LABEL_BASE* label = static_cast<SCH_LABEL_BASE*>( m_parent );
|
|
return label->ResolveTextVar( token, aDepth + 1 );
|
|
};
|
|
|
|
PROJECT* project = nullptr;
|
|
wxString text = EDA_TEXT::GetShownText();
|
|
|
|
if( text == "~" ) // Legacy placeholder for empty string
|
|
{
|
|
text = "";
|
|
}
|
|
else if( HasTextVars() )
|
|
{
|
|
if( Schematic() )
|
|
project = &Schematic()->Prj();
|
|
|
|
if( aDepth < 10 )
|
|
{
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
text = ExpandTextVars( text, &symbolResolver, nullptr, project );
|
|
else if( m_parent && m_parent->Type() == SCH_SHEET_T )
|
|
text = ExpandTextVars( text, &sheetResolver, nullptr, project );
|
|
else if( m_parent && m_parent->IsType( labelTypes ) )
|
|
text = ExpandTextVars( text, &labelResolver, nullptr, project );
|
|
else
|
|
text = ExpandTextVars( text, project );
|
|
}
|
|
}
|
|
|
|
// WARNING: the IDs of FIELDS and SHEETS overlap, so one must check *both* the
|
|
// id and the parent's type.
|
|
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
{
|
|
SCH_SYMBOL* parentSymbol = static_cast<SCH_SYMBOL*>( m_parent );
|
|
|
|
if( m_id == REFERENCE_FIELD )
|
|
{
|
|
// For more than one part per package, we must add the part selection
|
|
// A, B, ... or 1, 2, .. to the reference.
|
|
if( parentSymbol->GetUnitCount() > 1 )
|
|
text << LIB_SYMBOL::SubReference( parentSymbol->GetUnit() );
|
|
}
|
|
}
|
|
else if( m_parent && m_parent->Type() == SCH_SHEET_T )
|
|
{
|
|
if( m_id == SHEETFILENAME )
|
|
text = _( "File:" ) + wxS( " " )+ text;
|
|
}
|
|
|
|
return text;
|
|
}
|
|
|
|
|
|
int SCH_FIELD::GetPenWidth() const
|
|
{
|
|
return GetEffectiveTextPenWidth();
|
|
}
|
|
|
|
|
|
void SCH_FIELD::Print( const RENDER_SETTINGS* aSettings, const VECTOR2I& aOffset )
|
|
{
|
|
wxDC* DC = aSettings->GetPrintDC();
|
|
COLOR4D color = aSettings->GetLayerColor( IsForceVisible() ? LAYER_HIDDEN : m_layer );
|
|
VECTOR2I textpos;
|
|
int penWidth = GetEffectiveTextPenWidth( aSettings->GetDefaultPenWidth() );
|
|
|
|
if( ( !IsVisible() && !IsForceVisible() ) || IsVoid() )
|
|
return;
|
|
|
|
// Calculate the text orientation according to the symbol orientation.
|
|
EDA_ANGLE orient = GetTextAngle();
|
|
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
{
|
|
SCH_SYMBOL* parentSymbol = static_cast<SCH_SYMBOL*>( m_parent );
|
|
|
|
if( parentSymbol && parentSymbol->GetTransform().y1 ) // Rotate symbol 90 degrees.
|
|
{
|
|
if( orient == EDA_ANGLE::HORIZONTAL )
|
|
orient = EDA_ANGLE::VERTICAL;
|
|
else
|
|
orient = EDA_ANGLE::HORIZONTAL;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Calculate the text justification, according to the symbol orientation/mirror.
|
|
* This is a bit complicated due to cumulative calculations:
|
|
* - numerous cases (mirrored or not, rotation)
|
|
* - the GRText function will also recalculate H and V justifications according to the text
|
|
* orientation.
|
|
* - When a symbol is mirrored, the text is not mirrored and justifications are complicated
|
|
* to calculate so the more easily way is to use no justifications (centered text) and use
|
|
* GetBoundingBox to know the text coordinate considered as centered
|
|
*/
|
|
textpos = GetBoundingBox().Centre() + aOffset;
|
|
|
|
GRText( DC, textpos, color, GetShownText(), orient, GetTextSize(), GR_TEXT_H_ALIGN_CENTER,
|
|
GR_TEXT_V_ALIGN_CENTER, penWidth, IsItalic(), IsBold(), GetFont() );
|
|
}
|
|
|
|
|
|
void SCH_FIELD::ImportValues( const LIB_FIELD& aSource )
|
|
{
|
|
SetAttributes( aSource );
|
|
}
|
|
|
|
|
|
void SCH_FIELD::SwapData( SCH_ITEM* aItem )
|
|
{
|
|
wxCHECK_RET( ( aItem != nullptr ) && ( aItem->Type() == SCH_FIELD_T ),
|
|
wxT( "Cannot swap field data with invalid item." ) );
|
|
|
|
SCH_FIELD* item = (SCH_FIELD*) aItem;
|
|
|
|
std::swap( m_layer, item->m_layer );
|
|
SwapText( *item );
|
|
SwapAttributes( *item );
|
|
}
|
|
|
|
|
|
EDA_ANGLE SCH_FIELD::GetDrawRotation() const
|
|
{
|
|
// Calculate the text orientation according to the symbol orientation.
|
|
EDA_ANGLE orient = GetTextAngle();
|
|
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
{
|
|
SCH_SYMBOL* parentSymbol = static_cast<SCH_SYMBOL*>( m_parent );
|
|
|
|
if( parentSymbol && parentSymbol->GetTransform().y1 ) // Rotate symbol 90 degrees.
|
|
{
|
|
if( orient.IsHorizontal() )
|
|
orient = EDA_ANGLE::VERTICAL;
|
|
else
|
|
orient = EDA_ANGLE::HORIZONTAL;
|
|
}
|
|
}
|
|
|
|
return orient;
|
|
}
|
|
|
|
|
|
VECTOR2I SCH_FIELD::GetDrawPos() const
|
|
{
|
|
return GetBoundingBox().Centre();
|
|
}
|
|
|
|
|
|
GR_TEXT_H_ALIGN_T SCH_FIELD::GetDrawHorizJustify() const
|
|
{
|
|
return GR_TEXT_H_ALIGN_CENTER;
|
|
}
|
|
|
|
|
|
GR_TEXT_V_ALIGN_T SCH_FIELD::GetDrawVertJustify() const
|
|
{
|
|
return GR_TEXT_V_ALIGN_CENTER;
|
|
}
|
|
|
|
|
|
const EDA_RECT SCH_FIELD::GetBoundingBox() const
|
|
{
|
|
// Calculate the text bounding box:
|
|
EDA_RECT rect = GetTextBox();
|
|
|
|
// Calculate the bounding box position relative to the parent:
|
|
VECTOR2I origin = GetParentPosition();
|
|
VECTOR2I pos = GetTextPos() - origin;
|
|
VECTOR2I begin = rect.GetOrigin() - origin;
|
|
VECTOR2I end = rect.GetEnd() - origin;
|
|
RotatePoint( begin, pos, GetTextAngle() );
|
|
RotatePoint( end, pos, GetTextAngle() );
|
|
|
|
// Now, apply the symbol transform (mirror/rot)
|
|
TRANSFORM transform;
|
|
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
{
|
|
SCH_SYMBOL* parentSymbol = static_cast<SCH_SYMBOL*>( m_parent );
|
|
|
|
// Due to the Y axis direction, we must mirror the bounding box,
|
|
// relative to the text position:
|
|
MIRROR( begin.y, pos.y );
|
|
MIRROR( end.y, pos.y );
|
|
|
|
transform = parentSymbol->GetTransform();
|
|
}
|
|
else
|
|
{
|
|
transform = TRANSFORM( 1, 0, 0, 1 ); // identity transform
|
|
}
|
|
|
|
rect.SetOrigin( transform.TransformCoordinate( begin ) );
|
|
rect.SetEnd( transform.TransformCoordinate( end ) );
|
|
|
|
rect.Move( origin );
|
|
rect.Normalize();
|
|
|
|
return rect;
|
|
}
|
|
|
|
|
|
bool SCH_FIELD::IsHorizJustifyFlipped() const
|
|
{
|
|
VECTOR2I render_center = GetBoundingBox().Centre();
|
|
VECTOR2I pos = GetPosition();
|
|
|
|
switch( GetHorizJustify() )
|
|
{
|
|
case GR_TEXT_H_ALIGN_LEFT:
|
|
if( GetDrawRotation().IsVertical() )
|
|
return render_center.y > pos.y;
|
|
else
|
|
return render_center.x < pos.x;
|
|
case GR_TEXT_H_ALIGN_RIGHT:
|
|
if( GetDrawRotation().IsVertical() )
|
|
return render_center.y < pos.y;
|
|
else
|
|
return render_center.x > pos.x;
|
|
default:
|
|
return false;
|
|
}
|
|
}
|
|
|
|
|
|
GR_TEXT_H_ALIGN_T SCH_FIELD::GetEffectiveHorizJustify() const
|
|
{
|
|
switch( GetHorizJustify() )
|
|
{
|
|
case GR_TEXT_H_ALIGN_LEFT:
|
|
return IsHorizJustifyFlipped() ? GR_TEXT_H_ALIGN_RIGHT : GR_TEXT_H_ALIGN_LEFT;
|
|
case GR_TEXT_H_ALIGN_RIGHT:
|
|
return IsHorizJustifyFlipped() ? GR_TEXT_H_ALIGN_LEFT : GR_TEXT_H_ALIGN_RIGHT;
|
|
default:
|
|
return GR_TEXT_H_ALIGN_CENTER;
|
|
}
|
|
}
|
|
|
|
|
|
bool SCH_FIELD::IsVertJustifyFlipped() const
|
|
{
|
|
VECTOR2I render_center = GetBoundingBox().Centre();
|
|
VECTOR2I pos = GetPosition();
|
|
|
|
switch( GetVertJustify() )
|
|
{
|
|
case GR_TEXT_V_ALIGN_TOP:
|
|
if( GetDrawRotation().IsVertical() )
|
|
return render_center.x < pos.x;
|
|
else
|
|
return render_center.y < pos.y;
|
|
case GR_TEXT_V_ALIGN_BOTTOM:
|
|
if( GetDrawRotation().IsVertical() )
|
|
return render_center.x > pos.x;
|
|
else
|
|
return render_center.y > pos.y;
|
|
default:
|
|
return false;
|
|
}
|
|
}
|
|
|
|
|
|
GR_TEXT_V_ALIGN_T SCH_FIELD::GetEffectiveVertJustify() const
|
|
{
|
|
switch( GetVertJustify() )
|
|
{
|
|
case GR_TEXT_V_ALIGN_TOP:
|
|
return IsVertJustifyFlipped() ? GR_TEXT_V_ALIGN_BOTTOM : GR_TEXT_V_ALIGN_TOP;
|
|
case GR_TEXT_V_ALIGN_BOTTOM:
|
|
return IsVertJustifyFlipped() ? GR_TEXT_V_ALIGN_TOP : GR_TEXT_V_ALIGN_BOTTOM;
|
|
default:
|
|
return GR_TEXT_V_ALIGN_CENTER;
|
|
}
|
|
}
|
|
|
|
|
|
bool SCH_FIELD::IsVoid() const
|
|
{
|
|
return GetText().Len() == 0;
|
|
}
|
|
|
|
|
|
bool SCH_FIELD::Matches( const wxFindReplaceData& aSearchData, void* aAuxData ) const
|
|
{
|
|
wxString text = GetShownText();
|
|
int flags = aSearchData.GetFlags();
|
|
bool searchHiddenFields = flags & FR_SEARCH_ALL_FIELDS;
|
|
bool searchAndReplace = flags & FR_SEARCH_REPLACE;
|
|
bool replaceReferences = flags & FR_REPLACE_REFERENCES;
|
|
|
|
wxLogTrace( traceFindItem, wxT( " child item " )
|
|
+ GetSelectMenuText( EDA_UNITS::MILLIMETRES ) );
|
|
|
|
if( !IsVisible() && !searchHiddenFields )
|
|
return false;
|
|
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T && m_id == REFERENCE_FIELD )
|
|
{
|
|
if( searchAndReplace && !replaceReferences )
|
|
return false;
|
|
|
|
SCH_SYMBOL* parentSymbol = static_cast<SCH_SYMBOL*>( m_parent );
|
|
wxASSERT( aAuxData );
|
|
|
|
// Take sheet path into account which effects the reference field and the unit for
|
|
// symbols with multiple parts.
|
|
if( aAuxData )
|
|
{
|
|
text = parentSymbol->GetRef((SCH_SHEET_PATH*) aAuxData );
|
|
|
|
if( SCH_ITEM::Matches( text, aSearchData ) )
|
|
return true;
|
|
|
|
if( parentSymbol->GetUnitCount() > 1 )
|
|
text << LIB_SYMBOL::SubReference( parentSymbol->GetUnit() );
|
|
}
|
|
}
|
|
|
|
return SCH_ITEM::Matches( text, aSearchData );
|
|
}
|
|
|
|
|
|
bool SCH_FIELD::IsReplaceable() const
|
|
{
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
{
|
|
SCH_SYMBOL* parentSymbol = static_cast<SCH_SYMBOL*>( m_parent );
|
|
|
|
if( m_id == VALUE_FIELD )
|
|
{
|
|
if( parentSymbol->GetLibSymbolRef() && parentSymbol->GetLibSymbolRef()->IsPower() )
|
|
return false;
|
|
}
|
|
}
|
|
else if( m_parent && m_parent->Type() == SCH_SHEET_T )
|
|
{
|
|
// See comments in SCH_FIELD::Replace(), below.
|
|
if( m_id == SHEETFILENAME )
|
|
return false;
|
|
}
|
|
else if( m_parent && m_parent->Type() == SCH_GLOBAL_LABEL_T )
|
|
{
|
|
if( m_id == 0 /* IntersheetRefs */ )
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
|
|
bool SCH_FIELD::Replace( const wxFindReplaceData& aSearchData, void* aAuxData )
|
|
{
|
|
wxString text;
|
|
bool resolve = false; // Replace in source text, not shown text
|
|
bool isReplaced = false;
|
|
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
{
|
|
SCH_SYMBOL* parentSymbol = static_cast<SCH_SYMBOL*>( m_parent );
|
|
|
|
switch( m_id )
|
|
{
|
|
case REFERENCE_FIELD:
|
|
wxCHECK_MSG( aAuxData, false, wxT( "Need sheetpath to replace in refdes." ) );
|
|
|
|
if( !( aSearchData.GetFlags() & FR_REPLACE_REFERENCES ) )
|
|
return false;
|
|
|
|
text = parentSymbol->GetRef( (SCH_SHEET_PATH*) aAuxData );
|
|
isReplaced = EDA_ITEM::Replace( aSearchData, text );
|
|
|
|
if( isReplaced )
|
|
parentSymbol->SetRef( (SCH_SHEET_PATH*) aAuxData, text );
|
|
|
|
break;
|
|
|
|
case VALUE_FIELD:
|
|
wxCHECK_MSG( aAuxData, false, wxT( "Need sheetpath to replace in value field." ) );
|
|
|
|
text = parentSymbol->GetValue((SCH_SHEET_PATH*) aAuxData, resolve );
|
|
isReplaced = EDA_ITEM::Replace( aSearchData, text );
|
|
|
|
if( isReplaced )
|
|
parentSymbol->SetValue( (SCH_SHEET_PATH*) aAuxData, text );
|
|
|
|
break;
|
|
|
|
case FOOTPRINT_FIELD:
|
|
wxCHECK_MSG( aAuxData, false, wxT( "Need sheetpath to replace in footprint field." ) );
|
|
|
|
text = parentSymbol->GetFootprint((SCH_SHEET_PATH*) aAuxData, resolve );
|
|
isReplaced = EDA_ITEM::Replace( aSearchData, text );
|
|
|
|
if( isReplaced )
|
|
parentSymbol->SetFootprint( (SCH_SHEET_PATH*) aAuxData, text );
|
|
|
|
break;
|
|
|
|
default:
|
|
isReplaced = EDA_TEXT::Replace( aSearchData );
|
|
}
|
|
}
|
|
else if( m_parent && m_parent->Type() == SCH_SHEET_T )
|
|
{
|
|
isReplaced = EDA_TEXT::Replace( aSearchData );
|
|
|
|
if( m_id == SHEETFILENAME && isReplaced )
|
|
{
|
|
// If we allowed this we'd have a bunch of work to do here, including warning
|
|
// about it not being undoable, checking for recursive hierarchies, reloading
|
|
// sheets, etc. See DIALOG_SHEET_PROPERTIES::TransferDataFromWindow().
|
|
}
|
|
}
|
|
else
|
|
{
|
|
isReplaced = EDA_TEXT::Replace( aSearchData );
|
|
}
|
|
|
|
return isReplaced;
|
|
}
|
|
|
|
|
|
void SCH_FIELD::Rotate( const VECTOR2I& aCenter )
|
|
{
|
|
VECTOR2I pt = GetPosition();
|
|
RotatePoint( pt, aCenter, 900 );
|
|
SetPosition( pt );
|
|
}
|
|
|
|
|
|
wxString SCH_FIELD::GetSelectMenuText( EDA_UNITS aUnits ) const
|
|
{
|
|
return wxString::Format( "%s '%s'", GetName(), ShortenedShownText() );
|
|
}
|
|
|
|
|
|
void SCH_FIELD::GetMsgPanelInfo( EDA_DRAW_FRAME* aFrame, std::vector<MSG_PANEL_ITEM>& aList )
|
|
{
|
|
wxString msg;
|
|
|
|
aList.emplace_back( _( "Symbol Field" ), GetName() );
|
|
|
|
// Don't use GetShownText() here; we want to show the user the variable references
|
|
aList.emplace_back( _( "Text" ), UnescapeString( GetText() ) );
|
|
|
|
aList.emplace_back( _( "Visible" ), IsVisible() ? _( "Yes" ) : _( "No" ) );
|
|
|
|
aList.emplace_back( _( "Style" ), GetTextStyleName() );
|
|
|
|
aList.emplace_back( _( "Text Size" ), MessageTextFromValue( aFrame->GetUserUnits(),
|
|
GetTextWidth() ) );
|
|
|
|
switch ( GetHorizJustify() )
|
|
{
|
|
case GR_TEXT_H_ALIGN_LEFT: msg = _( "Left" ); break;
|
|
case GR_TEXT_H_ALIGN_CENTER: msg = _( "Center" ); break;
|
|
case GR_TEXT_H_ALIGN_RIGHT: msg = _( "Right" ); break;
|
|
}
|
|
|
|
aList.emplace_back( _( "H Justification" ), msg );
|
|
|
|
switch ( GetVertJustify() )
|
|
{
|
|
case GR_TEXT_V_ALIGN_TOP: msg = _( "Top" ); break;
|
|
case GR_TEXT_V_ALIGN_CENTER: msg = _( "Center" ); break;
|
|
case GR_TEXT_V_ALIGN_BOTTOM: msg = _( "Bottom" ); break;
|
|
}
|
|
|
|
aList.emplace_back( _( "V Justification" ), msg );
|
|
}
|
|
|
|
|
|
void SCH_FIELD::DoHypertextMenu( EDA_DRAW_FRAME* aFrame )
|
|
{
|
|
constexpr int START_ID = 1;
|
|
|
|
static wxString back = "HYPERTEXT_BACK";
|
|
wxMenu menu;
|
|
SCH_TEXT* label = dynamic_cast<SCH_TEXT*>( m_parent );
|
|
|
|
if( label && Schematic() )
|
|
{
|
|
auto it = Schematic()->GetPageRefsMap().find( label->GetText() );
|
|
|
|
if( it != Schematic()->GetPageRefsMap().end() )
|
|
{
|
|
std::map<wxString, wxString> sheetNames;
|
|
std::vector<wxString> pageListCopy;
|
|
|
|
pageListCopy.insert( pageListCopy.end(), it->second.begin(), it->second.end() );
|
|
if( !Schematic()->Settings().m_IntersheetRefsListOwnPage )
|
|
{
|
|
wxString currentPage = Schematic()->CurrentSheet().GetPageNumber();
|
|
alg::delete_matching( pageListCopy, currentPage );
|
|
|
|
if( pageListCopy.empty() )
|
|
return;
|
|
}
|
|
|
|
std::sort( pageListCopy.begin(), pageListCopy.end(),
|
|
[]( const wxString& a, const wxString& b ) -> bool
|
|
{
|
|
return StrNumCmp( a, b, true ) < 0;
|
|
} );
|
|
|
|
for( const SCH_SHEET_PATH& sheet : Schematic()->GetSheets() )
|
|
{
|
|
if( sheet.size() == 1 )
|
|
sheetNames[ sheet.GetPageNumber() ] = _( "<root sheet>" );
|
|
else
|
|
sheetNames[ sheet.GetPageNumber() ] = sheet.Last()->GetName();
|
|
}
|
|
|
|
for( int i = 0; i < (int) pageListCopy.size(); ++i )
|
|
{
|
|
menu.Append( i + START_ID, wxString::Format( _( "Go to Page %s (%s)" ),
|
|
pageListCopy[i],
|
|
sheetNames[ pageListCopy[i] ] ) );
|
|
}
|
|
|
|
menu.AppendSeparator();
|
|
menu.Append( 999, _( "Back to Previous Selected Sheet" ) );
|
|
|
|
int sel = aFrame->GetPopupMenuSelectionFromUser( menu ) - START_ID;
|
|
void* param = nullptr;
|
|
|
|
if( sel >= 0 && sel < (int) pageListCopy.size() )
|
|
param = (void*) &pageListCopy[ sel ];
|
|
else if( sel == 999 )
|
|
param = (void*) &back;
|
|
|
|
if( param )
|
|
aFrame->GetToolManager()->RunAction( EE_ACTIONS::hypertextCommand, true, param );
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
wxString SCH_FIELD::GetName( bool aUseDefaultName ) const
|
|
{
|
|
KICAD_T labelTypes[] = { SCH_LABEL_LOCATE_ANY_T, EOT };
|
|
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
{
|
|
if( m_id < MANDATORY_FIELDS )
|
|
return TEMPLATE_FIELDNAME::GetDefaultFieldName( m_id );
|
|
else if( m_name.IsEmpty() && aUseDefaultName )
|
|
return TEMPLATE_FIELDNAME::GetDefaultFieldName( m_id );
|
|
else
|
|
return m_name;
|
|
}
|
|
else if( m_parent && m_parent->Type() == SCH_SHEET_T )
|
|
{
|
|
if( m_id < SHEET_MANDATORY_FIELDS )
|
|
return SCH_SHEET::GetDefaultFieldName( m_id );
|
|
else if( m_name.IsEmpty() && aUseDefaultName )
|
|
return SCH_SHEET::GetDefaultFieldName( m_id );
|
|
else
|
|
return m_name;
|
|
}
|
|
else if( m_parent && m_parent->IsType( labelTypes ) )
|
|
{
|
|
return SCH_LABEL_BASE::GetDefaultFieldName( m_name, aUseDefaultName );
|
|
}
|
|
else
|
|
{
|
|
wxFAIL_MSG( "Unhandled field owner type." );
|
|
return m_name;
|
|
}
|
|
}
|
|
|
|
|
|
wxString SCH_FIELD::GetCanonicalName() const
|
|
{
|
|
KICAD_T labelTypes[] = { SCH_LABEL_LOCATE_ANY_T, EOT };
|
|
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
{
|
|
switch( m_id )
|
|
{
|
|
case REFERENCE_FIELD: return wxT( "Reference" );
|
|
case VALUE_FIELD: return wxT( "Value" );
|
|
case FOOTPRINT_FIELD: return wxT( "Footprint" );
|
|
case DATASHEET_FIELD: return wxT( "Datasheet" );
|
|
default: return m_name;
|
|
}
|
|
}
|
|
else if( m_parent && m_parent->Type() == SCH_SHEET_T )
|
|
{
|
|
switch( m_id )
|
|
{
|
|
case SHEETNAME: return wxT( "Sheetname" );
|
|
case SHEETFILENAME: return wxT( "Sheetfile" );
|
|
default: return m_name;
|
|
}
|
|
}
|
|
else if( m_parent && m_parent->IsType( labelTypes ) )
|
|
{
|
|
// These should be stored in canonical format, but just in case:
|
|
if( m_name == _( "Net Class" ) )
|
|
return wxT( "Netclass" );
|
|
else if (m_name == _( "Sheet References" ) )
|
|
return wxT( "Intersheetrefs" );
|
|
else
|
|
return m_name;
|
|
}
|
|
else
|
|
{
|
|
if( m_parent )
|
|
{
|
|
wxFAIL_MSG( wxString::Format( "Unhandled field owner type (id %d, parent type %d).",
|
|
m_id, m_parent->Type() ) );
|
|
}
|
|
|
|
return m_name;
|
|
}
|
|
}
|
|
|
|
|
|
BITMAPS SCH_FIELD::GetMenuImage() const
|
|
{
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
{
|
|
switch( m_id )
|
|
{
|
|
case REFERENCE_FIELD: return BITMAPS::edit_comp_ref;
|
|
case VALUE_FIELD: return BITMAPS::edit_comp_value;
|
|
case FOOTPRINT_FIELD: return BITMAPS::edit_comp_footprint;
|
|
default: return BITMAPS::text;
|
|
}
|
|
}
|
|
|
|
return BITMAPS::text;
|
|
}
|
|
|
|
|
|
bool SCH_FIELD::HitTest( const VECTOR2I& aPosition, int aAccuracy ) const
|
|
{
|
|
// Do not hit test hidden or empty fields.
|
|
if( !IsVisible() || IsVoid() )
|
|
return false;
|
|
|
|
EDA_RECT rect = GetBoundingBox();
|
|
|
|
rect.Inflate( aAccuracy );
|
|
|
|
return rect.Contains( aPosition );
|
|
}
|
|
|
|
|
|
bool SCH_FIELD::HitTest( const EDA_RECT& aRect, bool aContained, int aAccuracy ) const
|
|
{
|
|
// Do not hit test hidden fields.
|
|
if( !IsVisible() || IsVoid() )
|
|
return false;
|
|
|
|
EDA_RECT rect = aRect;
|
|
|
|
rect.Inflate( aAccuracy );
|
|
|
|
if( aContained )
|
|
return rect.Contains( GetBoundingBox() );
|
|
|
|
return rect.Intersects( GetBoundingBox() );
|
|
}
|
|
|
|
|
|
void SCH_FIELD::Plot( PLOTTER* aPlotter ) const
|
|
{
|
|
RENDER_SETTINGS* settings = aPlotter->RenderSettings();
|
|
COLOR4D color = settings->GetLayerColor( GetLayer() );
|
|
int penWidth = GetEffectiveTextPenWidth( settings->GetDefaultPenWidth() );
|
|
|
|
penWidth = std::max( penWidth, settings->GetMinPenWidth() );
|
|
|
|
if( !IsVisible() )
|
|
return;
|
|
|
|
if( IsVoid() )
|
|
return;
|
|
|
|
// Calculate the text orientation, according to the symbol orientation/mirror
|
|
EDA_ANGLE orient = GetTextAngle();
|
|
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
{
|
|
SCH_SYMBOL* parentSymbol = static_cast<SCH_SYMBOL*>( m_parent );
|
|
|
|
if( parentSymbol->GetTransform().y1 ) // Rotate symbol 90 deg.
|
|
{
|
|
if( orient.IsHorizontal() )
|
|
orient = EDA_ANGLE::VERTICAL;
|
|
else
|
|
orient = EDA_ANGLE::HORIZONTAL;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Calculate the text justification, according to the symbol orientation/mirror.
|
|
* This is a bit complicated due to cumulative calculations:
|
|
* - numerous cases (mirrored or not, rotation)
|
|
* - the plotter's Text function will also recalculate H and V justifications according to
|
|
* the text orientation.
|
|
* - When a symbol is mirrored, the text is not mirrored and justifications are complicated
|
|
* to calculate so the easier way is to use no justifications (centered text) and use
|
|
* GetBoundingBox to know the text coordinate considered as centered
|
|
*/
|
|
GR_TEXT_H_ALIGN_T hjustify = GR_TEXT_H_ALIGN_CENTER;
|
|
GR_TEXT_V_ALIGN_T vjustify = GR_TEXT_V_ALIGN_CENTER;
|
|
VECTOR2I textpos = GetBoundingBox().Centre();
|
|
|
|
aPlotter->Text( textpos, color, GetShownText(), orient, GetTextSize(), hjustify, vjustify,
|
|
penWidth, IsItalic(), IsBold() );
|
|
}
|
|
|
|
|
|
void SCH_FIELD::SetPosition( const VECTOR2I& aPosition )
|
|
{
|
|
// Actual positions are calculated by the rotation/mirror transform of the parent symbol
|
|
// of the field. The inverse transform is used to calculate the position relative to the
|
|
// parent symbol.
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
{
|
|
SCH_SYMBOL* parentSymbol = static_cast<SCH_SYMBOL*>( m_parent );
|
|
VECTOR2I relPos = aPosition - parentSymbol->GetPosition();
|
|
|
|
relPos = parentSymbol->GetTransform().InverseTransform().TransformCoordinate( relPos );
|
|
|
|
SetTextPos( relPos + parentSymbol->GetPosition() );
|
|
return;
|
|
}
|
|
|
|
SetTextPos( aPosition );
|
|
}
|
|
|
|
|
|
VECTOR2I SCH_FIELD::GetPosition() const
|
|
{
|
|
if( m_parent && m_parent->Type() == SCH_SYMBOL_T )
|
|
{
|
|
SCH_SYMBOL* parentSymbol = static_cast<SCH_SYMBOL*>( m_parent );
|
|
VECTOR2I relativePos = GetTextPos() - parentSymbol->GetPosition();
|
|
|
|
relativePos = parentSymbol->GetTransform().TransformCoordinate( relativePos );
|
|
|
|
return relativePos + parentSymbol->GetPosition();
|
|
}
|
|
|
|
return GetTextPos();
|
|
}
|
|
|
|
|
|
VECTOR2I SCH_FIELD::GetParentPosition() const
|
|
{
|
|
return m_parent ? m_parent->GetPosition() : wxPoint( 0, 0 );
|
|
}
|
|
|
|
|
|
bool SCH_FIELD::operator <( const SCH_ITEM& aItem ) const
|
|
{
|
|
if( Type() != aItem.Type() )
|
|
return Type() < aItem.Type();
|
|
|
|
auto field = static_cast<const SCH_FIELD*>( &aItem );
|
|
|
|
if( GetId() != field->GetId() )
|
|
return GetId() < field->GetId();
|
|
|
|
if( GetText() != field->GetText() )
|
|
return GetText() < field->GetText();
|
|
|
|
if( GetLibPosition().x != field->GetLibPosition().x )
|
|
return GetLibPosition().x < field->GetLibPosition().x;
|
|
|
|
if( GetLibPosition().y != field->GetLibPosition().y )
|
|
return GetLibPosition().y < field->GetLibPosition().y;
|
|
|
|
return GetName() < field->GetName();
|
|
}
|