561 lines
14 KiB
C++
561 lines
14 KiB
C++
/**********************************************************/
|
|
/* libclass.cpp */
|
|
/**********************************************************/
|
|
|
|
#include "fctsys.h"
|
|
#include "gr_basic.h"
|
|
#include "common.h"
|
|
#include "base_struct.h"
|
|
#include "drawtxt.h"
|
|
#include "kicad_string.h"
|
|
#include "class_drawpanel.h"
|
|
#include "plot_common.h"
|
|
#include "trigo.h"
|
|
|
|
#include "program.h"
|
|
#include "general.h"
|
|
#include "protos.h"
|
|
#include "class_libentry.h"
|
|
|
|
#include <wx/tokenzr.h>
|
|
#include <wx/stream.h>
|
|
#include <wx/txtstrm.h>
|
|
|
|
|
|
/***************************/
|
|
/* class LibraryFieldEntry */
|
|
/***************************/
|
|
|
|
/**
|
|
* a Field is a string linked to a component.
|
|
* Unlike a pure graphic text, fields can be used in netlist generation
|
|
* and other tools (BOM).
|
|
*
|
|
* The first 4 fields have a special meaning:
|
|
*
|
|
* 0 = REFERENCE
|
|
* 1 = VALUE
|
|
* 3 = FOOTPRINT (default Footprint)
|
|
* 4 = DOCUMENTATION (user doc link)
|
|
*
|
|
* others = free fields
|
|
*/
|
|
LIB_FIELD::LIB_FIELD(LIB_COMPONENT * aParent, int idfield ) :
|
|
LIB_DRAW_ITEM( COMPONENT_FIELD_DRAW_TYPE, aParent )
|
|
{
|
|
Init( idfield );
|
|
}
|
|
|
|
|
|
LIB_FIELD::LIB_FIELD( int idfield ) :
|
|
LIB_DRAW_ITEM( COMPONENT_FIELD_DRAW_TYPE, NULL )
|
|
{
|
|
Init( idfield );
|
|
}
|
|
|
|
|
|
LIB_FIELD::LIB_FIELD( const LIB_FIELD& field ) : LIB_DRAW_ITEM( field )
|
|
{
|
|
m_FieldId = field.m_FieldId;
|
|
m_Pos = field.m_Pos;
|
|
m_Size = field.m_Size;
|
|
m_Width = field.m_Width;
|
|
m_Orient = field.m_Orient;
|
|
m_Attributs = field.m_Attributs;
|
|
m_Text = field.m_Text;
|
|
m_Name = field.m_Name;
|
|
m_HJustify = field.m_HJustify;
|
|
m_VJustify = field.m_VJustify;
|
|
m_Italic = field.m_Italic;
|
|
m_Bold = field.m_Bold;
|
|
}
|
|
|
|
|
|
LIB_FIELD::~LIB_FIELD()
|
|
{
|
|
}
|
|
|
|
|
|
void LIB_FIELD::Init( int id )
|
|
{
|
|
m_FieldId = id;
|
|
m_Size.x = m_Size.y = DEFAULT_SIZE_TEXT;
|
|
m_typeName = _( "Field" );
|
|
}
|
|
|
|
|
|
bool LIB_FIELD::Save( FILE* ExportFile )
|
|
{
|
|
int hjustify, vjustify;
|
|
wxString text = m_Text;
|
|
|
|
hjustify = 'C';
|
|
if( m_HJustify == GR_TEXT_HJUSTIFY_LEFT )
|
|
hjustify = 'L';
|
|
else if( m_HJustify == GR_TEXT_HJUSTIFY_RIGHT )
|
|
hjustify = 'R';
|
|
vjustify = 'C';
|
|
if( m_VJustify == GR_TEXT_VJUSTIFY_BOTTOM )
|
|
vjustify = 'B';
|
|
else if( m_VJustify == GR_TEXT_VJUSTIFY_TOP )
|
|
vjustify = 'T';
|
|
if( text.IsEmpty() )
|
|
text = wxT( "~" );
|
|
if( fprintf( ExportFile, "F%d \"%s\" %d %d %d %c %c %c %c%c%c",
|
|
m_FieldId, CONV_TO_UTF8( text ), m_Pos.x, m_Pos.y, m_Size.x,
|
|
m_Orient == 0 ? 'H' : 'V',
|
|
(m_Attributs & TEXT_NO_VISIBLE ) ? 'I' : 'V',
|
|
hjustify, vjustify,
|
|
m_Italic ? 'I' : 'N',
|
|
m_Bold ? 'B' : 'N' ) < 0 )
|
|
return false;
|
|
|
|
/* Save field name, if necessary
|
|
* Field name is saved only if it is not the default name.
|
|
* Just because default name depends on the language and can change from
|
|
* a country to an other
|
|
*/
|
|
if( m_FieldId >= FIELD1 && !m_Name.IsEmpty()
|
|
&& m_Name != ReturnDefaultFieldName( m_FieldId )
|
|
&& fprintf( ExportFile, " \"%s\"", CONV_TO_UTF8( m_Name ) ) < 0 )
|
|
return false;
|
|
|
|
if( fprintf( ExportFile, "\n" ) < 0 )
|
|
return false;
|
|
|
|
return true;
|
|
}
|
|
|
|
|
|
bool LIB_FIELD::Load( char* line, wxString& errorMsg )
|
|
{
|
|
int cnt;
|
|
char textOrient;
|
|
char textVisible;
|
|
char textHJustify;
|
|
char textVJustify[256];
|
|
char fieldUserName[1024];
|
|
char* text;
|
|
|
|
if( sscanf( line + 1, "%d", &m_FieldId ) != 1 || m_FieldId < 0 )
|
|
{
|
|
errorMsg = wxT( "invalid field header" );
|
|
return false;
|
|
}
|
|
|
|
/* Search the beginning of the data. */
|
|
while( *line != 0 )
|
|
line++;
|
|
|
|
while( *line == 0 )
|
|
line++;
|
|
|
|
while( *line && (*line != '"') )
|
|
line++;
|
|
|
|
if( *line == 0 )
|
|
return false;
|
|
line++;
|
|
|
|
text = line;
|
|
|
|
/* Find end of text. */
|
|
while( *line && (*line != '"') )
|
|
line++;
|
|
|
|
if( *line == 0 )
|
|
return false;
|
|
|
|
*line = 0;
|
|
line++;
|
|
|
|
fieldUserName[0] = 0;
|
|
memset( textVJustify, 0, sizeof( textVJustify ) );
|
|
|
|
cnt = sscanf( line, " %d %d %d %c %c %c %s", &m_Pos.x, &m_Pos.y, &m_Size.y,
|
|
&textOrient, &textVisible, &textHJustify, textVJustify );
|
|
|
|
if( cnt < 5 )
|
|
{
|
|
errorMsg.Printf( wxT( "field %d does not have the correct number of \
|
|
parameters" ),
|
|
m_FieldId );
|
|
return false;
|
|
}
|
|
|
|
m_Text = CONV_FROM_UTF8( text );
|
|
m_Size.x = m_Size.y;
|
|
|
|
if( textOrient == 'H' )
|
|
m_Orient = TEXT_ORIENT_HORIZ;
|
|
else if( textOrient == 'V' )
|
|
m_Orient = TEXT_ORIENT_VERT;
|
|
else
|
|
{
|
|
errorMsg.Printf( wxT( "field %d text orientation parameter <%c> is \
|
|
not valid" ),
|
|
textOrient );
|
|
return false;
|
|
}
|
|
|
|
if( textVisible == 'V' )
|
|
m_Attributs &= ~TEXT_NO_VISIBLE;
|
|
else if ( textVisible == 'I' )
|
|
m_Attributs |= TEXT_NO_VISIBLE;
|
|
else
|
|
{
|
|
errorMsg.Printf( wxT( "field %d text visible parameter <%c> is not \
|
|
valid" ),
|
|
textVisible );
|
|
return false;
|
|
}
|
|
|
|
m_HJustify = GR_TEXT_HJUSTIFY_CENTER;
|
|
m_VJustify = GR_TEXT_VJUSTIFY_CENTER;
|
|
|
|
if( cnt >= 6 )
|
|
{
|
|
if( textHJustify == 'C' )
|
|
m_HJustify = GR_TEXT_HJUSTIFY_CENTER;
|
|
else if( textHJustify == 'L' )
|
|
m_HJustify = GR_TEXT_HJUSTIFY_LEFT;
|
|
else if( textHJustify == 'R' )
|
|
m_HJustify = GR_TEXT_HJUSTIFY_RIGHT;
|
|
else
|
|
{
|
|
errorMsg.Printf( wxT( "field %d text horizontal justification \
|
|
parameter <%c> is not valid" ),
|
|
textHJustify );
|
|
return false;
|
|
}
|
|
|
|
if( textVJustify[0] == 'C' )
|
|
m_VJustify = GR_TEXT_VJUSTIFY_CENTER;
|
|
else if( textVJustify[0] == 'B' )
|
|
m_VJustify = GR_TEXT_VJUSTIFY_BOTTOM;
|
|
else if( textVJustify[0] == 'T' )
|
|
m_VJustify = GR_TEXT_VJUSTIFY_TOP;
|
|
else
|
|
{
|
|
errorMsg.Printf( wxT( "field %d text vertical justification \
|
|
parameter <%c> is not valid" ),
|
|
textVJustify[0] );
|
|
return false;
|
|
}
|
|
|
|
if ( textVJustify[1] == 'I' ) // Italic
|
|
m_Italic = true;
|
|
if ( textVJustify[2] == 'B' ) // Bold
|
|
m_Bold = true;
|
|
}
|
|
|
|
if( m_FieldId >= FIELD1 )
|
|
{
|
|
ReadDelimitedText( fieldUserName, line, sizeof( fieldUserName ) );
|
|
m_Name = CONV_FROM_UTF8( fieldUserName );
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
|
|
|
|
/** Function GetPenSize
|
|
* @return the size of the "pen" that be used to draw or plot this item
|
|
*/
|
|
int LIB_FIELD::GetPenSize()
|
|
{
|
|
return ( m_Width == 0 ) ? g_DrawDefaultLineThickness : m_Width;
|
|
}
|
|
|
|
|
|
/*
|
|
* if aData not NULL, aData must point a wxString which is used instead of
|
|
* the m_Text
|
|
*/
|
|
void LIB_FIELD::Draw( WinEDA_DrawPanel* aPanel, wxDC* aDC,
|
|
const wxPoint& aOffset, int aColor, int aDrawMode,
|
|
void* aData, const int aTransformMatrix[2][2] )
|
|
{
|
|
wxPoint text_pos;
|
|
int color;
|
|
int linewidth = GetPenSize();
|
|
|
|
linewidth = Clamp_Text_PenSize( linewidth, m_Size, m_Bold );
|
|
|
|
if( ( m_Attributs & TEXT_NO_VISIBLE ) && ( aColor < 0 ) )
|
|
{
|
|
color = g_InvisibleItemColor;
|
|
}
|
|
else if( ( m_Selected & IS_SELECTED ) && ( aColor < 0 ) )
|
|
{
|
|
color = g_ItemSelectetColor;
|
|
}
|
|
else
|
|
{
|
|
color = aColor;
|
|
}
|
|
|
|
if( color < 0 )
|
|
{
|
|
switch( m_FieldId )
|
|
{
|
|
case REFERENCE:
|
|
color = ReturnLayerColor( LAYER_REFERENCEPART );
|
|
break;
|
|
|
|
case VALUE:
|
|
color = ReturnLayerColor( LAYER_VALUEPART );
|
|
break;
|
|
|
|
default:
|
|
color = ReturnLayerColor( LAYER_FIELDS );
|
|
break;
|
|
}
|
|
}
|
|
|
|
text_pos = TransformCoordinate( aTransformMatrix, m_Pos ) + aOffset;
|
|
wxString* text = aData ? (wxString*)aData : &m_Text;
|
|
GRSetDrawMode( aDC, aDrawMode );
|
|
DrawGraphicText( aPanel, aDC, text_pos, (EDA_Colors) color, *text,
|
|
m_Orient, m_Size, m_HJustify, m_VJustify, linewidth,
|
|
m_Italic, m_Bold );
|
|
|
|
/* Set to one (1) to draw bounding box around field text to validate
|
|
* bounding box calculation. */
|
|
#if 0
|
|
wxString tmp = m_Text;
|
|
m_Text = *text;
|
|
EDA_Rect bBox = GetBoundingBox();
|
|
m_Text = tmp;
|
|
bBox.Inflate( 1, 1 );
|
|
GRRect( &aPanel->m_ClipBox, aDC, bBox.GetOrigin().x, bBox.GetOrigin().y,
|
|
bBox.GetEnd().x, bBox.GetEnd().y, 0, LIGHTMAGENTA );
|
|
#endif
|
|
}
|
|
|
|
|
|
/**
|
|
* Function HitTest
|
|
* tests if the given wxPoint is within the bounds of this object.
|
|
* @param refPos A wxPoint to test, in Field coordinate system
|
|
* @return bool - true if a hit, else false
|
|
*/
|
|
bool LIB_FIELD::HitTest( const wxPoint& refPos )
|
|
{
|
|
return HitTest( refPos, 0, DefaultTransformMatrix );
|
|
}
|
|
|
|
/** Function HitTest
|
|
* @return true if the point aPosRef is near this object
|
|
* @param aPosRef = a wxPoint to test
|
|
* @param aThreshold = unused here (TextHitTest calculates its threshold )
|
|
* @param aTransMat = the transform matrix
|
|
*/
|
|
bool LIB_FIELD::HitTest( wxPoint aPosRef, int aThreshold,
|
|
const int aTransMat[2][2] )
|
|
{
|
|
int extraCharCount = 0;
|
|
// Reference designator text has one or 2 additional character (displays
|
|
// U? or U?A)
|
|
if( m_FieldId == REFERENCE )
|
|
{
|
|
extraCharCount++;
|
|
m_Text.Append('?');
|
|
LIB_COMPONENT* parent = (LIB_COMPONENT*)m_Parent;
|
|
if ( parent && ( parent->GetPartCount() > 1 ) )
|
|
{
|
|
m_Text.Append('A');
|
|
extraCharCount++;
|
|
}
|
|
}
|
|
|
|
wxPoint physicalpos = TransformCoordinate( aTransMat, m_Pos );
|
|
wxPoint tmp = m_Pos;
|
|
m_Pos = physicalpos;
|
|
/* The text orientation may need to be flipped if the
|
|
* transformation matrix causes xy axes to be flipped.
|
|
* this simple algo works only for schematic matrix (rot 90 or/and mirror)
|
|
*/
|
|
int t1 = ( aTransMat[0][0] != 0 ) ^ ( m_Orient != 0 );
|
|
int orient = t1 ? TEXT_ORIENT_HORIZ : TEXT_ORIENT_VERT;
|
|
EXCHG( m_Orient, orient );
|
|
|
|
bool hit = TextHitTest(aPosRef);
|
|
|
|
EXCHG( m_Orient, orient );
|
|
m_Pos = tmp;
|
|
|
|
while( extraCharCount-- )
|
|
m_Text.RemoveLast( );
|
|
|
|
return hit;
|
|
}
|
|
|
|
LIB_DRAW_ITEM* LIB_FIELD::DoGenCopy()
|
|
{
|
|
LIB_FIELD* newfield = new LIB_FIELD( m_FieldId );
|
|
|
|
Copy( newfield );
|
|
|
|
return (LIB_DRAW_ITEM*) newfield;
|
|
}
|
|
|
|
|
|
/** Function Copy
|
|
* copy parameters of this to Target. Pointers are not copied
|
|
* @param Target = the LIB_FIELD to set with "this" values
|
|
*/
|
|
void LIB_FIELD::Copy( LIB_FIELD* Target ) const
|
|
{
|
|
Target->SetParent( m_Parent );
|
|
Target->m_Pos = m_Pos;
|
|
Target->m_Size = m_Size;
|
|
Target->m_Width = m_Width;
|
|
Target->m_Orient = m_Orient;
|
|
Target->m_Attributs = m_Attributs;
|
|
Target->m_Text = m_Text;
|
|
Target->m_Name = m_Name;
|
|
Target->m_HJustify = m_HJustify;
|
|
Target->m_VJustify = m_VJustify;
|
|
Target->m_Italic = m_Italic;
|
|
Target->m_Bold = m_Bold;
|
|
}
|
|
|
|
|
|
int LIB_FIELD::DoCompare( const LIB_DRAW_ITEM& other ) const
|
|
{
|
|
wxASSERT( other.Type() == COMPONENT_FIELD_DRAW_TYPE );
|
|
|
|
const LIB_FIELD* tmp = ( LIB_FIELD* ) &other;
|
|
|
|
if( m_FieldId != tmp->m_FieldId )
|
|
return m_FieldId - tmp->m_FieldId;
|
|
|
|
int result = m_Text.CmpNoCase( tmp->m_Text );
|
|
|
|
if( result != 0 )
|
|
return result;
|
|
|
|
if( m_Pos.x != tmp->m_Pos.x )
|
|
return m_Pos.x - tmp->m_Pos.x;
|
|
|
|
if( m_Pos.y != tmp->m_Pos.y )
|
|
return m_Pos.y - tmp->m_Pos.y;
|
|
|
|
if( m_Size.x != tmp->m_Size.x )
|
|
return m_Size.x - tmp->m_Size.x;
|
|
|
|
if( m_Size.y != tmp->m_Size.y )
|
|
return m_Size.y - tmp->m_Size.y;
|
|
|
|
return 0;
|
|
}
|
|
|
|
|
|
void LIB_FIELD::DoOffset( const wxPoint& offset )
|
|
{
|
|
m_Pos += offset;
|
|
}
|
|
|
|
|
|
bool LIB_FIELD::DoTestInside( EDA_Rect& rect )
|
|
{
|
|
/*
|
|
* FIXME: This fails to take into acount the size and/or orientation of
|
|
* the text.
|
|
*/
|
|
return rect.Inside( m_Pos.x, -m_Pos.y );
|
|
}
|
|
|
|
|
|
void LIB_FIELD::DoMove( const wxPoint& newPosition )
|
|
{
|
|
m_Pos = newPosition;
|
|
}
|
|
|
|
|
|
void LIB_FIELD::DoMirrorHorizontal( const wxPoint& center )
|
|
{
|
|
m_Pos.x -= center.x;
|
|
m_Pos.x *= -1;
|
|
m_Pos.x += center.x;
|
|
}
|
|
|
|
|
|
void LIB_FIELD::DoPlot( PLOTTER* plotter, const wxPoint& offset, bool fill,
|
|
const int transform[2][2] )
|
|
{
|
|
}
|
|
|
|
|
|
/*
|
|
* If the field is the reference, return reference like schematic,
|
|
* i.e U -> U? or U?A or the field text for others
|
|
*
|
|
* @fixme This should be handled by the field object.
|
|
*/
|
|
wxString LIB_FIELD::GetFullText( int unit )
|
|
{
|
|
if( m_FieldId != REFERENCE )
|
|
return m_Text;
|
|
|
|
wxString text = m_Text;
|
|
text << wxT( "?" );
|
|
|
|
if( GetParent()->IsMulti() )
|
|
text << LIB_COMPONENT::ReturnSubReference( unit );
|
|
|
|
return text;
|
|
}
|
|
|
|
|
|
EDA_Rect LIB_FIELD::GetBoundingBox()
|
|
{
|
|
EDA_Rect rect = GetTextBox();
|
|
rect.m_Pos.y *= -1;
|
|
rect.m_Pos.y -= rect.GetHeight();
|
|
|
|
wxPoint orig = rect.GetOrigin();
|
|
wxPoint end = rect.GetEnd();
|
|
wxPoint center = rect.Centre();
|
|
|
|
RotatePoint( &orig, center, m_Orient );
|
|
RotatePoint( &end, center, m_Orient );
|
|
rect.SetOrigin( orig );
|
|
rect.SetEnd( end );
|
|
|
|
return rect;
|
|
}
|
|
|
|
|
|
/**
|
|
* Function ReturnDefaultFieldName
|
|
* Return the default field name from its index (REFERENCE, VALUE ..)
|
|
* FieldDefaultNameList is not static, because we want the text translation
|
|
* for I18n
|
|
* @param aFieldNdx = Filed number (>= 0)
|
|
*/
|
|
wxString ReturnDefaultFieldName( int aFieldNdx )
|
|
{
|
|
// avoid unnecessarily copying wxStrings at runtime.
|
|
static const wxString defaults[] = {
|
|
_( "Reference" ), // Reference of part, i.e. "IC21"
|
|
_( "Value" ), // Value of part, i.e. "3.3K" and name in lib
|
|
// for lib entries
|
|
_( "Footprint" ), // Footprint, used by cvpcb or pcbnew, i.e.
|
|
// "16DIP300"
|
|
_( "Datasheet" ), // A link to an user document, if wanted
|
|
};
|
|
|
|
if( (unsigned) aFieldNdx <= DATASHEET )
|
|
return defaults[ aFieldNdx ];
|
|
|
|
else
|
|
{
|
|
wxString ret = _( "Field" );
|
|
ret << ( aFieldNdx - FIELD1 + 1);
|
|
return ret;
|
|
}
|
|
}
|