Schematic plotting class. More...

#include <sch_plotter.h>

Public Member Functions
	SCH_PLOTTER (SCH_EDIT_FRAME *aFrame)
	Constructor for usage with a frame having the schematic we want to print loaded.

	SCH_PLOTTER (SCHEMATIC *aSch)
	Constructor for usage with a schematic that can be headless.

void	Plot (PLOT_FORMAT aPlotFormat, const SCH_PLOT_OPTS &aPlotOpts, SCH_RENDER_SETTINGS aRenderSettings, REPORTER aReporter=nullptr)
	Perform the plotting of the schematic using the given aPlotFormat and a\ aPlotSettings.

wxString	GetLastOutputFilePath () const
	Get the last output file path, this is mainly intended for PDFs with the open after plot GUI option.

const std::vector< wxString > &	GetOutputFilePaths () const
	Get all output file paths generated by the last Plot() call.

Protected Member Functions
wxFileName	getOutputFilenameSingle (const SCH_PLOT_OPTS &aPlotOpts, REPORTER *aReporter, const wxString &ext)
	Return the output filename for formats where the output is a single file.

void	createPDFFile (const SCH_PLOT_OPTS &aPlotOpts, SCH_RENDER_SETTINGS aRenderSettings, REPORTER aReporter)

void	plotOneSheetPDF (PLOTTER aPlotter, SCH_SCREEN aScreen, const SCH_PLOT_OPTS &aPlotOpts)

void	setupPlotPagePDF (PLOTTER aPlotter, SCH_SCREEN aScreen, const SCH_PLOT_OPTS &aPlotOpts)

void	createDXFFiles (const SCH_PLOT_OPTS &aPlotOpts, SCH_RENDER_SETTINGS aRenderSettings, REPORTER aReporter)

bool	plotOneSheetDXF (const wxString &aFileName, SCH_SCREEN aScreen, RENDER_SETTINGS aRenderSettings, const VECTOR2I &aPlotOffset, double aScale, const SCH_PLOT_OPTS &aPlotOpts)

void	createPSFiles (const SCH_PLOT_OPTS &aPlotOpts, SCH_RENDER_SETTINGS aRenderSettings, REPORTER aReporter)

bool	plotOneSheetPS (const wxString &aFileName, SCH_SCREEN aScreen, RENDER_SETTINGS aRenderSettings, const PAGE_INFO &aPageInfo, const VECTOR2I &aPlot0ffset, double aScale, const SCH_PLOT_OPTS &aPlotOpts)

void	createSVGFiles (const SCH_PLOT_OPTS &aPlotOpts, SCH_RENDER_SETTINGS aRenderSettings, REPORTER aReporter)

bool	plotOneSheetSVG (const wxString &aFileName, SCH_SCREEN aScreen, RENDER_SETTINGS aRenderSettings, const SCH_PLOT_OPTS &aPlotOpts)

void	createPNGFiles (const SCH_PLOT_OPTS &aPlotOpts, SCH_RENDER_SETTINGS aRenderSettings, REPORTER aReporter)

bool	plotOneSheetPNG (const wxString &aFileName, SCH_SCREEN aScreen, RENDER_SETTINGS aRenderSettings, const SCH_PLOT_OPTS &aPlotOpts)

wxFileName	createPlotFileName (const SCH_PLOT_OPTS &aPlotOpts, const wxString &aPlotFileName, const wxString &aExtension, REPORTER *aReporter=nullptr)
	Create a file name with an absolute path name.

Private Attributes
SCHEMATIC *	m_schematic

COLOR_SETTINGS *	m_colorSettings

wxString	m_lastOutputFilePath

std::vector< wxString >	m_outputFilePaths

Detailed Description

Schematic plotting class.

Definition at line 106 of file sch_plotter.h.

Constructor & Destructor Documentation

◆ SCH_PLOTTER() [1/2]

SCH_PLOTTER::SCH_PLOTTER ( SCH_EDIT_FRAME * aFrame )

Constructor for usage with a frame having the schematic we want to print loaded.

Definition at line 60 of file sch_plotter.cpp.

References m_colorSettings, and m_schematic.

◆ SCH_PLOTTER() [2/2]

SCH_PLOTTER::SCH_PLOTTER ( SCHEMATIC * aSch )

Constructor for usage with a schematic that can be headless.

Definition at line 53 of file sch_plotter.cpp.

References m_colorSettings, and m_schematic.

Member Function Documentation

◆ createDXFFiles()

void SCH_PLOTTER::createDXFFiles	(	const SCH_PLOT_OPTS &	aPlotOpts,
		SCH_RENDER_SETTINGS *	aRenderSettings,
		REPORTER *	aReporter )

protected

◆ createPDFFile()

void SCH_PLOTTER::createPDFFile	(	const SCH_PLOT_OPTS &	aPlotOpts,
		SCH_RENDER_SETTINGS *	aRenderSettings,
		REPORTER *	aReporter )

protected

Definition at line 121 of file sch_plotter.cpp.

References _, SCH_SHEET_LIST::BuildSheetList(), PDF_PLOTTER::ClosePage(), ExpandTextVars(), FOR_GUI, PDF_PLOTTER::GetDefaultFileExtension(), SCH_SHEET::GetField(), getOutputFilenameSingle(), SCH_SHEET_PATH::GetPageNumber(), SCH_FIELD::GetShownText(), SCH_SHEET_PATH::Last(), SCH_PLOT_OPTS::m_blackAndWhite, m_lastOutputFilePath, m_outputFilePaths, SCH_PLOT_OPTS::m_PDFMetadata, SCH_PLOT_OPTS::m_plotAll, SCH_PLOT_OPTS::m_plotPages, m_schematic, SCH_PLOT_OPTS::m_sheetPath, PDF_PLOTTER::OpenFile(), plotOneSheetPDF(), SCH_SHEET_PATH::pop_back(), REPORTER::Report(), REPORTER::ReportTail(), RPT_SEVERITY_ACTION, RPT_SEVERITY_ERROR, RPT_SEVERITY_INFO, PLOTTER::SetAuthor(), PLOTTER::SetColorMode(), PLOTTER::SetCreator(), PLOTTER::SetRenderSettings(), PLOTTER::SetSubject(), PLOTTER::SetTitle(), setupPlotPagePDF(), SHEET_NAME, SCH_SHEET_PATH::size(), SCH_SHEET_LIST::SortByHierarchicalPageNumbers(), PDF_PLOTTER::StartPage(), PDF_PLOTTER::StartPlot(), SCH_SHEET_LIST::TrimToPageNumbers(), and IO_ERROR::What().

Referenced by Plot().

◆ createPlotFileName()

wxFileName SCH_PLOTTER::createPlotFileName	(	const SCH_PLOT_OPTS &	aPlotOpts,
		const wxString &	aPlotFileName,
		const wxString &	aExtension,
		REPORTER *	aReporter = nullptr )

protected

Create a file name with an absolute path name.

Parameters

aPlotOpts	The configuration for the plotting operation
aPlotFileName	the name for the file to plot without a path.
aExtension	the extension for the file to plot.
aReporter	a point to a REPORTER object use to show messages (can be NULL).

Returns: the created file name.

Exceptions

IO_ERROR on file I/O errors.

Definition at line 1081 of file sch_plotter.cpp.

References _, EnsureFileDirectoryExists(), SCH_PLOT_OPTS::m_outputDirectory, SCHEMATIC_SETTINGS::m_PlotDirectoryName, m_schematic, REPORTER::Report(), RPT_SEVERITY_ERROR, and tracePathsAndFiles.

Referenced by createDXFFiles(), createPNGFiles(), createPSFiles(), createSVGFiles(), and getOutputFilenameSingle().

◆ createPNGFiles()

void SCH_PLOTTER::createPNGFiles	(	const SCH_PLOT_OPTS &	aPlotOpts,
		SCH_RENDER_SETTINGS *	aRenderSettings,
		REPORTER *	aReporter )

protected

◆ createPSFiles()

void SCH_PLOTTER::createPSFiles	(	const SCH_PLOT_OPTS &	aPlotOpts,
		SCH_RENDER_SETTINGS *	aRenderSettings,
		REPORTER *	aReporter )

protected

◆ createSVGFiles()

void SCH_PLOTTER::createSVGFiles	(	const SCH_PLOT_OPTS &	aPlotOpts,
		SCH_RENDER_SETTINGS *	aRenderSettings,
		REPORTER *	aReporter )

protected

◆ GetLastOutputFilePath()

wxString SCH_PLOTTER::GetLastOutputFilePath ( ) const

inline

Get the last output file path, this is mainly intended for PDFs with the open after plot GUI option.

Definition at line 134 of file sch_plotter.h.

References m_lastOutputFilePath.

Referenced by DIALOG_PRINT::TransferDataFromWindow().

◆ getOutputFilenameSingle()

wxFileName SCH_PLOTTER::getOutputFilenameSingle	(	const SCH_PLOT_OPTS &	aPlotOpts,
		REPORTER *	aReporter,
		const wxString &	ext )

protected

Return the output filename for formats where the output is a single file.

Definition at line 67 of file sch_plotter.cpp.

References createPlotFileName(), SCH_PLOT_OPTS::m_outputFile, and m_schematic.

Referenced by createPDFFile().

◆ GetOutputFilePaths()

const std::vector< wxString > & SCH_PLOTTER::GetOutputFilePaths ( ) const

inline

Get all output file paths generated by the last Plot() call.

Definition at line 139 of file sch_plotter.h.

References m_outputFilePaths.

◆ Plot()

void SCH_PLOTTER::Plot	(	PLOT_FORMAT	aPlotFormat,
		const SCH_PLOT_OPTS &	aPlotOpts,
		SCH_RENDER_SETTINGS *	aRenderSettings,
		REPORTER *	aReporter = nullptr )

Perform the plotting of the schematic using the given aPlotFormat and a\ aPlotSettings.

Parameters

aPlotFormat	The resulting output plot format (PDF, SVG, DXF, etc).
aPlotOpts	The configuration for the plotting operation.
aRenderSettings	Mandatory object containing render settings for lower level classes.
aReporter	Optional reporter to print messages to.

Definition at line 1123 of file sch_plotter.cpp.

References createDXFFiles(), createPDFFile(), createPNGFiles(), createPSFiles(), createSVGFiles(), DXF, GetColorSettings(), HPGL, m_colorSettings, m_outputFilePaths, m_schematic, SCH_PLOT_OPTS::m_theme, SCH_PLOT_OPTS::m_variant, PDF, PNG, POST, and SVG.

Referenced by DIALOG_PRINT::TransferDataFromWindow().

◆ plotOneSheetDXF()

bool SCH_PLOTTER::plotOneSheetDXF	(	const wxString &	aFileName,
		SCH_SCREEN *	aScreen,
		RENDER_SETTINGS *	aRenderSettings,
		const VECTOR2I &	aPlotOffset,
		double	aScale,
		const SCH_PLOT_OPTS &	aPlotOpts )

protected

Definition at line 1026 of file sch_plotter.cpp.

References COLOR4D::BLACK, DXF_PLOTTER::EndPlot(), PLOTTER::GetColorMode(), SCH_SCREEN::GetFileName(), KIGFX::RENDER_SETTINGS::GetLayerColor(), BASE_SCREEN::GetPageCount(), BASE_SCREEN::GetPageNumber(), SCH_SCREEN::GetPageSettings(), SCH_SCREEN::GetTitleBlock(), BASE_SCREEN::GetVirtualPageNumber(), LAYER_SCHEMATIC_DRAWINGSHEET, KIGFX::RENDER_SETTINGS::LoadColors(), SCH_PLOT_OPTS::m_blackAndWhite, m_colorSettings, SCH_PLOT_OPTS::m_DXF_File_Unit, SCH_PLOT_OPTS::m_plotDrawingSheet, m_schematic, PLOTTER::OpenFile(), SCH_SCREEN::Plot(), PlotDrawingSheet(), PLOTTER::RenderSettings(), schIUScale, PLOTTER::SetColorMode(), PLOTTER::SetCreator(), KIGFX::RENDER_SETTINGS::SetDefaultPenWidth(), PLOTTER::SetPageSettings(), PLOTTER::SetRenderSettings(), DXF_PLOTTER::SetUnits(), DXF_PLOTTER::SetViewport(), and DXF_PLOTTER::StartPlot().

Referenced by createDXFFiles().

◆ plotOneSheetPDF()

void SCH_PLOTTER::plotOneSheetPDF	(	PLOTTER *	aPlotter,
		SCH_SCREEN *	aScreen,
		const SCH_PLOT_OPTS &	aPlotOpts )

protected

Definition at line 265 of file sch_plotter.cpp.

References COLOR4D::BLACK, end, FILLED_SHAPE, KIGFX::RENDER_SETTINGS::GetBackgroundColor(), PLOTTER::GetColorMode(), SCHEMATIC::GetCurrentVariant(), SCH_SCREEN::GetFileName(), PAGE_INFO::GetHeightIU(), KIGFX::RENDER_SETTINGS::GetLayerColor(), BASE_SCREEN::GetPageCount(), BASE_SCREEN::GetPageNumber(), SCH_SCREEN::GetPageSettings(), SCHEMATIC::GetProperties(), SCH_SCREEN::GetTitleBlock(), SCHEMATIC::GetVariantDescription(), BASE_SCREEN::GetVirtualPageNumber(), PAGE_INFO::GetWidthIU(), LAYER_SCHEMATIC_DRAWINGSHEET, SCH_PLOT_OPTS::m_plotDrawingSheet, m_schematic, SCH_PLOT_OPTS::m_useBackgroundColor, SCH_SCREEN::Plot(), PlotDrawingSheet(), SCHEMATIC::Project(), PLOTTER::Rect(), PLOTTER::RenderSettings(), SCH_SCREEN::Schematic(), schIUScale, and PLOTTER::SetColor().

Referenced by createPDFFile().

◆ plotOneSheetPNG()

bool SCH_PLOTTER::plotOneSheetPNG	(	const wxString &	aFileName,
		SCH_SCREEN *	aScreen,
		RENDER_SETTINGS *	aRenderSettings,
		const SCH_PLOT_OPTS &	aPlotOpts )

protected

Definition at line 825 of file sch_plotter.cpp.

References COLOR4D::BLACK, end, PNG_PLOTTER::EndPlot(), FILLED_SHAPE, PLOTTER::GetColorMode(), SCHEMATIC::GetCurrentVariant(), SCH_SCREEN::GetFileName(), PAGE_INFO::GetHeightIU(), PAGE_INFO::GetHeightMils(), KIGFX::RENDER_SETTINGS::GetLayerColor(), BASE_SCREEN::GetPageCount(), BASE_SCREEN::GetPageNumber(), SCH_SCREEN::GetPageSettings(), SCHEMATIC::GetProperties(), SCH_SCREEN::GetTitleBlock(), SCHEMATIC::GetVariantDescription(), BASE_SCREEN::GetVirtualPageNumber(), PAGE_INFO::GetWidthIU(), PAGE_INFO::GetWidthMils(), PAGE_INFO::IsPortrait(), KiROUND(), LAYER_SCHEMATIC_BACKGROUND, LAYER_SCHEMATIC_DRAWINGSHEET, SCH_PLOT_OPTS::m_blackAndWhite, SCH_PLOT_OPTS::m_pageSizeSelect, SCH_PLOT_OPTS::m_plotDrawingSheet, SCH_PLOT_OPTS::m_pngAntialias, SCH_PLOT_OPTS::m_pngDPI, m_schematic, SCH_PLOT_OPTS::m_useBackgroundColor, MAX_PNG_DPI, MIN_PNG_DPI, PNG_PLOTTER::OpenFile(), PAGE_SIZE_A, PAGE_SIZE_A4, PAGE_SIZE_AUTO, SCH_SCREEN::Plot(), PlotDrawingSheet(), SCHEMATIC::Project(), PNG_PLOTTER::Rect(), PLOTTER::RenderSettings(), scale, SCH_SCREEN::Schematic(), schIUScale, PNG_PLOTTER::SetAntialias(), PNG_PLOTTER::SetColor(), PLOTTER::SetColorMode(), PLOTTER::SetCreator(), PLOTTER::SetPageSettings(), PNG_PLOTTER::SetPixelSize(), PAGE_INFO::SetPortrait(), PLOTTER::SetRenderSettings(), PNG_PLOTTER::SetResolution(), PAGE_INFO::SetType(), PNG_PLOTTER::SetViewport(), and PNG_PLOTTER::StartPlot().

Referenced by createPNGFiles().

◆ plotOneSheetPS()

bool SCH_PLOTTER::plotOneSheetPS	(	const wxString &	aFileName,
		SCH_SCREEN *	aScreen,
		RENDER_SETTINGS *	aRenderSettings,
		const PAGE_INFO &	aPageInfo,
		const VECTOR2I &	aPlot0ffset,
		double	aScale,
		const SCH_PLOT_OPTS &	aPlotOpts )

protected

Definition at line 477 of file sch_plotter.cpp.

References COLOR4D::BLACK, end, PS_PLOTTER::EndPlot(), FILLED_SHAPE, PLOTTER::GetColorMode(), SCHEMATIC::GetCurrentVariant(), SCH_SCREEN::GetFileName(), PAGE_INFO::GetHeightIU(), KIGFX::RENDER_SETTINGS::GetLayerColor(), BASE_SCREEN::GetPageCount(), BASE_SCREEN::GetPageNumber(), SCH_SCREEN::GetPageSettings(), SCHEMATIC::GetProperties(), SCH_SCREEN::GetTitleBlock(), SCHEMATIC::GetVariantDescription(), BASE_SCREEN::GetVirtualPageNumber(), PAGE_INFO::GetWidthIU(), LAYER_SCHEMATIC_BACKGROUND, LAYER_SCHEMATIC_DRAWINGSHEET, SCH_PLOT_OPTS::m_blackAndWhite, SCH_PLOT_OPTS::m_plotDrawingSheet, m_schematic, SCH_PLOT_OPTS::m_useBackgroundColor, PLOTTER::OpenFile(), SCH_SCREEN::Plot(), PlotDrawingSheet(), SCHEMATIC::Project(), PS_PLOTTER::Rect(), PLOTTER::RenderSettings(), SCH_SCREEN::Schematic(), schIUScale, PSLIKE_PLOTTER::SetColor(), PLOTTER::SetColorMode(), PLOTTER::SetCreator(), PLOTTER::SetPageSettings(), PLOTTER::SetRenderSettings(), PS_PLOTTER::SetViewport(), and PS_PLOTTER::StartPlot().

Referenced by createPSFiles().

◆ plotOneSheetSVG()

bool SCH_PLOTTER::plotOneSheetSVG	(	const wxString &	aFileName,
		SCH_SCREEN *	aScreen,
		RENDER_SETTINGS *	aRenderSettings,
		const SCH_PLOT_OPTS &	aPlotOpts )

protected

Definition at line 642 of file sch_plotter.cpp.

References COLOR4D::BLACK, end, SVG_PLOTTER::EndPlot(), FILLED_SHAPE, PLOTTER::GetColorMode(), SCHEMATIC::GetCurrentVariant(), SCH_SCREEN::GetFileName(), PAGE_INFO::GetHeightIU(), PAGE_INFO::GetHeightMils(), KIGFX::RENDER_SETTINGS::GetLayerColor(), BASE_SCREEN::GetPageCount(), BASE_SCREEN::GetPageNumber(), SCH_SCREEN::GetPageSettings(), SCHEMATIC::GetProperties(), SCH_SCREEN::GetTitleBlock(), SCHEMATIC::GetVariantDescription(), BASE_SCREEN::GetVirtualPageNumber(), PAGE_INFO::GetWidthIU(), PAGE_INFO::GetWidthMils(), PAGE_INFO::IsPortrait(), LAYER_SCHEMATIC_BACKGROUND, LAYER_SCHEMATIC_DRAWINGSHEET, SCH_PLOT_OPTS::m_blackAndWhite, SCH_PLOT_OPTS::m_pageSizeSelect, SCH_PLOT_OPTS::m_plotDrawingSheet, m_schematic, SCH_PLOT_OPTS::m_useBackgroundColor, PLOTTER::OpenFile(), PAGE_SIZE_A, PAGE_SIZE_A4, PAGE_SIZE_AUTO, SCH_SCREEN::Plot(), PlotDrawingSheet(), SCHEMATIC::Project(), SVG_PLOTTER::Rect(), PLOTTER::RenderSettings(), scale, SCH_SCREEN::Schematic(), schIUScale, PSLIKE_PLOTTER::SetColor(), PLOTTER::SetColorMode(), PLOTTER::SetCreator(), PLOTTER::SetPageSettings(), PAGE_INFO::SetPortrait(), PLOTTER::SetRenderSettings(), PAGE_INFO::SetType(), SVG_PLOTTER::SetViewport(), and SVG_PLOTTER::StartPlot().

Referenced by createSVGFiles().

◆ setupPlotPagePDF()

void SCH_PLOTTER::setupPlotPagePDF	(	PLOTTER *	aPlotter,
		SCH_SCREEN *	aScreen,
		const SCH_PLOT_OPTS &	aPlotOpts )

protected

Definition at line 305 of file sch_plotter.cpp.

References PAGE_INFO::GetHeightMils(), SCH_SCREEN::GetPageSettings(), PAGE_INFO::GetWidthMils(), PAGE_INFO::IsPortrait(), SCH_PLOT_OPTS::m_pageSizeSelect, PAGE_SIZE_A, PAGE_SIZE_A4, PAGE_SIZE_AUTO, scale, schIUScale, PLOTTER::SetPageSettings(), PAGE_INFO::SetPortrait(), PAGE_INFO::SetType(), and PLOTTER::SetViewport().

Referenced by createPDFFile().

Member Data Documentation

◆ m_colorSettings

COLOR_SETTINGS* SCH_PLOTTER::m_colorSettings

private

Definition at line 197 of file sch_plotter.h.

Referenced by Plot(), plotOneSheetDXF(), SCH_PLOTTER(), and SCH_PLOTTER().

◆ m_lastOutputFilePath

wxString SCH_PLOTTER::m_lastOutputFilePath

private

Definition at line 198 of file sch_plotter.h.

Referenced by createDXFFiles(), createPDFFile(), createPNGFiles(), createPSFiles(), createSVGFiles(), and GetLastOutputFilePath().

◆ m_outputFilePaths

std::vector<wxString> SCH_PLOTTER::m_outputFilePaths

private

Definition at line 199 of file sch_plotter.h.

Referenced by createDXFFiles(), createPDFFile(), createPNGFiles(), createPSFiles(), createSVGFiles(), GetOutputFilePaths(), and Plot().

◆ m_schematic

SCHEMATIC* SCH_PLOTTER::m_schematic

private

Definition at line 196 of file sch_plotter.h.

Referenced by createDXFFiles(), createPDFFile(), createPlotFileName(), createPNGFiles(), createPSFiles(), createSVGFiles(), getOutputFilenameSingle(), Plot(), plotOneSheetDXF(), plotOneSheetPDF(), plotOneSheetPNG(), plotOneSheetPS(), plotOneSheetSVG(), SCH_PLOTTER(), and SCH_PLOTTER().

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

Public Member Functions

Protected Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ SCH_PLOTTER() [1/2]

◆ SCH_PLOTTER() [2/2]

Member Function Documentation

◆ createDXFFiles()

◆ createPDFFile()

◆ createPlotFileName()

◆ createPNGFiles()

◆ createPSFiles()

◆ createSVGFiles()

◆ GetLastOutputFilePath()

◆ getOutputFilenameSingle()

◆ GetOutputFilePaths()

◆ Plot()

◆ plotOneSheetDXF()

◆ plotOneSheetPDF()

◆ plotOneSheetPNG()

◆ plotOneSheetPS()

◆ plotOneSheetSVG()

◆ setupPlotPagePDF()

Member Data Documentation

◆ m_colorSettings

◆ m_lastOutputFilePath

◆ m_outputFilePaths

◆ m_schematic