#include <pgm_base.h>
#include <eda_pattern_match.h>
#include <background_jobs_monitor.h>
#include <cli_progress_reporter.h>
#include <confirm.h>
#include <api/api_handler_footprint.h>
#include <api/api_handler_fp_libraries.h>
#include <api/api_handler_pcb.h>
#include <api/api_server.h>
#include <api/api_utils.h>
#include <api/cross_probe_client.h>
#include <api/headless_footprint_context.h>
#include <api/headless_pcb_context.h>
#include <kiface_base.h>
#include <kiface_ids.h>
#include <kiway_holder.h>
#include <pcb_edit_frame.h>
#include <macros.h>
#include <gestfich.h>
#include <paths.h>
#include <pcbnew_settings.h>
#include <footprint.h>
#include <footprint_editor_settings.h>
#include <settings/settings_manager.h>
#include <settings/cvpcb_settings.h>
#include <footprint_library_adapter.h>
#include <footprint_edit_frame.h>
#include <footprint_viewer_frame.h>
#include <footprint_chooser_frame.h>
#include <footprint_wizard_frame.h>
#include <footprint_preview_panel.h>
#include <footprint_info_impl.h>
#include <board.h>
#include <board_loader.h>
#include <lib_id.h>
#include <nlohmann/json.hpp>
#include <dialogs/dialog_configure_paths.h>
#include <dialogs/panel_grid_settings.h>
#include <panel_display_options.h>
#include <panel_edit_options.h>
#include <dialogs/panel_snapping.h>
#include <panel_fp_editor_field_defaults.h>
#include <panel_fp_editor_graphics_defaults.h>
#include <panel_fp_user_layer_names.h>
#include <panel_fp_editor_color_settings.h>
#include <panel_pcbnew_color_settings.h>
#include <panel_pcbnew_action_plugins.h>
#include <panel_pcbnew_display_origin.h>
#include <panel_3D_display_options.h>
#include <panel_3D_opengl_options.h>
#include <panel_3D_raytracing_options.h>
#include <project_pcb.h>
#include <string_utils.h>
#include <thread_pool.h>
#include <trace_helpers.h>
#include <widgets/kistatusbar.h>
#include <wx/tokenzr.h>
#include "invoke_pcb_dialog.h"
#include <wildcards_and_files_ext.h>
#include "pcbnew_jobs_handler.h"
#include <diff_merge/diff_doc_kind.h>
#include <reporter.h>
#include "git/kigit_pcb_merge.h"
#include "git/kigit_fp_merge.h"
#include <git/kigit_driver_registry.h>
#include <dialogs/panel_toolbar_customization.h>
#include <3d_viewer/toolbars_3d.h>
#include <toolbars_footprint_editor.h>
#include <toolbars_pcb_editor.h>
#include <wx/crt.h>

Classes
struct	PCB::IFACE

Namespaces
namespace	PCB

Functions
static wxString	filterFootprints (const wxString &aFilterJson)
	Filter footprints based on criteria passed as JSON.

static int	PCB::pcbnewMergeExport (int aKind, const wxString &aAncestor, const wxString &aOurs, const wxString &aTheirs, const wxString &aOutput, bool aInteractive, bool aSingleFile, REPORTER *aReporter)

static int	PCB::pcbnewOpenDiffDialogExport (int aKind, const wxString &aFileA, const wxString &aFileB, const wxString &aLabelA, const wxString &aLabelB, wxWindow aParent, REPORTER aReporter)

PCB::IFACE KIFACE_BASE, UNITS_PROVIDER	PCB::kiface ("pcbnew", KIWAY::FACE_PCB)

	IFACE (const char *aName, KIWAY::FACE_T aType)

bool	OnKifaceStart (PGM_BASE aProgram, int aCtlBits, KIWAY aKiway) override

void	Reset () override

void	OnKifaceEnd () override

wxWindow *	CreateKiWindow (wxWindow aParent, int aClassId, KIWAY aKiway, int aCtlBits=0) override

void *	IfaceOrAddress (int aDataId) override
	Return a pointer to the requested object.

PCBNEW_JOBS_HANDLER *	JobHandler () const
	Accessor for the non-job diff/merge exports (pcbnewMergeExport etc.).

void	SaveFileAs (const wxString &aProjectBasePath, const wxString &aSrcProjectName, const wxString &aNewProjectBasePath, const wxString &aNewProjectName, const wxString &aSrcFilePath, wxString &aErrors) override
	Saving a file under a different name is delegated to the various KIFACEs because the project doesn't know the internal format of the various files (which may have paths in them that need updating).

int	HandleJob (JOB aJob, REPORTER aReporter, PROGRESS_REPORTER *aProgressReporter) override

bool	HandleJobConfig (JOB aJob, wxWindow aParent) override

bool	HandleApiOpenDocument (const DOCUMENT_SPEC &aSpec, KICAD_API_SERVER aServer, wxString aError) override

bool	HandleApiCloseDocument (const wxString &aBoardFileName, KICAD_API_SERVER aServer, wxString aError) override

bool	handleOpenPcb (const wxString &aPath, KICAD_API_SERVER aServer, wxString aError)

bool	handleCreatePcb (const wxString &aPath, KICAD_API_SERVER aServer, wxString aError)

bool	handleOpenFootprint (const wxString &aProjectPath, const wxString &aLibIdStr, KICAD_API_SERVER aServer, wxString aError)

void	PreloadLibraries (KIWAY *aKiway) override

void	ProjectChanged () override

void	CancelPreload (bool aBlock=true) override

void	RegisterLibraryHandlers (KICAD_API_SERVER *aServer) override

bool	LoadAllLibraries () override

void	closeCurrentDocument (KICAD_API_SERVER *aServer)

KIFACE_BASE &	Kiface ()
	Global KIFACE_BASE "get" accessor.

KIFACE_API KIFACE *	KIFACE_GETTER (int aKIFACEversion, int aKiwayVersion, PGM_BASE aProgram)
	No name mangling. Each KIFACE (DSO/DLL) will implement this once.

Variables
std::unique_ptr< PCBNEW_JOBS_HANDLER >	m_jobHandler

std::shared_ptr< BACKGROUND_JOB >	m_libraryPreloadBackgroundJob

std::future< void >	m_libraryPreloadReturn

std::atomic_bool	m_libraryPreloadInProgress

std::atomic_bool	m_libraryPreloadAbort

KIWAY *	m_kiway = nullptr

std::shared_ptr< HEADLESS_PCB_CONTEXT >	m_openContext

std::unique_ptr< API_HANDLER_PCB >	m_openHandler

std::shared_ptr< HEADLESS_FOOTPRINT_CONTEXT >	m_openFpContext

std::unique_ptr< API_HANDLER_FOOTPRINT >	m_openFpHandler

std::unique_ptr< API_HANDLER_FP_LIBRARIES >	m_apiHandlerFpLibs

Function Documentation

◆ CancelPreload()

void kiface::CancelPreload ( bool aBlock = true )

override

◆ closeCurrentDocument()

void kiface::closeCurrentDocument ( KICAD_API_SERVER * aServer )

private

◆ CreateKiWindow()

wxWindow * kiface::CreateKiWindow	(	wxWindow *	aParent,
		int	aClassId,
		KIWAY *	aKiway,
		int	aCtlBits = 0 )

override

Definition at line 13 of file pcbnew.cpp.

◆ filterFootprints()

static wxString filterFootprints ( const wxString & aFilterJson )

static

Filter footprints based on criteria passed as JSON.

Input JSON format: {"pin_count": N, "filters": ["pattern1", ...], "zero_filters": bool, "max_results": N}

Output JSON format: ["lib:footprint1", "lib:footprint2", ...]

Parameters

aFilterJson JSON string with filter parameters

Returns: JSON string with array of matching footprint LIB_IDs

Definition at line 111 of file pcbnew.cpp.

References LIBRARY_MANAGER_ADAPTER::AsyncLoad(), LIBRARY_MANAGER_ADAPTER::BlockUntilLoaded(), PROJECT_PCB::FootprintLibAdapter(), FOOTPRINT_LIBRARY_ADAPTER::GetFootprints(), LIBRARY_MANAGER_ADAPTER::GetLibraryNames(), PGM_BASE::GetSettingsManager(), name, Pgm(), SETTINGS_MANAGER::Prj(), and top().

Referenced by PCB::IFACE::IfaceOrAddress(), and FOOTPRINT_SELECT_WIDGET::UpdateList().

◆ HandleApiCloseDocument()

bool kiface::HandleApiCloseDocument	(	const wxString &	aBoardFileName,
		KICAD_API_SERVER *	aServer,
		wxString *	aError )

override

References FRAME_FOOTPRINT_EDITOR, and FRAME_FOOTPRINT_VIEWER.

◆ HandleApiOpenDocument()

bool kiface::HandleApiOpenDocument	(	const DOCUMENT_SPEC &	aSpec,
		KICAD_API_SERVER *	aServer,
		wxString *	aError )

override

References FRAME_FOOTPRINT_EDITOR, and PANEL_FP_EDIT_OPTIONS.

◆ handleCreatePcb()

bool kiface::handleCreatePcb	(	const wxString &	aPath,
		KICAD_API_SERVER *	aServer,
		wxString *	aError )

References FRAME_PCB_EDITOR.

◆ HandleJob()

int kiface::HandleJob	(	JOB *	aJob,
		REPORTER *	aReporter,
		PROGRESS_REPORTER *	aProgressReporter )

override

References FOOTPRINT_EDITOR_SETTINGS::m_MagneticItems.

◆ HandleJobConfig()

bool kiface::HandleJobConfig	(	JOB *	aJob,
		wxWindow *	aParent )

override

References GetAppSettings(), and PANEL_FP_ORIGINS_AXES.

◆ handleOpenFootprint()

bool kiface::handleOpenFootprint	(	const wxString &	aProjectPath,
		const wxString &	aLibIdStr,
		KICAD_API_SERVER *	aServer,
		wxString *	aError )

◆ handleOpenPcb()

bool kiface::handleOpenPcb	(	const wxString &	aPath,
		KICAD_API_SERVER *	aServer,
		wxString *	aError )

◆ IFACE()

kiface::IFACE	(	const char *	aName,
		KIWAY::FACE_T	aType )

Definition at line 2 of file pcbnew.cpp.

◆ IfaceOrAddress()

void * kiface::IfaceOrAddress ( int aDataId )

override

Return a pointer to the requested object.

The safest way to use this is to retrieve a pointer to a static instance of an interface, similar to how the KIFACE interface is exported. But if you know what you are doing use it to retrieve anything you want.

Parameters

aDataId identifies which object you want the address of.

Returns: the object which must be cast into the know type.

Definition at line 284 of file pcbnew.cpp.

References DIALOG_CONFIGUREPATHS, ENVVARS_CHANGED, FRAME_FOOTPRINT_CHOOSER, FRAME_FOOTPRINT_PREVIEW, FRAME_FOOTPRINT_VIEWER, and FRAME_FOOTPRINT_WIZARD.

◆ JobHandler()

PCBNEW_JOBS_HANDLER * kiface::JobHandler ( ) const

Accessor for the non-job diff/merge exports (pcbnewMergeExport etc.).

Definition at line 331 of file pcbnew.cpp.

References FRAME_FOOTPRINT_EDITOR, and FRAME_PCB_EDITOR.

◆ Kiface()

KIFACE_BASE & Kiface ( )

Global KIFACE_BASE "get" accessor.

Definition at line 662 of file pcbnew.cpp.

References PCB::kiface().

◆ KIFACE_GETTER()

KIFACE_API KIFACE * KIFACE_GETTER	(	int *	aKIFACEversion,
		int	aKiwayVersion,
		PGM_BASE *	aProgram )

No name mangling. Each KIFACE (DSO/DLL) will implement this once.

Definition at line 667 of file pcbnew.cpp.

References PCB::kiface(), and KIFACE_API.

◆ LoadAllLibraries()

bool kiface::LoadAllLibraries ( )

override

References FRAME_FOOTPRINT_EDITOR, and KIWAY::Player().

◆ OnKifaceEnd()

void kiface::OnKifaceEnd ( )

override

Definition at line 11 of file test_app_main.cpp.

◆ OnKifaceStart()

bool kiface::OnKifaceStart	(	PGM_BASE *	aProgram,
		int	aCtlBits,
		KIWAY *	aKiway )

override

Definition at line 6 of file test_app_main.cpp.

◆ PreloadLibraries()

void kiface::PreloadLibraries ( KIWAY * aKiway )

override

◆ ProjectChanged()

void kiface::ProjectChanged ( )

override

◆ RegisterLibraryHandlers()

void kiface::RegisterLibraryHandlers ( KICAD_API_SERVER * aServer )

override

References PANEL_FP_DEFAULT_FIELDS.

◆ Reset()

void kiface::Reset ( )

override

◆ SaveFileAs()

void kiface::SaveFileAs	(	const wxString &	aProjectBasePath,
		const wxString &	aSrcProjectName,
		const wxString &	aNewProjectBasePath,
		const wxString &	aNewProjectName,
		const wxString &	aSrcFilePath,
		wxString &	aErrors )

override

Saving a file under a different name is delegated to the various KIFACEs because the project doesn't know the internal format of the various files (which may have paths in them that need updating).

References FRAME_FOOTPRINT_EDITOR, GetAppSettings(), FOOTPRINT_EDITOR_SETTINGS::m_SnapInference, and PANEL_FP_SNAPPING.

Variable Documentation

◆ m_apiHandlerFpLibs

std::unique_ptr<API_HANDLER_FP_LIBRARIES> m_apiHandlerFpLibs

private

Definition at line 382 of file pcbnew.cpp.

◆ m_jobHandler

std::unique_ptr<PCBNEW_JOBS_HANDLER> m_jobHandler

private

Definition at line 369 of file pcbnew.cpp.

◆ m_kiway

KIWAY* m_kiway = nullptr

private

Definition at line 377 of file pcbnew.cpp.

◆ m_libraryPreloadAbort

std::atomic_bool m_libraryPreloadAbort

private

Definition at line 373 of file pcbnew.cpp.

◆ m_libraryPreloadBackgroundJob

std::shared_ptr<BACKGROUND_JOB> m_libraryPreloadBackgroundJob

private

Definition at line 370 of file pcbnew.cpp.

◆ m_libraryPreloadInProgress

std::atomic_bool m_libraryPreloadInProgress

private

Definition at line 372 of file pcbnew.cpp.

◆ m_libraryPreloadReturn

std::future<void> m_libraryPreloadReturn

private

Definition at line 371 of file pcbnew.cpp.

◆ m_openContext

std::shared_ptr<HEADLESS_PCB_CONTEXT> m_openContext

private

Definition at line 378 of file pcbnew.cpp.

◆ m_openFpContext

std::shared_ptr<HEADLESS_FOOTPRINT_CONTEXT> m_openFpContext

private

Definition at line 380 of file pcbnew.cpp.

◆ m_openFpHandler

std::unique_ptr<API_HANDLER_FOOTPRINT> m_openFpHandler

private

Definition at line 381 of file pcbnew.cpp.

◆ m_openHandler

std::unique_ptr<API_HANDLER_PCB> m_openHandler

private

Definition at line 379 of file pcbnew.cpp.

Classes

Namespaces

Functions

Variables

Function Documentation

◆ CancelPreload()

◆ closeCurrentDocument()

◆ CreateKiWindow()

◆ filterFootprints()

◆ HandleApiCloseDocument()

◆ HandleApiOpenDocument()

◆ handleCreatePcb()

◆ HandleJob()

◆ HandleJobConfig()

◆ handleOpenFootprint()

◆ handleOpenPcb()

◆ IFACE()

◆ IfaceOrAddress()

◆ JobHandler()

◆ Kiface()

◆ KIFACE_GETTER()

◆ LoadAllLibraries()

◆ OnKifaceEnd()

◆ OnKifaceStart()

◆ PreloadLibraries()

◆ ProjectChanged()

◆ RegisterLibraryHandlers()

◆ Reset()

◆ SaveFileAs()

Variable Documentation

◆ m_apiHandlerFpLibs

◆ m_jobHandler

◆ m_kiway

◆ m_libraryPreloadAbort

◆ m_libraryPreloadBackgroundJob

◆ m_libraryPreloadInProgress

◆ m_libraryPreloadReturn

◆ m_openContext

◆ m_openFpContext

◆ m_openFpHandler

◆ m_openHandler