24#include <boost/algorithm/string/join.hpp>
29#include <wx/mstream.h>
30#include <wx/filename.h>
32#include <wx/textfile.h>
33#include <wx/tokenzr.h>
37#include <fmt/format.h>
71#define T_STYLE "style"
73#define T_COLORA "rgba"
74#define T_WIDTH "width"
79 m_lineReader( nullptr ),
80 m_lastProgressLine( 0 ),
106 const unsigned PROGRESS_DELTA = 250;
128 const std::map<std::string, UTF8>* aProperties )
130 wxASSERT( !aFileName || aSchematic !=
nullptr );
133 wxFileName fn = aFileName;
138 wxASSERT( fn.IsAbsolute() );
147 if( !normedFn.IsAbsolute() )
149 if( aFileName.Right( normedFn.GetFullPath().Length() ) == normedFn.GetFullPath() )
150 m_path = aFileName.Left( aFileName.Length() - normedFn.GetFullPath().Length() );
164 init( aSchematic, aProperties );
166 if( aAppendToMe ==
nullptr )
169 std::unique_ptr<SCH_SHEET> newSheet = std::make_unique<SCH_SHEET>( aSchematic );
170 newSheet->SetFileName( aFileName );
175 sheet = newSheet.release();
181 wxCHECK_MSG( aSchematic->
IsValid(),
nullptr,
"Can't append to a schematic with no root!" );
207 fileName.SetExt(
"sch" );
209 if( !fileName.IsAbsolute() )
258 wxCHECK2( aItem->Type() ==
SCH_SHEET_T,
continue );
259 auto sheet =
static_cast<SCH_SHEET*
>( aItem );
307 char* line = reader.
Line();
309 while( *line ==
' ' )
324 "Cannot call SCH_IO_KICAD_LEGACY::LoadContent() without setting root sheet." );
330 char* line = aReader.
Line();
332 while( *line ==
' ' )
369 const char* line = aReader.
ReadLine();
371 if( !line || !
strCompare(
"Eeschema Schematic File Version", line, &line ) )
373 m_error.Printf(
_(
"'%s' does not appear to be an Eeschema file." ),
394 line = aReader.
Line();
396 while( *line ==
' ' )
409 wxASSERT( aScreen !=
nullptr );
412 const char* line = aReader.
Line();
417 wxCHECK_RET(
strCompare(
"$Descr", line, &line ),
"Invalid sheet description" );
424 int pagew =
parseInt( aReader, line, &line );
425 int pageh =
parseInt( aReader, line, &line );
434 wxString orientation;
440 if( orientation ==
"portrait" )
446 while( line !=
nullptr )
453 line = aReader.
Line();
480 else if(
strCompare(
"Comment1", line, &line ) )
485 else if(
strCompare(
"Comment2", line, &line ) )
490 else if(
strCompare(
"Comment3", line, &line ) )
495 else if(
strCompare(
"Comment4", line, &line ) )
500 else if(
strCompare(
"Comment5", line, &line ) )
505 else if(
strCompare(
"Comment6", line, &line ) )
510 else if(
strCompare(
"Comment7", line, &line ) )
515 else if(
strCompare(
"Comment8", line, &line ) )
520 else if(
strCompare(
"Comment9", line, &line ) )
538 std::unique_ptr<SCH_SHEET> sheet = std::make_unique<SCH_SHEET>();
540 const char* line = aReader.
ReadLine();
542 while( line !=
nullptr )
550 sheet->SetPosition( position );
556 sheet->SetSize( size );
563 if(
text !=
"00000000" )
566 else if( *line ==
'F' )
572 int legacy_field_id =
parseInt( aReader, line, &line );
574 if( legacy_field_id == 0 || legacy_field_id == 1 )
579 SCH_FIELD* field = sheet->GetField( legacy_field_id == 0 ? FIELD_T::SHEET_NAME
580 : FIELD_T::SHEET_FILENAME );
587 std::unique_ptr<SCH_SHEET_PIN> sheetPin = std::make_unique<SCH_SHEET_PIN>( sheet.get() );
589 sheetPin->SetNumber( legacy_field_id );
596 if( line ==
nullptr )
599 switch(
parseChar( aReader, line, &line ) )
601 case 'I': sheetPin->SetShape( LABEL_FLAG_SHAPE::L_INPUT );
break;
602 case 'O': sheetPin->SetShape( LABEL_FLAG_SHAPE::L_OUTPUT );
break;
603 case 'B': sheetPin->SetShape( LABEL_FLAG_SHAPE::L_BIDI );
break;
604 case 'T': sheetPin->SetShape( LABEL_FLAG_SHAPE::L_TRISTATE );
break;
605 case 'U': sheetPin->SetShape( LABEL_FLAG_SHAPE::L_UNSPECIFIED );
break;
609 switch(
parseChar( aReader, line, &line ) )
611 case 'R': sheetPin->SetSide( SHEET_SIDE::RIGHT );
break;
612 case 'T': sheetPin->SetSide( SHEET_SIDE::TOP );
break;
613 case 'B': sheetPin->SetSide( SHEET_SIDE::BOTTOM );
break;
614 case 'L': sheetPin->SetSide( SHEET_SIDE::LEFT );
break;
623 sheetPin->SetPosition( position );
627 sheetPin->SetTextSize(
VECTOR2I( size, size ) );
629 sheet->AddPin( sheetPin.release() );
635 return sheet.release();
649 std::unique_ptr<SCH_BITMAP> bitmap = std::make_unique<SCH_BITMAP>();
652 const char* line = aReader.
Line();
654 wxCHECK(
strCompare(
"$Bitmap", line, &line ),
nullptr );
658 while( line !=
nullptr )
666 bitmap->SetPosition( position );
670 auto scalefactor =
parseDouble( aReader, line, &line );
676 if( !std::isnormal( scalefactor ) )
683 wxMemoryBuffer buffer;
690 line = aReader.
Line();
711 int len = strlen( line );
713 for( ; len > 0 && !isspace( *line ) &&
'$' != *line; len -= 3, line += 3 )
717 if( sscanf( line,
"%X", &value ) == 1 )
718 buffer.AppendByte( (
char) value );
724 if( line ==
nullptr )
729 return bitmap.release();
741 std::unique_ptr<SCH_JUNCTION> junction = std::make_unique<SCH_JUNCTION>();
743 const char* line = aReader.
Line();
745 wxCHECK(
strCompare(
"Connection", line, &line ),
nullptr );
755 junction->SetPosition( position );
757 return junction.release();
763 std::unique_ptr<SCH_NO_CONNECT> no_connect = std::make_unique<SCH_NO_CONNECT>();
765 const char* line = aReader.
Line();
767 wxCHECK(
strCompare(
"NoConn", line, &line ),
nullptr );
777 no_connect->SetPosition( position );
779 return no_connect.release();
785 std::unique_ptr<SCH_LINE> wire = std::make_unique<SCH_LINE>();
787 const char* line = aReader.
Line();
789 wxCHECK(
strCompare(
"Wire", line, &line ),
nullptr );
805 wire->SetLineStyle( LINE_STYLE::DASH );
821 wire->SetLineWidth( size );
827 if( buf == wxT(
"solid" ) )
828 wire->SetLineStyle( LINE_STYLE::SOLID );
829 else if( buf == wxT(
"dashed" ) )
830 wire->SetLineStyle( LINE_STYLE::DASH );
831 else if( buf == wxT(
"dash_dot" ) )
832 wire->SetLineStyle( LINE_STYLE::DASHDOT );
833 else if( buf == wxT(
"dotted" ) )
834 wire->SetLineStyle( LINE_STYLE::DOT );
842 wxString prm, keyword;
843 keyword = buf.BeforeLast(
'(', &prm );
847 long color[4] = { 0 };
853 prm.ToLong( &
color[ii] );
857 int prm_count = ( keyword ==
T_COLORA ) ? 4 : 3;
862 for(; ii < prm_count && !
is_eol( *line ); ii++ )
867 if( *line ==
',' || *line ==
' ')
886 wire->SetStartPoint( begin );
887 wire->SetEndPoint(
end );
889 return wire.release();
895 const char* line = aReader.
Line();
897 wxCHECK(
strCompare(
"Entry", line, &line ),
nullptr );
899 std::unique_ptr<SCH_BUS_ENTRY_BASE> busEntry;
903 busEntry = std::make_unique<SCH_BUS_WIRE_ENTRY>();
906 SCH_PARSE_ERROR(
"invalid bus entry definition expected 'Line'", aReader, line );
910 busEntry = std::make_unique<SCH_BUS_BUS_ENTRY>();
913 SCH_PARSE_ERROR(
"invalid bus entry definition expected 'Bus'", aReader, line );
933 busEntry->SetPosition( pos );
934 busEntry->SetSize( size );
936 return busEntry.release();
954 const char* line = aReader.
Line();
957 wxCHECK(
strCompare(
"Text", line, &line ),
nullptr );
967 else if(
strCompare(
"HLabel", line, &line ) )
971 else if(
strCompare(
"GLabel", line, &line ) )
989 std::unique_ptr<SCH_TEXT>
text;
1000 int spinStyle =
parseInt( aReader, line, &line );
1012 if( spinStyle == 0 )
1014 else if( spinStyle == 2 )
1032 [ &line ](
const auto& it )
1034 return strCompare( it.second, line, &line );
1038 label->
SetShape( resultIt->first );
1080 text->SetItalicFlag(
true );
1088 penWidth =
parseInt( aReader, line, &line );
1091 text->SetBoldFlag( penWidth != 0 );
1097 tmp = strtok( tmp,
"\r\n" );
1102 size_t i = val.find( wxT(
"\\n" ) );
1104 if( i == wxString::npos )
1108 val.insert( i, wxT(
"\n" ) );
1113 return text.release();
1119 const char* line = aReader.
Line();
1121 wxCHECK(
strCompare(
"$Comp", line, &line ),
nullptr );
1123 std::unique_ptr<SCH_SYMBOL> symbol = std::make_unique<SCH_SYMBOL>();
1127 while( line !=
nullptr )
1133 wxString utf8Line = wxString::FromUTF8( line );
1134 wxStringTokenizer tokens( utf8Line,
" \r\n\t" );
1136 if( tokens.CountTokens() < 2 )
1140 libName = tokens.GetNextToken();
1141 libName.Replace(
"~",
" " );
1149 libId.
Parse( libName,
true );
1153 symbol->SetLibId( libId );
1155 wxString refDesignator = tokens.GetNextToken();
1157 refDesignator.Replace(
"~",
" " );
1159 wxString prefix = refDesignator;
1161 while( prefix.Length() )
1163 if( ( prefix.Last() <
'0' || prefix.Last() >
'9') && prefix.Last() !=
'?' )
1166 prefix.RemoveLast();
1170 prefix.Trim(
true );
1171 prefix.Trim(
false );
1173 if( prefix.IsEmpty() )
1174 symbol->SetPrefix( wxString(
"U" ) );
1176 symbol->SetPrefix( prefix );
1182 int unit =
parseInt( aReader, line, &line );
1193 symbol->SetUnit( unit );
1196 int bodyStyle =
parseInt( aReader, line, &line );
1198 if( bodyStyle == 0 )
1207 symbol->SetBodyStyle( bodyStyle );
1212 if(
text !=
"00000000" )
1221 symbol->SetPosition( pos );
1228 if( strncasecmp(
strCompare, line, len ) != 0 )
1232 wxString pathStr, reference, unit;
1240 if(
path.size() > 0 )
1252 if( strncasecmp(
strCompare, line, len ) != 0 )
1261 if( strncasecmp(
strCompare, line, len ) != 0 )
1269 if( !unit.ToLong( &tmp, 10 ) )
1275 symbol->AddHierarchicalReference(
path, reference, (
int)tmp );
1276 symbol->GetField( FIELD_T::REFERENCE )->SetText( reference );
1280 int legacy_field_id =
parseInt( aReader, line, &line );
1286 char orientation =
parseChar( aReader, line, &line );
1292 pos.
y = -( pos.
y - symbol->GetY() ) + symbol->GetY();
1295 int attributes =
parseHex( aReader, line, &line );
1300 switch( legacy_field_id )
1302 case 0: field = symbol->GetField( FIELD_T::REFERENCE );
break;
1303 case 1: field = symbol->GetField( FIELD_T::VALUE );
break;
1304 case 2: field = symbol->GetField( FIELD_T::FOOTPRINT );
break;
1305 case 3: field = symbol->GetField( FIELD_T::DATASHEET );
break;
1308 field = symbol->AddField(
SCH_FIELD( symbol.get(), FIELD_T::USER ) );
1316 char hjustify =
parseChar( aReader, line, &line );
1323 if( hjustify ==
'L' )
1325 else if( hjustify ==
'R' )
1327 else if( hjustify !=
'C' )
1328 SCH_PARSE_ERROR(
"symbol field text horizontal justification must be "
1329 "L, R, or C", aReader, line );
1333 if( textAttrs[0] ==
'T' )
1335 else if( textAttrs[0] ==
'B' )
1337 else if( textAttrs[0] !=
'C' )
1339 "B, T, or C", aReader, line );
1342 if( textAttrs.Length() > 1 )
1344 if( textAttrs.Length() != 3 )
1346 SCH_PARSE_ERROR(
_(
"symbol field text attributes must be 3 characters wide" ),
1350 if( textAttrs[1] ==
'I' )
1354 else if( textAttrs[1] !=
'N' )
1356 SCH_PARSE_ERROR(
"symbol field text italics indicator must be I or N",
1360 if( textAttrs[2] ==
'B' )
1364 else if( textAttrs[2] !=
'N' )
1377 if( orientation ==
'H' )
1379 else if( orientation ==
'V' )
1382 SCH_PARSE_ERROR(
"symbol field orientation must be H or V", aReader, line );
1384 if(
name.IsEmpty() )
1405 instance.
m_Reference = symbol->GetField( FIELD_T::REFERENCE )->GetText();
1406 instance.
m_Unit = symbol->GetUnit();
1407 symbol->AddHierarchicalReference( instance );
1414 symbol->AddHierarchicalReference( tmpInstance );
1420 symbol->ClearFlags();
1421 return symbol.release();
1438 transform.
x1 =
parseInt( aReader, line, &line );
1440 if( transform.
x1 < -1 || transform.
x1 > 1 )
1441 SCH_PARSE_ERROR(
"invalid symbol X1 transform value", aReader, line );
1443 transform.
y1 = -
parseInt( aReader, line, &line );
1445 if( transform.
y1 < -1 || transform.
y1 > 1 )
1446 SCH_PARSE_ERROR(
"invalid symbol Y1 transform value", aReader, line );
1448 transform.
x2 =
parseInt( aReader, line, &line );
1450 if( transform.
x2 < -1 || transform.
x2 > 1 )
1451 SCH_PARSE_ERROR(
"invalid symbol X2 transform value", aReader, line );
1453 transform.
y2 = -
parseInt( aReader, line, &line );
1455 if( transform.
y2 < -1 || transform.
y2 > 1 )
1456 SCH_PARSE_ERROR(
"invalid symbol Y2 transform value", aReader, line );
1458 symbol->SetTransform( transform );
1473 auto busAlias = std::make_shared<BUS_ALIAS>( aScreen );
1474 const char* line = aReader.
Line();
1476 wxCHECK(
strCompare(
"BusAlias", line, &line ),
nullptr );
1480 busAlias->SetName( buf );
1482 while( *line !=
'\0' )
1487 if( !buf.IsEmpty() )
1488 busAlias->Members().emplace_back( buf );
1497 const std::map<std::string, UTF8>* aProperties )
1499 wxCHECK_RET( aSheet !=
nullptr,
"NULL SCH_SHEET object." );
1500 wxCHECK_RET( !aFileName.IsEmpty(),
"No schematic file name defined." );
1502 init( aSchematic, aProperties );
1504 wxFileName fn = aFileName;
1508 wxASSERT( fn.IsAbsolute() );
1522 wxCHECK_RET( aSheet !=
nullptr,
"NULL SCH_SHEET* object." );
1523 wxCHECK_RET(
m_schematic !=
nullptr,
"NULL SCHEMATIC* object." );
1565 for(
const std::shared_ptr<BUS_ALIAS>& alias : screen->
GetBusAliases() )
1570 std::multiset<
SCH_ITEM*,
decltype( cmp )> save_map( cmp );
1573 save_map.insert( item );
1576 for(
auto& item : save_map )
1578 switch( item->Type() )
1609 wxASSERT(
"Unexpected schematic object type in SCH_IO_KICAD_LEGACY::Format()" );
1621 for(
unsigned i = 0; i < aSelection->
GetSize(); ++i )
1625 switch( item->
Type() )
1656 wxASSERT(
"Unexpected schematic object type in SCH_IO_KICAD_LEGACY::Format()" );
1683 if( symbol_name.size() )
1693 m_out->
Print( 0,
"L %s %s\n", name2.c_str(), name1.c_str() );
1722 wxString
path =
"/";
1725 for(
int i = 1; i < (int) instance.m_Path.size(); ++i )
1726 path += instance.m_Path[i].AsLegacyTimestampString() +
"/";
1728 m_out->
Print( 0,
"AR Path=\"%s\" Ref=\"%s\" Part=\"%d\" \n",
1730 TO_UTF8( instance.m_Reference ),
1736 int legacy_field_id = 0;
1749 transform.
x1, transform.
y1, transform.
x2, transform.
y2 );
1756 char hjustify =
'C';
1763 char vjustify =
'C';
1770 m_out->
Print( 0,
"F %d %s %c %-3d %-3d %-3d %4.4X %c %c%c%c",
1780 aField->
IsBold() ?
'B' :
'N' );
1796 wxCHECK_RET(
image !=
nullptr,
"wxImage* is NULL" );
1805 wxMemoryOutputStream stream;
1807 image->SaveFile( stream, wxBITMAP_TYPE_PNG );
1810 wxStreamBuffer* buffer = stream.GetOutputStreamBuffer();
1811 char* begin = (
char*) buffer->GetBufferStart();
1813 for(
int ii = 0; begin < buffer->GetBufferEnd(); begin++, ii++ )
1832 wxCHECK_RET( aSheet !=
nullptr,
"SCH_SHEET* is NULL" );
1846 if( !sheetName->
GetText().IsEmpty() )
1853 if( !fileName->
GetText().IsEmpty() )
1864 if(
pin->GetText().IsEmpty() )
1867 switch(
pin->GetSide() )
1870 case SHEET_SIDE::LEFT: side =
'L';
break;
1871 case SHEET_SIDE::RIGHT: side =
'R';
break;
1872 case SHEET_SIDE::TOP: side =
'T';
break;
1873 case SHEET_SIDE::BOTTOM: side =
'B';
break;
1876 switch(
pin->GetShape() )
1879 case LABEL_FLAG_SHAPE::L_UNSPECIFIED: type =
'U';
break;
1880 case LABEL_FLAG_SHAPE::L_INPUT: type =
'I';
break;
1881 case LABEL_FLAG_SHAPE::L_OUTPUT: type =
'O';
break;
1882 case LABEL_FLAG_SHAPE::L_BIDI: type =
'B';
break;
1883 case LABEL_FLAG_SHAPE::L_TRISTATE: type =
'T';
break;
1886 m_out->
Print( 0,
"F%d %s %c %c %-3d %-3d %-3d\n",
1900 wxCHECK_RET( aJunction !=
nullptr,
"SCH_JUNCTION* is NULL" );
1910 wxCHECK_RET( aNoConnect !=
nullptr,
"SCH_NOCONNECT* is NULL" );
1920 wxCHECK_RET( aBusEntry !=
nullptr,
"SCH_BUS_ENTRY_BASE* is NULL" );
1924 m_out->
Print( 0,
"Entry Wire Line\n\t%-4d %-4d %-4d %-4d\n",
1932 m_out->
Print( 0,
"Entry Bus Bus\n\t%-4d %-4d %-4d %-4d\n",
1943 wxCHECK_RET( aLine !=
nullptr,
"SCH_LINE* is NULL" );
1945 const char* layer =
"Notes";
1946 const char* width =
"Line";
1953 m_out->
Print( 0,
"Wire %s %s", layer, width );
1967 if( stroke.
GetColor() != COLOR4D::UNSPECIFIED )
1985 wxCHECK_RET( aText !=
nullptr,
"SCH_TEXT* is NULL" );
1987 const char* italics =
"~";
1988 const char* textType =
"Notes";
2003 text.Replace( wxT(
"\n" ), wxT(
"\\n" ) );
2011 for(
unsigned ii = 0; ii <
text.Len(); )
2013 if(
text[ii] == 0x0A ||
text[ii] == 0x0D )
2014 text.erase( ii, 1 );
2029 spinStyle =
static_cast<int>( label->GetSpinStyle() );
2031 if( spinStyle == 0 )
2033 else if( spinStyle == 2 )
2037 m_out->
Print( 0,
"Text %s %-4d %-4d %-4d %-4d %s %d\n%s\n", textType,
2050 wxCHECK_RET( shapeLabelIt !=
sheetLabelNames.end(),
"Shape not found in names list" );
2052 m_out->
Print( 0,
"Text %s %-4d %-4d %-4d %-4d %s %s %d\n%s\n", textType,
2057 shapeLabelIt->second,
2066 wxCHECK_RET( aAlias !=
nullptr,
"BUS_ALIAS* is NULL" );
2068 wxString members = boost::algorithm::join( aAlias->Members(),
" " );
2076 const std::map<std::string, UTF8>* aProperties )
2094 if( aProperties && aProperties->find( propName ) != aProperties->end() )
2118 const wxString& aLibraryPath,
2119 const std::map<std::string, UTF8>* aProperties )
2121 bool powerSymbolsOnly = ( aProperties &&
2124 cacheLib( aLibraryPath, aProperties );
2128 for( LIB_SYMBOL_MAP::const_iterator it = symbols.begin(); it != symbols.end(); ++it )
2130 if( !powerSymbolsOnly || it->second->IsGlobalPower() )
2131 aSymbolNameList.Add( it->first );
2137 const wxString& aLibraryPath,
2138 const std::map<std::string, UTF8>* aProperties )
2140 bool powerSymbolsOnly = ( aProperties &&
2143 cacheLib( aLibraryPath, aProperties );
2147 for( LIB_SYMBOL_MAP::const_iterator it = symbols.begin(); it != symbols.end(); ++it )
2149 if( !powerSymbolsOnly || it->second->IsGlobalPower() )
2150 aSymbolList.push_back( it->second );
2156 const wxString& aSymbolName,
2157 const std::map<std::string, UTF8>* aProperties )
2159 cacheLib( aLibraryPath, aProperties );
2161 LIB_SYMBOL_MAP::const_iterator it =
m_cache->
m_symbols.find( aSymbolName );
2171 const std::map<std::string, UTF8>* aProperties )
2173 cacheLib( aLibraryPath, aProperties );
2183 const std::map<std::string, UTF8>* aProperties )
2185 cacheLib( aLibraryPath, aProperties );
2195 const std::map<std::string, UTF8>* aProperties )
2197 if( wxFileExists( aLibraryPath ) )
2199 THROW_IO_ERROR( wxString::Format(
_(
"Symbol library '%s' already exists." ),
2200 aLibraryPath.GetData() ) );
2212 const std::map<std::string, UTF8>* aProperties )
2214 wxFileName fn = aLibraryPath;
2216 if( !fn.FileExists() )
2221 if( wxRemove( aLibraryPath ) )
2223 THROW_IO_ERROR( wxString::Format(
_(
"Symbol library '%s' cannot be deleted." ),
2224 aLibraryPath.GetData() ) );
2238 const std::map<std::string, UTF8>* aProperties )
constexpr EDA_IU_SCALE schIUScale
void SetPageCount(int aPageCount)
int GetVirtualPageNumber() const
void SetVirtualPageNumber(int aPageNumber)
void SetContentModified(bool aModified=true)
This class handle bitmap images in KiCad.
bool IsHorizontal() const
KICAD_T Type() const
Returns the type of object.
virtual void SetParent(EDA_ITEM *aParent)
const EDA_ANGLE & GetTextAngle() const
void SetTextSize(VECTOR2I aNewSize, bool aEnforceMinTextSize=true)
virtual const wxString & GetText() const
Return the string associated with the text object.
virtual bool IsVisible() const
void SetTextPos(const VECTOR2I &aPoint)
void SetVertJustify(GR_TEXT_V_ALIGN_T aType)
GR_TEXT_H_ALIGN_T GetHorizJustify() const
void SetBoldFlag(bool aBold)
Set only the bold flag, without changing the font.
virtual void SetVisible(bool aVisible)
void SetItalicFlag(bool aItalic)
Set only the italic flag, without changing the font.
GR_TEXT_V_ALIGN_T GetVertJustify() const
virtual void SetTextAngle(const EDA_ANGLE &aAngle)
int GetTextThickness() const
VECTOR2I GetTextSize() const
void SetHorizJustify(GR_TEXT_H_ALIGN_T aType)
EE_TYPE OfType(KICAD_T aType) const
A LINE_READER that reads from an open file.
void Rewind()
Rewind the file and resets the line number back to zero.
char * ReadLine() override
Read a line of text into the buffer and increments the line number counter.
PROGRESS_REPORTER * m_progressReporter
Progress reporter to track the progress of the operation, may be nullptr.
virtual bool CanReadLibrary(const wxString &aFileName) const
Checks if this IO object can read the specified library file/directory.
Hold an error message and may be used when throwing exceptions containing meaningful error messages.
virtual const wxString What() const
A composite of Problem() and Where()
wxString ToCSSString() const
wxString AsLegacyTimestampString() const
timestamp_t AsLegacyTimestamp() const
A logical library item identifier and consists of various portions much like a URI.
int Parse(const UTF8 &aId, bool aFix=false)
Parse LIB_ID with the information from aId.
int SetLibItemName(const UTF8 &aLibItemName)
Override the library item name portion of the LIB_ID to aLibItemName.
Define a library symbol object.
An abstract class from which implementation specific LINE_READERs may be derived to read single lines...
virtual char * ReadLine()=0
Read a line of text into the buffer and increments the line number counter.
virtual const wxString & GetSource() const
Returns the name of the source of the lines in an abstract sense.
virtual unsigned LineNumber() const
Return the line number of the last line read from this LINE_READER.
char * Line() const
Return a pointer to the last line that was read in.
Describe the page size and margins of a paper page on which to eventually print or plot.
void SetPortrait(bool aIsPortrait)
Rotate the paper page 90 degrees.
static const wxChar Custom[]
"User" defined page type
void SetHeightMils(double aHeightInMils)
double GetHeightMils() const
const wxString & GetType() const
double GetWidthMils() const
void SetWidthMils(double aWidthInMils)
bool SetType(const wxString &aStandardPageDescriptionName, bool aIsPortrait=false)
Set the name of the page type and also the sizes and margins commonly associated with that type name.
virtual bool KeepRefreshing(bool aWait=false)=0
Update the UI (if any).
virtual void Report(const wxString &aMessage)=0
Display aMessage in the progress bar dialog.
virtual void SetCurrentProgress(double aProgress)=0
Set the progress value to aProgress (0..1).
virtual const wxString GetProjectPath() const
Return the full path of the project.
A REFERENCE_IMAGE is a wrapper around a BITMAP_IMAGE that is displayed in an editor as a reference fo...
bool ReadImageFile(const wxString &aFullFilename)
Read and store an image file.
const BITMAP_BASE & GetImage() const
Get the underlying image.
double GetImageScale() const
void SetImageScale(double aScale)
Set the image "zoom" value.
Holds all the data relating to one schematic.
PROJECT & Project() const
Return a reference to the project this schematic is part of.
bool IsValid() const
A simple test if the schematic is loaded, not a complete one.
Object to handle a bitmap image that can be inserted in a schematic.
VECTOR2I GetPosition() const override
REFERENCE_IMAGE & GetReferenceImage()
Base class for a bus or wire entry.
VECTOR2I GetPosition() const override
VECTOR2I GetLibPosition() const
wxString GetName(bool aUseDefaultName=true) const
Return the field name (not translated).
void SetName(const wxString &aName)
void SetText(const wxString &aText) override
A cache assistant for KiCad legacy symbol libraries.
static LIB_SYMBOL * LoadPart(LINE_READER &aReader, int aMajorVersion, int aMinorVersion, LIB_SYMBOL_MAP *aMap=nullptr)
void Save(const std::optional< bool > &aOpt) override
Save the entire library to file m_libFileName;.
void DeleteSymbol(const wxString &aName) override
static void SaveSymbol(LIB_SYMBOL *aSymbol, OUTPUTFORMATTER &aFormatter, LIB_SYMBOL_MAP *aMap=nullptr)
wxString m_error
For throwing exceptions or errors on partial schematic loads.
SCH_SHEET * m_currentSheet
The sheet currently being loaded.
void loadFile(const wxString &aFileName, SCH_SCREEN *aScreen)
void saveBusAlias(std::shared_ptr< BUS_ALIAS > aAlias)
void SaveSchematicFile(const wxString &aFileName, SCH_SHEET *aScreen, SCHEMATIC *aSchematic, const std::map< std::string, UTF8 > *aProperties=nullptr) override
Write aSchematic to a storage file in a format that this SCH_IO implementation knows about,...
void saveText(SCH_TEXT *aText)
void saveJunction(SCH_JUNCTION *aJunction)
virtual ~SCH_IO_KICAD_LEGACY()
void loadPageSettings(LINE_READER &aReader, SCH_SCREEN *aScreen)
OUTPUTFORMATTER * m_out
The formatter for saving SCH_SCREEN objects.
void saveField(SCH_FIELD *aField, int aLegacyId)
bool isBuffering(const std::map< std::string, UTF8 > *aProperties)
void Format(SCH_SHEET *aSheet)
void loadHierarchy(SCH_SHEET *aSheet)
void saveBusEntry(SCH_BUS_ENTRY_BASE *aBusEntry)
SCH_SYMBOL * loadSymbol(LINE_READER &aReader)
LIB_SYMBOL * LoadSymbol(const wxString &aLibraryPath, const wxString &aAliasName, const std::map< std::string, UTF8 > *aProperties=nullptr) override
Load a LIB_SYMBOL object having aPartName from the aLibraryPath containing a library format that this...
std::stack< wxString > m_currentPath
Stack to maintain nested sheet paths.
int GetModifyHash() const override
Return the modification hash from the library cache.
wxString m_path
Root project path for loading child sheets.
void LoadContent(LINE_READER &aReader, SCH_SCREEN *aScreen, int version=EESCHEMA_VERSION)
void loadHeader(LINE_READER &aReader, SCH_SCREEN *aScreen)
SCH_TEXT * loadText(LINE_READER &aReader)
void init(SCHEMATIC *aSchematic, const std::map< std::string, UTF8 > *aProperties=nullptr)
initialize PLUGIN like a constructor would.
static const char * PropBuffering
The property used internally by the plugin to enable cache buffering which prevents the library file ...
static void FormatPart(LIB_SYMBOL *aSymbol, OUTPUTFORMATTER &aFormatter)
SCH_NO_CONNECT * loadNoConnect(LINE_READER &aReader)
int m_version
Version of file being loaded.
bool CanReadSchematicFile(const wxString &aFileName) const override
Checks if this SCH_IO can read the specified schematic file.
void saveLine(SCH_LINE *aLine)
SCH_BUS_ENTRY_BASE * loadBusEntry(LINE_READER &aReader)
SCH_SHEET * LoadSchematicFile(const wxString &aFileName, SCHEMATIC *aSchematic, SCH_SHEET *aAppendToMe=nullptr, const std::map< std::string, UTF8 > *aProperties=nullptr) override
Load information from some input file format that this SCH_IO implementation knows about,...
void saveSymbol(SCH_SYMBOL *aSymbol)
SCH_SHEET * loadSheet(LINE_READER &aReader)
SCH_LINE * loadWire(LINE_READER &aReader)
void saveNoConnect(SCH_NO_CONNECT *aNoConnect)
unsigned m_lineCount
for progress reporting
void DeleteSymbol(const wxString &aLibraryPath, const wxString &aSymbolName, const std::map< std::string, UTF8 > *aProperties=nullptr) override
Delete the entire LIB_SYMBOL associated with aAliasName from the library aLibraryPath.
void SaveLibrary(const wxString &aLibraryPath, const std::map< std::string, UTF8 > *aProperties=nullptr) override
std::shared_ptr< BUS_ALIAS > loadBusAlias(LINE_READER &aReader, SCH_SCREEN *aScreen)
SCH_IO_KICAD_LEGACY_LIB_CACHE * m_cache
unsigned m_lastProgressLine
SCH_BITMAP * loadBitmap(LINE_READER &aReader)
void EnumerateSymbolLib(wxArrayString &aSymbolNameList, const wxString &aLibraryPath, const std::map< std::string, UTF8 > *aProperties=nullptr) override
Populate a list of LIB_SYMBOL alias names contained within the library aLibraryPath.
static LIB_SYMBOL * ParsePart(LINE_READER &aReader, int majorVersion=0, int minorVersion=0)
void cacheLib(const wxString &aLibraryFileName, const std::map< std::string, UTF8 > *aProperties)
SCH_SHEET * m_rootSheet
The root sheet of the schematic being loaded.
static const char * PropNoDocFile
The property used internally by the plugin to disable writing the library documentation (....
SCH_JUNCTION * loadJunction(LINE_READER &aReader)
void saveBitmap(const SCH_BITMAP &aBitmap)
void saveSheet(SCH_SHEET *aSheet)
bool IsLibraryWritable(const wxString &aLibraryPath) override
Return true if the library at aLibraryPath is writable.
void CreateLibrary(const wxString &aLibraryPath, const std::map< std::string, UTF8 > *aProperties=nullptr) override
Create a new empty library at aLibraryPath empty.
bool CanReadLibrary(const wxString &aFileName) const override
Checks if this IO object can read the specified library file/directory.
bool DeleteLibrary(const wxString &aLibraryPath, const std::map< std::string, UTF8 > *aProperties=nullptr) override
Delete an existing library and returns true, or if library does not exist returns false,...
void SaveSymbol(const wxString &aLibraryPath, const LIB_SYMBOL *aSymbol, const std::map< std::string, UTF8 > *aProperties=nullptr) override
Write aSymbol to an existing library located at aLibraryPath.
bool writeDocFile(const std::map< std::string, UTF8 > *aProperties)
LINE_READER * m_lineReader
for progress reporting
bool IsFile(const wxString &aFullPathAndFileName) const
void SetFileName(const wxString &aFileName)
virtual void AddSymbol(const LIB_SYMBOL *aSymbol)
bool IsFileChanged() const
wxString GetFileName() const
void SetModified(bool aModified=true)
Base class that schematic file and library loading and saving plugins should derive from.
virtual bool CanReadSchematicFile(const wxString &aFileName) const
Checks if this SCH_IO can read the specified schematic file.
Base class for any item which can be embedded within the SCHEMATIC container class,...
SCH_LAYER_ID GetLayer() const
Return the layer this item is on.
VECTOR2I GetPosition() const override
SPIN_STYLE GetSpinStyle() const
void SetShape(LABEL_FLAG_SHAPE aShape)
LABEL_FLAG_SHAPE GetShape() const
virtual void SetSpinStyle(SPIN_STYLE aSpinStyle)
Segment description base class to describe items which have 2 end points (track, wire,...
virtual STROKE_PARAMS GetStroke() const override
VECTOR2I GetEndPoint() const
VECTOR2I GetStartPoint() const
bool IsGraphicLine() const
Return if the line is a graphic (non electrical line)
VECTOR2I GetPosition() const override
const PAGE_INFO & GetPageSettings() const
auto & GetBusAliases() const
Return a set of bus aliases defined in this screen.
void SetTitleBlock(const TITLE_BLOCK &aTitleBlock)
void Append(SCH_ITEM *aItem, bool aUpdateLibSymbol=true)
void AddBusAlias(std::shared_ptr< BUS_ALIAS > aAlias)
Add a bus alias definition (and transfers ownership of the pointer).
void SetPageSettings(const PAGE_INFO &aPageSettings)
EE_RTREE & Items()
Get the full RTree, usually for iterating.
const wxString & GetFileName() const
const KIID & GetUuid() const
void SetFileName(const wxString &aFileName)
Set the file name for this screen to aFileName.
const TITLE_BLOCK & GetTitleBlock() const
void SetFileReadOnly(bool aIsReadOnly)
void SetFileExists(bool aFileExists)
Define a sheet pin (label) used in sheets to create hierarchical schematics.
Sheet symbol placed in a schematic, and is the entry point for a sub schematic.
wxString GetFileName() const
Return the filename corresponding to this sheet.
SCH_FIELD * GetField(FIELD_T aFieldType)
Return a mandatory field in this sheet.
bool SearchHierarchy(const wxString &aFilename, SCH_SCREEN **aScreen)
Search the existing hierarchy for an instance of screen loaded from aFileName.
SCH_SCREEN * GetScreen() const
VECTOR2I GetPosition() const override
void SetScreen(SCH_SCREEN *aScreen)
Set the SCH_SCREEN associated with this sheet to aScreen.
std::vector< SCH_SHEET_PIN * > & GetPins()
const std::vector< SCH_SYMBOL_INSTANCE > & GetInstances() const
void GetFields(std::vector< SCH_FIELD * > &aVector, bool aVisibleOnly) const override
Populate a std::vector with SCH_FIELDs, sorted in ordinal order.
VECTOR2I GetPosition() const override
const LIB_ID & GetLibId() const override
wxString GetPrefix() const
SCH_FIELD * GetField(FIELD_T aFieldType)
Return a mandatory field in this symbol.
VECTOR2I GetPosition() const override
virtual KIGFX::VIEW_ITEM * GetItem(unsigned int aIdx) const override
virtual unsigned int GetSize() const override
Return the number of stored items.
Simple container to manage line stroke parameters.
LINE_STYLE GetLineStyle() const
KIGFX::COLOR4D GetColor() const
static wxString GetLineStyleToken(LINE_STYLE aStyle)
static const char * PropPowerSymsOnly
const TRANSFORM & GetTransform() const
Hold the information shown in the lower right corner of a plot, printout, or editing view.
const wxString & GetCompany() const
void SetRevision(const wxString &aRevision)
void SetComment(int aIdx, const wxString &aComment)
const wxString & GetRevision() const
void SetTitle(const wxString &aTitle)
const wxString & GetDate() const
const wxString & GetComment(int aIdx) const
void SetCompany(const wxString &aCompany)
const wxString & GetTitle() const
void SetDate(const wxString &aDate)
Set the date field, and defaults to the current time and date.
static constexpr EDA_ANGLE ANGLE_VERTICAL
static constexpr EDA_ANGLE ANGLE_HORIZONTAL
#define MAX_UNIT_COUNT_PER_PACKAGE
The maximum number of units per package.
#define SCHEMATIC_HEAD_STRING
int GetPenSizeForBold(int aTextSize)
const wxChar *const traceSchLegacyPlugin
Flag to enable legacy schematic plugin debug output.
#define THROW_IO_ERROR(msg)
#define THROW_PARSE_ERROR(aProblem, aSource, aInputLine, aLineNumber, aByteIndex)
#define SCH_LAYER_ID_COUNT
SCH_LAYER_ID
Eeschema drawing layers.
bool fileStartsWithPrefix(const wxString &aFilePath, const wxString &aPrefix, bool aIgnoreWhitespace)
Check if a file starts with a defined string.
const std::map< LABEL_FLAG_SHAPE, const char * > sheetLabelNames
int parseInt(LINE_READER &aReader, const char *aLine, const char **aOutput)
Parse an ASCII integer string with possible leading whitespace into an integer and updates the pointe...
bool strCompare(const char *aString, const char *aLine, const char **aOutput)
Compare aString to the string starting at aLine and advances the character point to the end of String...
void parseQuotedString(wxString &aString, LINE_READER &aReader, const char *aCurrentToken, const char **aNextToken, bool aCanBeEmpty)
Parse an quoted ASCII utf8 and updates the pointer at aOutput if it is not NULL.
void parseUnquotedString(wxString &aString, LINE_READER &aReader, const char *aCurrentToken, const char **aNextToken, bool aCanBeEmpty)
Parse an unquoted utf8 string and updates the pointer at aOutput if it is not NULL.
uint32_t parseHex(LINE_READER &aReader, const char *aLine, const char **aOutput)
Parse an ASCII hex integer string with possible leading whitespace into a long integer and updates th...
char parseChar(LINE_READER &aReader, const char *aCurrentToken, const char **aNextToken)
Parse a single ASCII character and updates the pointer at aOutput if it is not NULL.
double parseDouble(LINE_READER &aReader, const char *aLine, const char **aOutput)
Parses an ASCII point string with possible leading whitespace into a double precision floating point ...
#define SCH_PARSE_ERROR(text, reader, pos)
std::string toUTFTildaText(const wxString &txt)
Convert a wxString to UTF8 and replace any control characters with a ~, where a control character is ...
wxString ConvertToNewOverbarNotation(const wxString &aOldStr)
Convert the old ~...~ overbar notation to the new ~{...} one.
wxString From_UTF8(const char *cstring)
std::string EscapedUTF8(const wxString &aString)
Return an 8 bit UTF8 string given aString in Unicode form.
#define TO_UTF8(wxstring)
Convert a wxString to a UTF8 encoded C string for all wxWidgets build modes.
constexpr int IUToMils(int iu) const
constexpr int MilsToIU(int mils) const
A simple container for schematic symbol instance information.
Definition for symbol library class.
std::map< wxString, LIB_SYMBOL *, LibSymbolMapSort > LIB_SYMBOL_MAP
wxString GetUserFieldName(int aFieldNdx, bool aTranslateForHI)
wxString GetCanonicalFieldName(FIELD_T aFieldType)
wxLogTrace helper definitions.
KICAD_T
The set of class identification values stored in EDA_ITEM::m_structType.
VECTOR2< int32_t > VECTOR2I
Definition of file extensions used in Kicad.