506 lines
13 KiB
C++
506 lines
13 KiB
C++
/***********************************************/
|
|
/* sch_field.cpp : handle the class SCH_FIELD */
|
|
/***********************************************/
|
|
|
|
/* Fields are texts attached to a component, having a special meaning
|
|
* Fields 0 and 1 are very important: reference and value
|
|
* Field 2 is used as default footprint name.
|
|
* Field 3 is reserved (not currently used
|
|
* Fields 4 and more are user fields.
|
|
* They can be renamed and can appear in reports
|
|
*/
|
|
|
|
#include "fctsys.h"
|
|
#include "common.h"
|
|
#include "class_drawpanel.h"
|
|
#include "base_struct.h"
|
|
#include "gr_basic.h"
|
|
#include "drawtxt.h"
|
|
#include "macros.h"
|
|
#include "trigo.h"
|
|
#include "class_sch_screen.h"
|
|
#include "wxEeschemaStruct.h"
|
|
|
|
#include "general.h"
|
|
#include "protos.h"
|
|
#include "class_library.h"
|
|
#include "sch_component.h"
|
|
#include "sch_field.h"
|
|
#include "template_fieldnames.h"
|
|
#include "kicad_string.h"
|
|
|
|
SCH_FIELD::SCH_FIELD( const wxPoint& aPos, int aFieldId, SCH_COMPONENT* aParent, wxString aName ) :
|
|
SCH_ITEM( aParent, SCH_FIELD_T ),
|
|
EDA_TEXT()
|
|
{
|
|
m_Pos = aPos;
|
|
m_FieldId = aFieldId;
|
|
m_AddExtraText = false;
|
|
m_Attributs = TEXT_NO_VISIBLE;
|
|
m_Name = aName;
|
|
|
|
SetLayer( LAYER_FIELDS );
|
|
}
|
|
|
|
|
|
SCH_FIELD::SCH_FIELD( const SCH_FIELD& aField ) :
|
|
SCH_ITEM( aField ),
|
|
EDA_TEXT( aField )
|
|
{
|
|
m_FieldId = aField.m_FieldId;
|
|
m_Name = aField.m_Name;
|
|
m_AddExtraText = aField.m_AddExtraText;
|
|
}
|
|
|
|
|
|
SCH_FIELD::~SCH_FIELD()
|
|
{
|
|
}
|
|
|
|
|
|
EDA_ITEM* SCH_FIELD::doClone() const
|
|
{
|
|
return new SCH_FIELD( *this );
|
|
}
|
|
|
|
|
|
int SCH_FIELD::GetPenSize() const
|
|
{
|
|
int pensize = m_Thickness;
|
|
|
|
if( pensize == 0 ) // Use default values for pen size
|
|
{
|
|
if( m_Bold )
|
|
pensize = GetPenSizeForBold( m_Size.x );
|
|
else
|
|
pensize = g_DrawDefaultLineThickness;
|
|
}
|
|
|
|
// Clip pen size for small texts:
|
|
pensize = Clamp_Text_PenSize( pensize, m_Size, m_Bold );
|
|
return pensize;
|
|
}
|
|
|
|
|
|
void SCH_FIELD::Draw( EDA_DRAW_PANEL* panel, wxDC* DC,
|
|
const wxPoint& offset, int DrawMode, int Color )
|
|
{
|
|
int orient;
|
|
EDA_Colors color;
|
|
wxPoint textpos;
|
|
SCH_COMPONENT* parentComponent = (SCH_COMPONENT*) m_Parent;
|
|
int LineWidth = m_Thickness;
|
|
|
|
if( LineWidth == 0 ) // Use default values for pen size
|
|
{
|
|
if( m_Bold )
|
|
LineWidth = GetPenSizeForBold( m_Size.x );
|
|
else
|
|
LineWidth = g_DrawDefaultLineThickness;
|
|
}
|
|
|
|
|
|
// Clip pen size for small texts:
|
|
LineWidth = Clamp_Text_PenSize( LineWidth, m_Size, m_Bold );
|
|
|
|
if( ( m_Attributs & TEXT_NO_VISIBLE ) || IsVoid() )
|
|
return;
|
|
|
|
GRSetDrawMode( DC, DrawMode );
|
|
|
|
/* Calculate the text orientation, according to the component
|
|
* orientation/mirror */
|
|
orient = m_Orient;
|
|
|
|
if( parentComponent->GetTransform().y1 ) // Rotate component 90 degrees.
|
|
{
|
|
if( orient == TEXT_ORIENT_HORIZ )
|
|
orient = TEXT_ORIENT_VERT;
|
|
else
|
|
orient = TEXT_ORIENT_HORIZ;
|
|
}
|
|
|
|
/* Calculate the text justification, according to the component
|
|
* orientation/mirror this is a bit complicated due to cumulative
|
|
* calculations:
|
|
* - numerous cases (mirrored or not, rotation)
|
|
* - the DrawGraphicText function recalculate also H and H justifications
|
|
* according to the text orientation.
|
|
* - When a component 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 GetBoundaryBox to know the text coordinate considered as centered
|
|
*/
|
|
EDA_RECT BoundaryBox = GetBoundingBox();
|
|
GRTextHorizJustifyType hjustify = GR_TEXT_HJUSTIFY_CENTER;
|
|
GRTextVertJustifyType vjustify = GR_TEXT_VJUSTIFY_CENTER;
|
|
textpos = BoundaryBox.Centre();
|
|
|
|
if( m_FieldId == REFERENCE )
|
|
color = ReturnLayerColor( LAYER_REFERENCEPART );
|
|
else if( m_FieldId == VALUE )
|
|
color = ReturnLayerColor( LAYER_VALUEPART );
|
|
else
|
|
color = ReturnLayerColor( LAYER_FIELDS );
|
|
|
|
if( !m_AddExtraText || ( m_FieldId != REFERENCE ) )
|
|
{
|
|
DrawGraphicText( panel, DC, textpos, color, m_Text, orient, m_Size, hjustify, vjustify,
|
|
LineWidth, m_Italic, m_Bold );
|
|
}
|
|
else
|
|
{
|
|
/* For more than one part per package, we must add the part selection
|
|
* A, B, ... or 1, 2, .. to the reference. */
|
|
wxString fulltext = m_Text;
|
|
fulltext << LIB_COMPONENT::ReturnSubReference( parentComponent->GetUnit() );
|
|
|
|
DrawGraphicText( panel, DC, textpos, color, fulltext, orient, m_Size, hjustify, vjustify,
|
|
LineWidth, m_Italic, m_Bold );
|
|
}
|
|
|
|
/* Enable this to draw the bounding box around the text field to validate
|
|
* the bounding box calculations.
|
|
*/
|
|
#if 0
|
|
|
|
// Draw boundary box:
|
|
int x1 = BoundaryBox.GetX();
|
|
int y1 = BoundaryBox.GetY();
|
|
int x2 = BoundaryBox.GetRight();
|
|
int y2 = BoundaryBox.GetBottom();
|
|
GRRect( &panel->m_ClipBox, DC, x1, y1, x2, y2, BROWN );
|
|
|
|
// Draw the text anchor point
|
|
|
|
/* Calculate the text position, according to the component
|
|
* orientation/mirror */
|
|
textpos = m_Pos - parentComponent->m_Pos;
|
|
textpos = parentComponent->GetScreenCoord( textpos );
|
|
textpos += parentComponent->m_Pos;
|
|
x1 = textpos.x;
|
|
y1 = textpos.y;
|
|
int len = 10;
|
|
GRLine( &panel->m_ClipBox, DC, x1 - len, y1, x1 + len, y1, 0, BLUE );
|
|
GRLine( &panel->m_ClipBox, DC, x1, y1 - len, x1, y1 + len, 0, BLUE );
|
|
#endif
|
|
}
|
|
|
|
|
|
void SCH_FIELD::ImportValues( const LIB_FIELD& aSource )
|
|
{
|
|
m_Orient = aSource.m_Orient;
|
|
m_Size = aSource.m_Size;
|
|
m_HJustify = aSource.m_HJustify;
|
|
m_VJustify = aSource.m_VJustify;
|
|
m_Italic = aSource.m_Italic;
|
|
m_Bold = aSource.m_Bold;
|
|
m_Thickness = aSource.m_Thickness;
|
|
m_Attributs = aSource.m_Attributs;
|
|
m_Mirror = aSource.m_Mirror;
|
|
}
|
|
|
|
|
|
void SCH_FIELD::SwapData( SCH_FIELD* aField )
|
|
{
|
|
EXCHG( m_Text, aField->m_Text );
|
|
EXCHG( m_Layer, aField->m_Layer );
|
|
EXCHG( m_Pos, aField->m_Pos );
|
|
EXCHG( m_Size, aField->m_Size );
|
|
EXCHG( m_Thickness, aField->m_Thickness );
|
|
EXCHG( m_Orient, aField->m_Orient );
|
|
EXCHG( m_Mirror, aField->m_Mirror );
|
|
EXCHG( m_Attributs, aField->m_Attributs );
|
|
EXCHG( m_Italic, aField->m_Italic );
|
|
EXCHG( m_Bold, aField->m_Bold );
|
|
EXCHG( m_HJustify, aField->m_HJustify );
|
|
EXCHG( m_VJustify, aField->m_VJustify );
|
|
}
|
|
|
|
|
|
EDA_RECT SCH_FIELD::GetBoundingBox() const
|
|
{
|
|
EDA_RECT BoundaryBox;
|
|
int hjustify, vjustify;
|
|
int orient;
|
|
wxSize size;
|
|
wxPoint pos1, pos2;
|
|
|
|
SCH_COMPONENT* parentComponent = (SCH_COMPONENT*) m_Parent;
|
|
|
|
orient = m_Orient;
|
|
wxPoint pos = parentComponent->m_Pos;
|
|
pos1 = m_Pos - pos;
|
|
|
|
size.x = LenSize( m_Text );
|
|
size.y = m_Size.y;
|
|
hjustify = m_HJustify;
|
|
vjustify = m_VJustify;
|
|
|
|
pos2 = pos + parentComponent->GetTransform().TransformCoordinate( pos1 );
|
|
|
|
// Calculate the text orientation, according to the component orientation/mirror.
|
|
if( parentComponent->GetTransform().y1 )
|
|
{
|
|
if( orient == TEXT_ORIENT_HORIZ )
|
|
orient = TEXT_ORIENT_VERT;
|
|
else
|
|
orient = TEXT_ORIENT_HORIZ;
|
|
}
|
|
|
|
// Calculate the text justification, according to the component orientation/mirror.
|
|
if( parentComponent->GetTransform().y1 )
|
|
{
|
|
/* is it mirrored (for text justify)*/
|
|
EXCHG( hjustify, vjustify );
|
|
|
|
if( parentComponent->GetTransform().x2 < 0 )
|
|
NEGATE( vjustify );
|
|
|
|
if( parentComponent->GetTransform().y1 > 0 )
|
|
NEGATE( hjustify );
|
|
}
|
|
else /* component horizontal: is it mirrored (for text justify)*/
|
|
{
|
|
if( parentComponent->GetTransform().x1 < 0 )
|
|
NEGATE( hjustify );
|
|
|
|
if( parentComponent->GetTransform().y2 > 0 )
|
|
NEGATE( vjustify );
|
|
}
|
|
|
|
if( orient == TEXT_ORIENT_VERT )
|
|
EXCHG( size.x, size.y );
|
|
|
|
switch( hjustify )
|
|
{
|
|
case GR_TEXT_HJUSTIFY_CENTER:
|
|
pos1.x = pos2.x - (size.x / 2);
|
|
break;
|
|
|
|
case GR_TEXT_HJUSTIFY_RIGHT:
|
|
pos1.x = pos2.x - size.x;
|
|
break;
|
|
|
|
default:
|
|
pos1.x = pos2.x;
|
|
break;
|
|
}
|
|
|
|
switch( vjustify )
|
|
{
|
|
case GR_TEXT_VJUSTIFY_CENTER:
|
|
pos1.y = pos2.y - (size.y / 2);
|
|
break;
|
|
|
|
case GR_TEXT_VJUSTIFY_BOTTOM:
|
|
pos1.y = pos2.y - size.y;
|
|
break;
|
|
|
|
default:
|
|
pos1.y = pos2.y;
|
|
break;
|
|
}
|
|
|
|
BoundaryBox.SetOrigin( pos1 );
|
|
BoundaryBox.SetSize( size );
|
|
|
|
// Take thickness in account:
|
|
int linewidth = ( m_Thickness == 0 ) ? g_DrawDefaultLineThickness : m_Thickness;
|
|
BoundaryBox.Inflate( linewidth, linewidth );
|
|
|
|
return BoundaryBox;
|
|
}
|
|
|
|
|
|
bool SCH_FIELD::Save( FILE* aFile ) const
|
|
{
|
|
char hjustify = 'C';
|
|
|
|
if( m_HJustify == GR_TEXT_HJUSTIFY_LEFT )
|
|
hjustify = 'L';
|
|
else if( m_HJustify == GR_TEXT_HJUSTIFY_RIGHT )
|
|
hjustify = 'R';
|
|
|
|
char vjustify = 'C';
|
|
|
|
if( m_VJustify == GR_TEXT_VJUSTIFY_BOTTOM )
|
|
vjustify = 'B';
|
|
else if( m_VJustify == GR_TEXT_VJUSTIFY_TOP )
|
|
vjustify = 'T';
|
|
|
|
if( fprintf( aFile, "F %d %s %c %-3d %-3d %-3d %4.4X %c %c%c%c",
|
|
m_FieldId,
|
|
EscapedUTF8( m_Text ).c_str(), // wraps in quotes too
|
|
m_Orient == TEXT_ORIENT_HORIZ ? 'H' : 'V',
|
|
m_Pos.x, m_Pos.y,
|
|
m_Size.x,
|
|
m_Attributs,
|
|
hjustify, vjustify,
|
|
m_Italic ? 'I' : 'N',
|
|
m_Bold ? 'B' : 'N' ) == EOF )
|
|
{
|
|
return false;
|
|
}
|
|
|
|
// Save field name, if the name is user definable
|
|
if( m_FieldId >= FIELD1 )
|
|
{
|
|
if( fprintf( aFile, " %s", EscapedUTF8( m_Name ).c_str() ) == EOF )
|
|
{
|
|
return false;
|
|
}
|
|
}
|
|
|
|
if( fprintf( aFile, "\n" ) == EOF )
|
|
{
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
|
|
void SCH_FIELD::Place( SCH_EDIT_FRAME* frame, wxDC* DC )
|
|
{
|
|
int fieldNdx;
|
|
LIB_COMPONENT* Entry;
|
|
|
|
frame->DrawPanel->SetMouseCapture( NULL, NULL );
|
|
|
|
SCH_COMPONENT* component = (SCH_COMPONENT*) GetParent();
|
|
|
|
// save old cmp in undo list
|
|
frame->SaveUndoItemInUndoList( component );
|
|
|
|
fieldNdx = m_FieldId;
|
|
m_AddExtraText = 0;
|
|
|
|
if( fieldNdx == REFERENCE )
|
|
{
|
|
Entry = CMP_LIBRARY::FindLibraryComponent( component->GetLibName() );
|
|
|
|
if( Entry != NULL )
|
|
{
|
|
if( Entry->GetPartCount() > 1 )
|
|
m_AddExtraText = 1;
|
|
}
|
|
}
|
|
|
|
Draw( frame->DrawPanel, DC, wxPoint( 0, 0 ), GR_DEFAULT_DRAWMODE );
|
|
ClearFlags();
|
|
frame->GetScreen()->SetCurItem( NULL );
|
|
frame->OnModify();
|
|
}
|
|
|
|
|
|
bool SCH_FIELD::Matches( wxFindReplaceData& aSearchData, void* aAuxData, wxPoint * aFindLocation )
|
|
{
|
|
bool match;
|
|
|
|
if( aAuxData && m_FieldId == REFERENCE )
|
|
{
|
|
// reference is a special field because:
|
|
// >> a part identifier is added in multi parts per package
|
|
// (the .m_AddExtraText of the field is set in this case )
|
|
// >> In complex hierarchies, the actual reference depend on the sheet path.
|
|
SCH_COMPONENT* pSch = (SCH_COMPONENT*) m_Parent;
|
|
SCH_SHEET_PATH* sheet = (SCH_SHEET_PATH*) aAuxData;
|
|
wxString fulltext = pSch->GetRef( sheet );
|
|
|
|
if( m_AddExtraText )
|
|
{
|
|
/* For more than one part per package, we must add the part selection
|
|
* A, B, ... or 1, 2, .. to the reference. */
|
|
int part_id = pSch->GetUnitSelection( sheet );
|
|
fulltext << LIB_COMPONENT::ReturnSubReference( part_id );
|
|
}
|
|
|
|
match = SCH_ITEM::Matches( fulltext, aSearchData );
|
|
}
|
|
else
|
|
match = SCH_ITEM::Matches( m_Text, aSearchData );
|
|
|
|
if( match )
|
|
{
|
|
EDA_RECT BoundaryBox = GetBoundingBox();
|
|
|
|
if( aFindLocation )
|
|
*aFindLocation = GetBoundingBox().Centre();
|
|
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
|
|
void SCH_FIELD::Rotate( wxPoint rotationPoint )
|
|
{
|
|
RotatePoint( &m_Pos, rotationPoint, 900 );
|
|
}
|
|
|
|
|
|
wxString SCH_FIELD::GetSelectMenuText() const
|
|
{
|
|
wxString tmp;
|
|
tmp.Printf( _( "Field %s" ), GetChars( GetName() ) );
|
|
|
|
return tmp;
|
|
}
|
|
|
|
|
|
wxString SCH_FIELD::GetName() const
|
|
{
|
|
if( !m_Name.IsEmpty() )
|
|
return m_Name;
|
|
else
|
|
return TEMPLATE_FIELDNAME::GetDefaultFieldName( m_FieldId );
|
|
}
|
|
|
|
|
|
const char** SCH_FIELD::GetMenuImage() const
|
|
{
|
|
if( m_FieldId == REFERENCE )
|
|
return (const char**) edit_comp_ref_xpm;
|
|
|
|
if( m_FieldId == VALUE )
|
|
return (const char**) edit_comp_value_xpm;
|
|
|
|
if( m_FieldId == FOOTPRINT )
|
|
return (const char**) edit_comp_footprint_xpm;
|
|
|
|
return (const char**) edit_text_xpm;
|
|
}
|
|
|
|
|
|
bool SCH_FIELD::doHitTest( const wxPoint& aPoint, 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( aPoint );
|
|
}
|
|
|
|
|
|
bool SCH_FIELD::doHitTest( 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() );
|
|
}
|