#include <downgrade/board_downgrade.h>
#include <downgrade_scan.h>
#include <settings/settings_manager.h>
#include <wildcards_and_files_ext.h>
#include <algorithm>
#include <cctype>
#include <functional>
#include <memory>
#include <set>
#include <string>
#include <vector>
#include <wx/ffile.h>
#include <wx/filefn.h>
#include <base_units.h>
#include <board.h>
#include <board_design_settings.h>
#include <footprint.h>
#include <constraints/pcb_constraint.h>
#include <pad.h>
#include <pcb_barcode.h>
#include <pcb_shape.h>
#include <pcb_table.h>
#include <pcb_tablecell.h>
#include <pcb_textbox.h>
#include <pcb_track.h>
#include <pcb_point.h>
#include <pcb_reference_image.h>
#include <zone.h>
#include <zone_settings.h>
#include <netinfo.h>
#include <eda_group.h>
#include <eda_shape.h>
#include <pcb_group.h>
#include <pcb_dimension.h>
#include <pcb_generator.h>
#include <pcb_text.h>
#include <project.h>
#include <common.h>
#include <text_eval/text_eval_wrapper.h>
#include <board_stackup_manager/board_stackup.h>
#include <layer_ids.h>
#include <lset.h>
#include <io/kicad/legacy_tuning_pattern.h>
#include <geometry/shape_ellipse.h>
#include <geometry/shape_poly_set.h>
#include <pcb_io/kicad_sexpr/pcb_io_kicad_sexpr.h>
#include <pcb_io/kicad_sexpr/writers/pcb_writer_v9.h>
#include <pcb_io/kicad_sexpr/writers/pcb_writer_v10.h>

Classes
struct	TEXT_DOWNGRADE_PLAN

struct	BOARD_RULE

Functions
static bool	isEllipse (const BOARD_ITEM *aItem)

static bool	isHatchedShape (const BOARD_ITEM *aItem)

static bool	isHatchedCopperShape (const BOARD_ITEM *aItem)

static bool	isHatchedInkShape (const BOARD_ITEM *aItem)

static void	detachFromGroup (BOARD_ITEM *aItem)

static void	ellipseToPolygon (PCB_SHAPE *aShape, int aMaxError)

static int	footprintMaxError (const FOOTPRINT *aFootprint)

static void	forEachPadPrimitive (FOOTPRINT aFootprint, const std::function< void(PCB_SHAPE )> &aFunc)

static void	lowerEllipsesFp (FOOTPRINT *aFootprint)

static void	setHatchedFillsFp (FOOTPRINT aFootprint, const std::function< bool(const BOARD_ITEM )> &aMatches, FILL_T aFill)

static std::vector< PCB_SHAPE * >	barcodeToShapes (PCB_BARCODE aBarcode, BOARD_ITEM_CONTAINER aParent)

static void	lowerBarcodesFp (FOOTPRINT *aFootprint)

static void	dropPcbPointsFp (FOOTPRINT *aFootprint)

static void	dropExtrudedBodiesFp (FOOTPRINT *aFootprint)

static void	dropFootprintHeightsFp (FOOTPRINT *aFootprint)

static void	dropPadSimTypesFp (FOOTPRINT *aFootprint)

static void	dropUnitInfoFp (FOOTPRINT *aFootprint)

static void	dropJumperPadsFp (FOOTPRINT *aFootprint)

static void	dropPcbVariantsFp (FOOTPRINT *aFootprint)

static void	dropPostMachiningFp (FOOTPRINT *aFootprint)

static void	dropPressFitPadsFp (FOOTPRINT *aFootprint)

static void	dropDieDelaysFp (FOOTPRINT *aFootprint)

static void	dropGroupDesignBlocksFp (FOOTPRINT *aFootprint)

static int	countNetChains (const BOARD *aBoard)

static void	dropNetChains (BOARD *aBoard)

static int	countEllipses (const BOARD *aBoard)

static void	lowerEllipses (BOARD *aBoard)

static int	countExtrudedBodies (const BOARD *aBoard)

static void	dropExtrudedBodies (BOARD *aBoard)

static int	countFootprintHeights (const BOARD *aBoard)

static void	dropFootprintHeights (BOARD *aBoard)

static int	countThievingZones (const BOARD *aBoard)

static int	countPadSimTypes (const BOARD *aBoard)

static void	dropPadSimTypes (BOARD *aBoard)

static int	countUnitInfo (const BOARD *aBoard)

static void	dropUnitInfo (BOARD *aBoard)

static int	countBarcodes (const BOARD *aBoard)

static void	lowerBarcodes (BOARD *aBoard)

static int	countPcbVariants (const BOARD *aBoard)

static void	dropPcbVariants (BOARD *aBoard)

static int	countJumperPads (const BOARD *aBoard)

static void	dropJumperPads (BOARD *aBoard)

static bool	hasBackdrill (const PADSTACK &aPadstack)

static int	countBackdrills (const BOARD *aBoard)

static bool	hasPostMachining (const PADSTACK &aPadstack)

static int	countPostMachining (const BOARD *aBoard)

static void	dropPostMachining (BOARD *aBoard)

static int	countPressFitPads (const BOARD *aBoard)

static void	dropPressFitPads (BOARD *aBoard)

static int	countBuriedVias (const BOARD *aBoard)

static void	lowerBuriedVias (BOARD *aBoard)

static int	countZoneDefaults (const BOARD *aBoard)

static void	dropZoneDefaults (BOARD *aBoard)

static int	countSkipVias (const BOARD *aBoard)

static void	lowerSkipVias (BOARD *aBoard)

static int	countDieDelays (const BOARD *aBoard)

static void	dropDieDelays (BOARD *aBoard)

static int	countHatchedFills (const BOARD aBoard, const std::function< bool(const BOARD_ITEM )> &aMatches)

static void	setHatchedFills (BOARD aBoard, const std::function< bool(const BOARD_ITEM )> &aMatches, FILL_T aFill)

static int	countPcbPoints (const BOARD *aBoard)

static void	dropPcbPoints (BOARD *aBoard)

static int	countHighUserLayers (const BOARD *aBoard)

static bool	hasViaProtection (const PCB_VIA *aVia)

static int	countViaProtection (const BOARD *aBoard)

static void	dropViaProtection (BOARD *aBoard)

static int	countDielectricModels (const BOARD *aBoard)

static void	dropDielectricModels (BOARD *aBoard)

static int	countGroupDesignBlocks (const BOARD *aBoard)

static void	dropGroupDesignBlocks (BOARD *aBoard)

static int	countScaledFootprints (const BOARD *aBoard)

static bool	isRoundedRect (const BOARD_ITEM *aItem)

static void	roundedRectToPolygon (PCB_SHAPE *aShape, int aMaxError)

static int	countRoundedRectsFp (const FOOTPRINT *aFootprint)

static void	lowerRoundedRectsFp (FOOTPRINT *aFootprint)

static int	countRoundedRects (const BOARD *aBoard)

static void	lowerRoundedRects (BOARD *aBoard)

static int	countKnockoutTextBoxesFp (const FOOTPRINT *aFootprint)

static void	dropKnockoutTextBoxesFp (FOOTPRINT *aFootprint)

static int	countKnockoutTextBoxes (const BOARD *aBoard)

static void	dropKnockoutTextBoxes (BOARD *aBoard)

static int	countKnockoutCellsIn (const BOARD_ITEM *aItem)

static int	countKnockoutTableCells (const BOARD *aBoard)

static void	dropKnockoutCellsIn (BOARD_ITEM *aItem)

static void	dropKnockoutTableCellsFp (FOOTPRINT *aFootprint)

static void	dropKnockoutTableCells (BOARD *aBoard)

static int	countZoneLayerProperties (const BOARD *aBoard)

static void	dropZoneLayerPropertiesFp (FOOTPRINT *aFootprint)

static void	dropZoneLayerProperties (BOARD *aBoard)

static bool	hasGroupPlacementLinkage (const ZONE *aZone)

static int	countGroupPlacementAreas (const BOARD *aBoard)

static void	dropGroupPlacementLinkage (ZONE *aZone)

static void	dropGroupPlacementAreasFp (FOOTPRINT *aFootprint)

static void	dropGroupPlacementAreas (BOARD *aBoard)

static int	countCustomFpStackups (const BOARD *aBoard)

static void	omitGraphicsFp (FOOTPRINT aFootprint, const std::function< bool(const BOARD_ITEM )> &aMatches)

static void	omitGraphics (BOARD aBoard, const std::function< bool(const BOARD_ITEM )> &aMatches)

static void	omitPadPrimitives (FOOTPRINT aFootprint, const std::function< bool(const BOARD_ITEM )> &aMatches)

static void	omitEllipsesFp (FOOTPRINT *aFootprint)

static void	omitEllipses (BOARD *aBoard)

static bool	isBarcode (const BOARD_ITEM *aItem)

static void	omitBarcodesFp (FOOTPRINT *aFootprint)

static void	omitBarcodes (BOARD *aBoard)

static bool	isKnockoutTextBox (const BOARD_ITEM *aItem)

static void	omitKnockoutTextBoxesFp (FOOTPRINT *aFootprint)

static void	omitKnockoutTextBoxes (BOARD *aBoard)

static void	omitRoundedRectsFp (FOOTPRINT *aFootprint)

static void	omitRoundedRects (BOARD *aBoard)

static void	omitKnockoutCellContents (BOARD_ITEM *aItem)

static void	omitKnockoutTableCellsFp (FOOTPRINT *aFootprint)

static void	omitKnockoutTableCells (BOARD *aBoard)

static int	countConstraints (const BOARD *aBoard)

static void	dropConstraintsFp (FOOTPRINT *aFootprint)

static void	dropConstraints (BOARD *aBoard)

static bool	isGrid (const BOARD_ITEM *aItem)

static bool	isDrillDrawing (const BOARD_ITEM *aItem)

static int	countDrawings (const BOARD aBoard, const std::function< bool(const BOARD_ITEM )> &aMatches)

static int	countGrids (const BOARD *aBoard)

static void	dropGrids (BOARD *aBoard)

static int	countReferenceImageRotations (const BOARD *aBoard)

static int	countReferenceImageOpacities (const BOARD *aBoard)

static void	dropReferenceImageOpacities (BOARD *aBoard)

static int	countDrillDrawings (const BOARD *aBoard)

static void	dropDrillDrawings (BOARD *aBoard)

static int	countDrillSymbolConfiguration (const BOARD *aBoard)

static void	dropDrillSymbolConfiguration (BOARD *aBoard)

static int	countGenerators (const BOARD *aBoard, const wxString &aType)

static void	dropGenerators (BOARD aBoard, const std::function< bool(const PCB_GENERATOR )> &aMatches)

static void	dropGenerators (BOARD *aBoard, const wxString &aType)

static bool	isTimeDomainTuning (const PCB_GENERATOR *aGenerator)

static int	countTimeDomainTuning (const BOARD *aBoard)

static void	dropTimeDomainTuning (BOARD *aBoard)

static int	countUnreviewedTuningProperties (const BOARD *aBoard)

static int	countUnknownGenerators (const BOARD *aBoard)

static bool	isUnreviewedDrawing (const BOARD_ITEM *aItem)

static int	countUnreviewedDrawings (const BOARD *aBoard)

static void	visitFootprintItems (const FOOTPRINT aFootprint, const std::function< void(BOARD_ITEM )> &aVisit)

static void	visitBoardItems (const BOARD aBoard, const std::function< void(BOARD_ITEM )> &aVisit)

static int	countCustomProperties (const BOARD *aBoard)

static void	dropCustomPropertiesFp (FOOTPRINT *aFootprint)

static void	dropCustomProperties (BOARD *aBoard)

static int	countLinkedPlacementAreas (const BOARD *aBoard)

static void	dropLinkedPlacementAreas (BOARD *aBoard)

static int	countSimulationExclusions (const BOARD *aBoard)

static void	dropSimulationExclusionsFp (FOOTPRINT *aFootprint)

static void	dropSimulationExclusions (BOARD *aBoard)

static bool	hasLineEndings (const BOARD_ITEM *aItem)

static bool	unsafeLineEndings (const PCB_SHAPE *aShape)

static int	countLineEndings (const BOARD *aBoard, bool aUnsafeOnly=false)

static void	clearLineEndings (PCB_SHAPE *aShape)

static void	lowerLineEndingShape (PCB_SHAPE *aShape, int aMaxError)

static void	transformLineEndingsFp (FOOTPRINT *aFootprint, bool aOmit)

static void	transformLineEndings (BOARD *aBoard, bool aOmit)

static int	titleFieldIndex (const wxString &aName)

static const wxString &	titleFieldText (const TITLE_BLOCK &aTitle, int aIndex)

static bool	postTargetText (const wxString &aText, const BOARD *aBoard, int aTargetVersion, std::set< wxString > &aDependencies, int aDepth=0)

static bool	postTargetText (const wxString &aText, const BOARD *aBoard, int aTargetVersion)

static bool	hasActiveExpression (const wxString &aText)

static void	planTextItem (BOARD_ITEM aItem, int aTargetVersion, TEXT_DOWNGRADE_PLAN &aPlan, const std::function< bool(wxString )> *aResolver=nullptr)

static TEXT_DOWNGRADE_PLAN	planBoardText (const BOARD *aBoard, int aTargetVersion)

static void	applyTextPlan (const TEXT_DOWNGRADE_PLAN &aPlan)

static std::vector< BOARD_RULE >	boardRules ()

COMPATIBILITY_REPORT	ClassifyBoardForDowngrade (const BOARD *aBoard, const DOWNGRADE_TARGET &aTarget, bool aDropInsteadOfApproximate)
	Report what a board would lose if exported to an older KiCad.

static void	compensateImageScale (PCB_REFERENCE_IMAGE *aImage)

static void	compensateReferenceImageScalesFp (FOOTPRINT *aFootprint)

static void	compensateReferenceImageScales (BOARD *aBoard)

void	DowngradeBoardInPlace (BOARD *aBoard, const DOWNGRADE_TARGET &aTarget, bool aDropInsteadOfApproximate)
	Approximate or remove, in place, what the target cannot represent.

void	DowngradeFootprintInPlace (FOOTPRINT *aFootprint, const DOWNGRADE_TARGET &aTarget, bool aDropInsteadOfApproximate)
	Footprint-scoped downgrade for standalone .kicad_mod files the board pass never sees.

int	BoardDowngradeCoveredVersion ()
	The format the denylist was generated against. A format bump forces a review.

void	SaveBoardForTarget (BOARD *aBoard, const wxString &aPath, const DOWNGRADE_TARGET &aTarget)
	Save a board stamped for the target, using the writer for that version.

void	SaveFootprintForTarget (FOOTPRINT *aFootprint, const wxString &aPath, const DOWNGRADE_TARGET &aTarget)
	Save a single .kicad_mod footprint file for the target.

static bool	containsGroupPlacementSource (const std::string &aText)

wxString	FindUnsupportedBoardToken (const wxString &aSerialized, const DOWNGRADE_TARGET &aTarget)
	Scan serialized board text for tokens the target cannot parse.

void	FlattenBoardVariant (BOARD *aBoard, const wxString &aVariantName)
	Bake a variant's overrides into the base footprint attributes.

DOWNGRADE_FILE_RESULT	DowngradeFootprintFileToTemp (const wxString &aSrcFile, const wxString &aTmpFile, const DOWNGRADE_TARGET &aTarget, bool aDropInsteadOfApproximate)
	Load one .kicad_mod, classify it against the rule table, and write the downgraded copy to aTmpFile.

bool	ExportBoardToOlderVersion (const wxString &aSrcFile, const wxString &aDestFile, const DOWNGRADE_TARGET &aTarget, COMPATIBILITY_REPORT &aReport, wxString *aUnsupportedToken, const wxString &aVariant, bool aDropInsteadOfApproximate)
	Load a board, downgrade the copy, and write it stamped for the target.

Variables
static constexpr int	VER_USER_LAYERS = 20241229

static constexpr int	VER_TEXTBOX_KNOCKOUT = 20250210

static constexpr int	VER_SHAPE_HATCH = 20250222

static constexpr int	VER_VIA_PROTECTION = 20250228

static constexpr int	VER_ZONE_DEFAULTS = 20250302

static constexpr int	VER_JUMPER_PADS = 20250324

static constexpr int	VER_VIA_SPLIT = 20250926

static constexpr int	VER_SKIP_VIA = 20250801

static constexpr int	VER_PRESSFIT = 20250811

static constexpr int	VER_POST_MACHINING = 20251101

static constexpr int	VER_PCB_POINTS = 20250901

static constexpr int	VER_ROUNDED_RECT = 20250829

static constexpr int	VER_FP_UNITS = 20250909

static constexpr int	VER_BARCODE = 20250914

static constexpr int	VER_PAD_DIE_DELAY = 20250401

static constexpr int	VER_TIME_DOMAIN_TUNING = 20250401

static constexpr int	VER_GROUP_PLACEMENT = 20250401

static constexpr int	VER_CELL_KNOCKOUT = 20260603

static constexpr int	VER_BACKDRILL = 20251101

static constexpr int	VER_EXTRUDED_BODY = 20260410

static constexpr int	VER_ELLIPSE = 20260508

static constexpr int	VER_THIEVING = 20260513

static constexpr int	VER_NET_CHAINS = 20260512

static constexpr int	VER_PAD_SIM = 20260521

static constexpr int	VER_DIELECTRIC = 20260511

static constexpr int	VER_GROUP_LIB_ID = 20250513

static constexpr int	VER_IMAGE_PPI = 20260623

static constexpr int	VER_CONSTRAINTS = 20260624

static constexpr int	VER_GRIDS = 20260728

static constexpr int	VER_VIA_STITCH = 20260816

static constexpr int	VER_PROPERTY_VARIABLES = 20260817

static constexpr int	VER_LINE_ENDINGS = 20260818

static constexpr int	VER_SIM_EXCLUSION = 20260828

static constexpr int	VER_VIA_STACK = 20260830

static constexpr int	VER_CUSTOM_PROPERTIES = 20260831

static constexpr int	VER_DRILL_DRAWINGS = 20260901

static constexpr int	VER_FOOTPRINT_HEIGHT = 20261017

static constexpr int	VER_LINKED_PLACEMENT = 20261018

static constexpr int	VER_IMAGE_ROTATION = 20261025

static constexpr int	VER_IMAGE_OPACITY = 20261025

static constexpr int	BOARD_DOWNGRADE_COVERED = 20261025

static constexpr DATED_TOKEN	BOARD_TOKENS []

static constexpr DATED_TOKEN	BOARD_VALUES []

Function Documentation

◆ applyTextPlan()

static void applyTextPlan ( const TEXT_DOWNGRADE_PLAN & aPlan )

static

Definition at line 2534 of file board_downgrade.cpp.

References BOARD::GetTitleBlock(), TEXT_DOWNGRADE_PLAN::m_board, TEXT_DOWNGRADE_PLAN::m_replacements, TEXT_DOWNGRADE_PLAN::m_titleReplacements, TITLE_BLOCK::SetComment(), TITLE_BLOCK::SetCompany(), TITLE_BLOCK::SetDate(), TITLE_BLOCK::SetRevision(), TITLE_BLOCK::SetTitle(), and text.

Referenced by DowngradeBoardInPlace(), and DowngradeFootprintInPlace().

◆ barcodeToShapes()

static std::vector< PCB_SHAPE * > barcodeToShapes	(	PCB_BARCODE *	aBarcode,
		BOARD_ITEM_CONTAINER *	aParent )

static

◆ BoardDowngradeCoveredVersion()

int BoardDowngradeCoveredVersion ( )

The format the denylist was generated against. A format bump forces a review.

Definition at line 3084 of file board_downgrade.cpp.

References BOARD_DOWNGRADE_COVERED.

Referenced by BOOST_AUTO_TEST_CASE().

◆ boardRules()

static std::vector< BOARD_RULE > boardRules ( )

static

Definition at line 2583 of file board_downgrade.cpp.

References _, BLOCK, countBackdrills(), countBarcodes(), countBuriedVias(), countConstraints(), countCustomFpStackups(), countCustomProperties(), countDieDelays(), countDielectricModels(), countDrillDrawings(), countDrillSymbolConfiguration(), countEllipses(), countExtrudedBodies(), countFootprintHeights(), countGenerators(), countGrids(), countGroupDesignBlocks(), countGroupPlacementAreas(), countHatchedFills(), countHighUserLayers(), countJumperPads(), countKnockoutTableCells(), countKnockoutTextBoxes(), countLineEndings(), countLinkedPlacementAreas(), countNetChains(), countPadSimTypes(), countPcbPoints(), countPcbVariants(), countPostMachining(), countPressFitPads(), countReferenceImageOpacities(), countReferenceImageRotations(), countRoundedRects(), countScaledFootprints(), countSimulationExclusions(), countSkipVias(), countThievingZones(), countTimeDomainTuning(), countUnitInfo(), countUnknownGenerators(), countUnreviewedDrawings(), countUnreviewedTuningProperties(), countViaProtection(), countZoneDefaults(), countZoneLayerProperties(), DROP, dropConstraints(), dropConstraintsFp(), dropCustomProperties(), dropCustomPropertiesFp(), dropDieDelays(), dropDieDelaysFp(), dropDielectricModels(), dropDrillDrawings(), dropDrillSymbolConfiguration(), dropExtrudedBodies(), dropExtrudedBodiesFp(), dropFootprintHeights(), dropFootprintHeightsFp(), dropGenerators(), dropGrids(), dropGroupDesignBlocks(), dropGroupDesignBlocksFp(), dropGroupPlacementAreas(), dropGroupPlacementAreasFp(), dropJumperPads(), dropJumperPadsFp(), dropKnockoutTableCells(), dropKnockoutTableCellsFp(), dropKnockoutTextBoxes(), dropKnockoutTextBoxesFp(), dropLinkedPlacementAreas(), dropNetChains(), dropPadSimTypes(), dropPadSimTypesFp(), dropPcbPoints(), dropPcbPointsFp(), dropPcbVariants(), dropPcbVariantsFp(), dropPostMachining(), dropPostMachiningFp(), dropPressFitPads(), dropPressFitPadsFp(), dropReferenceImageOpacities(), dropSimulationExclusions(), dropSimulationExclusionsFp(), dropTimeDomainTuning(), dropUnitInfo(), dropUnitInfoFp(), dropViaProtection(), dropZoneDefaults(), dropZoneLayerProperties(), dropZoneLayerPropertiesFp(), FILLED_SHAPE, FIRST_FP_AFFINE_TRANSFORM, FIRST_FP_CUSTOM_STACKUP, FIRST_PCB_VARIANTS, isHatchedCopperShape(), isHatchedInkShape(), LOWER, lowerBarcodes(), lowerBarcodesFp(), lowerBuriedVias(), lowerEllipses(), lowerEllipsesFp(), lowerRoundedRects(), lowerRoundedRectsFp(), lowerSkipVias(), NO_FILL, omitBarcodes(), omitBarcodesFp(), omitEllipses(), omitEllipsesFp(), omitKnockoutTableCells(), omitKnockoutTableCellsFp(), omitKnockoutTextBoxes(), omitKnockoutTextBoxesFp(), omitRoundedRects(), omitRoundedRectsFp(), setHatchedFills(), setHatchedFillsFp(), transformLineEndings(), transformLineEndingsFp(), VER_BACKDRILL, VER_BARCODE, VER_CELL_KNOCKOUT, VER_CONSTRAINTS, VER_CUSTOM_PROPERTIES, VER_DIELECTRIC, VER_DRILL_DRAWINGS, VER_ELLIPSE, VER_EXTRUDED_BODY, VER_FOOTPRINT_HEIGHT, VER_FP_UNITS, VER_GRIDS, VER_GROUP_LIB_ID, VER_GROUP_PLACEMENT, VER_IMAGE_OPACITY, VER_IMAGE_ROTATION, VER_JUMPER_PADS, VER_LINE_ENDINGS, VER_LINKED_PLACEMENT, VER_NET_CHAINS, VER_PAD_DIE_DELAY, VER_PAD_SIM, VER_PCB_POINTS, VER_POST_MACHINING, VER_PRESSFIT, VER_ROUNDED_RECT, VER_SHAPE_HATCH, VER_SIM_EXCLUSION, VER_SKIP_VIA, VER_TEXTBOX_KNOCKOUT, VER_THIEVING, VER_TIME_DOMAIN_TUNING, VER_USER_LAYERS, VER_VIA_PROTECTION, VER_VIA_SPLIT, VER_VIA_STACK, VER_VIA_STITCH, and VER_ZONE_DEFAULTS.

Referenced by ClassifyBoardForDowngrade(), DowngradeBoardInPlace(), and DowngradeFootprintInPlace().

◆ ClassifyBoardForDowngrade()

COMPATIBILITY_REPORT ClassifyBoardForDowngrade	(	const BOARD *	aBoard,
		const DOWNGRADE_TARGET &	aTarget,
		bool	aDropInsteadOfApproximate = false )

Report what a board would lose if exported to an older KiCad.

Does not modify the board. aDropInsteadOfApproximate reports LOWER features as DROP and selects their omission transforms.

Definition at line 2821 of file board_downgrade.cpp.

References _, COMPATIBILITY_REPORT::Add(), BLOCK, BOARD_DOWNGRADE_COVERED, boardRules(), countLineEndings(), DROP, PCB_PLOT_PARAMS::GetFormat(), BOARD::GetPlotOptions(), LOWER, DOWNGRADE_TARGET::m_boardVersion, planBoardText(), PNG, SEXPR_BOARD_FILE_VERSION, text, VER_LINE_ENDINGS, and VER_PROPERTY_VARIABLES.

◆ clearLineEndings()

static void clearLineEndings ( PCB_SHAPE * aShape )

static

Definition at line 2062 of file board_downgrade.cpp.

References EDA_SHAPE::SetEndEnding(), and EDA_SHAPE::SetStartEnding().

Referenced by lowerLineEndingShape(), transformLineEndings(), and transformLineEndingsFp().

◆ compensateImageScale()

static void compensateImageScale ( PCB_REFERENCE_IMAGE * aImage )

static

Definition at line 2899 of file board_downgrade.cpp.

References REFERENCE_IMAGE::GetImage(), REFERENCE_IMAGE::GetImageScale(), BITMAP_BASE::GetLegacyPPI(), BITMAP_BASE::GetPPI(), PCB_REFERENCE_IMAGE::GetReferenceImage(), and REFERENCE_IMAGE::SetImageScale().

Referenced by compensateReferenceImageScales(), and compensateReferenceImageScalesFp().

◆ compensateReferenceImageScales()

static void compensateReferenceImageScales ( BOARD * aBoard )

static

Definition at line 2919 of file board_downgrade.cpp.

References compensateImageScale(), compensateReferenceImageScalesFp(), BOARD::Drawings(), BOARD::Footprints(), and PCB_REFERENCE_IMAGE_T.

Referenced by DowngradeBoardInPlace().

◆ compensateReferenceImageScalesFp()

static void compensateReferenceImageScalesFp ( FOOTPRINT * aFootprint )

static

Definition at line 2909 of file board_downgrade.cpp.

References compensateImageScale(), FOOTPRINT::GraphicalItems(), and PCB_REFERENCE_IMAGE_T.

Referenced by compensateReferenceImageScales(), and DowngradeFootprintInPlace().

◆ containsGroupPlacementSource()

static bool containsGroupPlacementSource ( const std::string & aText )

static

Definition at line 3114 of file board_downgrade.cpp.

References end, path, StripSexprStrings(), and text.

Referenced by FindUnsupportedBoardToken().

◆ countBackdrills()

static int countBackdrills ( const BOARD * aBoard )

static

Definition at line 693 of file board_downgrade.cpp.

References BOARD::GetPads(), hasBackdrill(), pad, PCB_VIA_T, and BOARD::Tracks().

Referenced by boardRules().

◆ countBarcodes()

static int countBarcodes ( const BOARD * aBoard )

static

Definition at line 588 of file board_downgrade.cpp.

References BOARD::Drawings(), BOARD::Footprints(), and PCB_BARCODE_T.

Referenced by boardRules().

◆ countBuriedVias()

static int countBuriedVias ( const BOARD * aBoard )

static

Definition at line 786 of file board_downgrade.cpp.

References BURIED, PCB_VIA::GetViaType(), PCB_VIA_T, and BOARD::Tracks().

Referenced by boardRules().

◆ countConstraints()

static int countConstraints ( const BOARD * aBoard )

static

Definition at line 1595 of file board_downgrade.cpp.

References BOARD::Constraints(), and BOARD::Footprints().

Referenced by boardRules().

◆ countCustomFpStackups()

static int countCustomFpStackups ( const BOARD * aBoard )

static

Definition at line 1430 of file board_downgrade.cpp.

References EXPAND_INNER_LAYERS, and BOARD::Footprints().

Referenced by boardRules().

◆ countCustomProperties()

static int countCustomProperties ( const BOARD * aBoard )

static

Definition at line 1921 of file board_downgrade.cpp.

References EDA_ITEM::HasCustomProperties(), and visitBoardItems().

◆ countDieDelays()

static int countDieDelays ( const BOARD * aBoard )

static

Definition at line 864 of file board_downgrade.cpp.

References BOARD::GetPads(), and pad.

Referenced by boardRules().

◆ countDielectricModels()

static int countDielectricModels ( const BOARD * aBoard )

static

Definition at line 1026 of file board_downgrade.cpp.

References BS_ITEM_TYPE_DIELECTRIC, CONSTANT, BOARD::GetDesignSettings(), BOARD_STACKUP::GetList(), and BOARD_DESIGN_SETTINGS::GetStackupDescriptor().

Referenced by boardRules().

◆ countDrawings()

static int countDrawings	(	const BOARD *	aBoard,
		const std::function< bool(const BOARD_ITEM *)> &	aMatches )

static

Definition at line 1646 of file board_downgrade.cpp.

References BOARD::Drawings().

Referenced by countDrillDrawings(), countGrids(), and countUnreviewedDrawings().

◆ countDrillDrawings()

static int countDrillDrawings ( const BOARD * aBoard )

static

Definition at line 1727 of file board_downgrade.cpp.

References countDrawings(), and isDrillDrawing().

Referenced by boardRules().

◆ countDrillSymbolConfiguration()

static int countDrillSymbolConfiguration ( const BOARD * aBoard )

static

Definition at line 1739 of file board_downgrade.cpp.

References BOARD::GetDesignSettings(), and BOARD_DESIGN_SETTINGS::GetDrillSymbolProfile().

Referenced by boardRules().

◆ countEllipses()

static int countEllipses ( const BOARD * aBoard )

static

Definition at line 434 of file board_downgrade.cpp.

References BOARD::Drawings(), BOARD::Footprints(), forEachPadPrimitive(), and isEllipse().

◆ countExtrudedBodies()

static int countExtrudedBodies ( const BOARD * aBoard )

static

Definition at line 479 of file board_downgrade.cpp.

References BOARD::Footprints().

Referenced by boardRules().

◆ countFootprintHeights()

static int countFootprintHeights ( const BOARD * aBoard )

static

Definition at line 500 of file board_downgrade.cpp.

References BOARD::Footprints().

Referenced by boardRules().

◆ countGenerators()

static int countGenerators	(	const BOARD *	aBoard,
		const wxString &	aType )

static

Definition at line 1751 of file board_downgrade.cpp.

References BOARD::Generators().

Referenced by boardRules().

◆ countGrids()

static int countGrids ( const BOARD * aBoard )

static

Definition at line 1652 of file board_downgrade.cpp.

References countDrawings(), and isGrid().

Referenced by boardRules().

◆ countGroupDesignBlocks()

static int countGroupDesignBlocks ( const BOARD * aBoard )

static

Definition at line 1063 of file board_downgrade.cpp.

References BOARD::Footprints(), group, and BOARD::Groups().

Referenced by boardRules().

◆ countGroupPlacementAreas()

static int countGroupPlacementAreas ( const BOARD * aBoard )

static

Definition at line 1391 of file board_downgrade.cpp.

References BOARD::Footprints(), hasGroupPlacementLinkage(), and BOARD::Zones().

Referenced by boardRules().

◆ countHatchedFills()

static int countHatchedFills	(	const BOARD *	aBoard,
		const std::function< bool(const BOARD_ITEM *)> &	aMatches )

static

Definition at line 885 of file board_downgrade.cpp.

References BOARD::Drawings(), and BOARD::Footprints().

Referenced by boardRules().

◆ countHighUserLayers()

static int countHighUserLayers ( const BOARD * aBoard )

static

Definition at line 947 of file board_downgrade.cpp.

References LSET::Contains(), BOARD::GetEnabledLayers(), User_10, and User_45.

Referenced by boardRules().

◆ countJumperPads()

static int countJumperPads ( const BOARD * aBoard )

static

Definition at line 666 of file board_downgrade.cpp.

References BOARD::Footprints().

Referenced by boardRules().

◆ countKnockoutCellsIn()

static int countKnockoutCellsIn ( const BOARD_ITEM * aItem )

static

Definition at line 1279 of file board_downgrade.cpp.

References PCB_TABLE_T, and EDA_ITEM::Type().

Referenced by countKnockoutTableCells().

◆ countKnockoutTableCells()

static int countKnockoutTableCells ( const BOARD * aBoard )

static

Definition at line 1296 of file board_downgrade.cpp.

References countKnockoutCellsIn(), BOARD::Drawings(), and BOARD::Footprints().

Referenced by boardRules().

◆ countKnockoutTextBoxes()

static int countKnockoutTextBoxes ( const BOARD * aBoard )

static

Definition at line 1249 of file board_downgrade.cpp.

References countKnockoutTextBoxesFp(), BOARD::Drawings(), BOARD::Footprints(), and PCB_TEXTBOX_T.

Referenced by boardRules().

◆ countKnockoutTextBoxesFp()

static int countKnockoutTextBoxesFp ( const FOOTPRINT * aFootprint )

static

Definition at line 1225 of file board_downgrade.cpp.

References FOOTPRINT::GraphicalItems(), and PCB_TEXTBOX_T.

Referenced by countKnockoutTextBoxes().

◆ countLineEndings()

static int countLineEndings	(	const BOARD *	aBoard,
		bool	aUnsafeOnly = false )

static

Definition at line 2048 of file board_downgrade.cpp.

References hasLineEndings(), unsafeLineEndings(), and visitBoardItems().

Referenced by boardRules(), and ClassifyBoardForDowngrade().

◆ countLinkedPlacementAreas()

static int countLinkedPlacementAreas ( const BOARD * aBoard )

static

Definition at line 1956 of file board_downgrade.cpp.

References niluuid, and BOARD::Zones().

Referenced by boardRules().

◆ countNetChains()

static int countNetChains ( const BOARD * aBoard )

static

Definition at line 400 of file board_downgrade.cpp.

References BOARD::GetNetInfo().

Referenced by boardRules().

◆ countPadSimTypes()

static int countPadSimTypes ( const BOARD * aBoard )

static

Definition at line 544 of file board_downgrade.cpp.

References BOARD::GetPads(), NONE, and pad.

Referenced by boardRules().

◆ countPcbPoints()

static int countPcbPoints ( const BOARD * aBoard )

static

Definition at line 921 of file board_downgrade.cpp.

References BOARD::Footprints(), and BOARD::Points().

Referenced by boardRules().

◆ countPcbVariants()

static int countPcbVariants ( const BOARD * aBoard )

static

Definition at line 642 of file board_downgrade.cpp.

References BOARD::Footprints(), and BOARD::GetVariantNames().

Referenced by boardRules().

◆ countPostMachining()

static int countPostMachining ( const BOARD * aBoard )

static

Definition at line 725 of file board_downgrade.cpp.

References BOARD::GetPads(), hasPostMachining(), pad, PCB_VIA_T, and BOARD::Tracks().

Referenced by boardRules().

◆ countPressFitPads()

static int countPressFitPads ( const BOARD * aBoard )

static

Definition at line 765 of file board_downgrade.cpp.

References BOARD::GetPads(), pad, and PRESSFIT.

Referenced by boardRules().

◆ countReferenceImageOpacities()

static int countReferenceImageOpacities ( const BOARD * aBoard )

static

Definition at line 1686 of file board_downgrade.cpp.

References BOARD::Drawings(), BOARD::Footprints(), REFERENCE_IMAGE::GetOpacity(), PCB_REFERENCE_IMAGE::GetReferenceImage(), and PCB_REFERENCE_IMAGE_T.

Referenced by boardRules().

◆ countReferenceImageRotations()

static int countReferenceImageRotations ( const BOARD * aBoard )

static

Definition at line 1664 of file board_downgrade.cpp.

References BOARD::Drawings(), BOARD::Footprints(), REFERENCE_IMAGE::GetOrientation(), PCB_REFERENCE_IMAGE::GetReferenceImage(), EDA_ANGLE::IsZero(), and PCB_REFERENCE_IMAGE_T.

Referenced by boardRules().

◆ countRoundedRects()

static int countRoundedRects ( const BOARD * aBoard )

static

Definition at line 1193 of file board_downgrade.cpp.

References countRoundedRectsFp(), BOARD::Drawings(), BOARD::Footprints(), and isRoundedRect().

◆ countRoundedRectsFp()

static int countRoundedRectsFp ( const FOOTPRINT * aFootprint )

static

Definition at line 1153 of file board_downgrade.cpp.

References forEachPadPrimitive(), FOOTPRINT::GraphicalItems(), and isRoundedRect().

Referenced by countRoundedRects().

◆ countScaledFootprints()

static int countScaledFootprints ( const BOARD * aBoard )

static

Definition at line 1096 of file board_downgrade.cpp.

References BOARD::Footprints().

Referenced by boardRules().

◆ countSimulationExclusions()

static int countSimulationExclusions ( const BOARD * aBoard )

static

Definition at line 1980 of file board_downgrade.cpp.

References BOARD::Footprints(), and name.

Referenced by boardRules().

◆ countSkipVias()

static int countSkipVias ( const BOARD * aBoard )

static

Definition at line 828 of file board_downgrade.cpp.

References PCB_VIA_T, START_END_ONLY, BOARD::Tracks(), and via.

Referenced by boardRules().

◆ countThievingZones()

static int countThievingZones ( const BOARD * aBoard )

static

Definition at line 521 of file board_downgrade.cpp.

References BOARD::Footprints(), and BOARD::Zones().

Referenced by boardRules().

◆ countTimeDomainTuning()

static int countTimeDomainTuning ( const BOARD * aBoard )

static

Definition at line 1803 of file board_downgrade.cpp.

References BOARD::Generators(), and isTimeDomainTuning().

Referenced by boardRules().

◆ countUnitInfo()

static int countUnitInfo ( const BOARD * aBoard )

static

Definition at line 565 of file board_downgrade.cpp.

References BOARD::Footprints().

Referenced by boardRules().

◆ countUnknownGenerators()

static int countUnknownGenerators ( const BOARD * aBoard )

static

Definition at line 1830 of file board_downgrade.cpp.

References BOARD::Generators(), and BOARD::IsItemIndexedById().

Referenced by boardRules().

◆ countUnreviewedDrawings()

static int countUnreviewedDrawings ( const BOARD * aBoard )

static

Definition at line 1883 of file board_downgrade.cpp.

References countDrawings(), BOARD::Footprints(), and isUnreviewedDrawing().

Referenced by boardRules().

◆ countUnreviewedTuningProperties()

static int countUnreviewedTuningProperties ( const BOARD * aBoard )

static

Definition at line 1815 of file board_downgrade.cpp.

References BOARD::Generators().

Referenced by boardRules().

◆ countViaProtection()

static int countViaProtection ( const BOARD * aBoard )

static

Definition at line 976 of file board_downgrade.cpp.

References BOARD::GetDesignSettings(), hasViaProtection(), BOARD_DESIGN_SETTINGS::m_CapVias, BOARD_DESIGN_SETTINGS::m_CoverViasBack, BOARD_DESIGN_SETTINGS::m_CoverViasFront, BOARD_DESIGN_SETTINGS::m_FillVias, BOARD_DESIGN_SETTINGS::m_PlugViasBack, BOARD_DESIGN_SETTINGS::m_PlugViasFront, PCB_VIA_T, and BOARD::Tracks().

Referenced by boardRules().

◆ countZoneDefaults()

static int countZoneDefaults ( const BOARD * aBoard )

static

Definition at line 816 of file board_downgrade.cpp.

References BOARD::GetDesignSettings(), and BOARD_DESIGN_SETTINGS::m_ZoneLayerProperties.

Referenced by boardRules().

◆ countZoneLayerProperties()

static int countZoneLayerProperties ( const BOARD * aBoard )

static

Definition at line 1343 of file board_downgrade.cpp.

References BOARD::Footprints(), and BOARD::Zones().

Referenced by boardRules().

◆ detachFromGroup()

static void detachFromGroup ( BOARD_ITEM * aItem )

static

Definition at line 162 of file board_downgrade.cpp.

References EDA_ITEM::GetParentGroup(), and group.

Referenced by dropConstraintsFp(), dropPcbPointsFp(), lowerBarcodesFp(), and omitGraphicsFp().

◆ DowngradeBoardInPlace()

void DowngradeBoardInPlace	(	BOARD *	aBoard,
		const DOWNGRADE_TARGET &	aTarget,
		bool	aDropInsteadOfApproximate = false )

Approximate or remove, in place, what the target cannot represent.

When aDropInsteadOfApproximate is true, omit LOWER features without generating replacements.

Definition at line 2932 of file board_downgrade.cpp.

References applyTextPlan(), boardRules(), compensateReferenceImageScales(), GERBER, PCB_PLOT_PARAMS::GetFormat(), BOARD::GetPlotOptions(), LOWER, DOWNGRADE_TARGET::m_boardVersion, planBoardText(), PNG, PCB_PLOT_PARAMS::SetFormat(), BOARD::SetPlotOptions(), VER_IMAGE_PPI, and VER_PROPERTY_VARIABLES.

◆ DowngradeFootprintFileToTemp()

DOWNGRADE_FILE_RESULT DowngradeFootprintFileToTemp	(	const wxString &	aSrcFile,
		const wxString &	aTmpFile,
		const DOWNGRADE_TARGET &	aTarget,
		bool	aDropInsteadOfApproximate = false )

Load one .kicad_mod, classify it against the rule table, and write the downgraded copy to aTmpFile.

Refuses when a block rule fires.

Definition at line 3186 of file board_downgrade.cpp.

References BOARD::Add(), ClassifyBoardForDowngrade(), CONVERTED, DowngradeFootprintInPlace(), PCB_IO_KICAD_SEXPR::ImportFootprint(), REFUSED, BOARD::Remove(), SaveFootprintForTarget(), EDA_ITEM::SetParent(), and SKIPPED.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), checkNativeFootprintGolden(), and downgradeFootprintLibraries().

◆ DowngradeFootprintInPlace()

void DowngradeFootprintInPlace	(	FOOTPRINT *	aFootprint,
		const DOWNGRADE_TARGET &	aTarget,
		bool	aDropInsteadOfApproximate )

Footprint-scoped downgrade for standalone .kicad_mod files the board pass never sees.

Definition at line 2968 of file board_downgrade.cpp.

References applyTextPlan(), boardRules(), compensateReferenceImageScalesFp(), LOWER, DOWNGRADE_TARGET::m_boardVersion, planTextItem(), text, VER_IMAGE_PPI, VER_PROPERTY_VARIABLES, and visitFootprintItems().

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), and DowngradeFootprintFileToTemp().

◆ dropConstraints()

static void dropConstraints ( BOARD * aBoard )

static

Definition at line 1619 of file board_downgrade.cpp.

References BOARD::Constraints(), dropConstraintsFp(), BOARD::Footprints(), and BOARD::Remove().

Referenced by boardRules().

◆ dropConstraintsFp()

static void dropConstraintsFp ( FOOTPRINT * aFootprint )

static

Definition at line 1606 of file board_downgrade.cpp.

References FOOTPRINT::Constraints(), detachFromGroup(), and FOOTPRINT::Remove().

Referenced by boardRules(), and dropConstraints().

◆ dropCustomProperties()

static void dropCustomProperties ( BOARD * aBoard )

static

Definition at line 1945 of file board_downgrade.cpp.

References EDA_ITEM::ClearCustomProperties(), and visitBoardItems().

◆ dropCustomPropertiesFp()

static void dropCustomPropertiesFp ( FOOTPRINT * aFootprint )

static

Definition at line 1934 of file board_downgrade.cpp.

References EDA_ITEM::ClearCustomProperties(), and visitFootprintItems().

Referenced by boardRules().

◆ dropDieDelays()

static void dropDieDelays ( BOARD * aBoard )

static

Definition at line 878 of file board_downgrade.cpp.

References dropDieDelaysFp(), and BOARD::Footprints().

Referenced by boardRules().

◆ dropDieDelaysFp()

static void dropDieDelaysFp ( FOOTPRINT * aFootprint )

static

Definition at line 386 of file board_downgrade.cpp.

References pad, and FOOTPRINT::Pads().

Referenced by boardRules(), and dropDieDelays().

◆ dropDielectricModels()

static void dropDielectricModels ( BOARD * aBoard )

static

Definition at line 1048 of file board_downgrade.cpp.

References BS_ITEM_TYPE_DIELECTRIC, CONSTANT, BOARD::GetDesignSettings(), BOARD_STACKUP::GetList(), and BOARD_DESIGN_SETTINGS::GetStackupDescriptor().

Referenced by boardRules().

◆ dropDrillDrawings()

static void dropDrillDrawings ( BOARD * aBoard )

static

Definition at line 1733 of file board_downgrade.cpp.

References isDrillDrawing(), and omitGraphics().

Referenced by boardRules().

◆ dropDrillSymbolConfiguration()

static void dropDrillSymbolConfiguration ( BOARD * aBoard )

static

Definition at line 1745 of file board_downgrade.cpp.

References BOARD::GetDesignSettings(), and BOARD_DESIGN_SETTINGS::GetDrillSymbolProfile().

Referenced by boardRules().

◆ dropExtrudedBodies()

static void dropExtrudedBodies ( BOARD * aBoard )

static

Definition at line 493 of file board_downgrade.cpp.

References dropExtrudedBodiesFp(), and BOARD::Footprints().

Referenced by boardRules().

◆ dropExtrudedBodiesFp()

static void dropExtrudedBodiesFp ( FOOTPRINT * aFootprint )

static

Definition at line 322 of file board_downgrade.cpp.

References FOOTPRINT::ClearBody().

Referenced by boardRules(), and dropExtrudedBodies().

◆ dropFootprintHeights()

static void dropFootprintHeights ( BOARD * aBoard )

static

Definition at line 514 of file board_downgrade.cpp.

References dropFootprintHeightsFp(), and BOARD::Footprints().

Referenced by boardRules().

◆ dropFootprintHeightsFp()

static void dropFootprintHeightsFp ( FOOTPRINT * aFootprint )

static

Definition at line 328 of file board_downgrade.cpp.

References FOOTPRINT::SetHeight().

Referenced by boardRules(), and dropFootprintHeights().

◆ dropGenerators() [1/2]

static void dropGenerators	(	BOARD *	aBoard,
		const std::function< bool(const PCB_GENERATOR *)> &	aMatches )

static

Definition at line 1761 of file board_downgrade.cpp.

References EDA_GROUP::AddItem(), BOARD::Generators(), EDA_GROUP::GetItems(), and BOARD::Remove().

Referenced by boardRules(), dropGenerators(), and dropTimeDomainTuning().

◆ dropGenerators() [2/2]

static void dropGenerators	(	BOARD *	aBoard,
		const wxString &	aType )

static

Definition at line 1786 of file board_downgrade.cpp.

References dropGenerators(), and PCB_GENERATOR::GetGeneratorType().

◆ dropGrids()

static void dropGrids ( BOARD * aBoard )

static

Definition at line 1658 of file board_downgrade.cpp.

References isGrid(), and omitGraphics().

Referenced by boardRules().

◆ dropGroupDesignBlocks()

static void dropGroupDesignBlocks ( BOARD * aBoard )

static

Definition at line 1086 of file board_downgrade.cpp.

References dropGroupDesignBlocksFp(), BOARD::Footprints(), group, and BOARD::Groups().

Referenced by boardRules().

◆ dropGroupDesignBlocksFp()

static void dropGroupDesignBlocksFp ( FOOTPRINT * aFootprint )

static

Definition at line 393 of file board_downgrade.cpp.

References group, and FOOTPRINT::Groups().

Referenced by boardRules(), and dropGroupDesignBlocks().

◆ dropGroupPlacementAreas()

static void dropGroupPlacementAreas ( BOARD * aBoard )

static

Definition at line 1420 of file board_downgrade.cpp.

References dropGroupPlacementAreasFp(), dropGroupPlacementLinkage(), BOARD::Footprints(), and BOARD::Zones().

Referenced by boardRules().

◆ dropGroupPlacementAreasFp()

static void dropGroupPlacementAreasFp ( FOOTPRINT * aFootprint )

static

Definition at line 1413 of file board_downgrade.cpp.

References dropGroupPlacementLinkage(), and FOOTPRINT::Zones().

Referenced by boardRules(), and dropGroupPlacementAreas().

◆ dropGroupPlacementLinkage()

static void dropGroupPlacementLinkage ( ZONE * aZone )

static

Definition at line 1402 of file board_downgrade.cpp.

References ZONE::GetPlacementAreaSourceType(), GROUP_PLACEMENT, ZONE::SetPlacementAreaEnabled(), ZONE::SetPlacementAreaSource(), ZONE::SetPlacementAreaSourceType(), and SHEETNAME.

Referenced by dropGroupPlacementAreas(), and dropGroupPlacementAreasFp().

◆ dropJumperPads()

static void dropJumperPads ( BOARD * aBoard )

static

Definition at line 680 of file board_downgrade.cpp.

References dropJumperPadsFp(), and BOARD::Footprints().

Referenced by boardRules().

◆ dropJumperPadsFp()

static void dropJumperPadsFp ( FOOTPRINT * aFootprint )

static

Definition at line 347 of file board_downgrade.cpp.

References JUMPER_GROUP_SET::Clear(), FOOTPRINT::JumperPadGroups(), and FOOTPRINT::SetDuplicatePadNumbersAreJumpers().

Referenced by boardRules(), and dropJumperPads().

◆ dropKnockoutCellsIn()

static void dropKnockoutCellsIn ( BOARD_ITEM * aItem )

static

Definition at line 1313 of file board_downgrade.cpp.

References PCB_TABLE_T, and EDA_ITEM::Type().

Referenced by dropKnockoutTableCells(), and dropKnockoutTableCellsFp().

◆ dropKnockoutTableCells()

static void dropKnockoutTableCells ( BOARD * aBoard )

static

Definition at line 1333 of file board_downgrade.cpp.

References BOARD::Drawings(), dropKnockoutCellsIn(), dropKnockoutTableCellsFp(), and BOARD::Footprints().

Referenced by boardRules().

◆ dropKnockoutTableCellsFp()

static void dropKnockoutTableCellsFp ( FOOTPRINT * aFootprint )

static

Definition at line 1326 of file board_downgrade.cpp.

References dropKnockoutCellsIn(), and FOOTPRINT::GraphicalItems().

Referenced by boardRules(), and dropKnockoutTableCells().

◆ dropKnockoutTextBoxes()

static void dropKnockoutTextBoxes ( BOARD * aBoard )

static

Definition at line 1266 of file board_downgrade.cpp.

References BOARD::Drawings(), dropKnockoutTextBoxesFp(), BOARD::Footprints(), and PCB_TEXTBOX_T.

Referenced by boardRules().

◆ dropKnockoutTextBoxesFp()

static void dropKnockoutTextBoxesFp ( FOOTPRINT * aFootprint )

static

Definition at line 1239 of file board_downgrade.cpp.

References FOOTPRINT::GraphicalItems(), and PCB_TEXTBOX_T.

Referenced by boardRules(), and dropKnockoutTextBoxes().

◆ dropLinkedPlacementAreas()

static void dropLinkedPlacementAreas ( BOARD * aBoard )

static

Definition at line 1970 of file board_downgrade.cpp.

References niluuid, and BOARD::Zones().

Referenced by boardRules().

◆ dropNetChains()

static void dropNetChains ( BOARD * aBoard )

static

Definition at line 415 of file board_downgrade.cpp.

References chain, BOARD::GetNetChainColors(), BOARD::GetNetInfo(), BOARD::SetNetChainColor(), and KIGFX::COLOR4D::UNSPECIFIED.

Referenced by boardRules().

◆ dropPadSimTypes()

static void dropPadSimTypes ( BOARD * aBoard )

static

Definition at line 558 of file board_downgrade.cpp.

References dropPadSimTypesFp(), and BOARD::Footprints().

Referenced by boardRules().

◆ dropPadSimTypesFp()

static void dropPadSimTypesFp ( FOOTPRINT * aFootprint )

static

Definition at line 334 of file board_downgrade.cpp.

References NONE, pad, and FOOTPRINT::Pads().

Referenced by boardRules(), and dropPadSimTypes().

◆ dropPcbPoints()

static void dropPcbPoints ( BOARD * aBoard )

static

Definition at line 932 of file board_downgrade.cpp.

References dropPcbPointsFp(), BOARD::Footprints(), BOARD::Points(), and BOARD::Remove().

Referenced by boardRules().

◆ dropPcbPointsFp()

static void dropPcbPointsFp ( FOOTPRINT * aFootprint )

static

Definition at line 310 of file board_downgrade.cpp.

References detachFromGroup(), and FOOTPRINT::Points().

Referenced by boardRules(), and dropPcbPoints().

◆ dropPcbVariants()

static void dropPcbVariants ( BOARD * aBoard )

static

Definition at line 656 of file board_downgrade.cpp.

References dropPcbVariantsFp(), BOARD::Footprints(), BOARD::SetCurrentVariant(), and BOARD::SetVariantNames().

Referenced by boardRules().

◆ dropPcbVariantsFp()

static void dropPcbVariantsFp ( FOOTPRINT * aFootprint )

static

Definition at line 354 of file board_downgrade.cpp.

References FOOTPRINT::DeleteVariant(), FOOTPRINT::GetVariants(), and name.

Referenced by boardRules(), and dropPcbVariants().

◆ dropPostMachining()

static void dropPostMachining ( BOARD * aBoard )

static

Definition at line 745 of file board_downgrade.cpp.

References clear(), dropPostMachiningFp(), BOARD::Footprints(), PCB_VIA_T, and BOARD::Tracks().

Referenced by boardRules().

◆ dropPostMachiningFp()

static void dropPostMachiningFp ( FOOTPRINT * aFootprint )

static

Definition at line 366 of file board_downgrade.cpp.

References pad, and FOOTPRINT::Pads().

Referenced by boardRules(), and dropPostMachining().

◆ dropPressFitPads()

static void dropPressFitPads ( BOARD * aBoard )

static

Definition at line 779 of file board_downgrade.cpp.

References dropPressFitPadsFp(), and BOARD::Footprints().

Referenced by boardRules().

◆ dropPressFitPadsFp()

static void dropPressFitPadsFp ( FOOTPRINT * aFootprint )

static

Definition at line 376 of file board_downgrade.cpp.

References NONE, pad, FOOTPRINT::Pads(), and PRESSFIT.

Referenced by boardRules(), and dropPressFitPads().

◆ dropReferenceImageOpacities()

static void dropReferenceImageOpacities ( BOARD * aBoard )

static

Definition at line 1708 of file board_downgrade.cpp.

References BOARD::Drawings(), BOARD::Footprints(), PCB_REFERENCE_IMAGE_T, and PCB_REFERENCE_IMAGE::SetOpacity().

Referenced by boardRules().

◆ dropSimulationExclusions()

static void dropSimulationExclusions ( BOARD * aBoard )

static

Definition at line 2008 of file board_downgrade.cpp.

References dropSimulationExclusionsFp(), and BOARD::Footprints().

Referenced by boardRules().

◆ dropSimulationExclusionsFp()

static void dropSimulationExclusionsFp ( FOOTPRINT * aFootprint )

static

Definition at line 1999 of file board_downgrade.cpp.

References FOOTPRINT::GetVariant(), FOOTPRINT::GetVariants(), name, FOOTPRINT::SetExcludedFromSim(), and FOOTPRINT_VARIANT::SetExcludedFromSim().

Referenced by boardRules(), and dropSimulationExclusions().

◆ dropTimeDomainTuning()

static void dropTimeDomainTuning ( BOARD * aBoard )

static

Definition at line 1809 of file board_downgrade.cpp.

References dropGenerators(), and isTimeDomainTuning().

Referenced by boardRules().

◆ dropUnitInfo()

static void dropUnitInfo ( BOARD * aBoard )

static

Definition at line 581 of file board_downgrade.cpp.

References dropUnitInfoFp(), and BOARD::Footprints().

Referenced by boardRules().

◆ dropUnitInfoFp()

static void dropUnitInfoFp ( FOOTPRINT * aFootprint )

static

Definition at line 341 of file board_downgrade.cpp.

References FOOTPRINT::SetUnitInfo().

Referenced by boardRules(), and dropUnitInfo().

◆ dropViaProtection()

static void dropViaProtection ( BOARD * aBoard )

static

Definition at line 998 of file board_downgrade.cpp.

References PADSTACK::BackOuterLayers(), PADSTACK::Drill(), PADSTACK::FrontOuterLayers(), BOARD::GetDesignSettings(), PADSTACK::MASK_LAYER_PROPS::has_covering, PADSTACK::MASK_LAYER_PROPS::has_plugging, PADSTACK::DRILL_PROPS::is_capped, PADSTACK::DRILL_PROPS::is_filled, BOARD_DESIGN_SETTINGS::m_CapVias, BOARD_DESIGN_SETTINGS::m_CoverViasBack, BOARD_DESIGN_SETTINGS::m_CoverViasFront, BOARD_DESIGN_SETTINGS::m_FillVias, BOARD_DESIGN_SETTINGS::m_PlugViasBack, BOARD_DESIGN_SETTINGS::m_PlugViasFront, PCB_VIA_T, and BOARD::Tracks().

Referenced by boardRules().

◆ dropZoneDefaults()

static void dropZoneDefaults ( BOARD * aBoard )

static

Definition at line 822 of file board_downgrade.cpp.

References BOARD::GetDesignSettings(), and BOARD_DESIGN_SETTINGS::m_ZoneLayerProperties.

Referenced by boardRules().

◆ dropZoneLayerProperties()

static void dropZoneLayerProperties ( BOARD * aBoard )

static

Definition at line 1373 of file board_downgrade.cpp.

References dropZoneLayerPropertiesFp(), BOARD::Footprints(), and BOARD::Zones().

Referenced by boardRules().

◆ dropZoneLayerPropertiesFp()

static void dropZoneLayerPropertiesFp ( FOOTPRINT * aFootprint )

static

Definition at line 1366 of file board_downgrade.cpp.

References FOOTPRINT::Zones().

Referenced by boardRules(), and dropZoneLayerProperties().

◆ ellipseToPolygon()

static void ellipseToPolygon	(	PCB_SHAPE *	aShape,
		int	aMaxError )

static

◆ ExportBoardToOlderVersion()

bool ExportBoardToOlderVersion	(	const wxString &	aSrcFile,
		const wxString &	aDestFile,
		const DOWNGRADE_TARGET &	aTarget,
		COMPATIBILITY_REPORT &	aReport,
		wxString *	aUnsupportedToken = nullptr,
		const wxString &	aVariant = wxEmptyString,
		bool	aDropInsteadOfApproximate = false )

Load a board, downgrade the copy, and write it stamped for the target.

Fails closed and removes the output if the result would not open there. aUnsupportedToken receives the offending token.

Definition at line 3218 of file board_downgrade.cpp.

References ClassifyBoardForDowngrade(), DowngradeBoardInPlace(), FlattenBoardVariant(), SETTINGS_MANAGER::GetProject(), COMPATIBILITY_REPORT::IsBlocked(), PCB_IO::LoadBoard(), SETTINGS_MANAGER::LoadProject(), DOWNGRADE_TARGET::m_boardVersion, FILEEXT::ProjectFileExtension, SaveBoardForTarget(), and VerifyDowngradedFile().

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), checkCustomPadArcSurvives(), checkExportUsesOnlyKnownTokens(), checkNativeBoardGolden(), checkTransformedBoardUsesOnlyKnownTokens(), and PCBNEW_JOBS_HANDLER::JobDowngrade().

◆ FindUnsupportedBoardToken()

wxString FindUnsupportedBoardToken	(	const wxString &	aSerialized,
		const DOWNGRADE_TARGET &	aTarget )

Scan serialized board text for tokens the target cannot parse.

Returns the first such token, or empty if the output is safe. Non-empty means refuse the export.

Definition at line 3152 of file board_downgrade.cpp.

References BOARD_TOKENS, BOARD_VALUES, containsGroupPlacementSource(), FindUnsupportedToken(), DOWNGRADE_TARGET::m_boardVersion, SEXPR_BOARD_FILE_VERSION, and VER_GROUP_PLACEMENT.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), and BOOST_AUTO_TEST_CASE().

◆ FlattenBoardVariant()

void FlattenBoardVariant	(	BOARD *	aBoard,
		const wxString &	aVariantName )

Bake a variant's overrides into the base footprint attributes.

Run before the variant registry is dropped, so the exported board matches the chosen variant.

Definition at line 3165 of file board_downgrade.cpp.

References BOARD::Footprints(), and name.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), ExportBoardToOlderVersion(), and PCBNEW_JOBS_HANDLER::JobDowngrade().

◆ footprintMaxError()

static int footprintMaxError ( const FOOTPRINT * aFootprint )

static

Definition at line 208 of file board_downgrade.cpp.

References BOARD_ITEM::GetBoard(), BOARD::GetDesignSettings(), BOARD_DESIGN_SETTINGS::m_MaxError, and pcbIUScale.

Referenced by lowerEllipsesFp(), lowerRoundedRectsFp(), and transformLineEndingsFp().

◆ forEachPadPrimitive()

static void forEachPadPrimitive	(	FOOTPRINT *	aFootprint,
		const std::function< void(PCB_SHAPE *)> &	aFunc )

static

Definition at line 1139 of file board_downgrade.cpp.

References pad, and FOOTPRINT::Pads().

Referenced by countEllipses(), countRoundedRectsFp(), lowerEllipsesFp(), and lowerRoundedRectsFp().

◆ hasActiveExpression()

static bool hasActiveExpression ( const wxString & aText )

static

Definition at line 2304 of file board_downgrade.cpp.

Referenced by planTextItem().

◆ hasBackdrill()

static bool hasBackdrill ( const PADSTACK & aPadstack )

static

Definition at line 687 of file board_downgrade.cpp.

References PADSTACK::SecondaryDrill(), PADSTACK::DRILL_PROPS::size, PADSTACK::TertiaryDrill(), and VECTOR2< T >::x.

Referenced by countBackdrills(), PCB_IO_IPC2581::ensureBackdrillSpecs(), and DIALOG_PAD_PROPERTIES::OnDrillShapeSelected().

◆ hasGroupPlacementLinkage()

static bool hasGroupPlacementLinkage ( const ZONE * aZone )

static

Definition at line 1383 of file board_downgrade.cpp.

References ZONE::GetIsRuleArea(), ZONE::GetPlacementAreaEnabled(), ZONE::GetPlacementAreaSource(), ZONE::GetPlacementAreaSourceType(), and GROUP_PLACEMENT.

Referenced by countGroupPlacementAreas().

◆ hasLineEndings()

static bool hasLineEndings ( const BOARD_ITEM * aItem )

static

Definition at line 2015 of file board_downgrade.cpp.

References EDA_SHAPE::GetEndEndingStyle(), EDA_SHAPE::GetStartEndingStyle(), NONE, PCB_SHAPE_T, and EDA_ITEM::Type().

Referenced by countLineEndings(), transformLineEndings(), and transformLineEndingsFp().

◆ hasPostMachining()

static bool hasPostMachining ( const PADSTACK & aPadstack )

static

Definition at line 713 of file board_downgrade.cpp.

References PADSTACK::BackPostMachining(), PADSTACK::FrontPostMachining(), and NOT_POST_MACHINED.

Referenced by countPostMachining().

◆ hasViaProtection()

static bool hasViaProtection ( const PCB_VIA * aVia )

static

Definition at line 963 of file board_downgrade.cpp.

References PADSTACK::BackOuterLayers(), PADSTACK::Drill(), PADSTACK::FrontOuterLayers(), PADSTACK::MASK_LAYER_PROPS::has_covering, PADSTACK::MASK_LAYER_PROPS::has_plugging, PADSTACK::DRILL_PROPS::is_capped, PADSTACK::DRILL_PROPS::is_filled, and PCB_VIA::Padstack().

Referenced by countViaProtection().

◆ isBarcode()

static bool isBarcode ( const BOARD_ITEM * aItem )

static

Definition at line 1517 of file board_downgrade.cpp.

References PCB_BARCODE_T, and EDA_ITEM::Type().

Referenced by omitBarcodes(), and omitBarcodesFp().

◆ isDrillDrawing()

static bool isDrillDrawing ( const BOARD_ITEM * aItem )

static

Definition at line 1640 of file board_downgrade.cpp.

References PCB_DRILL_CHART_T, PCB_DRILL_MAP_T, and EDA_ITEM::Type().

Referenced by countDrillDrawings(), and dropDrillDrawings().

◆ isEllipse()

static bool isEllipse ( const BOARD_ITEM * aItem )

static

Definition at line 130 of file board_downgrade.cpp.

References ELLIPSE, ELLIPSE_ARC, PCB_SHAPE_T, and EDA_ITEM::Type().

Referenced by countEllipses(), lowerEllipses(), and lowerEllipsesFp().

◆ isGrid()

static bool isGrid ( const BOARD_ITEM * aItem )

static

Definition at line 1634 of file board_downgrade.cpp.

References PCB_GRID_ITEM_T, and EDA_ITEM::Type().

Referenced by countGrids(), and dropGrids().

◆ isHatchedCopperShape()

static bool isHatchedCopperShape ( const BOARD_ITEM * aItem )

static

Definition at line 148 of file board_downgrade.cpp.

References BOARD_ITEM::GetLayer(), IsCopperLayer(), and isHatchedShape().

Referenced by boardRules().

◆ isHatchedInkShape()

static bool isHatchedInkShape ( const BOARD_ITEM * aItem )

static

Definition at line 154 of file board_downgrade.cpp.

References BOARD_ITEM::GetLayer(), IsCopperLayer(), and isHatchedShape().

Referenced by boardRules().

◆ isHatchedShape()

static bool isHatchedShape ( const BOARD_ITEM * aItem )

static

Definition at line 140 of file board_downgrade.cpp.

References PCB_SHAPE_T, and EDA_ITEM::Type().

Referenced by isHatchedCopperShape(), and isHatchedInkShape().

◆ isKnockoutTextBox()

static bool isKnockoutTextBox ( const BOARD_ITEM * aItem )

static

Definition at line 1530 of file board_downgrade.cpp.

References BOARD_ITEM::IsKnockout(), PCB_TEXTBOX_T, and EDA_ITEM::Type().

Referenced by omitKnockoutTextBoxes(), and omitKnockoutTextBoxesFp().

◆ isRoundedRect()

static bool isRoundedRect ( const BOARD_ITEM * aItem )

static

Definition at line 1110 of file board_downgrade.cpp.

References EDA_SHAPE::GetCornerRadius(), EDA_SHAPE::GetShape(), PCB_SHAPE_T, RECTANGLE, and EDA_ITEM::Type().

Referenced by countRoundedRects(), countRoundedRectsFp(), lowerRoundedRects(), and lowerRoundedRectsFp().

◆ isTimeDomainTuning()

static bool isTimeDomainTuning ( const PCB_GENERATOR * aGenerator )

static

Definition at line 1796 of file board_downgrade.cpp.

References EDA_GROUP::GetItems().

Referenced by countTimeDomainTuning(), and dropTimeDomainTuning().

◆ isUnreviewedDrawing()

static bool isUnreviewedDrawing ( const BOARD_ITEM * aItem )

static

Definition at line 1857 of file board_downgrade.cpp.

References PCB_BARCODE_T, PCB_DIM_ALIGNED_T, PCB_DIM_CENTER_T, PCB_DIM_LEADER_T, PCB_DIM_ORTHOGONAL_T, PCB_DIM_RADIAL_T, PCB_DRILL_CHART_T, PCB_DRILL_MAP_T, PCB_FIELD_T, PCB_GRID_ITEM_T, PCB_REFERENCE_IMAGE_T, PCB_SHAPE_T, PCB_TABLE_T, PCB_TARGET_T, PCB_TEXT_T, PCB_TEXTBOX_T, and EDA_ITEM::Type().

Referenced by countUnreviewedDrawings().

◆ lowerBarcodes()

static void lowerBarcodes ( BOARD * aBoard )

static

Definition at line 611 of file board_downgrade.cpp.

References BOARD::Add(), barcodeToShapes(), BOARD::Drawings(), BOARD::Footprints(), group, lowerBarcodesFp(), PCB_BARCODE_T, and BOARD::Remove().

Referenced by boardRules().

◆ lowerBarcodesFp()

static void lowerBarcodesFp ( FOOTPRINT * aFootprint )

static

Definition at line 281 of file board_downgrade.cpp.

References FOOTPRINT::Add(), barcodeToShapes(), detachFromGroup(), FOOTPRINT::GraphicalItems(), group, PCB_BARCODE_T, and FOOTPRINT::Remove().

Referenced by boardRules(), and lowerBarcodes().

◆ lowerBuriedVias()

static void lowerBuriedVias ( BOARD * aBoard )

static

Definition at line 801 of file board_downgrade.cpp.

References BLIND, BURIED, PCB_VIA_T, BOARD::Tracks(), and via.

Referenced by boardRules().

◆ lowerEllipses()

static void lowerEllipses ( BOARD * aBoard )

static

Definition at line 464 of file board_downgrade.cpp.

References BOARD::Drawings(), ellipseToPolygon(), BOARD::Footprints(), BOARD::GetDesignSettings(), isEllipse(), lowerEllipsesFp(), and BOARD_DESIGN_SETTINGS::m_MaxError.

◆ lowerEllipsesFp()

static void lowerEllipsesFp ( FOOTPRINT * aFootprint )

static

Definition at line 218 of file board_downgrade.cpp.

References ellipseToPolygon(), footprintMaxError(), forEachPadPrimitive(), FOOTPRINT::GraphicalItems(), and isEllipse().

Referenced by boardRules(), and lowerEllipses().

◆ lowerLineEndingShape()

static void lowerLineEndingShape	(	PCB_SHAPE *	aShape,
		int	aMaxError )

static

◆ lowerRoundedRects()

static void lowerRoundedRects ( BOARD * aBoard )

static

Definition at line 1210 of file board_downgrade.cpp.

References BOARD::Drawings(), BOARD::Footprints(), BOARD::GetDesignSettings(), isRoundedRect(), lowerRoundedRectsFp(), BOARD_DESIGN_SETTINGS::m_MaxError, and roundedRectToPolygon().

◆ lowerRoundedRectsFp()

static void lowerRoundedRectsFp ( FOOTPRINT * aFootprint )

static

Definition at line 1174 of file board_downgrade.cpp.

References footprintMaxError(), forEachPadPrimitive(), FOOTPRINT::GraphicalItems(), isRoundedRect(), and roundedRectToPolygon().

Referenced by boardRules(), and lowerRoundedRects().

◆ lowerSkipVias()

static void lowerSkipVias ( BOARD * aBoard )

static

Definition at line 849 of file board_downgrade.cpp.

References PCB_VIA_T, REMOVE_EXCEPT_START_AND_END, PADSTACK::SetUnconnectedLayerMode(), START_END_ONLY, BOARD::Tracks(), and PADSTACK::UnconnectedLayerMode().

Referenced by boardRules().

◆ omitBarcodes()

static void omitBarcodes ( BOARD * aBoard )

static

Definition at line 1525 of file board_downgrade.cpp.

References isBarcode(), and omitGraphics().

Referenced by boardRules().

◆ omitBarcodesFp()

static void omitBarcodesFp ( FOOTPRINT * aFootprint )

static

Definition at line 1521 of file board_downgrade.cpp.

References isBarcode(), and omitGraphicsFp().

Referenced by boardRules().

◆ omitEllipses()

static void omitEllipses ( BOARD * aBoard )

static

Definition at line 1509 of file board_downgrade.cpp.

References BOARD::Footprints(), isEllipse(), omitGraphics(), and omitPadPrimitives().

◆ omitEllipsesFp()

static void omitEllipsesFp ( FOOTPRINT * aFootprint )

static

Definition at line 1504 of file board_downgrade.cpp.

References isEllipse(), omitGraphicsFp(), and omitPadPrimitives().

Referenced by boardRules().

◆ omitGraphics()

static void omitGraphics	(	BOARD *	aBoard,
		const std::function< bool(const BOARD_ITEM *)> &	aMatches )

static

Definition at line 1465 of file board_downgrade.cpp.

References BOARD::Drawings(), BOARD::Footprints(), omitGraphicsFp(), and BOARD::Remove().

Referenced by dropDrillDrawings(), dropGrids(), omitBarcodes(), omitEllipses(), omitKnockoutTextBoxes(), and omitRoundedRects().

◆ omitGraphicsFp()

static void omitGraphicsFp	(	FOOTPRINT *	aFootprint,
		const std::function< bool(const BOARD_ITEM *)> &	aMatches )

static

Definition at line 1446 of file board_downgrade.cpp.

References detachFromGroup(), FOOTPRINT::GraphicalItems(), and FOOTPRINT::Remove().

Referenced by omitBarcodesFp(), omitEllipsesFp(), omitGraphics(), omitKnockoutTextBoxesFp(), and omitRoundedRectsFp().

◆ omitKnockoutCellContents()

static void omitKnockoutCellContents ( BOARD_ITEM * aItem )

static

Definition at line 1561 of file board_downgrade.cpp.

References PCB_TABLE_T, and EDA_ITEM::Type().

Referenced by omitKnockoutTableCells(), and omitKnockoutTableCellsFp().

◆ omitKnockoutTableCells()

static void omitKnockoutTableCells ( BOARD * aBoard )

static

Definition at line 1585 of file board_downgrade.cpp.

References BOARD::Drawings(), BOARD::Footprints(), omitKnockoutCellContents(), and omitKnockoutTableCellsFp().

Referenced by boardRules().

◆ omitKnockoutTableCellsFp()

static void omitKnockoutTableCellsFp ( FOOTPRINT * aFootprint )

static

Definition at line 1578 of file board_downgrade.cpp.

References FOOTPRINT::GraphicalItems(), and omitKnockoutCellContents().

Referenced by boardRules(), and omitKnockoutTableCells().

◆ omitKnockoutTextBoxes()

static void omitKnockoutTextBoxes ( BOARD * aBoard )

static

Definition at line 1539 of file board_downgrade.cpp.

References isKnockoutTextBox(), and omitGraphics().

Referenced by boardRules().

◆ omitKnockoutTextBoxesFp()

static void omitKnockoutTextBoxesFp ( FOOTPRINT * aFootprint )

static

Definition at line 1535 of file board_downgrade.cpp.

References isKnockoutTextBox(), and omitGraphicsFp().

Referenced by boardRules().

◆ omitPadPrimitives()

static void omitPadPrimitives	(	FOOTPRINT *	aFootprint,
		const std::function< bool(const BOARD_ITEM *)> &	aMatches )

static

Definition at line 1486 of file board_downgrade.cpp.

References pad, and FOOTPRINT::Pads().

Referenced by omitEllipses(), omitEllipsesFp(), omitRoundedRects(), and omitRoundedRectsFp().

◆ omitRoundedRects()

static void omitRoundedRects ( BOARD * aBoard )

static

Definition at line 1552 of file board_downgrade.cpp.

References BOARD::Footprints(), isRoundedRect(), omitGraphics(), and omitPadPrimitives().

◆ omitRoundedRectsFp()

static void omitRoundedRectsFp ( FOOTPRINT * aFootprint )

static

Definition at line 1545 of file board_downgrade.cpp.

References isRoundedRect(), omitGraphicsFp(), and omitPadPrimitives().

Referenced by boardRules().

◆ planBoardText()

static TEXT_DOWNGRADE_PLAN planBoardText	(	const BOARD *	aBoard,
		int	aTargetVersion )

static

Definition at line 2493 of file board_downgrade.cpp.

References BOARD::GetProject(), BOARD::GetTitleBlock(), INTERNAL, TEXT_DOWNGRADE_PLAN::m_blocked, TEXT_DOWNGRADE_PLAN::m_replacements, plan(), planTextItem(), BOARD::ResolveTextVar(), EDA_TEXT::SetText(), PROJECT::TextVarResolver(), TITLE_BLOCK::TextVarResolver(), titleFieldText(), and visitBoardItems().

Referenced by ClassifyBoardForDowngrade(), and DowngradeBoardInPlace().

◆ planTextItem()

static void planTextItem	(	BOARD_ITEM *	aItem,
		int	aTargetVersion,
		TEXT_DOWNGRADE_PLAN &	aPlan,
		const std::function< bool(wxString )>	aResolver = nullptr )

static

◆ postTargetText() [1/2]

static bool postTargetText	(	const wxString &	aText,
		const BOARD *	aBoard,
		int	aTargetVersion )

static

Definition at line 2288 of file board_downgrade.cpp.

References postTargetText().

◆ postTargetText() [2/2]

static bool postTargetText	(	const wxString &	aText,
		const BOARD *	aBoard,
		int	aTargetVersion,
		std::set< wxString > &	aDependencies,
		int	aDepth = 0 )

static

Definition at line 2183 of file board_downgrade.cpp.

References ExtractTextVarReferences(), FinalizeTextVarExpansion(), PCB_WRITER_V9::FORMAT_VERSION, BOARD::GetProject(), BOARD::GetProperties(), PROJECT::GetTextVars(), BOARD::GetTitleBlock(), INTERNAL, name, postTargetText(), TITLE_BLOCK::TextVarResolver(), and titleFieldIndex().

Referenced by planTextItem(), postTargetText(), and postTargetText().

◆ roundedRectToPolygon()

static void roundedRectToPolygon	(	PCB_SHAPE *	aShape,
		int	aMaxError )

static

Definition at line 1120 of file board_downgrade.cpp.

References SHAPE_POLY_SET::Append(), SHAPE_POLY_SET::Fillet(), EDA_SHAPE::GetCornerRadius(), EDA_SHAPE::GetRectCorners(), SHAPE_POLY_SET::NewOutline(), POLY, radius, PCB_SHAPE::SetCornerRadius(), PCB_SHAPE::SetPolyShape(), and PCB_SHAPE::SetShape().

Referenced by lowerRoundedRects(), and lowerRoundedRectsFp().

◆ SaveBoardForTarget()

void SaveBoardForTarget	(	BOARD *	aBoard,
		const wxString &	aPath,
		const DOWNGRADE_TARGET &	aTarget )

Save a board stamped for the target, using the writer for that version.

Definition at line 3092 of file board_downgrade.cpp.

References PCB_WRITER_V10::FORMAT_VERSION, PCB_WRITER_V9::FORMAT_VERSION, DOWNGRADE_TARGET::m_boardVersion, PCB_WRITER_V10::SaveBoard(), and PCB_WRITER_V9::SaveBoard().

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), and ExportBoardToOlderVersion().

◆ SaveFootprintForTarget()

void SaveFootprintForTarget	(	FOOTPRINT *	aFootprint,
		const wxString &	aPath,
		const DOWNGRADE_TARGET &	aTarget )

Save a single .kicad_mod footprint file for the target.

Definition at line 3103 of file board_downgrade.cpp.

References PCB_WRITER_V10::FORMAT_VERSION, PCB_WRITER_V9::FORMAT_VERSION, DOWNGRADE_TARGET::m_boardVersion, PCB_WRITER_V10::SaveFootprintFile(), and PCB_WRITER_V9::SaveFootprintFile().

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), and DowngradeFootprintFileToTemp().

◆ setHatchedFills()

static void setHatchedFills	(	BOARD *	aBoard,
		const std::function< bool(const BOARD_ITEM *)> &	aMatches,
		FILL_T	aFill )

static

Definition at line 908 of file board_downgrade.cpp.

References BOARD::Drawings(), BOARD::Footprints(), and setHatchedFillsFp().

Referenced by boardRules().

◆ setHatchedFillsFp()

static void setHatchedFillsFp	(	FOOTPRINT *	aFootprint,
		const std::function< bool(const BOARD_ITEM *)> &	aMatches,
		FILL_T	aFill )

static

Definition at line 237 of file board_downgrade.cpp.

References FOOTPRINT::GraphicalItems().

Referenced by boardRules(), and setHatchedFills().

◆ titleFieldIndex()

static int titleFieldIndex ( const wxString & aName )

static

Definition at line 2154 of file board_downgrade.cpp.

Referenced by postTargetText().

◆ titleFieldText()

static const wxString & titleFieldText	(	const TITLE_BLOCK &	aTitle,
		int	aIndex )

static

Definition at line 2170 of file board_downgrade.cpp.

References TITLE_BLOCK::GetComment(), TITLE_BLOCK::GetCompany(), TITLE_BLOCK::GetDate(), TITLE_BLOCK::GetRevision(), and TITLE_BLOCK::GetTitle().

Referenced by planBoardText().

◆ transformLineEndings()

static void transformLineEndings	(	BOARD *	aBoard,
		bool	aOmit )

static

Definition at line 2134 of file board_downgrade.cpp.

References clearLineEndings(), BOARD::GetDesignSettings(), hasLineEndings(), lowerLineEndingShape(), BOARD_DESIGN_SETTINGS::m_MaxError, unsafeLineEndings(), and visitBoardItems().

Referenced by boardRules().

◆ transformLineEndingsFp()

static void transformLineEndingsFp	(	FOOTPRINT *	aFootprint,
		bool	aOmit )

static

Definition at line 2114 of file board_downgrade.cpp.

References clearLineEndings(), footprintMaxError(), hasLineEndings(), lowerLineEndingShape(), unsafeLineEndings(), and visitFootprintItems().

Referenced by boardRules().

◆ unsafeLineEndings()

static bool unsafeLineEndings ( const PCB_SHAPE * aShape )

static

Definition at line 2026 of file board_downgrade.cpp.

References DEFAULT, end, EDA_SHAPE::GetEffectiveWidth(), EDA_SHAPE::GetEndEnding(), EDA_SHAPE::GetLineEndingEndpoints(), EDA_SHAPE::GetLineStyle(), EDA_SHAPE::GetStartEnding(), LINE_ENDING::GetStroke(), SOLID, and KIGFX::COLOR4D::UNSPECIFIED.

Referenced by countLineEndings(), transformLineEndings(), and transformLineEndingsFp().

◆ visitBoardItems()

static void visitBoardItems	(	const BOARD *	aBoard,
		const std::function< void(BOARD_ITEM *)> &	aVisit )

static

Definition at line 1903 of file board_downgrade.cpp.

References BOARD::Generators(), name, RECURSE, and BOARD::RunOnChildren().

Referenced by countCustomProperties(), countLineEndings(), dropCustomProperties(), planBoardText(), and transformLineEndings().

◆ visitFootprintItems()

static void visitFootprintItems	(	const FOOTPRINT *	aFootprint,
		const std::function< void(BOARD_ITEM *)> &	aVisit )

static

Definition at line 1896 of file board_downgrade.cpp.

References RECURSE, and FOOTPRINT::RunOnChildren().

Referenced by DowngradeFootprintInPlace(), dropCustomPropertiesFp(), and transformLineEndingsFp().

Variable Documentation

◆ BOARD_DOWNGRADE_COVERED

int BOARD_DOWNGRADE_COVERED = 20261025

staticconstexpr

Definition at line 127 of file board_downgrade.cpp.

Referenced by BoardDowngradeCoveredVersion(), and ClassifyBoardForDowngrade().

◆ BOARD_TOKENS

DATED_TOKEN BOARD_TOKENS[]

staticconstexpr

Definition at line 3006 of file board_downgrade.cpp.

Referenced by FindUnsupportedBoardToken().

◆ BOARD_VALUES

DATED_TOKEN BOARD_VALUES[]

staticconstexpr

Initial value:

= {
    { "exclude_from_sim", VER_SIM_EXCLUSION },
    { "via_stitch", VER_VIA_STITCH },
    { "via_stack", VER_VIA_STACK },
    { "pad_prop_pressfit", VER_PRESSFIT },
    { "buried", VER_VIA_SPLIT },
}

Definition at line 3075 of file board_downgrade.cpp.

Referenced by FindUnsupportedBoardToken().

◆ VER_BACKDRILL

int VER_BACKDRILL = 20251101

staticconstexpr

Definition at line 94 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_BARCODE

int VER_BARCODE = 20250914

staticconstexpr

Definition at line 88 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_CELL_KNOCKOUT

int VER_CELL_KNOCKOUT = 20260603

staticconstexpr

Definition at line 93 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_CONSTRAINTS

int VER_CONSTRAINTS = 20260624

staticconstexpr

Definition at line 103 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_CUSTOM_PROPERTIES

int VER_CUSTOM_PROPERTIES = 20260831

staticconstexpr

Definition at line 110 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_DIELECTRIC

int VER_DIELECTRIC = 20260511

staticconstexpr

Definition at line 100 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_DRILL_DRAWINGS

int VER_DRILL_DRAWINGS = 20260901

staticconstexpr

Definition at line 111 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_ELLIPSE

int VER_ELLIPSE = 20260508

staticconstexpr

Definition at line 96 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_EXTRUDED_BODY

int VER_EXTRUDED_BODY = 20260410

staticconstexpr

Definition at line 95 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_FOOTPRINT_HEIGHT

int VER_FOOTPRINT_HEIGHT = 20261017

staticconstexpr

Definition at line 112 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_FP_UNITS

int VER_FP_UNITS = 20250909

staticconstexpr

Definition at line 87 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_GRIDS

int VER_GRIDS = 20260728

staticconstexpr

Definition at line 104 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_GROUP_LIB_ID

int VER_GROUP_LIB_ID = 20250513

staticconstexpr

Definition at line 101 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_GROUP_PLACEMENT

int VER_GROUP_PLACEMENT = 20250401

staticconstexpr

Definition at line 92 of file board_downgrade.cpp.

Referenced by boardRules(), and FindUnsupportedBoardToken().

◆ VER_IMAGE_OPACITY

int VER_IMAGE_OPACITY = 20261025

staticconstexpr

Definition at line 115 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_IMAGE_PPI

int VER_IMAGE_PPI = 20260623

staticconstexpr

Definition at line 102 of file board_downgrade.cpp.

Referenced by DowngradeBoardInPlace(), and DowngradeFootprintInPlace().

◆ VER_IMAGE_ROTATION

int VER_IMAGE_ROTATION = 20261025

staticconstexpr

Definition at line 114 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_JUMPER_PADS

int VER_JUMPER_PADS = 20250324

staticconstexpr

Definition at line 80 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_LINE_ENDINGS

int VER_LINE_ENDINGS = 20260818

staticconstexpr

Definition at line 107 of file board_downgrade.cpp.

Referenced by boardRules(), and ClassifyBoardForDowngrade().

◆ VER_LINKED_PLACEMENT

int VER_LINKED_PLACEMENT = 20261018

staticconstexpr

Definition at line 113 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_NET_CHAINS

int VER_NET_CHAINS = 20260512

staticconstexpr

Definition at line 98 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_PAD_DIE_DELAY

int VER_PAD_DIE_DELAY = 20250401

staticconstexpr

Definition at line 89 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_PAD_SIM

int VER_PAD_SIM = 20260521

staticconstexpr

Definition at line 99 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_PCB_POINTS

int VER_PCB_POINTS = 20250901

staticconstexpr

Definition at line 85 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_POST_MACHINING

int VER_POST_MACHINING = 20251101

staticconstexpr

Definition at line 84 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_PRESSFIT

int VER_PRESSFIT = 20250811

staticconstexpr

Definition at line 83 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_PROPERTY_VARIABLES

int VER_PROPERTY_VARIABLES = 20260817

staticconstexpr

Definition at line 106 of file board_downgrade.cpp.

Referenced by ClassifyBoardForDowngrade(), DowngradeBoardInPlace(), and DowngradeFootprintInPlace().

◆ VER_ROUNDED_RECT

int VER_ROUNDED_RECT = 20250829

staticconstexpr

Definition at line 86 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_SHAPE_HATCH

int VER_SHAPE_HATCH = 20250222

staticconstexpr

Definition at line 77 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_SIM_EXCLUSION

int VER_SIM_EXCLUSION = 20260828

staticconstexpr

Definition at line 108 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_SKIP_VIA

int VER_SKIP_VIA = 20250801

staticconstexpr

Definition at line 82 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_TEXTBOX_KNOCKOUT

int VER_TEXTBOX_KNOCKOUT = 20250210

staticconstexpr

Definition at line 76 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_THIEVING

int VER_THIEVING = 20260513

staticconstexpr

Definition at line 97 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_TIME_DOMAIN_TUNING

int VER_TIME_DOMAIN_TUNING = 20250401

staticconstexpr

Definition at line 90 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_USER_LAYERS

int VER_USER_LAYERS = 20241229

staticconstexpr

Definition at line 75 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_VIA_PROTECTION

int VER_VIA_PROTECTION = 20250228

staticconstexpr

Definition at line 78 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_VIA_SPLIT

int VER_VIA_SPLIT = 20250926

staticconstexpr

Definition at line 81 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_VIA_STACK

int VER_VIA_STACK = 20260830

staticconstexpr

Definition at line 109 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_VIA_STITCH

int VER_VIA_STITCH = 20260816

staticconstexpr

Definition at line 105 of file board_downgrade.cpp.

Referenced by boardRules().

◆ VER_ZONE_DEFAULTS

int VER_ZONE_DEFAULTS = 20250302

staticconstexpr

Definition at line 79 of file board_downgrade.cpp.

Referenced by boardRules().

Classes

Functions

Variables

Function Documentation

◆ applyTextPlan()

◆ barcodeToShapes()

◆ BoardDowngradeCoveredVersion()

◆ boardRules()

◆ ClassifyBoardForDowngrade()

◆ clearLineEndings()

◆ compensateImageScale()

◆ compensateReferenceImageScales()

◆ compensateReferenceImageScalesFp()

◆ containsGroupPlacementSource()

◆ countBackdrills()

◆ countBarcodes()

◆ countBuriedVias()

◆ countConstraints()

◆ countCustomFpStackups()

◆ countCustomProperties()

◆ countDieDelays()

◆ countDielectricModels()

◆ countDrawings()

◆ countDrillDrawings()

◆ countDrillSymbolConfiguration()

◆ countEllipses()

◆ countExtrudedBodies()

◆ countFootprintHeights()

◆ countGenerators()

◆ countGrids()

◆ countGroupDesignBlocks()

◆ countGroupPlacementAreas()

◆ countHatchedFills()

◆ countHighUserLayers()

◆ countJumperPads()

◆ countKnockoutCellsIn()

◆ countKnockoutTableCells()

◆ countKnockoutTextBoxes()

◆ countKnockoutTextBoxesFp()

◆ countLineEndings()

◆ countLinkedPlacementAreas()

◆ countNetChains()

◆ countPadSimTypes()

◆ countPcbPoints()

◆ countPcbVariants()

◆ countPostMachining()

◆ countPressFitPads()

◆ countReferenceImageOpacities()

◆ countReferenceImageRotations()

◆ countRoundedRects()

◆ countRoundedRectsFp()

◆ countScaledFootprints()

◆ countSimulationExclusions()

◆ countSkipVias()

◆ countThievingZones()

◆ countTimeDomainTuning()

◆ countUnitInfo()

◆ countUnknownGenerators()

◆ countUnreviewedDrawings()

◆ countUnreviewedTuningProperties()

◆ countViaProtection()

◆ countZoneDefaults()

◆ countZoneLayerProperties()

◆ detachFromGroup()

◆ DowngradeBoardInPlace()

◆ DowngradeFootprintFileToTemp()

◆ DowngradeFootprintInPlace()

◆ dropConstraints()

◆ dropConstraintsFp()

◆ dropCustomProperties()

◆ dropCustomPropertiesFp()

◆ dropDieDelays()

◆ dropDieDelaysFp()

◆ dropDielectricModels()

◆ dropDrillDrawings()

◆ dropDrillSymbolConfiguration()

◆ dropExtrudedBodies()

◆ dropExtrudedBodiesFp()

◆ dropFootprintHeights()

◆ dropFootprintHeightsFp()