/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2020 Roberto Fernandez Bautista * Copyright (C) 2020-2023 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 3 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, see . */ #ifndef CADSTAR_ARCHIVE_PLUGIN_H_ #define CADSTAR_ARCHIVE_PLUGIN_H_ #include #include #include #include // PCB_LAYER_ID #include class PCB_IO_CADSTAR_ARCHIVE : public PCB_IO, public LAYER_REMAPPABLE_PLUGIN { public: const IO_BASE::IO_FILE_DESC GetBoardFileDesc() const override { return IO_BASE::IO_FILE_DESC( _HKI( "CADSTAR PCB Archive files" ), { "cpa" } ); } const IO_BASE::IO_FILE_DESC GetLibraryDesc() const override { return GetBoardFileDesc(); } bool CanReadBoard( const wxString& aFileName ) const override; bool CanReadLibrary( const wxString& aFileName ) const override; bool CanReadFootprint( const wxString& aFileName ) const override; BOARD* LoadBoard( const wxString& aFileName, BOARD* aAppendToMe, const STRING_UTF8_MAP* aProperties = nullptr, PROJECT* aProject = nullptr ) override; std::vector GetImportedCachedLibraryFootprints() override; /** * Return the automapped layers. * * @param aInputLayerDescriptionVector * @return Auto-mapped layers */ static std::map DefaultLayerMappingCallback( const std::vector& aInputLayerDescriptionVector ); /** * Register a different handler to be called when mapping of Cadstar to KiCad layers occurs. * * @param aLayerMappingHandler */ void RegisterLayerMappingCallback( LAYER_MAPPING_HANDLER aLayerMappingHandler ) override; void FootprintEnumerate( wxArrayString& aFootprintNames, const wxString& aLibraryPath, bool aBestEfforts, const STRING_UTF8_MAP* aProperties = nullptr ) override; // default implementation of GetEnumeratedFootprint is fine (call FootprintLoad) bool FootprintExists( const wxString& aLibraryPath, const wxString& aFootprintName, const STRING_UTF8_MAP* aProperties = nullptr ) override; FOOTPRINT* FootprintLoad( const wxString& aLibraryPath, const wxString& aFootprintName, bool aKeepUUID = false, const STRING_UTF8_MAP* aProperties = nullptr ) override; long long GetLibraryTimestamp( const wxString& aLibraryPath ) const override; /** * CADSTAR Plugin is read-only * @return Always false */ bool IsLibraryWritable( const wxString& aLibraryPath ) override { return false; } PCB_IO_CADSTAR_ARCHIVE(); ~PCB_IO_CADSTAR_ARCHIVE(); private: void clearLoadedFootprints(); void ensureLoadedLibrary( const wxString& aLibraryPath ); typedef std::map> NAME_TO_FOOTPRINT_MAP; std::map m_cache; std::map m_timestamps; std::vector m_loaded_footprints; bool m_show_layer_mapping_warnings; bool checkBoardHeader( const wxString& aFileName ) const; }; #endif // CADSTAR_ARCHIVE_PLUGIN_H_