#include <api_handler_pcb.h>

Inheritance diagram for API_HANDLER_PCB:

Public Member Functions
	API_HANDLER_PCB (PCB_EDIT_FRAME *aFrame)

API_RESULT	Handle (ApiRequest &aMsg)
	Attempt to handle the given API request, if a handler exists in this class for the message.

Protected Types
typedef std::function< HANDLER_RESULT< ApiResponse >(ApiRequest &)>	REQUEST_HANDLER
	A handler for outer messages (envelopes) that will unpack to inner messages and call a specific handler function.

Protected Member Functions
std::unique_ptr< COMMIT >	createCommit () override
	Override this to create an appropriate COMMIT subclass for the frame in question.

kiapi::common::types::DocumentType	thisDocumentType () const override
	Override this to specify which document type this editor handles.

bool	validateDocumentInternal (const DocumentSpecifier &aDocument) const override

void	deleteItemsInternal (std::map< KIID, ItemDeletionStatus > &aItemsToDelete, const std::string &aClientName) override

std::optional< EDA_ITEM * >	getItemFromDocument (const DocumentSpecifier &aDocument, const KIID &aId) override

HANDLER_RESULT< std::optional< KIID > >	validateItemHeaderDocument (const kiapi::common::types::ItemHeader &aHeader)
	If the header is valid, returns the item container.

HANDLER_RESULT< bool >	validateDocument (const DocumentSpecifier &aDocument)

virtual std::optional< ApiResponseStatus >	checkForBusy ()
	Checks if the editor can accept commands.

HANDLER_RESULT< commands::BeginCommitResponse >	handleBeginCommit (const HANDLER_CONTEXT< commands::BeginCommit > &aCtx)

HANDLER_RESULT< commands::EndCommitResponse >	handleEndCommit (const HANDLER_CONTEXT< commands::EndCommit > &aCtx)

COMMIT *	getCurrentCommit (const std::string &aClientName)

HANDLER_RESULT< commands::CreateItemsResponse >	handleCreateItems (const HANDLER_CONTEXT< commands::CreateItems > &aCtx)

HANDLER_RESULT< commands::UpdateItemsResponse >	handleUpdateItems (const HANDLER_CONTEXT< commands::UpdateItems > &aCtx)

HANDLER_RESULT< commands::DeleteItemsResponse >	handleDeleteItems (const HANDLER_CONTEXT< commands::DeleteItems > &aCtx)

HANDLER_RESULT< commands::HitTestResponse >	handleHitTest (const HANDLER_CONTEXT< commands::HitTest > &aCtx)

template<class RequestType , class ResponseType , class HandlerType >
void	registerHandler (HANDLER_RESULT< ResponseType >(HandlerType::*aHandler)(const HANDLER_CONTEXT< RequestType > &))
	Registers an API command handler for the given message types.

Protected Attributes
std::map< std::string, std::pair< KIID, std::unique_ptr< COMMIT > > >	m_commits

std::set< std::string >	m_activeClients

EDA_BASE_FRAME *	m_frame

std::map< std::string, REQUEST_HANDLER >	m_handlers
	Maps type name (without the URL prefix) to a handler method.

Static Protected Attributes
static const wxString	m_defaultCommitMessage = _( "Modification from API" )

Private Types
typedef std::map< std::string, PROPERTY_BASE * >	PROTO_PROPERTY_MAP

Private Member Functions
HANDLER_RESULT< commands::RunActionResponse >	handleRunAction (const HANDLER_CONTEXT< commands::RunAction > &aCtx)

HANDLER_RESULT< commands::GetOpenDocumentsResponse >	handleGetOpenDocuments (const HANDLER_CONTEXT< commands::GetOpenDocuments > &aCtx)

HANDLER_RESULT< Empty >	handleSaveDocument (const HANDLER_CONTEXT< commands::SaveDocument > &aCtx)

HANDLER_RESULT< Empty >	handleSaveCopyOfDocument (const HANDLER_CONTEXT< commands::SaveCopyOfDocument > &aCtx)

HANDLER_RESULT< Empty >	handleRevertDocument (const HANDLER_CONTEXT< commands::RevertDocument > &aCtx)

HANDLER_RESULT< commands::GetItemsResponse >	handleGetItems (const HANDLER_CONTEXT< commands::GetItems > &aCtx)

HANDLER_RESULT< commands::SelectionResponse >	handleGetSelection (const HANDLER_CONTEXT< commands::GetSelection > &aCtx)

HANDLER_RESULT< Empty >	handleClearSelection (const HANDLER_CONTEXT< commands::ClearSelection > &aCtx)

HANDLER_RESULT< commands::SelectionResponse >	handleAddToSelection (const HANDLER_CONTEXT< commands::AddToSelection > &aCtx)

HANDLER_RESULT< commands::SelectionResponse >	handleRemoveFromSelection (const HANDLER_CONTEXT< commands::RemoveFromSelection > &aCtx)

HANDLER_RESULT< BoardStackupResponse >	handleGetStackup (const HANDLER_CONTEXT< GetBoardStackup > &aCtx)

HANDLER_RESULT< GraphicsDefaultsResponse >	handleGetGraphicsDefaults (const HANDLER_CONTEXT< GetGraphicsDefaults > &aCtx)

HANDLER_RESULT< types::Vector2 >	handleGetBoardOrigin (const HANDLER_CONTEXT< GetBoardOrigin > &aCtx)

HANDLER_RESULT< Empty >	handleSetBoardOrigin (const HANDLER_CONTEXT< SetBoardOrigin > &aCtx)

HANDLER_RESULT< commands::GetBoundingBoxResponse >	handleGetBoundingBox (const HANDLER_CONTEXT< commands::GetBoundingBox > &aCtx)

HANDLER_RESULT< PadShapeAsPolygonResponse >	handleGetPadShapeAsPolygon (const HANDLER_CONTEXT< GetPadShapeAsPolygon > &aCtx)

HANDLER_RESULT< types::TitleBlockInfo >	handleGetTitleBlockInfo (const HANDLER_CONTEXT< commands::GetTitleBlockInfo > &aCtx)

HANDLER_RESULT< commands::ExpandTextVariablesResponse >	handleExpandTextVariables (const HANDLER_CONTEXT< commands::ExpandTextVariables > &aCtx)

HANDLER_RESULT< Empty >	handleInteractiveMoveItems (const HANDLER_CONTEXT< InteractiveMoveItems > &aCtx)

HANDLER_RESULT< NetsResponse >	handleGetNets (const HANDLER_CONTEXT< GetNets > &aCtx)

HANDLER_RESULT< NetClassForNetsResponse >	handleGetNetClassForNets (const HANDLER_CONTEXT< GetNetClassForNets > &aCtx)

HANDLER_RESULT< Empty >	handleRefillZones (const HANDLER_CONTEXT< RefillZones > &aCtx)

HANDLER_RESULT< commands::SavedDocumentResponse >	handleSaveDocumentToString (const HANDLER_CONTEXT< commands::SaveDocumentToString > &aCtx)

HANDLER_RESULT< commands::SavedSelectionResponse >	handleSaveSelectionToString (const HANDLER_CONTEXT< commands::SaveSelectionToString > &aCtx)

HANDLER_RESULT< commands::CreateItemsResponse >	handleParseAndCreateItemsFromString (const HANDLER_CONTEXT< commands::ParseAndCreateItemsFromString > &aCtx)

HANDLER_RESULT< BoardLayers >	handleGetVisibleLayers (const HANDLER_CONTEXT< GetVisibleLayers > &aCtx)

HANDLER_RESULT< Empty >	handleSetVisibleLayers (const HANDLER_CONTEXT< SetVisibleLayers > &aCtx)

HANDLER_RESULT< BoardLayerResponse >	handleGetActiveLayer (const HANDLER_CONTEXT< GetActiveLayer > &aCtx)

HANDLER_RESULT< Empty >	handleSetActiveLayer (const HANDLER_CONTEXT< SetActiveLayer > &aCtx)

HANDLER_RESULT< BoardEditorAppearanceSettings >	handleGetBoardEditorAppearanceSettings (const HANDLER_CONTEXT< GetBoardEditorAppearanceSettings > &aCtx)

HANDLER_RESULT< Empty >	handleSetBoardEditorAppearanceSettings (const HANDLER_CONTEXT< SetBoardEditorAppearanceSettings > &aCtx)

PCB_EDIT_FRAME *	frame () const

void	pushCurrentCommit (const std::string &aClientName, const wxString &aMessage) override

std::optional< BOARD_ITEM * >	getItemById (const KIID &aId) const

HANDLER_RESULT< types::ItemRequestStatus >	handleCreateUpdateItemsInternal (bool aCreate, const std::string &aClientName, const types::ItemHeader &aHeader, const google::protobuf::RepeatedPtrField< google::protobuf::Any > &aItems, std::function< void(commands::ItemStatus, google::protobuf::Any)> aItemHandler) override

template<typename MessageType >
bool	tryUnpack (ApiRequest &aRequest, ApiResponse &aReply, MessageType &aDest)

Static Private Member Functions
static HANDLER_RESULT< std::unique_ptr< BOARD_ITEM > >	createItemForType (KICAD_T aType, BOARD_ITEM_CONTAINER *aContainer)

Detailed Description

Definition at line 50 of file api_handler_pcb.h.

Member Typedef Documentation

◆ PROTO_PROPERTY_MAP

typedef std::map<std::string, PROPERTY_BASE*> API_HANDLER_PCB::PROTO_PROPERTY_MAP

private

Definition at line 56 of file api_handler_pcb.h.

◆ REQUEST_HANDLER

typedef std::function<HANDLER_RESULT<ApiResponse>( ApiRequest& )> API_HANDLER::REQUEST_HANDLER

protectedinherited

A handler for outer messages (envelopes) that will unpack to inner messages and call a specific handler function.

See also: registerHandler.

Definition at line 76 of file api_handler.h.

Constructor & Destructor Documentation

◆ API_HANDLER_PCB()

API_HANDLER_PCB::API_HANDLER_PCB ( PCB_EDIT_FRAME * aFrame )

Definition at line 56 of file api_handler_pcb.cpp.

References handleAddToSelection(), handleClearSelection(), handleExpandTextVariables(), handleGetActiveLayer(), handleGetBoardEditorAppearanceSettings(), handleGetBoardOrigin(), handleGetBoundingBox(), handleGetGraphicsDefaults(), handleGetItems(), handleGetNetClassForNets(), handleGetNets(), handleGetOpenDocuments(), handleGetPadShapeAsPolygon(), handleGetSelection(), handleGetStackup(), handleGetTitleBlockInfo(), handleGetVisibleLayers(), handleInteractiveMoveItems(), handleParseAndCreateItemsFromString(), handleRefillZones(), handleRemoveFromSelection(), handleRevertDocument(), handleRunAction(), handleSaveCopyOfDocument(), handleSaveDocument(), handleSaveDocumentToString(), handleSaveSelectionToString(), handleSetActiveLayer(), handleSetBoardEditorAppearanceSettings(), handleSetBoardOrigin(), and handleSetVisibleLayers().

Member Function Documentation

◆ checkForBusy()

std::optional< ApiResponseStatus > API_HANDLER_EDITOR::checkForBusy ( )

protectedvirtualinherited

Checks if the editor can accept commands.

Returns: an error status if busy, std::nullopt if not busy

Definition at line 205 of file api_handler_editor.cpp.

References EDA_BASE_FRAME::CanAcceptApiCommands(), and API_HANDLER_EDITOR::m_frame.

Referenced by handleAddToSelection(), API_HANDLER_EDITOR::handleBeginCommit(), handleClearSelection(), API_HANDLER_EDITOR::handleCreateItems(), API_HANDLER_EDITOR::handleDeleteItems(), API_HANDLER_EDITOR::handleEndCommit(), handleGetBoundingBox(), handleGetItems(), API_HANDLER_EDITOR::handleHitTest(), handleInteractiveMoveItems(), handleParseAndCreateItemsFromString(), handleRefillZones(), handleRemoveFromSelection(), handleRevertDocument(), handleRunAction(), handleSaveCopyOfDocument(), handleSaveDocument(), handleSetActiveLayer(), handleSetBoardEditorAppearanceSettings(), handleSetBoardOrigin(), handleSetVisibleLayers(), and API_HANDLER_EDITOR::handleUpdateItems().

◆ createCommit()

std::unique_ptr< COMMIT > API_HANDLER_PCB::createCommit ( )

overrideprotectedvirtual

Override this to create an appropriate COMMIT subclass for the frame in question.

Returns: a new COMMIT, bound to the editor frame

Implements API_HANDLER_EDITOR.

Definition at line 265 of file api_handler_pcb.cpp.

References frame().

◆ createItemForType()

HANDLER_RESULT< std::unique_ptr< BOARD_ITEM > > API_HANDLER_PCB::createItemForType	(	KICAD_T	aType,
		BOARD_ITEM_CONTAINER *	aContainer
	)

staticprivate

Definition at line 292 of file api_handler_pcb.cpp.

References CreateItemForType(), EDA_ITEM::GetFriendlyName(), PCB_FOOTPRINT_T, and PCB_PAD_T.

Referenced by handleCreateUpdateItemsInternal().

◆ deleteItemsInternal()

void API_HANDLER_PCB::deleteItemsInternal	(	std::map< KIID, ItemDeletionStatus > &	aItemsToDelete,
		const std::string &	aClientName
	)

overrideprotectedvirtual

Implements API_HANDLER_EDITOR.

Definition at line 644 of file api_handler_pcb.cpp.

References _, frame(), PCB_BASE_FRAME::GetBoard(), API_HANDLER_EDITOR::getCurrentCommit(), BOARD::GetItem(), API_HANDLER_EDITOR::m_activeClients, pushCurrentCommit(), and COMMIT::Remove().

◆ frame()

PCB_EDIT_FRAME * API_HANDLER_PCB::frame ( ) const

private

Definition at line 111 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::m_frame.

Referenced by createCommit(), deleteItemsInternal(), getItemById(), handleAddToSelection(), handleClearSelection(), handleCreateUpdateItemsInternal(), handleExpandTextVariables(), handleGetActiveLayer(), handleGetBoardEditorAppearanceSettings(), handleGetBoardOrigin(), handleGetGraphicsDefaults(), handleGetItems(), handleGetNetClassForNets(), handleGetNets(), handleGetOpenDocuments(), handleGetSelection(), handleGetStackup(), handleGetTitleBlockInfo(), handleGetVisibleLayers(), handleInteractiveMoveItems(), handleRefillZones(), handleRemoveFromSelection(), handleRevertDocument(), handleRunAction(), handleSaveCopyOfDocument(), handleSaveDocument(), handleSaveDocumentToString(), handleSaveSelectionToString(), handleSetActiveLayer(), handleSetBoardEditorAppearanceSettings(), handleSetBoardOrigin(), handleSetVisibleLayers(), pushCurrentCommit(), and validateDocumentInternal().

◆ getCurrentCommit()

COMMIT * API_HANDLER_EDITOR::getCurrentCommit ( const std::string & aClientName )

protectedinherited

Definition at line 129 of file api_handler_editor.cpp.

References API_HANDLER_EDITOR::createCommit(), and API_HANDLER_EDITOR::m_commits.

Referenced by deleteItemsInternal(), API_HANDLER_SCH::handleCreateUpdateItemsInternal(), handleCreateUpdateItemsInternal(), and handleInteractiveMoveItems().

◆ getItemById()

std::optional< BOARD_ITEM * > API_HANDLER_PCB::getItemById ( const KIID & aId ) const

private

Definition at line 271 of file api_handler_pcb.cpp.

References frame(), PCB_BASE_FRAME::GetBoard(), DELETED_BOARD_ITEM::GetInstance(), and BOARD::GetItem().

Referenced by getItemFromDocument(), handleAddToSelection(), handleCreateUpdateItemsInternal(), handleGetBoundingBox(), handleGetPadShapeAsPolygon(), handleInteractiveMoveItems(), and handleRemoveFromSelection().

◆ getItemFromDocument()

std::optional< EDA_ITEM * > API_HANDLER_PCB::getItemFromDocument	(	const DocumentSpecifier &	aDocument,
		const KIID &	aId
	)

overrideprotectedvirtual

Implements API_HANDLER_EDITOR.

Definition at line 672 of file api_handler_pcb.cpp.

References getItemById(), and API_HANDLER_EDITOR::validateDocument().

◆ Handle()

API_RESULT API_HANDLER::Handle ( ApiRequest & aMsg )

inherited

Attempt to handle the given API request, if a handler exists in this class for the message.

Parameters

aMsg	is a request to attempt to handle

Returns: a response to send to the client, or an appropriate error

Definition at line 30 of file api_handler.cpp.

References API_HANDLER::m_handlers.

◆ handleAddToSelection()

HANDLER_RESULT< SelectionResponse > API_HANDLER_PCB::handleAddToSelection ( const HANDLER_CONTEXT< commands::AddToSelection > & aCtx )

private

Definition at line 743 of file api_handler_pcb.cpp.

References SELECTION_TOOL::AddItemsToSel(), API_HANDLER_EDITOR::checkForBusy(), frame(), getItemById(), PCB_SELECTION_TOOL::GetSelection(), TOOL_MANAGER::GetTool(), TOOLS_HOLDER::GetToolManager(), HANDLER_CONTEXT< RequestMessageType >::Request, and API_HANDLER_EDITOR::validateItemHeaderDocument().

Referenced by API_HANDLER_PCB().

◆ handleBeginCommit()

HANDLER_RESULT< BeginCommitResponse > API_HANDLER_EDITOR::handleBeginCommit ( const HANDLER_CONTEXT< commands::BeginCommit > & aCtx )

protectedinherited

Definition at line 43 of file api_handler_editor.cpp.

References API_HANDLER_EDITOR::checkForBusy(), HANDLER_CONTEXT< RequestMessageType >::ClientName, API_HANDLER_EDITOR::createCommit(), API_HANDLER_EDITOR::m_activeClients, and API_HANDLER_EDITOR::m_commits.

Referenced by API_HANDLER_EDITOR::API_HANDLER_EDITOR().

◆ handleClearSelection()

HANDLER_RESULT< Empty > API_HANDLER_PCB::handleClearSelection ( const HANDLER_CONTEXT< commands::ClearSelection > & aCtx )

private

Definition at line 721 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::checkForBusy(), frame(), TOOLS_HOLDER::GetToolManager(), HANDLER_CONTEXT< RequestMessageType >::Request, TOOL_MANAGER::RunAction(), ACTIONS::selectionClear, and API_HANDLER_EDITOR::validateItemHeaderDocument().

Referenced by API_HANDLER_PCB().

◆ handleCreateItems()

HANDLER_RESULT< CreateItemsResponse > API_HANDLER_EDITOR::handleCreateItems ( const HANDLER_CONTEXT< commands::CreateItems > & aCtx )

protectedinherited

Definition at line 219 of file api_handler_editor.cpp.

References API_HANDLER_EDITOR::checkForBusy(), HANDLER_CONTEXT< RequestMessageType >::ClientName, API_HANDLER_EDITOR::handleCreateUpdateItemsInternal(), and HANDLER_CONTEXT< RequestMessageType >::Request.

Referenced by API_HANDLER_EDITOR::API_HANDLER_EDITOR().

◆ handleCreateUpdateItemsInternal()

HANDLER_RESULT< ItemRequestStatus > API_HANDLER_PCB::handleCreateUpdateItemsInternal	(	bool	aCreate,
		const std::string &	aClientName,
		const types::ItemHeader &	aHeader,
		const google::protobuf::RepeatedPtrField< google::protobuf::Any > &	aItems,
		std::function< void(commands::ItemStatus, google::protobuf::Any)>	aItemHandler
	)

overrideprivatevirtual

◆ handleDeleteItems()

HANDLER_RESULT< DeleteItemsResponse > API_HANDLER_EDITOR::handleDeleteItems ( const HANDLER_CONTEXT< commands::DeleteItems > & aCtx )

protectedinherited

Definition at line 273 of file api_handler_editor.cpp.

References API_HANDLER_EDITOR::checkForBusy(), HANDLER_CONTEXT< RequestMessageType >::ClientName, API_HANDLER_EDITOR::deleteItemsInternal(), HANDLER_CONTEXT< RequestMessageType >::Request, and API_HANDLER_EDITOR::validateItemHeaderDocument().

Referenced by API_HANDLER_EDITOR::API_HANDLER_EDITOR().

◆ handleEndCommit()

HANDLER_RESULT< EndCommitResponse > API_HANDLER_EDITOR::handleEndCommit ( const HANDLER_CONTEXT< commands::EndCommit > & aCtx )

protectedinherited

Definition at line 72 of file api_handler_editor.cpp.

References API_HANDLER_EDITOR::checkForBusy(), HANDLER_CONTEXT< RequestMessageType >::ClientName, API_HANDLER_EDITOR::m_activeClients, API_HANDLER_EDITOR::m_commits, API_HANDLER_EDITOR::pushCurrentCommit(), and HANDLER_CONTEXT< RequestMessageType >::Request.

Referenced by API_HANDLER_EDITOR::API_HANDLER_EDITOR().

◆ handleExpandTextVariables()

HANDLER_RESULT< ExpandTextVariablesResponse > API_HANDLER_PCB::handleExpandTextVariables ( const HANDLER_CONTEXT< commands::ExpandTextVariables > & aCtx )

private

Definition at line 1081 of file api_handler_pcb.cpp.

References ExpandTextVars(), frame(), PCB_BASE_FRAME::GetBoard(), HANDLER_CONTEXT< RequestMessageType >::Request, BOARD::ResolveTextVar(), text, and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleGetActiveLayer()

HANDLER_RESULT< BoardLayerResponse > API_HANDLER_PCB::handleGetActiveLayer ( const HANDLER_CONTEXT< GetActiveLayer > & aCtx )

private

Definition at line 1348 of file api_handler_pcb.cpp.

References frame(), HANDLER_CONTEXT< RequestMessageType >::Request, and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleGetBoardEditorAppearanceSettings()

HANDLER_RESULT< BoardEditorAppearanceSettings > API_HANDLER_PCB::handleGetBoardEditorAppearanceSettings ( const HANDLER_CONTEXT< GetBoardEditorAppearanceSettings > & aCtx )

private

Definition at line 1391 of file api_handler_pcb.cpp.

References frame(), PCB_BASE_FRAME::GetDisplayOptions(), PCB_BASE_FRAME::GetPcbNewSettings(), PCB_DISPLAY_OPTIONS::m_ContrastModeDisplay, PCBNEW_SETTINGS::m_Display, PCB_DISPLAY_OPTIONS::m_NetColorMode, and PCBNEW_SETTINGS::DISPLAY_OPTIONS::m_RatsnestMode.

Referenced by API_HANDLER_PCB().

◆ handleGetBoardOrigin()

HANDLER_RESULT< types::Vector2 > API_HANDLER_PCB::handleGetBoardOrigin ( const HANDLER_CONTEXT< GetBoardOrigin > & aCtx )

private

Definition at line 888 of file api_handler_pcb.cpp.

References frame(), BOARD_DESIGN_SETTINGS::GetAuxOrigin(), PCB_BASE_FRAME::GetBoard(), BOARD::GetDesignSettings(), BOARD_DESIGN_SETTINGS::GetGridOrigin(), kiapi::common::PackVector2(), HANDLER_CONTEXT< RequestMessageType >::Request, and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleGetBoundingBox()

HANDLER_RESULT< GetBoundingBoxResponse > API_HANDLER_PCB::handleGetBoundingBox ( const HANDLER_CONTEXT< commands::GetBoundingBox > & aCtx )

private

Definition at line 974 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::checkForBusy(), EDA_ITEM::GetBoundingBox(), getItemById(), kiapi::common::PackBox2(), PCB_FOOTPRINT_T, HANDLER_CONTEXT< RequestMessageType >::Request, EDA_ITEM::Type(), and API_HANDLER_EDITOR::validateItemHeaderDocument().

Referenced by API_HANDLER_PCB().

◆ handleGetGraphicsDefaults()

HANDLER_RESULT< GraphicsDefaultsResponse > API_HANDLER_PCB::handleGetGraphicsDefaults ( const HANDLER_CONTEXT< GetGraphicsDefaults > & aCtx )

private

Definition at line 848 of file api_handler_pcb.cpp.

References frame(), PCB_BASE_FRAME::GetBoard(), BOARD::GetDesignSettings(), LAYER_CLASS_COUNT, BOARD_DESIGN_SETTINGS::m_LineThickness, BOARD_DESIGN_SETTINGS::m_TextItalic, BOARD_DESIGN_SETTINGS::m_TextSize, BOARD_DESIGN_SETTINGS::m_TextThickness, BOARD_DESIGN_SETTINGS::m_TextUpright, HANDLER_CONTEXT< RequestMessageType >::Request, text, API_HANDLER_EDITOR::validateDocument(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by API_HANDLER_PCB().

◆ handleGetItems()

HANDLER_RESULT< GetItemsResponse > API_HANDLER_PCB::handleGetItems ( const HANDLER_CONTEXT< commands::GetItems > & aCtx )

private

Definition at line 513 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::checkForBusy(), BOARD::Drawings(), BOARD::Footprints(), frame(), PCB_BASE_FRAME::GetBoard(), PCB_ARC_T, PCB_FOOTPRINT_T, PCB_PAD_T, PCB_SHAPE_T, PCB_TEXT_T, PCB_TEXTBOX_T, PCB_TRACE_T, PCB_VIA_T, PCB_ZONE_T, HANDLER_CONTEXT< RequestMessageType >::Request, BOARD::Tracks(), TYPE_NOT_INIT, API_HANDLER_EDITOR::validateItemHeaderDocument(), and BOARD::Zones().

Referenced by API_HANDLER_PCB().

◆ handleGetNetClassForNets()

HANDLER_RESULT< NetClassForNetsResponse > API_HANDLER_PCB::handleGetNetClassForNets ( const HANDLER_CONTEXT< GetNetClassForNets > & aCtx )

private

Definition at line 1182 of file api_handler_pcb.cpp.

References frame(), PCB_BASE_FRAME::GetBoard(), NETINFO_ITEM::GetNetClass(), BOARD::GetNetInfo(), NETINFO_LIST::GetNetItem(), HANDLER_CONTEXT< RequestMessageType >::Request, and NETCLASS::Serialize().

Referenced by API_HANDLER_PCB().

◆ handleGetNets()

HANDLER_RESULT< NetsResponse > API_HANDLER_PCB::handleGetNets ( const HANDLER_CONTEXT< GetNets > & aCtx )

private

Definition at line 1151 of file api_handler_pcb.cpp.

References frame(), PCB_BASE_FRAME::GetBoard(), NETCLASS::GetName(), BOARD::GetNetInfo(), HANDLER_CONTEXT< RequestMessageType >::Request, and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleGetOpenDocuments()

HANDLER_RESULT< GetOpenDocumentsResponse > API_HANDLER_PCB::handleGetOpenDocuments ( const HANDLER_CONTEXT< commands::GetOpenDocuments > & aCtx )

private

Definition at line 134 of file api_handler_pcb.cpp.

References frame(), Prj(), and HANDLER_CONTEXT< RequestMessageType >::Request.

Referenced by API_HANDLER_PCB().

◆ handleGetPadShapeAsPolygon()

HANDLER_RESULT< PadShapeAsPolygonResponse > API_HANDLER_PCB::handleGetPadShapeAsPolygon ( const HANDLER_CONTEXT< GetPadShapeAsPolygon > & aCtx )

private

Definition at line 1015 of file api_handler_pcb.cpp.

References ARC_HIGH_DEF, SHAPE_POLY_SET::COutline(), ERROR_INSIDE, getItemById(), kiapi::common::PackPolyLine(), pad, PCB_PAD_T, HANDLER_CONTEXT< RequestMessageType >::Request, and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleGetSelection()

HANDLER_RESULT< SelectionResponse > API_HANDLER_PCB::handleGetSelection ( const HANDLER_CONTEXT< commands::GetSelection > & aCtx )

private

Definition at line 682 of file api_handler_pcb.cpp.

References filter, frame(), PCB_SELECTION_TOOL::GetSelection(), TOOL_MANAGER::GetTool(), TOOLS_HOLDER::GetToolManager(), HANDLER_CONTEXT< RequestMessageType >::Request, TYPE_NOT_INIT, and API_HANDLER_EDITOR::validateItemHeaderDocument().

Referenced by API_HANDLER_PCB().

◆ handleGetStackup()

HANDLER_RESULT< BoardStackupResponse > API_HANDLER_PCB::handleGetStackup ( const HANDLER_CONTEXT< GetBoardStackup > & aCtx )

private

Definition at line 817 of file api_handler_pcb.cpp.

References frame(), GetBoard(), PCB_BASE_FRAME::GetBoard(), BOARD::GetStackupOrDefault(), HANDLER_CONTEXT< RequestMessageType >::Request, BOARD_STACKUP::Serialize(), UNDEFINED_LAYER, and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleGetTitleBlockInfo()

HANDLER_RESULT< types::TitleBlockInfo > API_HANDLER_PCB::handleGetTitleBlockInfo ( const HANDLER_CONTEXT< commands::GetTitleBlockInfo > & aCtx )

private

Definition at line 1050 of file api_handler_pcb.cpp.

References frame(), PCB_BASE_FRAME::GetBoard(), TITLE_BLOCK::GetComment(), TITLE_BLOCK::GetCompany(), TITLE_BLOCK::GetDate(), TITLE_BLOCK::GetRevision(), TITLE_BLOCK::GetTitle(), BOARD::GetTitleBlock(), HANDLER_CONTEXT< RequestMessageType >::Request, and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleGetVisibleLayers()

HANDLER_RESULT< BoardLayers > API_HANDLER_PCB::handleGetVisibleLayers ( const HANDLER_CONTEXT< GetVisibleLayers > & aCtx )

private

Definition at line 1300 of file api_handler_pcb.cpp.

References frame(), GetBoard(), HANDLER_CONTEXT< RequestMessageType >::Request, and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleHitTest()

HANDLER_RESULT< HitTestResponse > API_HANDLER_EDITOR::handleHitTest ( const HANDLER_CONTEXT< commands::HitTest > & aCtx )

protectedinherited

Definition at line 322 of file api_handler_editor.cpp.

References API_HANDLER_EDITOR::checkForBusy(), API_HANDLER_EDITOR::getItemFromDocument(), HANDLER_CONTEXT< RequestMessageType >::Request, kiapi::common::UnpackVector2(), and API_HANDLER_EDITOR::validateItemHeaderDocument().

Referenced by API_HANDLER_EDITOR::API_HANDLER_EDITOR().

◆ handleInteractiveMoveItems()

HANDLER_RESULT< Empty > API_HANDLER_PCB::handleInteractiveMoveItems ( const HANDLER_CONTEXT< InteractiveMoveItems > & aCtx )

private

Definition at line 1109 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::checkForBusy(), HANDLER_CONTEXT< RequestMessageType >::ClientName, frame(), API_HANDLER_EDITOR::getCurrentCommit(), getItemById(), PCB_SELECTION_TOOL::GetSelection(), TOOL_MANAGER::GetTool(), TOOLS_HOLDER::GetToolManager(), PCB_ACTIONS::move, TOOL_MANAGER::PostAPIAction(), HANDLER_CONTEXT< RequestMessageType >::Request, TOOL_MANAGER::RunAction(), ACTIONS::selectionClear, ACTIONS::selectItems, SELECTION::SetReferencePoint(), and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleParseAndCreateItemsFromString()

HANDLER_RESULT< CreateItemsResponse > API_HANDLER_PCB::handleParseAndCreateItemsFromString ( const HANDLER_CONTEXT< commands::ParseAndCreateItemsFromString > & aCtx )

private

Definition at line 1284 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::checkForBusy(), HANDLER_CONTEXT< RequestMessageType >::Request, and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleRefillZones()

HANDLER_RESULT< Empty > API_HANDLER_PCB::handleRefillZones ( const HANDLER_CONTEXT< RefillZones > & aCtx )

private

Definition at line 1207 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::checkForBusy(), frame(), TOOLS_HOLDER::GetToolManager(), HANDLER_CONTEXT< RequestMessageType >::Request, TOOL_MANAGER::RunAction(), API_HANDLER_EDITOR::validateDocument(), and PCB_ACTIONS::zoneFillAll.

Referenced by API_HANDLER_PCB().

◆ handleRemoveFromSelection()

HANDLER_RESULT< SelectionResponse > API_HANDLER_PCB::handleRemoveFromSelection ( const HANDLER_CONTEXT< commands::RemoveFromSelection > & aCtx )

private

Definition at line 780 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::checkForBusy(), frame(), getItemById(), PCB_SELECTION_TOOL::GetSelection(), TOOL_MANAGER::GetTool(), TOOLS_HOLDER::GetToolManager(), SELECTION_TOOL::RemoveItemsFromSel(), HANDLER_CONTEXT< RequestMessageType >::Request, and API_HANDLER_EDITOR::validateItemHeaderDocument().

Referenced by API_HANDLER_PCB().

◆ handleRevertDocument()

HANDLER_RESULT< Empty > API_HANDLER_PCB::handleRevertDocument ( const HANDLER_CONTEXT< commands::RevertDocument > & aCtx )

private

Definition at line 237 of file api_handler_pcb.cpp.

References PROJECT::AbsolutePath(), API_HANDLER_EDITOR::checkForBusy(), frame(), GetBoard(), PCB_BASE_FRAME::GetScreen(), KICTL_REVERT, PCB_EDIT_FRAME::OpenProjectFiles(), KIWAY_HOLDER::Prj(), EDA_DRAW_FRAME::ReleaseFile(), HANDLER_CONTEXT< RequestMessageType >::Request, BASE_SCREEN::SetContentModified(), and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleRunAction()

HANDLER_RESULT< RunActionResponse > API_HANDLER_PCB::handleRunAction ( const HANDLER_CONTEXT< commands::RunAction > & aCtx )

private

Definition at line 117 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::checkForBusy(), frame(), and HANDLER_CONTEXT< RequestMessageType >::Request.

Referenced by API_HANDLER_PCB().

◆ handleSaveCopyOfDocument()

HANDLER_RESULT< Empty > API_HANDLER_PCB::handleSaveCopyOfDocument ( const HANDLER_CONTEXT< commands::SaveCopyOfDocument > & aCtx )

private

Definition at line 177 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::checkForBusy(), PCB_EDIT_FRAME::Files_io_from_id(), frame(), PCB_BASE_FRAME::GetBoard(), BOARD::GetFileName(), ID_SAVE_BOARD, FILEEXT::KiCadPcbFileExtension, Prj(), HANDLER_CONTEXT< RequestMessageType >::Request, PCB_EDIT_FRAME::SavePcbCopy(), and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleSaveDocument()

HANDLER_RESULT< Empty > API_HANDLER_PCB::handleSaveDocument ( const HANDLER_CONTEXT< commands::SaveDocument > & aCtx )

private

Definition at line 161 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::checkForBusy(), PCB_EDIT_FRAME::Files_io_from_id(), frame(), ID_SAVE_BOARD, HANDLER_CONTEXT< RequestMessageType >::Request, and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleSaveDocumentToString()

HANDLER_RESULT< SavedDocumentResponse > API_HANDLER_PCB::handleSaveDocumentToString ( const HANDLER_CONTEXT< commands::SaveDocumentToString > & aCtx )

private

Definition at line 1237 of file api_handler_pcb.cpp.

References frame(), GetBoard(), HANDLER_CONTEXT< RequestMessageType >::Request, CLIPBOARD_IO::SaveBoard(), CLIPBOARD_IO::SetWriter(), and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleSaveSelectionToString()

HANDLER_RESULT< SavedSelectionResponse > API_HANDLER_PCB::handleSaveSelectionToString ( const HANDLER_CONTEXT< commands::SaveSelectionToString > & aCtx )

private

Definition at line 1261 of file api_handler_pcb.cpp.

References frame(), PCB_BASE_FRAME::GetBoard(), PCB_SELECTION_TOOL::GetSelection(), TOOL_MANAGER::GetTool(), TOOLS_HOLDER::GetToolManager(), CLIPBOARD_IO::SaveSelection(), CLIPBOARD_IO::SetBoard(), and CLIPBOARD_IO::SetWriter().

Referenced by API_HANDLER_PCB().

◆ handleSetActiveLayer()

HANDLER_RESULT< Empty > API_HANDLER_PCB::handleSetActiveLayer ( const HANDLER_CONTEXT< SetActiveLayer > & aCtx )

private

Definition at line 1364 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::checkForBusy(), frame(), GetBoard(), HANDLER_CONTEXT< RequestMessageType >::Request, PCB_EDIT_FRAME::SetActiveLayer(), and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleSetBoardEditorAppearanceSettings()

HANDLER_RESULT< Empty > API_HANDLER_PCB::handleSetBoardEditorAppearanceSettings ( const HANDLER_CONTEXT< SetBoardEditorAppearanceSettings > & aCtx )

private

◆ handleSetBoardOrigin()

HANDLER_RESULT< Empty > API_HANDLER_PCB::handleSetBoardOrigin ( const HANDLER_CONTEXT< SetBoardOrigin > & aCtx )

private

Definition at line 925 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::checkForBusy(), PCB_ACTIONS::drillSetOrigin, frame(), PCB_BASE_FRAME::GetBoard(), BOARD::GetDesignSettings(), TOOLS_HOLDER::GetToolManager(), HANDLER_CONTEXT< RequestMessageType >::Request, TOOL_MANAGER::RunAction(), BOARD_DESIGN_SETTINGS::SetGridOrigin(), kiapi::common::UnpackVector2(), and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleSetVisibleLayers()

HANDLER_RESULT< Empty > API_HANDLER_PCB::handleSetVisibleLayers ( const HANDLER_CONTEXT< SetVisibleLayers > & aCtx )

private

Definition at line 1317 of file api_handler_pcb.cpp.

References API_HANDLER_EDITOR::checkForBusy(), LSET::Contains(), frame(), PCB_BASE_EDIT_FRAME::GetAppearancePanel(), GetBoard(), PCB_BASE_FRAME::GetBoard(), PCB_BASE_FRAME::GetCanvas(), BOARD::GetEnabledLayers(), APPEARANCE_CONTROLS::OnBoardChanged(), HANDLER_CONTEXT< RequestMessageType >::Request, BASE_SET::set(), BOARD::SetVisibleLayers(), PCB_DRAW_PANEL_GAL::SyncLayersVisibility(), and API_HANDLER_EDITOR::validateDocument().

Referenced by API_HANDLER_PCB().

◆ handleUpdateItems()

HANDLER_RESULT< UpdateItemsResponse > API_HANDLER_EDITOR::handleUpdateItems ( const HANDLER_CONTEXT< commands::UpdateItems > & aCtx )

protectedinherited

Definition at line 246 of file api_handler_editor.cpp.

References API_HANDLER_EDITOR::checkForBusy(), HANDLER_CONTEXT< RequestMessageType >::ClientName, API_HANDLER_EDITOR::handleCreateUpdateItemsInternal(), and HANDLER_CONTEXT< RequestMessageType >::Request.

Referenced by API_HANDLER_EDITOR::API_HANDLER_EDITOR().

◆ pushCurrentCommit()

void API_HANDLER_PCB::pushCurrentCommit	(	const std::string &	aClientName,
		const wxString &	aMessage
	)

overrideprivatevirtual

Reimplemented from API_HANDLER_EDITOR.

Definition at line 258 of file api_handler_pcb.cpp.

References frame(), and API_HANDLER_EDITOR::pushCurrentCommit().

Referenced by deleteItemsInternal(), and handleCreateUpdateItemsInternal().

◆ registerHandler()

template<class RequestType , class ResponseType , class HandlerType >

void API_HANDLER::registerHandler ( HANDLER_RESULT< ResponseType >(HandlerType::*)(const HANDLER_CONTEXT< RequestType > &) aHandler )

inlineprotectedinherited

Registers an API command handler for the given message types.

When an API request matching the given type comes in, the handler will be called and its response will be packed into an envelope for sending back to the API client.

If the given message does not unpack into the request type, an envelope is returned with status AS_BAD_REQUEST, which probably indicates corruption in the message.

Template Parameters

RequestType	is a protobuf message type containing a command
ResponseType	is a protobuf message type containing a command response
HandlerType	is the implied type of the API_HANDLER subclass

Parameters

aHandler is the handler function for the given request and response types

Definition at line 93 of file api_handler.h.

References HANDLER_CONTEXT< RequestMessageType >::ClientName, and HANDLER_CONTEXT< RequestMessageType >::Request.

◆ thisDocumentType()

kiapi::common::types::DocumentType API_HANDLER_PCB::thisDocumentType ( ) const

inlineoverrideprotectedvirtual

Override this to specify which document type this editor handles.

Implements API_HANDLER_EDITOR.

Definition at line 145 of file api_handler_pcb.h.

◆ tryUnpack()

template<typename MessageType >

bool API_HANDLER::tryUnpack	(	ApiRequest &	aRequest,
		ApiResponse &	aReply,
		MessageType &	aDest
	)

inlineprivateinherited

Definition at line 136 of file api_handler.h.

◆ validateDocument()

HANDLER_RESULT< bool > API_HANDLER_EDITOR::validateDocument ( const DocumentSpecifier & aDocument )

protectedinherited

◆ validateDocumentInternal()

bool API_HANDLER_PCB::validateDocumentInternal ( const DocumentSpecifier & aDocument ) const

overrideprotectedvirtual

Returns: true if the given document is valid for this editor and is currently open

Implements API_HANDLER_EDITOR.

Definition at line 282 of file api_handler_pcb.cpp.

References frame().

◆ validateItemHeaderDocument()

HANDLER_RESULT< std::optional< KIID > > API_HANDLER_EDITOR::validateItemHeaderDocument ( const kiapi::common::types::ItemHeader & aHeader )

protectedinherited

If the header is valid, returns the item container.

Definition at line 170 of file api_handler_editor.cpp.

References API_HANDLER_EDITOR::thisDocumentType(), API_HANDLER_EDITOR::validateDocument(), and API_HANDLER_EDITOR::validateDocumentInternal().

Referenced by handleAddToSelection(), handleClearSelection(), API_HANDLER_SCH::handleCreateUpdateItemsInternal(), handleCreateUpdateItemsInternal(), API_HANDLER_EDITOR::handleDeleteItems(), handleGetBoundingBox(), handleGetItems(), handleGetSelection(), API_HANDLER_EDITOR::handleHitTest(), and handleRemoveFromSelection().

Member Data Documentation

◆ m_activeClients

std::set<std::string> API_HANDLER_EDITOR::m_activeClients

protectedinherited

Definition at line 110 of file api_handler_editor.h.

Referenced by deleteItemsInternal(), API_HANDLER_EDITOR::handleBeginCommit(), API_HANDLER_SCH::handleCreateUpdateItemsInternal(), handleCreateUpdateItemsInternal(), API_HANDLER_EDITOR::handleEndCommit(), and API_HANDLER_EDITOR::pushCurrentCommit().

◆ m_commits

std::map<std::string, std::pair<KIID, std::unique_ptr<COMMIT> > > API_HANDLER_EDITOR::m_commits

protectedinherited

Definition at line 108 of file api_handler_editor.h.

Referenced by API_HANDLER_EDITOR::getCurrentCommit(), API_HANDLER_EDITOR::handleBeginCommit(), API_HANDLER_EDITOR::handleEndCommit(), and API_HANDLER_EDITOR::pushCurrentCommit().

◆ m_defaultCommitMessage

const wxString API_HANDLER::m_defaultCommitMessage = _( "Modification from API" )

staticprotectedinherited

Definition at line 131 of file api_handler.h.

Referenced by API_HANDLER_EDITOR::pushCurrentCommit().

◆ m_frame

EDA_BASE_FRAME* API_HANDLER_EDITOR::m_frame

protectedinherited

Definition at line 112 of file api_handler_editor.h.

Referenced by API_HANDLER_EDITOR::checkForBusy(), and frame().

◆ m_handlers

std::map<std::string, REQUEST_HANDLER> API_HANDLER::m_handlers

protectedinherited

Maps type name (without the URL prefix) to a handler method.

Definition at line 129 of file api_handler.h.

Referenced by API_HANDLER::Handle().

The documentation for this class was generated from the following files:

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Types

Private Member Functions

Static Private Member Functions

Detailed Description

Member Typedef Documentation

◆ PROTO_PROPERTY_MAP

◆ REQUEST_HANDLER

Constructor & Destructor Documentation

◆ API_HANDLER_PCB()

Member Function Documentation

◆ checkForBusy()

◆ createCommit()

◆ createItemForType()

◆ deleteItemsInternal()

◆ frame()

◆ getCurrentCommit()

◆ getItemById()

◆ getItemFromDocument()

◆ Handle()

◆ handleAddToSelection()

◆ handleBeginCommit()

◆ handleClearSelection()

◆ handleCreateItems()

◆ handleCreateUpdateItemsInternal()

◆ handleDeleteItems()

◆ handleEndCommit()

◆ handleExpandTextVariables()

◆ handleGetActiveLayer()

◆ handleGetBoardEditorAppearanceSettings()

◆ handleGetBoardOrigin()

◆ handleGetBoundingBox()

◆ handleGetGraphicsDefaults()

◆ handleGetItems()

◆ handleGetNetClassForNets()

◆ handleGetNets()

◆ handleGetOpenDocuments()

◆ handleGetPadShapeAsPolygon()

◆ handleGetSelection()

◆ handleGetStackup()

◆ handleGetTitleBlockInfo()

◆ handleGetVisibleLayers()

◆ handleHitTest()

◆ handleInteractiveMoveItems()

◆ handleParseAndCreateItemsFromString()

◆ handleRefillZones()

◆ handleRemoveFromSelection()

◆ handleRevertDocument()

◆ handleRunAction()

◆ handleSaveCopyOfDocument()

◆ handleSaveDocument()

◆ handleSaveDocumentToString()

◆ handleSaveSelectionToString()

◆ handleSetActiveLayer()

◆ handleSetBoardEditorAppearanceSettings()

◆ handleSetBoardOrigin()

◆ handleSetVisibleLayers()

◆ handleUpdateItems()

◆ pushCurrentCommit()

◆ registerHandler()

◆ thisDocumentType()

◆ tryUnpack()

◆ validateDocument()

◆ validateDocumentInternal()

◆ validateItemHeaderDocument()

Member Data Documentation

◆ m_activeClients

◆ m_commits

◆ m_defaultCommitMessage

◆ m_frame

◆ m_handlers