#include <embedded_files.h>

Inheritance diagram for EMBEDDED_FILES:

Classes
struct	EMBEDDED_FILE

Public Types
enum class	RETURN_CODE : int { OK , FILE_NOT_FOUND , PERMISSIONS_ERROR , FILE_ALREADY_EXISTS , OUT_OF_MEMORY , CHECKSUM_ERROR }

Public Member Functions
	EMBEDDED_FILES ()=default

	~EMBEDDED_FILES ()

EMBEDDED_FILE *	AddFile (const wxFileName &aName, bool aOverwrite)
	Loads a file from disk and adds it to the collection.

void	AddFile (EMBEDDED_FILE *aFile)
	Appends a file to the collection.

void	RemoveFile (const wxString &name, bool aErase=true)
	Removes a file from the collection and frees the memory.

void	WriteEmbeddedFiles (OUTPUTFORMATTER &aOut, int aNestLevel, bool aWriteData) const
	Output formatter for the embedded files.

wxString	GetEmbeddedFileLink (const EMBEDDED_FILE &aFile) const
	Returns the link for an embedded file.

bool	HasFile (const wxString &name) const

bool	IsEmpty () const

const std::vector< wxString > *	UpdateFontFiles ()
	Helper function to get a list of fonts for fontconfig to add to the library.

const std::vector< wxString > *	GetFontFiles () const
	If we just need the cached version of the font files, we can use this function which is const and will not update the font files.

void	ClearEmbeddedFonts ()
	Removes all embedded fonts from the collection.

EMBEDDED_FILE *	GetEmbeddedFile (const wxString &aName) const
	Returns the embedded file with the given name or nullptr if it does not exist.

const std::map< wxString, EMBEDDED_FILE * > &	EmbeddedFileMap () const

wxFileName	GetTemporaryFileName (const wxString &aName) const

wxFileName	GetTemporaryFileName (EMBEDDED_FILE *aFile) const

void	ClearEmbeddedFiles (bool aDeleteFiles=true)

virtual void	EmbedFonts ()

void	SetAreFontsEmbedded (bool aEmbedFonts)

bool	GetAreFontsEmbedded () const

Static Public Member Functions
static RETURN_CODE	CompressAndEncode (EMBEDDED_FILE &aFile)
	Takes data from the #decompressedData buffer and compresses it using ZSTD into the #compressedEncodedData buffer.

static RETURN_CODE	DecompressAndDecode (EMBEDDED_FILE &aFile)
	Takes data from the #compressedEncodedData buffer and Base64 decodes it.

static uint32_t	Seed ()

Protected Attributes
bool	m_embedFonts = false

Private Attributes
std::map< wxString, EMBEDDED_FILE * >	m_files

std::vector< wxString >	m_fontFiles

Detailed Description

Definition at line 33 of file embedded_files.h.

Member Enumeration Documentation

◆ RETURN_CODE

enum class EMBEDDED_FILES::RETURN_CODE : int

strong

Enumerator
OK
FILE_NOT_FOUND
PERMISSIONS_ERROR
FILE_ALREADY_EXISTS
OUT_OF_MEMORY
CHECKSUM_ERROR

Definition at line 85 of file embedded_files.h.

Constructor & Destructor Documentation

◆ EMBEDDED_FILES()

EMBEDDED_FILES::EMBEDDED_FILES ( )

default

◆ ~EMBEDDED_FILES()

EMBEDDED_FILES::~EMBEDDED_FILES ( )

inline

Definition at line 97 of file embedded_files.h.

References m_files.

Member Function Documentation

◆ AddFile() [1/2]

EMBEDDED_FILES::EMBEDDED_FILE * EMBEDDED_FILES::AddFile	(	const wxFileName &	aName,
		bool	aOverwrite
	)

Loads a file from disk and adds it to the collection.

Parameters

aName	is the name of the file to load.
aOverwrite	is true if the file should be overwritten if it already exists.

Definition at line 43 of file embedded_files.cpp.

References CompressAndEncode(), EMBEDDED_FILES::EMBEDDED_FILE::DATASHEET, EMBEDDED_FILES::EMBEDDED_FILE::FONT, HasFile(), m_files, EMBEDDED_FILES::EMBEDDED_FILE::MODEL, OK, and EMBEDDED_FILES::EMBEDDED_FILE::WORKSHEET.

Referenced by EMBED_TOOL::AddFile(), ALTIUM_PCB::ConvertComponentBody6ToFootprintItem(), LIB_SYMBOL::EmbedFonts(), SCHEMATIC::EmbedFonts(), BOARD::EmbedFonts(), FOOTPRINT::EmbedFonts(), FOOTPRINT::FOOTPRINT(), PCB_IO_KICAD_SEXPR::format(), PANEL_FP_PROPERTIES_3D_MODEL::OnAdd3DModel(), PANEL_EMBEDDED_FILES::onAddEmbeddedFile(), TEXT_BUTTON_URL::OnButtonClick(), DIALOG_PAGES_SETTINGS::OnWksFileSelection(), PANEL_EMBEDDED_FILES::PANEL_EMBEDDED_FILES(), ALTIUM_PCB::ParseComponentsBodies6Data(), EMBEDDED_FILES_PARSER::ParseEmbedded(), PANEL_EMBEDDED_FILES::TransferDataFromWindow(), and PANEL_FP_PROPERTIES_3D_MODEL::TransferDataFromWindow().

◆ AddFile() [2/2]

void EMBEDDED_FILES::AddFile ( EMBEDDED_FILE * aFile )

Appends a file to the collection.

Definition at line 111 of file embedded_files.cpp.

References m_files, and EMBEDDED_FILES::EMBEDDED_FILE::name.

◆ ClearEmbeddedFiles()

void EMBEDDED_FILES::ClearEmbeddedFiles ( bool aDeleteFiles = true )

inline

Definition at line 207 of file embedded_files.h.

References m_files.

Referenced by PCB_IO_KICAD_SEXPR::format(), and PANEL_EMBEDDED_FILES::TransferDataFromWindow().

◆ ClearEmbeddedFonts()

void EMBEDDED_FILES::ClearEmbeddedFonts ( )

Removes all embedded fonts from the collection.

Definition at line 131 of file embedded_files.cpp.

References EMBEDDED_FILES::EMBEDDED_FILE::FONT, and m_files.

Referenced by SCH_IO_KICAD_SEXPR::Format(), FP_CACHE::Save(), PCB_IO_KICAD_SEXPR::SaveBoard(), and SCH_IO_KICAD_SEXPR_LIB_CACHE::SaveSymbol().

◆ CompressAndEncode()

EMBEDDED_FILES::RETURN_CODE EMBEDDED_FILES::CompressAndEncode ( EMBEDDED_FILE & aFile )

static

Takes data from the #decompressedData buffer and compresses it using ZSTD into the #compressedEncodedData buffer.

The data is then Base64 encoded.

This call is used when adding a new file to the collection from disk

Definition at line 213 of file embedded_files.cpp.

References MMH3_HASH::add(), EMBEDDED_FILES::EMBEDDED_FILE::compressedEncodedData, EMBEDDED_FILES::EMBEDDED_FILE::data_hash, EMBEDDED_FILES::EMBEDDED_FILE::decompressedData, MMH3_HASH::digest(), OK, OUT_OF_MEMORY, Seed(), and HASH_128::ToString().

Referenced by AddFile(), BOOST_AUTO_TEST_CASE(), ALTIUM_PCB::ConvertComponentBody6ToFootprintItem(), and ALTIUM_PCB::ParseComponentsBodies6Data().

◆ DecompressAndDecode()

EMBEDDED_FILES::RETURN_CODE EMBEDDED_FILES::DecompressAndDecode ( EMBEDDED_FILE & aFile )

static

Takes data from the #compressedEncodedData buffer and Base64 decodes it.

The data is then decompressed using ZSTD and stored in the #decompressedData buffer.

This call is used when loading the embedded files using the parsers.

Definition at line 246 of file embedded_files.cpp.

References MMH3_HASH::add(), CHECKSUM_ERROR, EMBEDDED_FILES::EMBEDDED_FILE::compressedEncodedData, EMBEDDED_FILES::EMBEDDED_FILE::data_hash, EMBEDDED_FILES::EMBEDDED_FILE::decompressedData, MMH3_HASH::digest(), EMBEDDED_FILES::EMBEDDED_FILE::name, OK, OUT_OF_MEMORY, Seed(), and HASH_128::ToString().

Referenced by BOOST_AUTO_TEST_CASE(), and EMBEDDED_FILES_PARSER::ParseEmbedded().

◆ EmbeddedFileMap()

const std::map< wxString, EMBEDDED_FILE * > & EMBEDDED_FILES::EmbeddedFileMap ( ) const

inline

Definition at line 198 of file embedded_files.h.

References m_files.

Referenced by FOOTPRINT::FOOTPRINT(), PCB_IO_KICAD_SEXPR::format(), EMBED_TOOL::GetFileList(), PANEL_EMBEDDED_FILES::onExportFiles(), PANEL_EMBEDDED_FILES::PANEL_EMBEDDED_FILES(), SCH_IO_KICAD_SEXPR_LIB_CACHE::SaveSymbol(), PANEL_EMBEDDED_FILES::TransferDataFromWindow(), PANEL_FP_PROPERTIES_3D_MODEL::TransferDataFromWindow(), and PANEL_EMBEDDED_FILES::TransferDataToWindow().

◆ EmbedFonts()

virtual void EMBEDDED_FILES::EmbedFonts ( )

inlinevirtual

Reimplemented in LIB_SYMBOL, SCHEMATIC, BOARD, and FOOTPRINT.

Definition at line 218 of file embedded_files.h.

◆ GetAreFontsEmbedded()

bool EMBEDDED_FILES::GetAreFontsEmbedded ( ) const

inline

Definition at line 225 of file embedded_files.h.

References m_embedFonts.

Referenced by PCB_IO_KICAD_SEXPR::format(), SCH_IO_KICAD_SEXPR::Format(), FP_CACHE::Save(), PCB_IO_KICAD_SEXPR::SaveBoard(), SCH_IO_KICAD_SEXPR_LIB_CACHE::SaveSymbol(), and PANEL_EMBEDDED_FILES::TransferDataToWindow().

◆ GetEmbeddedFile()

EMBEDDED_FILE * EMBEDDED_FILES::GetEmbeddedFile ( const wxString & aName ) const

inline

Returns the embedded file with the given name or nullptr if it does not exist.

Definition at line 191 of file embedded_files.h.

References m_files.

Referenced by SCH_SCREEN::FixupEmbeddedData(), and BOARD::FixupEmbeddedData().

◆ GetEmbeddedFileLink()

wxString EMBEDDED_FILES::GetEmbeddedFileLink ( const EMBEDDED_FILE & aFile ) const

inline

Returns the link for an embedded file.

Parameters

aFile is the file to get the link for.

Returns: the link for the file to be used in a hyperlink.

Definition at line 135 of file embedded_files.h.

References EMBEDDED_FILES::EMBEDDED_FILE::GetLink().

Referenced by ALTIUM_PCB::ConvertComponentBody6ToFootprintItem(), and ALTIUM_PCB::ParseComponentsBodies6Data().

◆ GetFontFiles()

const std::vector< wxString > * EMBEDDED_FILES::GetFontFiles ( ) const

If we just need the cached version of the font files, we can use this function which is const and will not update the font files.

Definition at line 507 of file embedded_files.cpp.

References m_fontFiles.

Referenced by FIELDS_GRID_TABLE::initGrid(), SCH_IO_KICAD_SEXPR_PARSER::ParseSchematic(), SCH_PROPERTIES_PANEL::updateFontList(), and PCB_PROPERTIES_PANEL::updateLists().

◆ GetTemporaryFileName() [1/2]

wxFileName EMBEDDED_FILES::GetTemporaryFileName ( const wxString & aName ) const

Definition at line 462 of file embedded_files.cpp.

References PATHS::EnsurePathExists(), PATHS::GetUserCachePath(), and m_files.

Referenced by GetAssociatedDocument(), DIALOG_PAGES_SETTINGS::OnWksFileSelection(), FILENAME_RESOLVER::ResolvePath(), and UpdateFontFiles().

◆ GetTemporaryFileName() [2/2]

wxFileName EMBEDDED_FILES::GetTemporaryFileName ( EMBEDDED_FILE * aFile ) const

◆ HasFile()

bool EMBEDDED_FILES::HasFile ( const wxString & name ) const

inline

Definition at line 140 of file embedded_files.h.

References m_files, and name.

Referenced by AddFile(), PANEL_EMBEDDED_FILES::onAddEmbeddedFile(), and PANEL_FP_PROPERTIES_3D_MODEL::TransferDataFromWindow().

◆ IsEmpty()

bool EMBEDDED_FILES::IsEmpty ( ) const

inline

Definition at line 147 of file embedded_files.h.

References m_files.

Referenced by PCB_IO_KICAD_SEXPR::format(), SCH_IO_KICAD_SEXPR::Format(), and LIB_SYMBOL::GetDescription().

◆ RemoveFile()

void EMBEDDED_FILES::RemoveFile	(	const wxString &	name,
		bool	aErase = `true`
	)

Removes a file from the collection and frees the memory.

Parameters

aName is the name of the file to remove.

Definition at line 117 of file embedded_files.cpp.

References m_files, and name.

Referenced by PANEL_EMBEDDED_FILES::onDeleteEmbeddedFile(), EMBED_TOOL::RemoveFile(), and PANEL_EMBEDDED_FILES::TransferDataFromWindow().

◆ Seed()

static uint32_t EMBEDDED_FILES::Seed ( )

inlinestatic

Definition at line 230 of file embedded_files.h.

Referenced by BOOST_AUTO_TEST_CASE(), CompressAndEncode(), DecompressAndDecode(), and EMBEDDED_FILES::EMBEDDED_FILE::Validate().

◆ SetAreFontsEmbedded()

void EMBEDDED_FILES::SetAreFontsEmbedded ( bool aEmbedFonts )

inline

Definition at line 220 of file embedded_files.h.

References m_embedFonts.

Referenced by PCB_IO_KICAD_SEXPR_PARSER::parseBOARD_unchecked(), SCH_IO_KICAD_SEXPR_PARSER::ParseSchematic(), and PANEL_EMBEDDED_FILES::TransferDataFromWindow().

◆ UpdateFontFiles()

const std::vector< wxString > * EMBEDDED_FILES::UpdateFontFiles ( )

Helper function to get a list of fonts for fontconfig to add to the library.

This is neccesary because EMBEDDED_FILES lives in common at the moment and fontconfig is in libkicommon. This will create the cache files in the KiCad cache directory (if they do not already exist) and return the temp files names

Definition at line 513 of file embedded_files.cpp.

References EMBEDDED_FILES::EMBEDDED_FILE::FONT, GetTemporaryFileName(), m_files, m_fontFiles, and name.

Referenced by FIELDS_GRID_TABLE::initGrid(), PCB_IO_KICAD_SEXPR_PARSER::Parse(), SCH_IO_KICAD_SEXPR_PARSER::ParseSchematic(), SCH_IO_KICAD_SEXPR_PARSER::ParseSymbol(), and SCH_PROPERTIES_PANEL::updateFontList().

◆ WriteEmbeddedFiles()

void EMBEDDED_FILES::WriteEmbeddedFiles	(	OUTPUTFORMATTER &	aOut,
		int	aNestLevel,
		bool	aWriteData
	)		const

Output formatter for the embedded files.

Parameters

aOut	is the output formatter.
aNestLevel	is the current indentation level.
aWriteData	is true if the actual data should be written. This is false when writing an element that is already embedded in a file that itself has embedded files (boards, schematics, etc.)

Definition at line 149 of file embedded_files.cpp.

References EMBEDDED_FILES::EMBEDDED_FILE::compressedEncodedData, EMBEDDED_FILES::EMBEDDED_FILE::data_hash, EMBEDDED_FILES::EMBEDDED_FILE::DATASHEET, EMBEDDED_FILES::EMBEDDED_FILE::FONT, m_files, MIME_BASE64_LENGTH, EMBEDDED_FILES::EMBEDDED_FILE::MODEL, name, EMBEDDED_FILES::EMBEDDED_FILE::name, OUTPUTFORMATTER::Print(), EMBEDDED_FILES::EMBEDDED_FILE::type, and EMBEDDED_FILES::EMBEDDED_FILE::WORKSHEET.

Referenced by PCB_IO_KICAD_SEXPR::format(), SCH_IO_KICAD_SEXPR::Format(), and SCH_IO_KICAD_SEXPR_LIB_CACHE::SaveSymbol().

Member Data Documentation

◆ m_embedFonts

bool EMBEDDED_FILES::m_embedFonts = false

protected

Definition at line 240 of file embedded_files.h.

Referenced by FOOTPRINT::FOOTPRINT(), GetAreFontsEmbedded(), and SetAreFontsEmbedded().

◆ m_files

std::map<wxString, EMBEDDED_FILE*> EMBEDDED_FILES::m_files

private

Definition at line 236 of file embedded_files.h.

Referenced by AddFile(), ClearEmbeddedFiles(), ClearEmbeddedFonts(), EmbeddedFileMap(), GetEmbeddedFile(), GetTemporaryFileName(), HasFile(), IsEmpty(), RemoveFile(), UpdateFontFiles(), WriteEmbeddedFiles(), and ~EMBEDDED_FILES().

◆ m_fontFiles

std::vector<wxString> EMBEDDED_FILES::m_fontFiles

private

Definition at line 237 of file embedded_files.h.

Referenced by GetFontFiles(), and UpdateFontFiles().

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

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Attributes

Private Attributes

Detailed Description

Member Enumeration Documentation

◆ RETURN_CODE

Constructor & Destructor Documentation

◆ EMBEDDED_FILES()

◆ ~EMBEDDED_FILES()

Member Function Documentation

◆ AddFile() [1/2]

◆ AddFile() [2/2]

◆ ClearEmbeddedFiles()

◆ ClearEmbeddedFonts()

◆ CompressAndEncode()

◆ DecompressAndDecode()

◆ EmbeddedFileMap()

◆ EmbedFonts()

◆ GetAreFontsEmbedded()

◆ GetEmbeddedFile()

◆ GetEmbeddedFileLink()

◆ GetFontFiles()

◆ GetTemporaryFileName() [1/2]

◆ GetTemporaryFileName() [2/2]

◆ HasFile()

◆ IsEmpty()

◆ RemoveFile()

◆ Seed()

◆ SetAreFontsEmbedded()

◆ UpdateFontFiles()

◆ WriteEmbeddedFiles()

Member Data Documentation

◆ m_embedFonts

◆ m_files

◆ m_fontFiles