Create drill maps and drill reports and drill files. More...

#include <gendrill_file_writer_base.h>

Inheritance diagram for GENDRILL_WRITER_BASE:

Public Types
enum	ZEROS_FMT { DECIMAL_FORMAT , SUPPRESS_LEADING , SUPPRESS_TRAILING , KEEP_ZEROS }

enum	TYPE_FILE { PTH_FILE , NPTH_FILE , MIXED_FILE }

Public Member Functions
virtual	~GENDRILL_WRITER_BASE ()

void	SetMergeOption (bool aMerge)
	Set the option to make separate drill files for PTH and NPTH.

VECTOR2I	GetOffset ()
	Return the plot offset (usually the position of the drill/place origin).

void	SetPageInfo (const PAGE_INFO *aPageInfo)
	Set the page info used to plot drill maps.

void	SetMapFileFormat (PLOT_FORMAT aMapFmt)
	Initialize the format for the drill map file.

bool	CreateMapFilesSet (const wxString &aPlotDirectory, REPORTER *aReporter=nullptr)
	Create the full set of map files for the board, in PS, PDF ... format (use SetMapFileFormat() to select the format).

bool	GenDrillReportFile (const wxString &aFullFileName)
	Create a plain text report file giving a list of drill values and drill count for through holes, oblong holes, and for buried vias, drill values and drill count per layer pair there is only one report for all drill files even when buried or blinds vias exist.

wxString	GetDrillFileExt () const
	Returns the file extension of the drill writer format.

Protected Member Functions
bool	genDrillMapFile (const wxString &aFullFileName, PLOT_FORMAT aFormat)
	Plot a map of drill marks for holes.

void	buildHolesList (DRILL_LAYER_PAIR aLayerPair, bool aGenerateNPTH_list)
	Create the list of holes and tools for a given board.

int	getHolesCount () const

bool	plotDrillMarks (PLOTTER *aPlotter)
	Write the drill marks in HPGL, POSTSCRIPT or other supported formats/.

std::vector< DRILL_LAYER_PAIR >	getUniqueLayerPairs () const
	Get unique layer pairs by examining the micro and blind_buried vias.

unsigned	printToolSummary (OUTPUTFORMATTER &aOut, bool aSummaryNPTH) const
	Print m_toolListBuffer[] tools to aOut and returns total hole count.

const std::string	layerPairName (DRILL_LAYER_PAIR aPair) const

const std::string	layerName (PCB_LAYER_ID aLayer) const

virtual const wxString	getDrillFileName (DRILL_LAYER_PAIR aPair, bool aNPTH, bool aMerge_PTH_NPTH) const

const wxString	BuildFileFunctionAttributeString (DRILL_LAYER_PAIR aLayerPair, TYPE_FILE aHoleType, bool aCompatNCdrill=false) const

	GENDRILL_WRITER_BASE (BOARD *aPcb)

Protected Attributes
BOARD *	m_pcb

wxString	m_drillFileExtension

bool	m_unitsMetric

ZEROS_FMT	m_zeroFormat

DRILL_PRECISION	m_precision

double	m_conversionUnits

VECTOR2I	m_offset

bool	m_merge_PTH_NPTH

std::vector< HOLE_INFO >	m_holeListBuffer

std::vector< DRILL_TOOL >	m_toolListBuffer

PLOT_FORMAT	m_mapFileFmt

const PAGE_INFO *	m_pageInfo

Detailed Description

Create drill maps and drill reports and drill files.

Drill files are created by specialized derived classes, depending on the file format.

Definition at line 152 of file gendrill_file_writer_base.h.

Member Enumeration Documentation

◆ TYPE_FILE

enum GENDRILL_WRITER_BASE::TYPE_FILE

Enumerator
PTH_FILE
NPTH_FILE
MIXED_FILE

Definition at line 162 of file gendrill_file_writer_base.h.

◆ ZEROS_FMT

enum GENDRILL_WRITER_BASE::ZEROS_FMT

Enumerator
DECIMAL_FORMAT
SUPPRESS_LEADING
SUPPRESS_TRAILING
KEEP_ZEROS

Definition at line 155 of file gendrill_file_writer_base.h.

Constructor & Destructor Documentation

◆ ~GENDRILL_WRITER_BASE()

virtual GENDRILL_WRITER_BASE::~GENDRILL_WRITER_BASE ( )

inlinevirtual

Definition at line 168 of file gendrill_file_writer_base.h.

◆ GENDRILL_WRITER_BASE()

GENDRILL_WRITER_BASE::GENDRILL_WRITER_BASE ( BOARD * aPcb )

inlineprotected

Definition at line 368 of file gendrill_file_writer_base.h.

References DECIMAL_FORMAT, m_conversionUnits, m_mapFileFmt, m_merge_PTH_NPTH, m_pageInfo, m_pcb, m_unitsMetric, and m_zeroFormat.

Member Function Documentation

◆ BuildFileFunctionAttributeString()

const wxString GENDRILL_WRITER_BASE::BuildFileFunctionAttributeString	(	DRILL_LAYER_PAIR	aLayerPair,
		TYPE_FILE	aHoleType,
		bool	aCompatNCdrill = `false`
	)		const

protected

Parameters

aLayerPair	is the layer pair (Drill from rom first layer to second layer)
aHoleType	is type of drill file (PTH, NPTH, mixed)
aCompatNCdrill	is true when generating NC (Excellon) compatible drill file

Returns: a wxString containing the .FileFunction attribute. the standard X2 FileFunction for drill files is TF.FileFunction,Plated[NonPlated],layer1num,layer2num,PTH[NPTH][Blind][Buried], Drill[Route][Mixed]*% There is no X1 version, as the Gerber drill files uses only X2 format There is a compatible NC drill version.

Definition at line 361 of file gendrill_file_writer_base.cpp.

References B_Cu, BOARD::GetCopperLayerCount(), HOLE_INFO::m_Hole_Shape, m_holeListBuffer, m_pcb, MIXED_FILE, NPTH_FILE, and text.

Referenced by GERBER_WRITER::createDrillFile(), and EXCELLON_WRITER::writeEXCELLONHeader().

◆ buildHolesList()

void GENDRILL_WRITER_BASE::buildHolesList	(	DRILL_LAYER_PAIR	aLayerPair,
		bool	aGenerateNPTH_list
	)

protected

Create the list of holes and tools for a given board.

The list is sorted by increasing drill size. Only holes included within aLayerPair are listed. If aLayerPair identifies with [F_Cu, B_Cu], then pad holes are always included also.

Parameters

aLayerPair	is an inclusive range of layers.
aGenerateNPTH_list	: true to create NPTH only list (with no plated holes) false to created plated holes list (with no NPTH )

Definition at line 66 of file gendrill_file_writer_base.cpp.

Referenced by EXCELLON_WRITER::CreateDrillandMapFilesSet(), GERBER_WRITER::CreateDrillandMapFilesSet(), CreateMapFilesSet(), and GenDrillReportFile().

◆ CreateMapFilesSet()

bool GENDRILL_WRITER_BASE::CreateMapFilesSet	(	const wxString &	aPlotDirectory,
		REPORTER *	aReporter = `nullptr`
	)

Create the full set of map files for the board, in PS, PDF ... format (use SetMapFileFormat() to select the format).

File names are computed from the board name and layer ID.

Parameters

aPlotDirectory	is the output folder.
aReporter	is a REPORTER to return activity or any message (can be NULL)

Definition at line 300 of file gendrill_file_writer_base.cpp.

References _, B_Cu, buildHolesList(), F_Cu, genDrillMapFile(), GetDefaultPlotExtension(), getDrillFileName(), getHolesCount(), getUniqueLayerPairs(), m_mapFileFmt, m_merge_PTH_NPTH, REPORTER::Report(), RPT_SEVERITY_ACTION, and RPT_SEVERITY_ERROR.

Referenced by EXCELLON_WRITER::CreateDrillandMapFilesSet(), and GERBER_WRITER::CreateDrillandMapFilesSet().

◆ genDrillMapFile()

bool GENDRILL_WRITER_BASE::genDrillMapFile	(	const wxString &	aFullFileName,
		PLOT_FORMAT	aFormat
	)

protected

Plot a map of drill marks for holes.

Hole list must be created before calling this function, by buildHolesList() for the right holes set (PTH, NPTH, buried/blind vias ...) the paper sheet to use to plot the map is set in m_pageInfo ( calls SetPageInfo() to set it ). If NULL, A4 format will be used.

Parameters

aFullFileName	is the full filename of the map file to create.
aFormat	is one of the supported plot formats (see enum PlotFormat ).

Definition at line 87 of file gen_drill_report_files.cpp.

References PAGE_INFO::A4, AddGerberX2Header(), PLOTTER::AddLineToHeader(), ANGLE_HORIZONTAL, BOX2< Vec >::Centre(), PLOTTER::ClearHeaderLinesList(), KIFONT::METRICS::Default(), diameter_in_inches(), diameter_in_mm(), GERBER_PLOTTER::DisableApertMacros(), BOARD::Drawings(), dummy, Dwgs_User, Edge_Cuts, PLOTTER::EndPlot(), BOARD::Footprints(), From_UTF8(), BOARD::GetBoardEdgesBoundingBox(), BOX2< Vec >::GetBottom(), getDefaultPenSize(), BOX2< Vec >::GetHeight(), getMarkerBestPenSize(), GetOffset(), PLOTTER::GetPlotterType(), PAGE_INFO::GetSizeIU(), BOARD::GetVisibleLayers(), BOX2< Vec >::GetWidth(), BOX2< Vec >::GetX(), GR_TEXT_H_ALIGN_LEFT, GR_TEXT_V_ALIGN_CENTER, EDA_IU_SCALE::IU_PER_MILS, EDA_IU_SCALE::IU_PER_MM, KI_FALLTHROUGH, KiROUND(), TEXT_ATTRIBUTES::m_Angle, DRILL_TOOL::m_Diameter, TEXT_ATTRIBUTES::m_Halign, DRILL_TOOL::m_Hole_NotPlated, TEXT_ATTRIBUTES::m_Multiline, DRILL_TOOL::m_OvalCount, m_pageInfo, m_pcb, TEXT_ATTRIBUTES::m_Size, TEXT_ATTRIBUTES::m_StrokeWidth, m_toolListBuffer, DRILL_TOOL::m_TotalCount, m_unitsMetric, TEXT_ATTRIBUTES::m_Valign, PLOTTER::Marker(), EDA_IU_SCALE::mmToIU(), PLOTTER::OpenFile(), PCB_SHAPE_T, pcbIUScale, plotDrillMarks(), BRDITEMS_PLOTTER::PlotShape(), PLOTTER::PlotText(), scale, PLOTTER::SetColorMode(), PLOTTER::SetCreator(), PLOTTER::SetCurrentLineWidth(), KIGFX::RENDER_SETTINGS::SetDefaultPenWidth(), PLOTTER::SetGerberCoordinatesFormat(), PCB_SHAPE::SetLayer(), BRDITEMS_PLOTTER::SetLayerSet(), PLOTTER::SetPageSettings(), BOARD_ITEM::SetParentGroup(), PLOTTER::SetRenderSettings(), DXF_PLOTTER::SetUnits(), PLOTTER::SetViewport(), BOARD::SetVisibleLayers(), PLOTTER::StartPlot(), text, GERBER_PLOTTER::UseX2format(), GERBER_PLOTTER::UseX2NetAttributes(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by CreateMapFilesSet().

◆ GenDrillReportFile()

bool GENDRILL_WRITER_BASE::GenDrillReportFile ( const wxString & aFullFileName )

Create a plain text report file giving a list of drill values and drill count for through holes, oblong holes, and for buried vias, drill values and drill count per layer pair there is only one report for all drill files even when buried or blinds vias exist.

Here is a sample created by this function: Drill report for F:/tmp/interf_u/interf_u.brd Created on 04/10/2012 20:48:38 Selected Drill Unit: Imperial (inches)

Drill report for plated through holes : T1 0,025" 0,64mm (88 holes) T2 0,031" 0,79mm (120 holes) T3 0,032" 0,81mm (151 holes) (with 1 slot) T4 0,040" 1,02mm (43 holes) T5 0,079" 2,00mm (1 hole) (with 1 slot) T6 0,120" 3,05mm (1 hole) (with 1 slot)

Total plated holes count 404

Drill report for buried and blind vias :

Drill report for holes from layer Soudure to layer Interne1 :

Total plated holes count 0

Drill report for holes from layer Interne1 to layer Interne2 : T1 0,025" 0,64mm (3 holes) Total plated holes count 3 Drill report for holes from layer Interne2 to layer Composant : T1 0,025" 0,64mm (1 hole)

Total plated holes count 1

Drill report for unplated through holes : T1 0,120" 3,05mm (1 hole) (with 1 slot)

Total unplated holes count 1

Parameters

aFullFileName is the name of the file to create.

Returns: true if the file is created.

Definition at line 408 of file gen_drill_report_files.cpp.

References LSET::AllCuMask(), B_Cu, buildHolesList(), F_Cu, getDrillFileName(), BOARD::GetEnabledLayers(), BOARD::GetFileName(), GetISO8601CurrentDateTime(), BOARD::GetLayerName(), getUniqueLayerPairs(), layerName(), m_merge_PTH_NPTH, m_pcb, OUTPUTFORMATTER::Print(), printToolSummary(), LSET::Seq(), TO_UTF8, and ToLAYER_ID().

Referenced by DIALOG_GENDRILL::OnGenReportFile().

◆ GetDrillFileExt()

wxString GENDRILL_WRITER_BASE::GetDrillFileExt ( ) const

inline

Returns the file extension of the drill writer format.

Definition at line 270 of file gendrill_file_writer_base.h.

References m_drillFileExtension.

◆ getDrillFileName()

const wxString GENDRILL_WRITER_BASE::getDrillFileName	(	DRILL_LAYER_PAIR	aPair,
		bool	aNPTH,
		bool	aMerge_PTH_NPTH
	)		const

protectedvirtual

Parameters

aPair	is the layer pair.
aNPTH	use true to generate the filename of NPTH holes.
aMerge_PTH_NPTH	use true to generate the filename of a file which containd both NPH and NPTH holes.

Returns: a filename which identify the drill file function. it is the board name with the layer pair names added, and for separate (PTH and NPTH) files, "-NPH" or "-NPTH" added

Reimplemented in GERBER_WRITER.

Definition at line 269 of file gendrill_file_writer_base.cpp.

References B_Cu, F_Cu, BOARD::GetFileName(), layerPairName(), m_drillFileExtension, and m_pcb.

Referenced by EXCELLON_WRITER::CreateDrillandMapFilesSet(), CreateMapFilesSet(), GenDrillReportFile(), and GERBER_WRITER::getDrillFileName().

◆ getHolesCount()

int GENDRILL_WRITER_BASE::getHolesCount ( ) const

inlineprotected

Definition at line 300 of file gendrill_file_writer_base.h.

References m_holeListBuffer.

Referenced by EXCELLON_WRITER::CreateDrillandMapFilesSet(), GERBER_WRITER::CreateDrillandMapFilesSet(), and CreateMapFilesSet().

◆ GetOffset()

VECTOR2I GENDRILL_WRITER_BASE::GetOffset ( )

inline

Return the plot offset (usually the position of the drill/place origin).

Definition at line 183 of file gendrill_file_writer_base.h.

References m_offset.

Referenced by genDrillMapFile().

◆ getUniqueLayerPairs()

std::vector< DRILL_LAYER_PAIR > GENDRILL_WRITER_BASE::getUniqueLayerPairs ( ) const

protected

Get unique layer pairs by examining the micro and blind_buried vias.

Definition at line 210 of file gendrill_file_writer_base.cpp.

References B_Cu, PCB_TYPE_COLLECTOR::Collect(), F_Cu, COLLECTOR::GetCount(), PCB_VIA::LayerPair(), m_pcb, and PCB_VIA_T.

Referenced by EXCELLON_WRITER::CreateDrillandMapFilesSet(), GERBER_WRITER::CreateDrillandMapFilesSet(), CreateMapFilesSet(), and GenDrillReportFile().

◆ layerName()

const std::string GENDRILL_WRITER_BASE::layerName ( PCB_LAYER_ID aLayer ) const

protected

Returns: a string from aLayer to identify the layer. string are "front" "back" or "in<aLayer>"

Definition at line 244 of file gendrill_file_writer_base.cpp.

References B_Cu, F_Cu, and StrPrintf().

Referenced by GenDrillReportFile(), and layerPairName().

◆ layerPairName()

const std::string GENDRILL_WRITER_BASE::layerPairName ( DRILL_LAYER_PAIR aPair ) const

protected

Returns: a string from aPair to identify the layer layer pair. string is "<layer1Name>"-"<layer2Name>" used to generate a filename for drill files and drill maps

Definition at line 259 of file gendrill_file_writer_base.cpp.

References layerName().

Referenced by getDrillFileName().

◆ plotDrillMarks()

bool GENDRILL_WRITER_BASE::plotDrillMarks ( PLOTTER * aPlotter )

protected

Write the drill marks in HPGL, POSTSCRIPT or other supported formats/.

Each hole size has a symbol (circle, cross X, cross + ...) up to PLOTTER::MARKER_COUNT different values. If more than PLOTTER::MARKER_COUNT different values, these other values share the same mark shape.

Parameters

aPlotter is a PLOTTER instance (HPGL, POSTSCRIPT ... plotter).

Definition at line 510 of file gen_drill_report_files.cpp.

References PLOTTER::FlashPadOval(), KIGFX::RENDER_SETTINGS::GetDefaultPenWidth(), getMarkerBestPenSize(), getSketchOvalBestPenSize(), HOLE_INFO::m_Hole_Diameter, HOLE_INFO::m_Hole_Orient, HOLE_INFO::m_Hole_Pos, HOLE_INFO::m_Hole_Shape, HOLE_INFO::m_Hole_Size, m_holeListBuffer, HOLE_INFO::m_Tool_Reference, PLOTTER::Marker(), PLOTTER::RenderSettings(), PLOTTER::SetCurrentLineWidth(), KIGFX::RENDER_SETTINGS::SetDefaultPenWidth(), and SKETCH.

Referenced by genDrillMapFile().

◆ printToolSummary()

unsigned GENDRILL_WRITER_BASE::printToolSummary	(	OUTPUTFORMATTER &	aOut,
		bool	aSummaryNPTH
	)		const

protected

Print m_toolListBuffer[] tools to aOut and returns total hole count.

Parameters

aOut	is the current OUTPUTFORMATTER to print summary.
aSummaryNPTH	is true to print summary for NPTH, false for PTH.

Definition at line 545 of file gen_drill_report_files.cpp.

References diameter_in_inches(), diameter_in_mm(), DRILL_TOOL::m_Diameter, DRILL_TOOL::m_Hole_NotPlated, DRILL_TOOL::m_OvalCount, m_toolListBuffer, DRILL_TOOL::m_TotalCount, and OUTPUTFORMATTER::Print().

Referenced by GenDrillReportFile().

◆ SetMapFileFormat()

void GENDRILL_WRITER_BASE::SetMapFileFormat ( PLOT_FORMAT aMapFmt )

inline

Initialize the format for the drill map file.

Parameters

aMapFmt a PlotFormat value (one of PLOT_FORMAT_HPGL, PLOT_FORMAT_POST, PLOT_FORMAT_GERBER, PLOT_FORMAT_DXF, PLOT_FORMAT_SVG, PLOT_FORMAT_PDF the most useful are PLOT_FORMAT_PDF and PLOT_FORMAT_POST.

Definition at line 201 of file gendrill_file_writer_base.h.

References m_mapFileFmt.

Referenced by DIALOG_GENDRILL::GenDrillAndMapFiles(), and PCBNEW_JOBS_HANDLER::JobExportDrill().