KiCad PCB EDA Suite: REFERENCE_IMAGE Class Reference

KiCad PCB EDA Suite

Loading...

Searching...

No Matches

A REFERENCE_IMAGE is a wrapper around a BITMAP_IMAGE that is displayed in an editor as a reference for the user. More...

#include <reference_image.h>

Public Member Functions
	REFERENCE_IMAGE (const EDA_IU_SCALE &aIuScale)

	REFERENCE_IMAGE (const REFERENCE_IMAGE &aOther)

	~REFERENCE_IMAGE ()

REFERENCE_IMAGE &	operator= (const REFERENCE_IMAGE &aOther)

bool	operator== (const REFERENCE_IMAGE &aOther) const

double	Similarity (const REFERENCE_IMAGE &aOther) const

BOX2I	GetBoundingBox () const

bool	HitTest (const BOX2I &aRect, bool aContained, int aAccuracy) const

VECTOR2I	GetPosition () const

void	SetPosition (const VECTOR2I &aPos)

VECTOR2I	GetSize () const

double	GetImageScale () const

void	SetImageScale (double aScale)
	Set the image "zoom" value.

void	SetWidth (int aWidth)

void	SetHeight (int aHeight)

void	Flip (const VECTOR2I &aCentre, FLIP_DIRECTION aFlipDirection)

void	Rotate (const VECTOR2I &aCenter, const EDA_ANGLE &aAngle)

bool	ReadImageFile (const wxString &aFullFilename)
	Read and store an image file.

bool	ReadImageFile (wxMemoryBuffer &aBuf)
	Read and store an image file.

bool	SetImage (const wxImage &aImage)
	Set the image from an existing wxImage.

void	SwapData (REFERENCE_IMAGE &aItem)

const BITMAP_BASE &	GetImage () const
	Get the underlying image.

BITMAP_BASE &	MutableImage () const
	Only use this if you really need to modify the underlying image.

VECTOR2I	GetTransformOriginOffset () const
	Get the center of scaling, etc, relative to the image center (GetPosition()).

void	SetTransformOriginOffset (const VECTOR2I &aCenter)

Private Member Functions
void	scaleBy (double ratio)

void	updatePixelSizeInIU ()

Private Attributes
const EDA_IU_SCALE &	m_iuScale

VECTOR2I	m_pos
	XY coordinates of center of the bitmap.

VECTOR2I	m_transformOriginOffset
	Center of scaling, etc, relative to the image center.

std::unique_ptr< BITMAP_BASE >	m_bitmapBase

Detailed Description

A REFERENCE_IMAGE is a wrapper around a BITMAP_IMAGE that is displayed in an editor as a reference for the user.

Definition at line 42 of file reference_image.h.

Constructor & Destructor Documentation

◆ REFERENCE_IMAGE() [1/2]

REFERENCE_IMAGE::REFERENCE_IMAGE ( const EDA_IU_SCALE & aIuScale )

Definition at line 32 of file reference_image.cpp.

References updatePixelSizeInIU().

◆ REFERENCE_IMAGE() [2/2]

REFERENCE_IMAGE::REFERENCE_IMAGE ( const REFERENCE_IMAGE & aOther )

Definition at line 40 of file reference_image.cpp.

References updatePixelSizeInIU().

◆ ~REFERENCE_IMAGE()

REFERENCE_IMAGE::~REFERENCE_IMAGE ( )

Definition at line 49 of file reference_image.cpp.

Member Function Documentation

◆ Flip()

void REFERENCE_IMAGE::Flip	(	const VECTOR2I &	aCentre,
		FLIP_DIRECTION	aFlipDirection
	)

Definition at line 238 of file reference_image.cpp.

References BOX2< VECTOR2D >::ByCenter(), IsBOX2Safe(), m_bitmapBase, m_pos, and MIRROR().

Referenced by PCB_REFERENCE_IMAGE::Flip(), SCH_BITMAP::MirrorHorizontally(), and SCH_BITMAP::MirrorVertically().

◆ GetBoundingBox()

BOX2I REFERENCE_IMAGE::GetBoundingBox ( ) const

Definition at line 133 of file reference_image.cpp.

References BOX2< VECTOR2I >::ByCenter(), m_bitmapBase, and m_pos.

Referenced by PCB_GRID_HELPER::AddConstructionItems(), PCB_GRID_HELPER::computeAnchors(), SCH_BITMAP::GetBoundingBox(), and PCB_REFERENCE_IMAGE::GetBoundingBox().

◆ GetImage()

const BITMAP_BASE & REFERENCE_IMAGE::GetImage ( ) const

Get the underlying image.

This will always return a valid reference, but it may be to an empty image.

Definition at line 303 of file reference_image.cpp.

References m_bitmapBase.

Referenced by BOOST_DATA_TEST_CASE_F(), DIALOG_IMAGE_PROPERTIES::DIALOG_IMAGE_PROPERTIES(), KIGFX::PCB_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), PCB_IO_KICAD_SEXPR::format(), SCH_BITMAP::GetHeight(), PCB_REFERENCE_IMAGE::GetHeight(), SCH_BITMAP::GetMsgPanelInfo(), PCB_REFERENCE_IMAGE::GetMsgPanelInfo(), SCH_BITMAP::GetWidth(), PCB_REFERENCE_IMAGE::GetWidth(), SCH_IO_KICAD_LEGACY::loadBitmap(), SCH_IO_KICAD_SEXPR_PARSER::parseImage(), SCH_BITMAP::Plot(), SCH_IO_KICAD_LEGACY::saveBitmap(), and SCH_IO_KICAD_SEXPR::saveBitmap().

◆ GetImageScale()

double REFERENCE_IMAGE::GetImageScale ( ) const

Returns: the image "zoom" value. scale = 1.0 = original size of bitmap. scale < 1.0 = the bitmap is drawn smaller than its original size. scale > 1.0 = the bitmap is drawn bigger than its original size.

Definition at line 194 of file reference_image.cpp.

References m_bitmapBase.

Referenced by BOOST_DATA_TEST_CASE_F(), KIGFX::PCB_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), PCB_IO_KICAD_SEXPR::format(), SCH_BITMAP::GetImageScale(), PCB_REFERENCE_IMAGE::GetImageScale(), SCH_BITMAP::GetMsgPanelInfo(), PCB_REFERENCE_IMAGE::GetMsgPanelInfo(), SCH_IO_KICAD_LEGACY::loadBitmap(), SCH_IO_KICAD_SEXPR_PARSER::parseImage(), PCB_IO_KICAD_SEXPR_PARSER::parsePCB_REFERENCE_IMAGE(), SCH_IO_KICAD_LEGACY::saveBitmap(), SCH_IO_KICAD_SEXPR::saveBitmap(), BITMAP_POINT_EDIT_BEHAVIOR::UpdateItem(), and REFERENCE_IMAGE_POINT_EDIT_BEHAVIOR::UpdateItem().

◆ GetPosition()

VECTOR2I REFERENCE_IMAGE::GetPosition ( ) const

Definition at line 139 of file reference_image.cpp.

References m_pos.

Referenced by PCB_GRID_HELPER::AddConstructionItems(), KIGFX::PCB_PAINTER::draw(), SCH_BITMAP::GetPosition(), PCB_REFERENCE_IMAGE::GetPosition(), BITMAP_POINT_EDIT_BEHAVIOR::MakePoints(), REFERENCE_IMAGE_POINT_EDIT_BEHAVIOR::MakePoints(), SCH_IO_KICAD_SEXPR::saveBitmap(), BITMAP_POINT_EDIT_BEHAVIOR::UpdateItem(), REFERENCE_IMAGE_POINT_EDIT_BEHAVIOR::UpdateItem(), BITMAP_POINT_EDIT_BEHAVIOR::UpdatePoints(), and REFERENCE_IMAGE_POINT_EDIT_BEHAVIOR::UpdatePoints().

◆ GetSize()

VECTOR2I REFERENCE_IMAGE::GetSize ( ) const

Definition at line 168 of file reference_image.cpp.

References m_bitmapBase.

Referenced by KIGFX::PCB_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), SCH_BITMAP::GetMsgPanelInfo(), PCB_REFERENCE_IMAGE::GetMsgPanelInfo(), BITMAP_POINT_EDIT_BEHAVIOR::MakePoints(), REFERENCE_IMAGE_POINT_EDIT_BEHAVIOR::MakePoints(), PCB_IO_EASYEDAPRO_PARSER::ParseBoard(), SCH_IO_ALTIUM::ParseImage(), SCH_EASYEDAPRO_PARSER::ParseSchematic(), SCH_EASYEDA_PARSER::ParseSchematic(), BITMAP_POINT_EDIT_BEHAVIOR::UpdateItem(), REFERENCE_IMAGE_POINT_EDIT_BEHAVIOR::UpdateItem(), BITMAP_POINT_EDIT_BEHAVIOR::UpdatePoints(), and REFERENCE_IMAGE_POINT_EDIT_BEHAVIOR::UpdatePoints().

◆ GetTransformOriginOffset()

VECTOR2I REFERENCE_IMAGE::GetTransformOriginOffset ( ) const

Get the center of scaling, etc, relative to the image center (GetPosition()).

Definition at line 156 of file reference_image.cpp.

References m_transformOriginOffset.

Referenced by PCB_GRID_HELPER::AddConstructionItems(), PCB_GRID_HELPER::computeAnchors(), SCH_BITMAP::GetTransformOriginOffsetX(), PCB_REFERENCE_IMAGE::GetTransformOriginOffsetX(), SCH_BITMAP::GetTransformOriginOffsetY(), PCB_REFERENCE_IMAGE::GetTransformOriginOffsetY(), BITMAP_POINT_EDIT_BEHAVIOR::MakePoints(), REFERENCE_IMAGE_POINT_EDIT_BEHAVIOR::MakePoints(), SCH_BITMAP::SetTransformOriginOffsetX(), PCB_REFERENCE_IMAGE::SetTransformOriginOffsetX(), SCH_BITMAP::SetTransformOriginOffsetY(), PCB_REFERENCE_IMAGE::SetTransformOriginOffsetY(), BITMAP_POINT_EDIT_BEHAVIOR::UpdateItem(), REFERENCE_IMAGE_POINT_EDIT_BEHAVIOR::UpdateItem(), BITMAP_POINT_EDIT_BEHAVIOR::UpdatePoints(), and REFERENCE_IMAGE_POINT_EDIT_BEHAVIOR::UpdatePoints().

◆ HitTest()

bool REFERENCE_IMAGE::HitTest	(	const BOX2I &	aRect,
		bool	aContained,
		int	aAccuracy
	)		const

◆ MutableImage()

BITMAP_BASE & REFERENCE_IMAGE::MutableImage ( ) const

Only use this if you really need to modify the underlying image.

Definition at line 310 of file reference_image.cpp.

References m_bitmapBase.

Referenced by DIALOG_REFERENCE_IMAGE_PROPERTIES::DIALOG_REFERENCE_IMAGE_PROPERTIES(), PCB_IO_EASYEDAPRO_PARSER::ParseBoard(), DIALOG_IMAGE_PROPERTIES::TransferDataFromWindow(), and DIALOG_REFERENCE_IMAGE_PROPERTIES::TransferDataFromWindow().

◆ operator=()

REFERENCE_IMAGE & REFERENCE_IMAGE::operator= ( const REFERENCE_IMAGE & aOther )

Definition at line 61 of file reference_image.cpp.

References EDA_IU_SCALE::IU_PER_MILS, m_bitmapBase, m_iuScale, m_pos, m_transformOriginOffset, and updatePixelSizeInIU().

◆ operator==()

bool REFERENCE_IMAGE::operator== ( const REFERENCE_IMAGE & aOther ) const

Definition at line 80 of file reference_image.cpp.

References m_bitmapBase, m_pos, and m_transformOriginOffset.

◆ ReadImageFile() [1/2]

bool REFERENCE_IMAGE::ReadImageFile ( const wxString & aFullFilename )

Read and store an image file.

Initialize the bitmap used to draw this item format.

Parameters

aFullFilename is the full filename of the image file to read.

Returns: true if success reading else false.

Definition at line 267 of file reference_image.cpp.

References m_bitmapBase, and updatePixelSizeInIU().

Referenced by SCH_IO_KICAD_LEGACY::loadBitmap(), PCB_IO_EASYEDAPRO_PARSER::ParseBoard(), SCH_IO_KICAD_SEXPR_PARSER::parseImage(), SCH_IO_ALTIUM::ParseImage(), PCB_IO_KICAD_SEXPR_PARSER::parsePCB_REFERENCE_IMAGE(), SCH_EASYEDAPRO_PARSER::ParseSchematic(), and SCH_EASYEDA_PARSER::ParseSchematic().

◆ ReadImageFile() [2/2]

bool REFERENCE_IMAGE::ReadImageFile ( wxMemoryBuffer & aBuf )

Read and store an image file.

Initialize the bitmap used to draw this item format.

Parameters

aBuf	is the memory buffer containing the image file to read.

Returns: true if success reading else false.

Definition at line 279 of file reference_image.cpp.

References m_bitmapBase, and updatePixelSizeInIU().

◆ Rotate()

void REFERENCE_IMAGE::Rotate	(	const VECTOR2I &	aCenter,
		const EDA_ANGLE &	aAngle
	)

Definition at line 253 of file reference_image.cpp.

References EDA_ANGLE::AsDegrees(), DEGREES_T, m_bitmapBase, m_pos, EDA_ANGLE::Normalize(), and RotatePoint().

Referenced by SCH_BITMAP::Rotate(), and PCB_REFERENCE_IMAGE::Rotate().

◆ scaleBy()

void REFERENCE_IMAGE::scaleBy ( double ratio )

private

Definition at line 210 of file reference_image.cpp.

References BOX2< VECTOR2D >::ByCenter(), IsBOX2Safe(), IsVec2SafeXY(), KiROUND(), m_bitmapBase, m_pos, m_transformOriginOffset, and SetTransformOriginOffset().

Referenced by SetHeight(), SetImageScale(), and SetWidth().

◆ SetHeight()

void REFERENCE_IMAGE::SetHeight ( int aHeight )

Definition at line 184 of file reference_image.cpp.

References m_bitmapBase, and scaleBy().

Referenced by SCH_BITMAP::SetHeight(), and PCB_REFERENCE_IMAGE::SetHeight().

◆ SetImage()

bool REFERENCE_IMAGE::SetImage ( const wxImage & aImage )

Set the image from an existing wxImage.

Definition at line 291 of file reference_image.cpp.

References m_bitmapBase, and updatePixelSizeInIU().

◆ SetImageScale()

void REFERENCE_IMAGE::SetImageScale ( double aScale )

Set the image "zoom" value.

The image is scaled such that the position of the image's transform origin is unchanged.

If the scale is negative or the image would overflow the the coordinate system, nothing is updated.

Definition at line 200 of file reference_image.cpp.

References m_bitmapBase, and scaleBy().

Referenced by SCH_IO_KICAD_LEGACY::loadBitmap(), PCB_IO_EASYEDAPRO_PARSER::ParseBoard(), SCH_IO_KICAD_SEXPR_PARSER::parseImage(), SCH_IO_ALTIUM::ParseImage(), PCB_IO_KICAD_SEXPR_PARSER::parsePCB_REFERENCE_IMAGE(), SCH_EASYEDAPRO_PARSER::ParseSchematic(), SCH_EASYEDA_PARSER::ParseSchematic(), SCH_BITMAP::SetImageScale(), PCB_REFERENCE_IMAGE::SetImageScale(), BITMAP_POINT_EDIT_BEHAVIOR::UpdateItem(), and REFERENCE_IMAGE_POINT_EDIT_BEHAVIOR::UpdateItem().

◆ SetPosition()

void REFERENCE_IMAGE::SetPosition ( const VECTOR2I & aPos )

Definition at line 145 of file reference_image.cpp.

References BOX2< VECTOR2D >::ByCenter(), IsBOX2Safe(), m_bitmapBase, and m_pos.

Referenced by PCB_REFERENCE_IMAGE::PCB_REFERENCE_IMAGE(), SCH_BITMAP::SCH_BITMAP(), SCH_BITMAP::SetPosition(), and PCB_REFERENCE_IMAGE::SetPosition().

◆ SetTransformOriginOffset()

void REFERENCE_IMAGE::SetTransformOriginOffset ( const VECTOR2I & aCenter )

Definition at line 162 of file reference_image.cpp.

References m_transformOriginOffset.

Referenced by scaleBy(), SCH_BITMAP::SetTransformOriginOffsetX(), PCB_REFERENCE_IMAGE::SetTransformOriginOffsetX(), SCH_BITMAP::SetTransformOriginOffsetY(), PCB_REFERENCE_IMAGE::SetTransformOriginOffsetY(), BITMAP_POINT_EDIT_BEHAVIOR::UpdateItem(), and REFERENCE_IMAGE_POINT_EDIT_BEHAVIOR::UpdateItem().

◆ SetWidth()

void REFERENCE_IMAGE::SetWidth ( int aWidth )

Definition at line 174 of file reference_image.cpp.

References m_bitmapBase, and scaleBy().

Referenced by SCH_BITMAP::SetWidth(), and PCB_REFERENCE_IMAGE::SetWidth().

◆ Similarity()

double REFERENCE_IMAGE::Similarity ( const REFERENCE_IMAGE & aOther ) const

Definition at line 107 of file reference_image.cpp.

References m_bitmapBase, and m_pos.

Referenced by PCB_REFERENCE_IMAGE::Similarity(), and SCH_BITMAP::Similarity().

◆ SwapData()

void REFERENCE_IMAGE::SwapData ( REFERENCE_IMAGE & aItem )

Definition at line 316 of file reference_image.cpp.

References m_bitmapBase, m_pos, and m_transformOriginOffset.

Referenced by PCB_REFERENCE_IMAGE::swapData(), and SCH_BITMAP::swapData().

◆ updatePixelSizeInIU()

void REFERENCE_IMAGE::updatePixelSizeInIU ( )

private

Definition at line 54 of file reference_image.cpp.

References m_bitmapBase, m_iuScale, and EDA_IU_SCALE::MilsToIU().

Referenced by operator=(), ReadImageFile(), REFERENCE_IMAGE(), and SetImage().

Member Data Documentation

◆ m_bitmapBase

std::unique_ptr<BITMAP_BASE> REFERENCE_IMAGE::m_bitmapBase

private

Definition at line 148 of file reference_image.h.

Referenced by Flip(), GetBoundingBox(), GetImage(), GetImageScale(), GetSize(), MutableImage(), operator=(), operator==(), ReadImageFile(), Rotate(), scaleBy(), SetHeight(), SetImage(), SetImageScale(), SetPosition(), SetWidth(), Similarity(), SwapData(), and updatePixelSizeInIU().

◆ m_iuScale

const EDA_IU_SCALE& REFERENCE_IMAGE::m_iuScale

private

Definition at line 141 of file reference_image.h.

Referenced by operator=(), and updatePixelSizeInIU().

◆ m_pos

VECTOR2I REFERENCE_IMAGE::m_pos

private

XY coordinates of center of the bitmap.

Definition at line 143 of file reference_image.h.

Referenced by Flip(), GetBoundingBox(), GetPosition(), operator=(), operator==(), Rotate(), scaleBy(), SetPosition(), Similarity(), and SwapData().

◆ m_transformOriginOffset

VECTOR2I REFERENCE_IMAGE::m_transformOriginOffset

private

Center of scaling, etc, relative to the image center.

Definition at line 146 of file reference_image.h.

Referenced by GetTransformOriginOffset(), operator=(), operator==(), scaleBy(), SetTransformOriginOffset(), and SwapData().

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

REFERENCE_IMAGE
Generated on Tue Aug 12 2025 00:07:38 for KiCad PCB EDA Suite by 1.9.6