A mix-in class (via multiple inheritance) that handles texts such as labels, parts, components, or footprints. More...

#include <eda_text.h>

Inheritance diagram for EDA_TEXT:

Classes
struct	BBOX_CACHE_ENTRY

Public Member Functions
	EDA_TEXT (const EDA_IU_SCALE &aIuScale, const wxString &aText=wxEmptyString)

	EDA_TEXT (const EDA_TEXT &aText)

virtual	~EDA_TEXT ()

EDA_TEXT &	operator= (const EDA_TEXT &aItem)

void	Serialize (google::protobuf::Any &aContainer) const override
	Serializes this object to the given Any message.

bool	Deserialize (const google::protobuf::Any &aContainer) override
	Deserializes the given protobuf message into this object.

void	Serialize (google::protobuf::Any &aContainer, const EDA_IU_SCALE &aScale) const

bool	Deserialize (const google::protobuf::Any &aContainer, const EDA_IU_SCALE &aScale)

void	Serialize (kiapi::common::types::Text &aOutput, const EDA_IU_SCALE &aScale) const

bool	Deserialize (const kiapi::common::types::Text &aInput, const EDA_IU_SCALE &aScale)

virtual const wxString &	GetText () const
	Return the string associated with the text object.

virtual wxString	GetShownText (RESOLUTION_CONTEXT aContext, int aDepth=0) const
	Return the string actually shown after processing of the base text.

bool	HasTextVars () const
	Indicates the ShownText has text var references which need to be processed.

const std::vector< TEXT_VAR_REF_KEY > &	GetTextVarReferences () const
	Return the set of `${...}` references extracted from the source text.

virtual void	SetText (const wxString &aText)

wxString	EvaluateText (const wxString &aText) const

virtual void	SetTextThickness (int aWidth)
	The TextThickness is that set by the user.

virtual int	GetTextThickness () const

int	GetTextThicknessProperty () const

void	SetAutoThickness (bool aAuto)

bool	GetAutoThickness () const

int	GetEffectiveTextPenWidth (int aDefaultPenWidth=0) const
	The EffectiveTextPenWidth uses the text thickness if > 1 or aDefaultPenWidth.

virtual void	SetTextAngle (const EDA_ANGLE &aAngle)

virtual EDA_ANGLE	GetTextAngle () const

void	SetTextAngleDegrees (double aOrientation)

double	GetTextAngleDegrees () const

void	SetItalic (bool aItalic)
	Set the text to be italic - this will also update the font if needed.

void	SetItalicFlag (bool aItalic)
	Set only the italic flag, without changing the font.

bool	IsItalic () const

void	SetBold (bool aBold)
	Set the text to be bold - this will also update the font if needed.

void	SetBoldFlag (bool aBold)
	Set only the bold flag, without changing the font.

bool	IsBold () const

void	MigrateLegacyBoldStrokeWidth ()
	Migrate a pre-v11 bold stroke text so its stored thickness holds the base (non-bold) width.

virtual void	SetVisible (bool aVisible)

virtual bool	IsVisible () const

void	SetMirrored (bool isMirrored)

bool	IsMirrored () const

void	SetMultilineAllowed (bool aAllow)

bool	IsMultilineAllowed () const

void	SetHorizJustify (GR_TEXT_H_ALIGN_T aType)

GR_TEXT_H_ALIGN_T	GetHorizJustify () const

void	SetVertJustify (GR_TEXT_V_ALIGN_T aType)

GR_TEXT_V_ALIGN_T	GetVertJustify () const

void	SetKeepUpright (bool aKeepUpright)

bool	IsKeepUpright () const

void	FlipHJustify ()

void	SetAttributes (const EDA_TEXT &aSrc, bool aSetPosition=true)
	Set the text attributes from another instance.

void	SwapAttributes (EDA_TEXT &aTradingPartner)
	Swap the text attributes of the two involved instances.

void	SwapText (EDA_TEXT &aTradingPartner)

void	CopyText (const EDA_TEXT &aSrc)

void	SetAttributes (const TEXT_ATTRIBUTES &aTextAttrs)

const TEXT_ATTRIBUTES &	GetAttributes () const

bool	Replace (const EDA_SEARCH_DATA &aSearchData)
	Helper function used in search and replace dialog.

bool	IsDefaultFormatting () const

void	SetFont (KIFONT::FONT *aFont)

KIFONT::FONT *	GetFont () const

void	SetUnresolvedFontName (const wxString &aFontName)

wxString	GetUnresolvedFontName () const

bool	ResolveFont (const std::vector< wxString > *aEmbeddedFonts)

wxString	GetFontName () const

void	SetFontProp (const wxString &aFontName)

wxString	GetFontProp () const

void	SetLineSpacing (double aLineSpacing)

double	GetLineSpacing () const

virtual void	SetTextSize (VECTOR2I aNewSize, bool aEnforceMinTextSize=true)

virtual VECTOR2I	GetTextSize () const

virtual void	SetTextWidth (int aWidth)

virtual int	GetTextWidth () const

virtual void	SetTextHeight (int aHeight)

virtual int	GetTextHeight () const

void	SetTextColor (const COLOR4D &aColor)

COLOR4D	GetTextColor () const

virtual void	SetTextPos (const VECTOR2I &aPoint)

virtual VECTOR2I	GetTextPos () const

virtual void	SetTextX (int aX)

virtual void	SetTextY (int aY)

void	SetActiveUrl (const wxString &aUrl) const

virtual void	Offset (const VECTOR2I &aOffset)

void	Empty ()

void	Print (const RENDER_SETTINGS *aSettings, const VECTOR2I &aOffset, const COLOR4D &aColor)
	Print this text object to the device context aDC.

std::shared_ptr< SHAPE_COMPOUND >	GetEffectiveTextShape (bool aTriangulate=true, const BOX2I &aBBox=BOX2I(), const EDA_ANGLE &aAngle=ANGLE_0) const
	build a list of segments (SHAPE_SEGMENT) to describe a text shape.

virtual bool	TextHitTest (const VECTOR2I &aPoint, int aAccuracy=0) const
	Test if aPoint is within the bounds of this object.

virtual bool	TextHitTest (const BOX2I &aRect, bool aContains, int aAccuracy=0) const
	Test if object bounding box is contained within or intersects aRect.

BOX2I	GetTextBox (const RENDER_SETTINGS *aSettings, int aLine=-1) const
	Useful in multiline texts to calculate the full text or a line area (for zones filling, locate functions....)

int	GetInterline (const RENDER_SETTINGS *aSettings) const
	Return the distance between two lines of text.

wxString	GetTextStyleName () const

void	GetLinePositions (const RENDER_SETTINGS *aSettings, std::vector< VECTOR2I > &aPositions, int aLineCount) const
	Populate aPositions with the position of each line of a multiline text, according to the vertical justification and the rotation of the whole text.

double	Levenshtein (const EDA_TEXT &aOther) const
	Return the levenstein distance between two texts.

double	Similarity (const EDA_TEXT &aOther) const

virtual void	Format (OUTPUTFORMATTER *aFormatter, int aControlBits) const
	Output the object to aFormatter in s-expression form.

virtual EDA_ANGLE	GetDrawRotation () const

virtual VECTOR2I	GetDrawPos () const

virtual KIFONT::FONT *	GetDrawFont (const RENDER_SETTINGS *aSettings) const

virtual void	ClearRenderCache ()

virtual void	ClearBoundingBoxCache ()

std::vector< std::unique_ptr< KIFONT::GLYPH > > *	GetRenderCache (const KIFONT::FONT *aFont, const wxString &forResolvedText, const VECTOR2I &aOffset={ 0, 0 }) const

void	SetupRenderCache (const wxString &aResolvedText, const KIFONT::FONT *aFont, const EDA_ANGLE &aAngle, const VECTOR2I &aOffset)

void	AddRenderCacheGlyph (const SHAPE_POLY_SET &aPoly)

int	Compare (const EDA_TEXT *aOther) const

bool	operator== (const EDA_TEXT &aRhs) const

bool	operator< (const EDA_TEXT &aRhs) const

bool	operator> (const EDA_TEXT &aRhs) const

virtual bool	HasHyperlink () const

wxString	GetHyperlink () const

void	SetHyperlink (wxString aLink)

void	RemoveHyperlink ()

Static Public Member Functions
static GR_TEXT_H_ALIGN_T	MapHorizJustify (int aHorizJustify)

static GR_TEXT_V_ALIGN_T	MapVertJustify (int aVertJustify)

static bool	ValidateHyperlink (const wxString &aURL)
	Check if aURL is a valid hyperlink.

static bool	IsGotoPageHref (const wxString &aHref, wxString *aDestination=nullptr)
	Check if aHref is a valid internal hyperlink.

static wxString	GotoPageHref (const wxString &aDestination)
	Generate a href to a page in the current schematic.

Protected Member Functions
virtual const KIFONT::METRICS &	getFontMetrics () const

virtual void	cacheShownText ()

void	printOneLineOfText (const RENDER_SETTINGS *aSettings, const VECTOR2I &aOffset, const COLOR4D &aColor, const wxString &aText, const VECTOR2I &aPos)
	Print each line of this EDA_TEXT.

bool	containsURL () const

bool	isStrokeFont () const
	Return true if this text is (or, while a font resolution is still pending, is named as) a stroke font, as opposed to an outline font.

Protected Attributes
wxString	m_hyperlink
	A hyperlink URL.

wxString	m_activeUrl

Private Attributes
wxString	m_text

wxString	m_shown_text

bool	m_shown_text_has_text_var_refs = false

std::vector< TEXT_VAR_REF_KEY >	m_text_var_refs

std::reference_wrapper< const EDA_IU_SCALE >	m_IuScale

std::unique_ptr< EDA_TEXT_RENDER_CACHE_DATA >	m_render_cache

std::map< int, BBOX_CACHE_ENTRY >	m_bbox_cache

std::mutex	m_bbox_cacheMutex

TEXT_ATTRIBUTES	m_attributes

wxString	m_unresolvedFontName

VECTOR2I	m_pos

bool	m_visible

Detailed Description

A mix-in class (via multiple inheritance) that handles texts such as labels, parts, components, or footprints.

Because it's a mix-in class, care is used to provide function names (accessors) that to not collide with function names likely to be seen in the combined derived classes.

Definition at line 93 of file eda_text.h.

Constructor & Destructor Documentation

◆ EDA_TEXT() [1/2]

EDA_TEXT::EDA_TEXT	(	const EDA_IU_SCALE &	aIuScale,
		const wxString &	aText = wxEmptyString )

◆ EDA_TEXT() [2/2]

EDA_TEXT::EDA_TEXT ( const EDA_TEXT & aText )

Definition at line 110 of file eda_text.cpp.

References EDA_TEXT(), m_attributes, m_bbox_cache, m_bbox_cacheMutex, m_IuScale, m_pos, m_render_cache, m_shown_text, m_shown_text_has_text_var_refs, m_text, m_text_var_refs, m_unresolvedFontName, and m_visible.

◆ ~EDA_TEXT()

EDA_TEXT::~EDA_TEXT ( )

virtual

Definition at line 133 of file eda_text.cpp.

Member Function Documentation

◆ AddRenderCacheGlyph()

void EDA_TEXT::AddRenderCacheGlyph ( const SHAPE_POLY_SET & aPoly )

Definition at line 720 of file eda_text.cpp.

References KIFONT::OUTLINE_GLYPH::CacheTriangulation(), and m_render_cache.

◆ cacheShownText()

void EDA_TEXT::cacheShownText ( )

protectedvirtual

Reimplemented in SCH_LABEL_BASE.

Definition at line 587 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), ExtractTextVarReferences(), m_shown_text, m_shown_text_has_text_var_refs, m_text, m_text_var_refs, and UnescapeString().

Referenced by SCH_LABEL_BASE::cacheShownText(), CopyText(), EDA_TEXT(), Empty(), Replace(), SetText(), and SwapText().

◆ ClearBoundingBoxCache()

void EDA_TEXT::ClearBoundingBoxCache ( )

virtual

◆ ClearRenderCache()

void EDA_TEXT::ClearRenderCache ( )

virtual

◆ Compare()

int EDA_TEXT::Compare ( const EDA_TEXT * aOther ) const

Definition at line 1205 of file eda_text.cpp.

References EDA_TEXT(), GetFontName(), GetTextPos(), m_attributes, m_text, VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by operator<(), operator==(), and operator>().

◆ containsURL()

bool EDA_TEXT::containsURL ( ) const

protected

Definition at line 992 of file eda_text.cpp.

References FOR_GUI, GetShownText(), MARKUP::MARKUP_PARSER::Parse(), recursiveDescent(), and TO_UTF8.

Referenced by SCH_TEXT::HasHypertext(), and SCH_TEXTBOX::HasHypertext().

◆ CopyText()

void EDA_TEXT::CopyText ( const EDA_TEXT & aSrc )

Definition at line 238 of file eda_text.cpp.

References cacheShownText(), EDA_TEXT(), and m_text.

◆ Deserialize() [1/3]

bool EDA_TEXT::Deserialize ( const google::protobuf::Any & aContainer )

overridevirtual

Deserializes the given protobuf message into this object.

Parameters

aContainer is an Any which should have a concrete type matching this object

Returns: true if unpacking and deserialization succeeded

Reimplemented from SERIALIZABLE.

Reimplemented in PCB_DIM_ALIGNED, PCB_DIM_CENTER, PCB_DIM_LEADER, PCB_DIM_ORTHOGONAL, PCB_DIM_RADIAL, PCB_DIMENSION_BASE, PCB_FIELD, PCB_TABLECELL, PCB_TEXT, PCB_TEXTBOX, SCH_DIRECTIVE_LABEL, SCH_FIELD, SCH_GLOBALLABEL, SCH_HIERLABEL, SCH_LABEL, SCH_SHEET_PIN, SCH_TABLECELL, SCH_TEXT, and SCH_TEXTBOX.

Definition at line 195 of file eda_text.cpp.

References Deserialize(), and pcbIUScale.

Referenced by Deserialize(), Deserialize(), PCB_DIMENSION_BASE::Deserialize(), PCB_TEXT::Deserialize(), SCH_FIELD::Deserialize(), SCH_SHEET_PIN::Deserialize(), and SCH_TEXT::Deserialize().

◆ Deserialize() [2/3]

bool EDA_TEXT::Deserialize	(	const google::protobuf::Any &	aContainer,
		const EDA_IU_SCALE &	aScale )

Definition at line 220 of file eda_text.cpp.

References Deserialize(), and text.

◆ Deserialize() [3/3]

bool EDA_TEXT::Deserialize	(	const kiapi::common::types::Text &	aInput,
		const EDA_IU_SCALE &	aScale )

Definition at line 201 of file eda_text.cpp.

References GetAttributes(), SetAttributes(), SetHyperlink(), SetText(), SetTextPos(), text, kiapi::common::UnpackTextAttributes(), and kiapi::common::UnpackVector2().

◆ Empty()

void EDA_TEXT::Empty ( )

Definition at line 580 of file eda_text.cpp.

References cacheShownText(), and m_text.

Referenced by SCH_IO_KICAD_LEGACY_LIB_CACHE::LoadPart().

◆ EvaluateText()

wxString EDA_TEXT::EvaluateText ( const wxString & aText ) const

Definition at line 619 of file eda_text.cpp.

References EXPRESSION_EVALUATOR::Evaluate().

◆ FlipHJustify()

void EDA_TEXT::FlipHJustify ( )

inline

Definition at line 247 of file eda_text.h.

References GetHorizJustify(), GR_TEXT_H_ALIGN_LEFT, GR_TEXT_H_ALIGN_RIGHT, and SetHorizJustify().

Referenced by AdjustTextForSymbolOrientation(), SCH_TEXT::MirrorHorizontally(), SCH_TEXT::MirrorSpinStyle(), SCH_TEXT::MirrorVertically(), SCH_TEXT::Rotate90(), and SimulateRenderTransform().

◆ Format()

void EDA_TEXT::Format	(	OUTPUTFORMATTER *	aFormatter,
		int	aControlBits ) const

virtual

Output the object to aFormatter in s-expression form.

Parameters

aFormatter	The OUTPUTFORMATTER object to write to.
aControlBits	The control bit definition for object specific formatting.

Exceptions

IO_ERROR on write error.

Definition at line 1063 of file eda_text.cpp.

References CTL_OMIT_COLOR, CTL_OMIT_HYPERLINK, KICAD_FORMAT::FormatBool(), FormatDouble2Str(), EDA_UNIT_UTILS::FormatInternalUnits(), GetAutoThickness(), GetFont(), GetHorizJustify(), GetHyperlink(), GetLineSpacing(), GetTextColor(), GetTextHeight(), GetTextThickness(), GetTextWidth(), GetVertJustify(), GR_TEXT_H_ALIGN_CENTER, GR_TEXT_H_ALIGN_LEFT, GR_TEXT_V_ALIGN_CENTER, GR_TEXT_V_ALIGN_TOP, HasHyperlink(), IsBold(), IsItalic(), IsMirrored(), KiROUND(), m_IuScale, OUTPUTFORMATTER::Print(), OUTPUTFORMATTER::Quotew(), and COLOR4D::UNSPECIFIED.

Referenced by SCH_IO_KICAD_SEXPR::saveField(), and SCH_IO_KICAD_SEXPR_LIB_CACHE::saveField().

◆ GetAttributes()

const TEXT_ATTRIBUTES & EDA_TEXT::GetAttributes ( ) const

inline

Definition at line 270 of file eda_text.h.

References m_attributes.

Referenced by FEATURES_MANAGER::AddText(), BOARD_ADAPTER::addText(), PCB_IO_IPC2581::addText(), LIB_SYMBOL::Compare(), SCH_FIELD::compare(), MULTICHANNEL_TOOL::copyRuleAreaContents(), Deserialize(), PCB_TEXTBOX::Deserialize(), SCH_TEXTBOX::Deserialize(), KIGFX::DS_PAINTER::draw(), KIGFX::PCB_PAINTER::draw(), KIGFX::PCB_PAINTER::draw(), KIGFX::PCB_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), DS_DRAW_ITEM_TEXT::GetApproxBBox(), GetEffectiveTextShape(), PCB_TEXT::GetKnockoutCache(), GetRenderCache(), SIM_MODEL::MigrateSimModel(), std::hash< EDA_TEXT >::operator()(), SCH_FIELD::Plot(), SCH_LABEL_BASE::Plot(), SCH_TEXT::Plot(), SCH_TEXTBOX::Plot(), BRDITEMS_PLOTTER::PlotText(), CLIPBOARD_IO::SaveSelection(), Serialize(), PCB_TEXTBOX::Serialize(), SCH_TEXTBOX::Serialize(), PCB_TEXT::TransformTextToPolySet(), and PCB_TEXTBOX::TransformTextToPolySet().

◆ GetAutoThickness()

bool EDA_TEXT::GetAutoThickness ( ) const

inline

Definition at line 170 of file eda_text.h.

References GetTextThickness().

Referenced by EDA_TEXT_DESC::EDA_TEXT_DESC(), Format(), PCB_IO_KICAD_SEXPR::format(), GetTextThicknessProperty(), IsDefaultFormatting(), PCB_IO_KICAD_SEXPR_PARSER::parsePCB_TEXT_effects(), and SetAutoThickness().

◆ GetDrawFont()

KIFONT::FONT * EDA_TEXT::GetDrawFont ( const RENDER_SETTINGS * aSettings ) const

virtual

◆ GetDrawPos()

virtual VECTOR2I EDA_TEXT::GetDrawPos ( ) const

inlinevirtual

Reimplemented in PCB_TEXTBOX, and SCH_TEXTBOX.

Definition at line 420 of file eda_text.h.

References GetTextPos().

Referenced by BOARD_ADAPTER::addText(), PCB_IO_IPC2581::addText(), PCB_TEXT::buildBoundingHull(), KIGFX::SCH_PAINTER::draw(), GetEffectiveTextShape(), PCB_TEXT::GetKnockoutCache(), GetLinePositions(), GetRenderCache(), GetTextBox(), SCH_TEXT::Plot(), Print(), TextHitTest(), and PCB_TEXT::TextHitTest().

◆ GetDrawRotation()

virtual EDA_ANGLE EDA_TEXT::GetDrawRotation ( ) const

inlinevirtual

Reimplemented in PCB_TEXT, and SCH_FIELD.

Definition at line 419 of file eda_text.h.

References GetTextAngle().

Referenced by FEATURES_MANAGER::AddText(), BOARD_ADAPTER::addText(), PCB_IO_IPC2581::addText(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), KIGFX::SCH_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), PCB_TABLE::DrawBorders(), PCB_IO_KICAD_SEXPR::formatRenderCache(), PCB_TEXTBOX::GetBotRight(), PCB_TEXTBOX::GetCorners(), PCB_TEXTBOX::GetDrawPos(), PCB_TEXTBOX::getDrawRotation(), PCB_TABLE::GetEffectiveShape(), GetEffectiveTextShape(), GetLinePositions(), PCB_TEXTBOX::GetMinSize(), SCH_TEXT::GetOffsetToMatchSCH_FIELD(), GetRenderCache(), PCB_TABLECELL::GetShownText(), PCB_TEXTBOX::GetShownText(), PCB_TEXTBOX::GetTopLeft(), BRDITEMS_PLOTTER::PlotText(), printOneLineOfText(), PCB_TEXTBOX::SetBottom(), PCB_TEXTBOX::SetLeft(), PCB_TEXTBOX::SetRight(), PCB_TEXTBOX::SetTop(), TextHitTest(), and TextHitTest().

◆ GetEffectiveTextPenWidth()

int EDA_TEXT::GetEffectiveTextPenWidth ( int aDefaultPenWidth = 0 ) const

The EffectiveTextPenWidth uses the text thickness if > 1 or aDefaultPenWidth.

Definition at line 422 of file eda_text.cpp.

References BOLD_STROKE_MULTIPLIER, ClampTextPenSize(), GetPenSizeForBold(), GetPenSizeForNormal(), GetTextSize(), GetTextThickness(), GetTextWidth(), IsBold(), isStrokeFont(), and KiROUND().

Referenced by FEATURES_MANAGER::AddText(), BOARD_ADAPTER::addText(), PCB_IO_IPC2581::addText(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), LABEL_BBOX_FIXTURE::CheckTextBoundingBoxWidth(), KIGFX::DS_PAINTER::draw(), KIGFX::PCB_PAINTER::draw(), KIGFX::PCB_PAINTER::draw(), KIGFX::PCB_PAINTER::draw(), SCH_HIERLABEL::GetBodyBoundingBox(), SCH_LABEL::GetBodyBoundingBox(), SCH_LABEL_BASE::GetBodyBoundingBox(), GetEffectiveTextShape(), PCB_TEXT::getKnockoutMargin(), PCB_TABLECELL::GetMsgPanelInfo(), PCB_TEXT::GetMsgPanelInfo(), PCB_TEXTBOX::GetMsgPanelInfo(), SCH_DIRECTIVE_LABEL::GetPenWidth(), SCH_FIELD::GetPenWidth(), SCH_TEXT::GetPenWidth(), PCB_TABLECELL::GetShownText(), PCB_TEXTBOX::GetShownText(), SCH_TABLECELL::GetShownText(), SCH_TEXTBOX::GetShownText(), GetTextBox(), GetTextThicknessProperty(), ALTIUM_PCB::HelperSetTextAlignmentAndPos(), SCH_FIELD::Plot(), SCH_LABEL_BASE::Plot(), SCH_TEXT::Plot(), SCH_TEXTBOX::Plot(), BRDITEMS_PLOTTER::PlotText(), printOneLineOfText(), PCB_TEXT::TextHitTest(), PCB_TEXT::TransformTextToPolySet(), PCB_TEXTBOX::TransformTextToPolySet(), PCB_DIM_ALIGNED::updateGeometry(), PCB_DIM_LEADER::updateGeometry(), PCB_DIM_ORTHOGONAL::updateGeometry(), PCB_DIM_RADIAL::updateGeometry(), PCB_DIM_ALIGNED::updateText(), and PCB_DIM_ORTHOGONAL::updateText().

◆ GetEffectiveTextShape()

std::shared_ptr< SHAPE_COMPOUND > EDA_TEXT::GetEffectiveTextShape	(	bool	aTriangulate = true,
		const BOX2I &	aBBox = BOX2I(),
		const EDA_ANGLE &	aAngle = ANGLE_0 ) const

build a list of segments (SHAPE_SEGMENT) to describe a text shape.

Parameters

aTriangulate	true to build also the triangulation of each shape
aUseTextRotation	true to use the actual text draw rotation. false to build a list of shape for a not rotated text ("native" shapes).

Definition at line 1125 of file eda_text.cpp.

References SHAPE_SIMPLE::Append(), KIFONT::FONT::Draw(), KIGFX::GAL::DrawGlyphs(), FOR_CANVAS, GetAttributes(), BOX2< Vec >::GetCenter(), GetDrawFont(), GetDrawPos(), GetDrawRotation(), GetEffectiveTextPenWidth(), getFontMetrics(), GetRenderCache(), GetShownText(), GetTextSize(), BOX2< Vec >::GetWidth(), GR_TEXT_H_ALIGN_CENTER, GR_TEXT_V_ALIGN_CENTER, KIFONT::FONT::IsOutline(), TEXT_ATTRIBUTES::m_Angle, TEXT_ATTRIBUTES::m_Halign, TEXT_ATTRIBUTES::m_Size, and TEXT_ATTRIBUTES::m_Valign.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), PCB_DIMENSION_BASE::GetEffectiveShape(), PCB_TEXT::GetEffectiveShape(), PCB_TEXTBOX::GetEffectiveShape(), SCH_SELECTION_TOOL::GuessSelectionCandidates(), and PCB_SELECTION_TOOL::hitTestDistance().

◆ GetFont()

KIFONT::FONT * EDA_TEXT::GetFont ( ) const

inline

Definition at line 286 of file eda_text.h.

References m_attributes.

◆ getFontMetrics()

const KIFONT::METRICS & EDA_TEXT::getFontMetrics ( ) const

protectedvirtual

Reimplemented in DS_DRAW_ITEM_TEXT, PCB_TEXT, PCB_TEXTBOX, SCH_FIELD, SCH_TEXT, and SCH_TEXTBOX.

Definition at line 646 of file eda_text.cpp.

References KIFONT::METRICS::Default().

Referenced by GetEffectiveTextShape(), GetInterline(), GetRenderCache(), GetTextBox(), and printOneLineOfText().

◆ GetFontName()

wxString EDA_TEXT::GetFontName ( ) const

Definition at line 1016 of file eda_text.cpp.

References GetFont(), and KIFONT::FONT::GetName().

Referenced by Compare(), and IsDefaultFormatting().

◆ GetFontProp()

wxString EDA_TEXT::GetFontProp ( ) const

Definition at line 1025 of file eda_text.cpp.

References _, GetFont(), IsEeschemaType(), and KICAD_FONT_NAME.

Referenced by EDA_TEXT_DESC::EDA_TEXT_DESC().

◆ GetHorizJustify()

GR_TEXT_H_ALIGN_T EDA_TEXT::GetHorizJustify ( ) const

inline

Definition at line 239 of file eda_text.h.

References m_attributes.

◆ GetHyperlink()

wxString EDA_TEXT::GetHyperlink ( ) const

inline

Definition at line 443 of file eda_text.h.

References m_hyperlink.

Referenced by SCH_EDIT_TOOL::ChangeTextType(), KIGFX::SCH_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), EDA_TEXT_DESC::EDA_TEXT_DESC(), Format(), SCH_TEXT::Plot(), SCH_TEXTBOX::Plot(), CLIPBOARD_IO::SaveSelection(), and Serialize().

◆ GetInterline()

int EDA_TEXT::GetInterline ( const RENDER_SETTINGS * aSettings ) const

Return the distance between two lines of text.

Calculates the distance (pitch) between two lines of text. This distance includes the interline distance plus room for characters like j, {, and [. It also used for single line text, to calculate the text bounding box.

Definition at line 730 of file eda_text.cpp.

References GetDrawFont(), getFontMetrics(), GetInterline(), GetLineSpacing(), GetTextHeight(), and KiROUND().

Referenced by BOOST_AUTO_TEST_CASE(), CADSTAR_ARCHIVE_PARSER::FixTextPositionNoAlignment(), GetInterline(), GetLinePositions(), and SCH_TEXT::Plot().

◆ GetLinePositions()

void EDA_TEXT::GetLinePositions	(	const RENDER_SETTINGS *	aSettings,
		std::vector< VECTOR2I > &	aPositions,
		int	aLineCount ) const

Populate aPositions with the position of each line of a multiline text, according to the vertical justification and the rotation of the whole text.

Parameters

aPositions	is the list to populate by the VECTOR2I positions.
aLineCount	is the number of lines (not recalculated here for efficiency reasons.

Definition at line 914 of file eda_text.cpp.

References GetDrawPos(), GetDrawRotation(), GetInterline(), GetVertJustify(), GR_TEXT_V_ALIGN_BOTTOM, GR_TEXT_V_ALIGN_CENTER, GR_TEXT_V_ALIGN_INDETERMINATE, GR_TEXT_V_ALIGN_TOP, RotatePoint(), and VECTOR2< T >::y.

Referenced by FEATURES_MANAGER::AddText(), SCH_TEXT::Plot(), SCH_TEXTBOX::Plot(), BRDITEMS_PLOTTER::PlotText(), and Print().

◆ GetLineSpacing()

double EDA_TEXT::GetLineSpacing ( ) const

inline

Definition at line 298 of file eda_text.h.

References m_attributes.

Referenced by BOOST_AUTO_TEST_CASE(), Format(), GetInterline(), GetTextBox(), FOOTPRINT::cmp_drawings::operator()(), and SCH_TEXTBOX::Serialize().

◆ GetRenderCache()

std::vector< std::unique_ptr< KIFONT::GLYPH > > * EDA_TEXT::GetRenderCache	(	const KIFONT::FONT *	aFont,
		const wxString &	forResolvedText,
		const VECTOR2I &	aOffset = { 0, 0 } ) const

◆ GetShownText()

virtual wxString EDA_TEXT::GetShownText	(	RESOLUTION_CONTEXT	aContext,
		int	aDepth = 0 ) const

inlinevirtual

Return the string actually shown after processing of the base text.

Parameters

aContext	controls some features of the expansion, such as whether or not field names are included, or whether or not escaped literal variable references should be prefixed with a '\'.
aDepth	is used to prevent infinite recursions and loops when expanding text variables.

Reimplemented in PCB_FIELD, PCB_TABLECELL, PCB_TEXT, PCB_TEXTBOX, SCH_FIELD, SCH_LABEL_BASE, SCH_TABLECELL, SCH_TEXT, and SCH_TEXTBOX.

Definition at line 128 of file eda_text.h.

References m_shown_text, m_text, and RAW_VALUE.

Referenced by FEATURES_MANAGER::AddText(), BOARD_ADAPTER::addText(), PCB_IO_IPC2581::addText(), SCH_LABEL_BASE::cacheShownText(), LABEL_BBOX_FIXTURE::CheckTextBoundingBoxWidth(), containsURL(), KIGFX::DS_PAINTER::draw(), PCB_IO_KICAD_SEXPR::formatRenderCache(), PCB_IO_IPC2581::generateLayerSetNet(), DS_DRAW_ITEM_TEXT::GetApproxBBox(), GetEffectiveTextShape(), DS_DRAW_ITEM_TEXT::GetItemDescription(), PCB_TABLECELL::GetShownText(), PCB_TEXT::GetShownText(), PCB_TEXTBOX::GetShownText(), SCH_LABEL_BASE::GetShownText(), SCH_TABLECELL::GetShownText(), SCH_TEXT::GetShownText(), SCH_TEXTBOX::GetShownText(), GetTextBox(), SCH_FIELD::getUnescapedText(), BRDITEMS_PLOTTER::PlotText(), Print(), and SCH_LABEL_BASE::SCH_LABEL_BASE().

◆ GetText()

virtual const wxString & EDA_TEXT::GetText ( ) const

inlinevirtual

Return the string associated with the text object.

Returns: a const wxString reference containing the string of the item.

Reimplemented in SCH_FIELD.

Definition at line 118 of file eda_text.h.

References m_text.

◆ GetTextAngle()

virtual EDA_ANGLE EDA_TEXT::GetTextAngle ( ) const

inlinevirtual

Reimplemented in PCB_TEXT, and PCB_TEXTBOX.

Definition at line 178 of file eda_text.h.

References m_attributes.

Referenced by AdjustFieldForSymbolOrientation(), AdjustTextForSymbolOrientation(), SYMBOL_FIELDS_EDITOR_GRID_DATA_MODEL::ApplyData(), CADSTAR_SCH_ARCHIVE_LOADER::applyTextSettings(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), SCH_EDIT_TOOL::ChangeTextType(), SCH_TEXTBOX::compare(), SCH_DRAWING_TOOLS::createNewText(), DIALOG_FIELD_PROPERTIES::DIALOG_FIELD_PROPERTIES(), KIGFX::SCH_PAINTER::draw(), SCH_TABLE::DrawBorders(), EE_GRAPHIC_TOOL::DrawShape(), CADSTAR_ARCHIVE_PARSER::FixTextPositionNoAlignment(), SCH_LABEL::GetBodyBoundingBox(), SCH_FIELD::GetBoundingBox(), SCH_TEXT::GetBoundingBox(), SCH_TEXTBOX::GetDrawPos(), GetDrawRotation(), SCH_FIELD::GetDrawRotation(), SCH_TEXTBOX::GetMinSize(), SCH_TABLECELL::GetShownText(), SCH_TEXTBOX::GetShownText(), SCH_LABEL_BASE::GetSpinStyle(), FIELDS_GRID_TABLE::GetValue(), SCH_SELECTION_TOOL::GuessSelectionCandidates(), SCH_EDIT_TOOL::JustifyText(), SCH_TEXT::MirrorHorizontally(), SCH_TEXTBOX::MirrorHorizontally(), SCH_TEXT::MirrorSpinStyle(), SCH_TEXT::MirrorVertically(), SCH_TEXTBOX::MirrorVertically(), SCH_TABLE::Normalize(), SCH_TEXT::NormalizeJustification(), SCH_FIELD::Plot(), SCH_TEXT::Plot(), SCH_TEXTBOX::Plot(), SCH_SYMBOL::PlotLocalPowerIconShape(), positioningChanged(), positioningChanged(), SCH_EDIT_TOOL::Rotate(), SCH_FIELD::Rotate(), SCH_TEXTBOX::Rotate(), SCH_TEXT::Rotate90(), SCH_TEXTBOX::Rotate90(), SCH_IO_KICAD_LEGACY::saveField(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveField(), SCH_IO_KICAD_SEXPR::saveField(), SCH_IO_KICAD_SEXPR_LIB_CACHE::saveField(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveText(), SCH_IO_KICAD_SEXPR::saveText(), SCH_IO_KICAD_SEXPR_LIB_CACHE::saveText(), SCH_IO_KICAD_SEXPR::saveTextBox(), SCH_IO_KICAD_SEXPR_LIB_CACHE::saveTextBox(), SimulateRenderTransform(), swapFieldPositionsWithMatching(), EASYEDA_PARSER_BASE::TransformTextToBaseline(), DIALOG_FIELD_PROPERTIES::UpdateField(), and DIPTRACE_SCH_IMPORT_FIXTURE::ValueFieldAngleDegrees().

◆ GetTextAngleDegrees()

double EDA_TEXT::GetTextAngleDegrees ( ) const

inline

Definition at line 185 of file eda_text.h.

References m_attributes.

Referenced by EDA_TEXT_DESC::EDA_TEXT_DESC(), PCB_DIMENSION_BASE::GetTextAngleDegreesProp(), and SCH_TEXTBOX::Serialize().

◆ GetTextBox()

BOX2I EDA_TEXT::GetTextBox	(	const RENDER_SETTINGS *	aSettings,
		int	aLine = -1 ) const

Useful in multiline texts to calculate the full text or a line area (for zones filling, locate functions....)

Parameters

aLine The line of text to consider. Pass -1 for all lines.

Returns: the rect containing the line of text (i.e. the position and the size of one line) this rectangle is calculated for 0 orient text. If orientation is not 0 the rect must be rotated to match the physical area

Definition at line 737 of file eda_text.cpp.

References FOR_CANVAS, GetDrawFont(), GetDrawPos(), GetEffectiveTextPenWidth(), getFontMetrics(), BOX2< Vec >::GetHeight(), GetHorizJustify(), KIFONT::FONT::GetInterline(), GetLineSpacing(), GetShownText(), GetTextSize(), GetVertJustify(), BOX2< Vec >::GetWidth(), BOX2< Vec >::GetX(), BOX2< Vec >::GetY(), GR_TEXT_H_ALIGN_CENTER, GR_TEXT_H_ALIGN_INDETERMINATE, GR_TEXT_H_ALIGN_LEFT, GR_TEXT_H_ALIGN_RIGHT, GR_TEXT_V_ALIGN_BOTTOM, GR_TEXT_V_ALIGN_CENTER, GR_TEXT_V_ALIGN_INDETERMINATE, GR_TEXT_V_ALIGN_TOP, IsBold(), IsItalic(), IsMirrored(), IsMultilineAllowed(), KIFONT::FONT::IsStroke(), ITALIC_TILT, KiROUND(), m_bbox_cache, m_bbox_cacheMutex, BOX2< Vec >::Normalize(), BOX2< Vec >::Offset(), BOX2< Vec >::SetOrigin(), BOX2< Vec >::SetSize(), BOX2< Vec >::SetX(), BOX2< Vec >::SetY(), KIFONT::FONT::StringBoundaryLimits(), text, wxStringSplit(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_FIXTURE_TEST_CASE(), LABEL_BBOX_FIXTURE::CheckLabelBodyBoundingBox(), LABEL_BBOX_FIXTURE::CheckTextBoundingBoxWidth(), SCH_GLOBALLABEL::CreateGraphicShape(), KIGFX::PCB_PAINTER::draw(), SCH_HIERLABEL::GetBodyBoundingBox(), SCH_LABEL::GetBodyBoundingBox(), DS_DRAW_ITEM_TEXT::GetBoundingBox(), PCB_DIMENSION_BASE::GetBoundingBox(), PCB_TEXT::GetBoundingBox(), SCH_FIELD::GetBoundingBox(), SCH_TEXT::GetBoundingBox(), PCB_TEXTBOX::GetMinSize(), SCH_TEXTBOX::GetMinSize(), SCH_TEXT::GetOffsetToMatchSCH_FIELD(), ALTIUM_PCB::HelperSetTextAlignmentAndPos(), SCH_TEXT::NormalizeJustification(), TextHitTest(), TextHitTest(), PCB_TEXT::TextHitTest(), PCB_DIM_ALIGNED::updateGeometry(), PCB_DIM_LEADER::updateGeometry(), PCB_DIM_ORTHOGONAL::updateGeometry(), and PCB_DIM_RADIAL::updateGeometry().

◆ GetTextColor()

COLOR4D EDA_TEXT::GetTextColor ( ) const

inline

◆ GetTextHeight()

virtual int EDA_TEXT::GetTextHeight ( ) const

inlinevirtual

Definition at line 307 of file eda_text.h.

References GetTextSize(), and VECTOR2< T >::y.

◆ GetTextPos()

virtual VECTOR2I EDA_TEXT::GetTextPos ( ) const

inlinevirtual

Reimplemented in PCB_TEXT.

Definition at line 313 of file eda_text.h.

References m_pos.

Referenced by FEATURES_MANAGER::AddText(), SCH_LABEL_BASE::AutoplaceFields(), Compare(), SCH_FIELD::compare(), SCH_TEXT::compare(), SCH_SHEET_PIN::ConstrainOnEdge(), DIALOG_FIELD_PROPERTIES::DIALOG_FIELD_PROPERTIES(), SCH_GLOBALLABEL::doIsConnected(), SCH_HIERLABEL::doIsConnected(), SCH_LABEL::doIsConnected(), KIGFX::DS_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), PCB_TEXT::Flip(), DS_DRAW_ITEM_TEXT::GetApproxBBox(), SCH_HIERLABEL::GetBodyBoundingBox(), SCH_LABEL::GetBodyBoundingBox(), SCH_LABEL_BASE::GetBodyBoundingBox(), SCH_FIELD::GetBoundingBox(), SCH_TEXT::GetBoundingBox(), SCH_MOVE_TOOL::getConnectedDragItems(), SCH_LABEL_BASE::GetConnectionPoints(), GetDrawPos(), SCH_LABEL_BASE::GetEndPoints(), SCH_SHEET_PIN::GetEndPoints(), SCH_FIELD::GetLibPosition(), DS_DRAW_ITEM_TEXT::GetPosition(), SCH_FIELD::GetPosition(), SCH_TEXT::GetPosition(), PCB_TEXT::GetTextPos(), FIELDS_GRID_TABLE::GetValue(), PCB_DIMENSION_BASE::Mirror(), SCH_DIRECTIVE_LABEL::MirrorHorizontally(), SCH_FIELD::MirrorHorizontally(), SCH_SHEET_PIN::MirrorHorizontally(), SCH_TEXT::MirrorHorizontally(), SCH_DIRECTIVE_LABEL::MirrorVertically(), SCH_FIELD::MirrorVertically(), SCH_SHEET_PIN::MirrorVertically(), SCH_TEXT::MirrorVertically(), SCH_TEXT::NormalizeJustification(), PCB_TEXT::Offset(), std::hash< EDA_TEXT >::operator()(), SCH_FIELD::Plot(), SCH_LABEL_BASE::Plot(), BRDITEMS_PLOTTER::PlotText(), DIALOG_CHANGE_SYMBOLS::processSymbols(), SCH_LABEL_BASE::Rotate(), SCH_SHEET_PIN::Rotate(), SCH_TEXT::Rotate(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveField(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveText(), Serialize(), PCB_TEXT::SetLibTextPos(), SCH_LABEL_BASE::SetPosition(), SetTextPos(), SetTextX(), SetTextY(), FIELDS_GRID_TABLE::SetValue(), LIB_SYMBOL::SyncFieldsFromParent(), EASYEDA_PARSER_BASE::TransformTextToBaseline(), and SCH_LABEL_BASE::UpdateDanglingState().

◆ GetTextSize()

virtual VECTOR2I EDA_TEXT::GetTextSize ( ) const

inlinevirtual

Reimplemented in PCB_TEXT, and PCB_TEXTBOX.

Definition at line 301 of file eda_text.h.

References m_attributes.

Referenced by ORCAD_CONVERTER::applyMultilineSpacing(), SCH_SHEET::AutoplaceFields(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), SCH_EDIT_TOOL::ChangeTextType(), LABEL_BBOX_FIXTURE::CheckTextBoundingBoxWidth(), LIB_SYMBOL::Compare(), PCB_IO_KICAD_SEXPR::format(), GetEffectiveTextPenWidth(), GetEffectiveTextShape(), SCH_LABEL_BASE::GetLabelBoxExpansion(), SCH_TEXTBOX::GetLegacyTextMargin(), SCH_TEXT::GetOffsetToMatchSCH_FIELD(), GetRenderCache(), CADSTAR_SCH_ARCHIVE_LOADER::getScaledLibPart(), SCH_TABLECELL::GetShownText(), SCH_TEXTBOX::GetShownText(), GetTextBox(), GetTextHeight(), SCH_TEXT::GetTextOffset(), PCB_TEXT::GetTextSize(), PCB_TEXTBOX::GetTextSize(), GetTextWidth(), ORCAD_CONVERTER::placeOffpageConnectors(), ORCAD_CONVERTER::placeSymbolFields(), SCH_FIELD::Plot(), BRDITEMS_PLOTTER::PlotText(), printOneLineOfText(), SCH_IO_KICAD_LEGACY::saveSheet(), SCH_TEXTBOX::Serialize(), and EASYEDA_PARSER_BASE::TransformTextToBaseline().

◆ GetTextStyleName()

wxString EDA_TEXT::GetTextStyleName ( ) const

Returns: a wxString with the style name( Normal, Italic, Bold, Bold+Italic).

Definition at line 1000 of file eda_text.cpp.

References _, IsBold(), and IsItalic().

Referenced by SCH_FIELD::GetMsgPanelInfo().

◆ GetTextThickness()

virtual int EDA_TEXT::GetTextThickness ( ) const

inlinevirtual

◆ GetTextThicknessProperty()

int EDA_TEXT::GetTextThicknessProperty ( ) const

inline

Definition at line 161 of file eda_text.h.

References GetAutoThickness(), GetEffectiveTextPenWidth(), and GetTextThickness().

Referenced by EDA_TEXT_DESC::EDA_TEXT_DESC().

◆ GetTextVarReferences()

const std::vector< TEXT_VAR_REF_KEY > & EDA_TEXT::GetTextVarReferences ( ) const

Return the set of ${...} references extracted from the source text.

The result is cached lazily and invalidated on SetText/CopyText/Replace. Consumers (the reactive dependency tracker) may call this at high frequency on items that rarely change; the cache avoids repeat lexing.

Definition at line 613 of file eda_text.cpp.

References m_text_var_refs.

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

◆ GetTextWidth()

virtual int EDA_TEXT::GetTextWidth ( ) const

inlinevirtual

Definition at line 304 of file eda_text.h.

References GetTextSize(), and VECTOR2< T >::x.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), SCH_TEXT::compare(), SCH_TEXTBOX::compare(), DIALOG_FIELD_PROPERTIES::DIALOG_FIELD_PROPERTIES(), EDA_TEXT_DESC::EDA_TEXT_DESC(), Format(), GetEffectiveTextPenWidth(), PCB_TEXT::getKnockoutMargin(), PCB_DIMENSION_BASE::GetMsgPanelInfo(), PCB_TABLECELL::GetMsgPanelInfo(), PCB_TEXT::GetMsgPanelInfo(), PCB_TEXTBOX::GetMsgPanelInfo(), SCH_FIELD::GetMsgPanelInfo(), SCH_LABEL_BASE::GetMsgPanelInfo(), SCH_TABLECELL::GetMsgPanelInfo(), SCH_TEXT::GetMsgPanelInfo(), SCH_TEXTBOX::GetMsgPanelInfo(), SCH_HIERLABEL::GetSchematicTextOffset(), SCH_FIELD::GetSchTextSize(), SCH_TEXT::GetSchTextSize(), SCH_TEXTBOX::GetSchTextSize(), PCB_FIELDS_GRID_TABLE::GetValue(), hash_fp_item(), ALTIUM_PCB::HelperSetTextAlignmentAndPos(), ALTIUM_PCB::HelperSetTextboxAlignmentAndPos(), CADSTAR_SCH_ARCHIVE_LOADER::loadDocumentationSymbols(), SCH_IO_KICAD_LEGACY::saveField(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveField(), SCH_IO_KICAD_LEGACY::saveText(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveText(), SetAutoThickness(), PCB_DIM_ALIGNED::updateGeometry(), PCB_DIM_LEADER::updateGeometry(), PCB_DIM_ORTHOGONAL::updateGeometry(), PCB_DIM_RADIAL::updateGeometry(), DIALOG_FIELD_PROPERTIES::updateText(), and DIALOG_FOOTPRINT_PROPERTIES_FP_EDITOR::Validate().

◆ GetUnresolvedFontName()

wxString EDA_TEXT::GetUnresolvedFontName ( ) const

inline

Definition at line 289 of file eda_text.h.

References m_unresolvedFontName.

◆ GetVertJustify()

GR_TEXT_V_ALIGN_T EDA_TEXT::GetVertJustify ( ) const

inline

Definition at line 242 of file eda_text.h.

References m_attributes.

Referenced by AdjustTextForSymbolOrientation(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), SCH_DRAWING_TOOLS::createNewText(), DIALOG_FIELD_PROPERTIES::DIALOG_FIELD_PROPERTIES(), EE_GRAPHIC_TOOL::DrawShape(), EDA_TEXT_DESC::EDA_TEXT_DESC(), Format(), PCB_TEXTBOX::GetDrawPos(), SCH_TEXTBOX::GetDrawPos(), SCH_FIELD::GetEffectiveVertJustify(), GetLinePositions(), SCH_FIELD::GetMsgPanelInfo(), SCH_TEXT::GetMsgPanelInfo(), GetTextBox(), hash_fp_item(), ALTIUM_PCB::HelperSetTextAlignmentAndPos(), IsDefaultFormatting(), SCH_FIELD::IsVertJustifyFlipped(), PCB_TEXT::KeepUpright(), SCH_EDIT_TOOL::Mirror(), SYMBOL_EDITOR_EDIT_TOOL::Mirror(), SCH_TEXT::MirrorHorizontally(), SCH_TEXT::MirrorVertically(), SCH_TEXT::NormalizeJustification(), PCB_IO_EAGLE::orientFPText(), SCH_EASYEDA_PARSER::ParseSchematic(), SCH_FIELD::Plot(), positioningChanged(), positioningChanged(), printOneLineOfText(), processTextItem(), SCH_IO_KICAD_LEGACY::saveField(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveField(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveText(), SCH_TEXTBOX::Serialize(), SimulateRenderTransform(), SCH_EDIT_TOOL::Swap(), and swapFieldPositionsWithMatching().

◆ GotoPageHref()

wxString EDA_TEXT::GotoPageHref ( const wxString & aDestination )

static

Generate a href to a page in the current schematic.

Parameters

aDestination Destination sheet's page number.

Returns: A hyperlink href string that goes to the specified page.

Definition at line 1309 of file eda_text.cpp.

Referenced by SCH_LABEL_BASE::Plot(), and SCH_SHEET::Plot().

◆ HasHyperlink()

virtual bool EDA_TEXT::HasHyperlink ( ) const

inlinevirtual

Definition at line 442 of file eda_text.h.

References m_hyperlink.

Referenced by SCH_TEXT::DoHypertextAction(), SCH_TEXTBOX::DoHypertextAction(), KIGFX::SCH_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), Format(), SCH_TEXT::HasHypertext(), SCH_TEXTBOX::HasHypertext(), SCH_TEXT::Plot(), and SCH_TEXTBOX::Plot().

◆ HasTextVars()

bool EDA_TEXT::HasTextVars ( ) const

inline

Indicates the ShownText has text var references which need to be processed.

Definition at line 139 of file eda_text.h.

References m_shown_text_has_text_var_refs.

Referenced by BACK_ANNOTATE::applyChangelist(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), SCH_LABEL_BASE::cacheShownText(), KIGFX::SCH_PAINTER::draw(), PCB_FIELD::GetShownText(), PCB_TABLECELL::GetShownText(), PCB_TEXT::GetShownText(), PCB_TEXTBOX::GetShownText(), SCH_FIELD::GetShownText(), SCH_LABEL_BASE::GetShownText(), SCH_TABLECELL::GetShownText(), SCH_TEXT::GetShownText(), SCH_TEXTBOX::GetShownText(), SCH_LABEL_BASE::HasCachedDriverName(), SCH_GLOBALLABEL::ResolveTextVar(), and SCH_LABEL_BASE::SCH_LABEL_BASE().

◆ IsBold()

bool EDA_TEXT::IsBold ( ) const

inline

Definition at line 215 of file eda_text.h.

References m_attributes.

◆ IsDefaultFormatting()

bool EDA_TEXT::IsDefaultFormatting ( ) const

Definition at line 1056 of file eda_text.cpp.

References GetAutoThickness(), GetFontName(), GetHorizJustify(), GetVertJustify(), GR_TEXT_H_ALIGN_CENTER, GR_TEXT_V_ALIGN_CENTER, IsBold(), IsItalic(), IsMirrored(), and IsMultilineAllowed().

Referenced by SCH_IO_KICAD_SEXPR::saveField().

◆ IsGotoPageHref()

bool EDA_TEXT::IsGotoPageHref	(	const wxString &	aHref,
		wxString *	aDestination = nullptr )

static

Check if aHref is a valid internal hyperlink.

Parameters

aHref	String to validate
aDestination	[optional] pointer to populate with the destination page

Returns: true if aHref is a valid internal hyperlink. Does not check if the destination page actually exists.

Definition at line 1303 of file eda_text.cpp.

Referenced by PDF_PLOTTER::endPlotEmitResources(), SCH_NAVIGATE_TOOL::HypertextCommand(), and ValidateHyperlink().

◆ IsItalic()

bool EDA_TEXT::IsItalic ( ) const

inline

Definition at line 200 of file eda_text.h.

References m_attributes.

Referenced by BOARD_ADAPTER::addText(), SCH_DIRECTIVE_LABEL::AutoplaceFields(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), SCH_EDIT_TOOL::ChangeTextType(), LABEL_BBOX_FIXTURE::CheckTextBoundingBoxWidth(), SCH_TEXTBOX::compare(), SCH_DRAWING_TOOLS::createNewLabel(), SCH_DRAWING_TOOLS::createNewText(), DIALOG_FIELD_PROPERTIES::DIALOG_FIELD_PROPERTIES(), KIGFX::DS_PAINTER::draw(), EE_GRAPHIC_TOOL::DrawShape(), EDA_TEXT_DESC::EDA_TEXT_DESC(), Format(), GetDrawFont(), SCH_FIELD::GetDrawFont(), SCH_TEXT::GetDrawFont(), SCH_TEXTBOX::GetDrawFont(), KIGFX::SCH_PAINTER::getFont(), SCH_LABEL_BASE::GetMsgPanelInfo(), SCH_TABLECELL::GetMsgPanelInfo(), SCH_TEXT::GetMsgPanelInfo(), SCH_TEXTBOX::GetMsgPanelInfo(), PCB_TABLECELL::GetShownText(), PCB_TEXTBOX::GetShownText(), SCH_TABLECELL::GetShownText(), SCH_TEXTBOX::GetShownText(), GetTextBox(), GetTextStyleName(), FIELDS_GRID_TABLE::GetValue(), FIELDS_GRID_TABLE::GetValueAsBool(), PCB_FIELDS_GRID_TABLE::GetValueAsBool(), hash_fp_item(), IsDefaultFormatting(), FOOTPRINT::cmp_drawings::operator()(), printOneLineOfText(), ResolveFont(), SCH_IO_KICAD_LEGACY::saveField(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveField(), SCH_IO_KICAD_LEGACY::saveText(), SCH_IO_KICAD_LEGACY_LIB_CACHE::saveText(), SCH_TEXTBOX::Serialize(), SetBold(), SetFontProp(), and FIELDS_GRID_TABLE::SetValue().

◆ IsKeepUpright()

bool EDA_TEXT::IsKeepUpright ( ) const

inline

Definition at line 245 of file eda_text.h.

References m_attributes.

Referenced by PCB_IO_KICAD_SEXPR::format(), PCB_TEXT::GetDrawRotation(), PCB_FIELDS_GRID_TABLE::GetValueAsBool(), PCB_TEXT::KeepUpright(), PCB_TEXT_DESC::PCB_TEXT_DESC(), processTextItem(), and SCH_TEXTBOX::Serialize().

◆ IsMirrored()

bool EDA_TEXT::IsMirrored ( ) const

inline

◆ IsMultilineAllowed()

bool EDA_TEXT::IsMultilineAllowed ( ) const

inline

Definition at line 236 of file eda_text.h.

References m_attributes.

Referenced by FEATURES_MANAGER::AddText(), GetTextBox(), IsDefaultFormatting(), BRDITEMS_PLOTTER::PlotText(), Print(), and SCH_TEXTBOX::Serialize().

◆ isStrokeFont()

bool EDA_TEXT::isStrokeFont ( ) const

protected

Return true if this text is (or, while a font resolution is still pending, is named as) a stroke font, as opposed to an outline font.

Definition at line 271 of file eda_text.cpp.

References GetFont(), KIFONT::FONT::IsStroke(), and m_unresolvedFontName.

Referenced by GetEffectiveTextPenWidth(), MigrateLegacyBoldStrokeWidth(), SetBold(), and SetItalic().

◆ IsVisible()

virtual bool EDA_TEXT::IsVisible ( ) const

inlinevirtual

Definition at line 226 of file eda_text.h.

References m_visible.

◆ Levenshtein()

double EDA_TEXT::Levenshtein ( const EDA_TEXT & aOther ) const

Return the levenstein distance between two texts.

Return a value of 0.0 - 1.0 where 1.0 is a perfect match.

Definition at line 1242 of file eda_text.cpp.

References distance(), EDA_TEXT(), and GetText().

Referenced by Similarity().

◆ MapHorizJustify()

GR_TEXT_H_ALIGN_T EDA_TEXT::MapHorizJustify ( int aHorizJustify )

static

Definition at line 70 of file eda_text.cpp.

References GR_TEXT_H_ALIGN_LEFT, and GR_TEXT_H_ALIGN_RIGHT.

Referenced by DIALOG_GLOBAL_EDIT_TEXT_AND_GRAPHICS::processItem(), SCH_FIELD::SetEffectiveHorizJustify(), FIELDS_GRID_TABLE::SetValue(), DIALOG_FIELD_PROPERTIES::UpdateField(), and DIALOG_FIELD_PROPERTIES::UpdateField().

◆ MapVertJustify()

GR_TEXT_V_ALIGN_T EDA_TEXT::MapVertJustify ( int aVertJustify )

static

Definition at line 84 of file eda_text.cpp.

References GR_TEXT_V_ALIGN_BOTTOM, and GR_TEXT_V_ALIGN_TOP.

Referenced by DIALOG_GLOBAL_EDIT_TEXT_AND_GRAPHICS::processItem(), SCH_FIELD::SetEffectiveVertJustify(), FIELDS_GRID_TABLE::SetValue(), DIALOG_FIELD_PROPERTIES::UpdateField(), and DIALOG_FIELD_PROPERTIES::UpdateField().

◆ MigrateLegacyBoldStrokeWidth()

void EDA_TEXT::MigrateLegacyBoldStrokeWidth ( )

Migrate a pre-v11 bold stroke text so its stored thickness holds the base (non-bold) width.

Older files baked the bolded pen size into the stroke width; Bold is now a render-time multiplier, so divide it back out. No-op for auto width, non-bold text, or outline fonts (where thickness is not the weight mechanism).

Definition at line 327 of file eda_text.cpp.

References BOLD_STROKE_MULTIPLIER, GetTextThickness(), IsBold(), isStrokeFont(), KiROUND(), and SetTextThickness().

Referenced by CADSTAR_PCB_ARCHIVE_LOADER::applyTextCode(), BOOST_AUTO_TEST_CASE(), ALTIUM_PCB::ConvertTexts6ToEdaTextSettings(), PCB_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), and SCH_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT().

◆ Offset()

void EDA_TEXT::Offset ( const VECTOR2I & aOffset )

virtual

◆ operator<()

bool EDA_TEXT::operator< ( const EDA_TEXT & aRhs ) const

inline

Definition at line 439 of file eda_text.h.

References Compare(), and EDA_TEXT().

◆ operator=()

EDA_TEXT & EDA_TEXT::operator= ( const EDA_TEXT & aItem )

Definition at line 138 of file eda_text.cpp.

References EDA_TEXT(), m_attributes, m_bbox_cache, m_bbox_cacheMutex, m_pos, m_render_cache, m_shown_text, m_shown_text_has_text_var_refs, m_text, m_text_var_refs, m_unresolvedFontName, and m_visible.

Referenced by PCB_TEXT::operator=(), SCH_FIELD::operator=(), and SCH_FIELD::SCH_FIELD().

◆ operator==()

bool EDA_TEXT::operator== ( const EDA_TEXT & aRhs ) const

inline

Definition at line 438 of file eda_text.h.

References Compare(), and EDA_TEXT().

Referenced by SCH_FIELD::HasSameContent(), PCB_DIMENSION_BASE::operator==(), PCB_FIELD::operator==(), PCB_TEXT::operator==(), PCB_TEXTBOX::operator==(), SCH_FIELD::operator==(), SCH_TEXT::operator==(), and SCH_TEXTBOX::operator==().

◆ operator>()

bool EDA_TEXT::operator> ( const EDA_TEXT & aRhs ) const

inline

Definition at line 440 of file eda_text.h.

References Compare(), and EDA_TEXT().

◆ Print()

void EDA_TEXT::Print	(	const RENDER_SETTINGS *	aSettings,
		const VECTOR2I &	aOffset,
		const COLOR4D &	aColor )

Print this text object to the device context aDC.

Parameters

aDC	the current Device Context.
aOffset	draw offset (usually (0,0)).
aColor	text color.

Definition at line 892 of file eda_text.cpp.

References FOR_CANVAS, GetDrawPos(), GetLinePositions(), GetShownText(), IsMultilineAllowed(), printOneLineOfText(), and wxStringSplit().

Referenced by DS_DRAW_ITEM_TEXT::PrintWsItem().

◆ printOneLineOfText()

void EDA_TEXT::printOneLineOfText	(	const RENDER_SETTINGS *	aSettings,
		const VECTOR2I &	aOffset,
		const COLOR4D &	aColor,
		const wxString &	aText,
		const VECTOR2I &	aPos )

protected

Print each line of this EDA_TEXT.

Parameters

aOffset	draw offset (usually (0,0)).
aColor	text color.
aText	the single line of text to draw.
aPos	the position of this line ).

Definition at line 959 of file eda_text.cpp.

References KIGFX::RENDER_SETTINGS::GetDefaultPenWidth(), GetDrawFont(), GetDrawRotation(), GetEffectiveTextPenWidth(), getFontMetrics(), GetHorizJustify(), KIGFX::RENDER_SETTINGS::GetPrintDC(), GetTextSize(), GetVertJustify(), GRPrintText(), IsBold(), IsItalic(), IsMirrored(), and VECTOR2< T >::x.

Referenced by Print().

◆ RemoveHyperlink()

void EDA_TEXT::RemoveHyperlink ( )

inline

Definition at line 445 of file eda_text.h.

References m_hyperlink.

◆ Replace()

bool EDA_TEXT::Replace ( const EDA_SEARCH_DATA & aSearchData )

Helper function used in search and replace dialog.

Perform a text replace using the find and replace criteria in aSearchData.

Parameters

aSearchData A reference to a EDA_SEARCH_DATA object containing the search and replace criteria.

Returns: True if the text item was modified, otherwise false.

Definition at line 445 of file eda_text.cpp.

References cacheShownText(), ClearBoundingBoxCache(), ClearRenderCache(), m_text, and EDA_ITEM::Replace().

Referenced by SCH_FIELD::Replace(), SCH_LABEL_BASE::Replace(), SCH_SHEET_PIN::Replace(), SCH_TEXT::Replace(), and SCH_TEXTBOX::Replace().

◆ ResolveFont()

bool EDA_TEXT::ResolveFont ( const std::vector< wxString > * aEmbeddedFonts )

Definition at line 466 of file eda_text.cpp.

References ClearBoundingBoxCache(), KIFONT::FONT::GetFont(), IsBold(), IsItalic(), m_attributes, m_render_cache, and m_unresolvedFontName.

Referenced by BOOST_AUTO_TEST_CASE().

◆ Serialize() [1/3]

void EDA_TEXT::Serialize ( google::protobuf::Any & aContainer ) const

overridevirtual

Serializes this object to the given Any message.

The Any message's concrete type will be specific to the object in question.

Parameters

aContainer will be filled with a message describing this object

Reimplemented from SERIALIZABLE.

Reimplemented in PCB_DIM_ALIGNED, PCB_DIM_CENTER, PCB_DIM_LEADER, PCB_DIM_ORTHOGONAL, PCB_DIM_RADIAL, PCB_DIMENSION_BASE, PCB_FIELD, PCB_TABLECELL, PCB_TEXT, PCB_TEXTBOX, SCH_DIRECTIVE_LABEL, SCH_FIELD, SCH_GLOBALLABEL, SCH_HIERLABEL, SCH_LABEL, SCH_SHEET_PIN, SCH_TABLECELL, SCH_TEXT, and SCH_TEXTBOX.

Definition at line 165 of file eda_text.cpp.

References pcbIUScale, and Serialize().

Referenced by Serialize(), Serialize(), PCB_DIMENSION_BASE::Serialize(), PCB_TEXT::Serialize(), SCH_FIELD::Serialize(), SCH_GLOBALLABEL::Serialize(), SCH_SHEET_PIN::Serialize(), and SCH_TEXT::Serialize().

◆ Serialize() [2/3]

void EDA_TEXT::Serialize	(	google::protobuf::Any &	aContainer,
		const EDA_IU_SCALE &	aScale ) const

Definition at line 187 of file eda_text.cpp.

References Serialize(), and text.

◆ Serialize() [3/3]

void EDA_TEXT::Serialize	(	kiapi::common::types::Text &	aOutput,
		const EDA_IU_SCALE &	aScale ) const

Definition at line 171 of file eda_text.cpp.

References GetAttributes(), GetHyperlink(), GetText(), GetTextPos(), kiapi::common::PackTextAttributes(), kiapi::common::PackVector2(), and text.

◆ SetActiveUrl()

void EDA_TEXT::SetActiveUrl ( const wxString & aUrl ) const

inline

Definition at line 318 of file eda_text.h.

References m_activeUrl.

Referenced by KIGFX::SCH_PAINTER::draw(), and KIGFX::SCH_PAINTER::draw().

◆ SetAttributes() [1/2]

void EDA_TEXT::SetAttributes	(	const EDA_TEXT &	aSrc,
		bool	aSetPosition = true )

Set the text attributes from another instance.

Definition at line 389 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), EDA_TEXT(), m_attributes, and m_pos.

Referenced by SCH_EDIT_TOOL::ChangeTextType(), MULTICHANNEL_TOOL::copyRuleAreaContents(), Deserialize(), PCB_TEXTBOX::Deserialize(), SCH_TEXTBOX::Deserialize(), SCH_FIELD::ImportValues(), SCH_IO_EAGLE::loadLibrary(), SCH_IO_EAGLE::loadSymbol(), SIM_MODEL::MigrateSimModel(), DIALOG_LABEL_PROPERTIES::OnAddField(), DIALOG_CHANGE_SYMBOLS::processSymbols(), processTextItem(), CLIPBOARD_IO::SaveSelection(), and LIB_SYMBOL::SyncFieldsFromParent().

◆ SetAttributes() [2/2]

void EDA_TEXT::SetAttributes ( const TEXT_ATTRIBUTES & aTextAttrs )

inline

Definition at line 269 of file eda_text.h.

References m_attributes.

◆ SetAutoThickness()

void EDA_TEXT::SetAutoThickness ( bool aAuto )

Definition at line 253 of file eda_text.cpp.

References GetAutoThickness(), GetPenSizeForNormal(), GetTextWidth(), and SetTextThickness().

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

◆ SetBold()

void EDA_TEXT::SetBold ( bool aBold )

Set the text to be bold - this will also update the font if needed.

This is the properties system interface.

Definition at line 305 of file eda_text.cpp.

References GetFont(), KIFONT::FONT::GetFont(), IsItalic(), isStrokeFont(), m_attributes, SetBoldFlag(), and SetFont().

Referenced by SCH_IO_ALTIUM::AddTextBox(), ORCAD_CONVERTER::applyFont(), CADSTAR_PCB_ARCHIVE_LOADER::applyTextCode(), CADSTAR_SCH_ARCHIVE_LOADER::applyTextCodeIfExists(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), SCH_EDIT_TOOL::ChangeTextType(), SCH_DRAWING_TOOLS::createNewLabel(), SCH_DRAWING_TOOLS::createNewText(), DS_DRAW_ITEM_TEXT::DS_DRAW_ITEM_TEXT(), EDA_TEXT_DESC::EDA_TEXT_DESC(), CADSTAR_SCH_ARCHIVE_LOADER::loadNets(), SCH_IO_EAGLE::loadTextAttributes(), SCH_IO_ALTIUM::ParseLabel(), FIELDS_GRID_TABLE::SetValue(), FIELDS_GRID_TABLE::SetValueAsBool(), SCH_DRAWING_TOOLS::TwoClickPlace(), and DIALOG_FIELD_PROPERTIES::updateText().

◆ SetBoldFlag()

void EDA_TEXT::SetBoldFlag ( bool aBold )

Set only the bold flag, without changing the font.

Used when bulk-changing text attributes (e.g. from a dialog or import).

Definition at line 319 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), and m_attributes.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), ALTIUM_PCB::ConvertTexts6ToEdaTextSettings(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadField(), SCH_IO_KICAD_LEGACY::loadSymbol(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadText(), PCB_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SCH_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SetBold(), and DIALOG_DIMENSION_PROPERTIES::updateDimensionFromDialog().

◆ SetFont()

void EDA_TEXT::SetFont ( KIFONT::FONT * aFont )

Definition at line 458 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), and m_attributes.

Referenced by ORCAD_CONVERTER::applyFont(), CADSTAR_PCB_ARCHIVE_LOADER::applyTextCode(), 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(), SCH_EDIT_TOOL::ChangeTextType(), ALTIUM_PCB::ConvertTexts6ToEdaTextSettings(), DS_DRAW_ITEM_TEXT::DS_DRAW_ITEM_TEXT(), PCB_IO_EASYEDAPRO_PARSER::ParseBoard(), PCB_IO_EASYEDAPRO_V3_PARSER::ParseBoard(), SCH_EASYEDA_PARSER::ParseSchematic(), SCH_EASYEDAPRO_V3_PARSER::ParseSymbol(), SCH_EASYEDA_PARSER::ParseSymbolShapes(), ORCAD_CONVERTER::placePageFrame(), SetBold(), SetFontProp(), SetItalic(), FIELDS_GRID_TABLE::SetValue(), DIALOG_DIMENSION_PROPERTIES::updateDimensionFromDialog(), and DIALOG_FIELD_PROPERTIES::updateText().

◆ SetFontProp()

void EDA_TEXT::SetFontProp ( const wxString & aFontName )

Definition at line 1037 of file eda_text.cpp.

References _, KIFONT::FONT::GetFont(), IsBold(), IsEeschemaType(), IsItalic(), KICAD_FONT_NAME, and SetFont().

Referenced by EDA_TEXT_DESC::EDA_TEXT_DESC().

◆ SetHorizJustify()

void EDA_TEXT::SetHorizJustify ( GR_TEXT_H_ALIGN_T aType )

Definition at line 365 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), and m_attributes.

Referenced by CADSTAR_PCB_ARCHIVE_LOADER::addAttribute(), SCH_IO_ALTIUM::AddLibTextBox(), SCH_IO_ALTIUM::AddTextBox(), AdjustFieldForSymbolOrientation(), PADS_SCH::PADS_SCH_SCHEMATIC_BUILDER::ApplyFieldSettings(), CADSTAR_SCH_ARCHIVE_LOADER::applyTextSettings(), SCH_SHEET::AutoplaceFields(), FOOTPRINT::AutoPositionFields(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), Build_Board_Stackup_Table(), SCH_IO_ALTIUM::CreateAliases(), SCH_DRAWING_TOOLS::createNewText(), PANEL_EESCHEMA_COLOR_SETTINGS::createPreviewItems(), createSchText(), CADSTAR_PCB_ARCHIVE_LOADER::drawCadstarText(), EaglePcbTextToKiCadAlignment(), eagleToKicadAlignment(), EDA_TEXT_DESC::EDA_TEXT_DESC(), FlipHJustify(), ALTIUM_PCB::HelperSetTextAlignmentAndPos(), ALTIUM_PCB::HelperSetTextboxAlignmentAndPos(), AUTOPLACER::justifyField(), PCB_TEXT::KeepUpright(), CADSTAR_PCB_ARCHIVE_LOADER::loadDimensions(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadField(), PCB_IO_PADS::loadFootprints(), PCB_IO_PADS_BINARY::loadFootprints(), SCH_IO_EAGLE::loadFrame(), PCB_IO_KICAD_LEGACY::loadMODULE_TEXT(), PCB_IO_KICAD_LEGACY::loadPCB_TEXT(), SCH_IO_PADS::LoadSchematicFile(), SCH_IO_KICAD_LEGACY::loadSymbol(), CADSTAR_SCH_ARCHIVE_LOADER::loadSymdef(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadText(), PCB_TEXT::Mirror(), SCH_EDIT_TOOL::Mirror(), SYMBOL_EDITOR_EDIT_TOOL::Mirror(), SCH_TEXT::MirrorHorizontally(), SCH_TEXTBOX::MirrorHorizontally(), SCH_TEXT::MirrorVertically(), SCH_TEXTBOX::MirrorVertically(), PCB_IO_EAGLE::packageText(), SCH_IO_LTSPICE_PARSER::Parse(), PCB_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SCH_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SCH_IO_ALTIUM::ParsePowerPort(), SCH_EASYEDA_PARSER::ParseSchematic(), SCH_EASYEDAPRO_V3_PARSER::ParseSymbol(), SCH_EASYEDA_PARSER::ParseSymbolShapes(), PCB_TEXTBOX::PCB_TEXTBOX(), ORCAD_CONVERTER::placePageFrame(), ORCAD_CONVERTER::placeSymbolFields(), PCB_DRILL_CHART::RebuildCells(), SCH_FIELD::Rotate(), SCH_TEXTBOX::SCH_TEXTBOX(), SCH_FIELD::SetEffectiveHorizJustify(), SCH_LABEL_BASE::SetSpinStyle(), SCH_IO_LTSPICE_PARSER::setTextJustification(), PCAD2KICAD::SetTextJustify(), FABMASTER::setupText(), FIELDS_GRID_TABLE::SetValue(), SCH_EDIT_TOOL::Swap(), swapFieldPositionsWithMatching(), DIALOG_DIMENSION_PROPERTIES::updateDimensionFromDialog(), DIALOG_FIELD_PROPERTIES::UpdateField(), and DIALOG_FIELD_PROPERTIES::UpdateField().

◆ SetHyperlink()

void EDA_TEXT::SetHyperlink ( wxString aLink )

inline

Definition at line 444 of file eda_text.h.

References m_hyperlink.

Referenced by SCH_EDIT_TOOL::ChangeTextType(), Deserialize(), EDA_TEXT_DESC::EDA_TEXT_DESC(), SCH_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), and CLIPBOARD_IO::SaveSelection().

◆ SetItalic()

void EDA_TEXT::SetItalic ( bool aItalic )

Set the text to be italic - this will also update the font if needed.

This is the properties system interface.

Definition at line 285 of file eda_text.cpp.

References GetFont(), KIFONT::FONT::GetFont(), IsBold(), isStrokeFont(), m_attributes, SetFont(), and SetItalicFlag().

Referenced by SCH_IO_ALTIUM::AddTextBox(), PCAD2KICAD::PCAD_FOOTPRINT::AddToBoard(), PCAD2KICAD::PCAD_TEXT::AddToBoard(), ORCAD_CONVERTER::applyFont(), CADSTAR_PCB_ARCHIVE_LOADER::applyTextCode(), CADSTAR_SCH_ARCHIVE_LOADER::applyTextCodeIfExists(), SCH_EDIT_TOOL::ChangeTextType(), ALTIUM_PCB::ConvertTexts6ToEdaTextSettings(), PCB_BASE_FRAME::CreateNewFootprint(), SCH_DRAWING_TOOLS::createNewLabel(), SCH_DRAWING_TOOLS::createNewText(), DRAWING_TOOL::DrawDimension(), DS_DRAW_ITEM_TEXT::DS_DRAW_ITEM_TEXT(), EDA_TEXT_DESC::EDA_TEXT_DESC(), PCB_IO_KICAD_LEGACY::loadMODULE_TEXT(), PCB_IO_KICAD_LEGACY::loadPCB_TEXT(), DIALOG_FOOTPRINT_PROPERTIES_FP_EDITOR::OnAddField(), DIALOG_LABEL_PROPERTIES::OnAddField(), SCH_IO_ALTIUM::ParseLabel(), FABMASTER::setupText(), FIELDS_GRID_TABLE::SetValue(), FIELDS_GRID_TABLE::SetValueAsBool(), PCB_FIELDS_GRID_TABLE::SetValueAsBool(), PCB_TEXT::StyleFromSettings(), PCB_TEXTBOX::StyleFromSettings(), SCH_DRAWING_TOOLS::TwoClickPlace(), DIALOG_DIMENSION_PROPERTIES::updateDimensionFromDialog(), and DIALOG_FIELD_PROPERTIES::updateText().

◆ SetItalicFlag()

void EDA_TEXT::SetItalicFlag ( bool aItalic )

Set only the italic flag, without changing the font.

Used when bulk-changing text attributes (e.g. from a dialog or import).

Definition at line 297 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), and m_attributes.

Referenced by SCH_IO_KICAD_LEGACY_LIB_CACHE::loadField(), SCH_IO_KICAD_LEGACY::loadSymbol(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadText(), PCB_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SCH_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), and SetItalic().

◆ SetKeepUpright()

void EDA_TEXT::SetKeepUpright ( bool aKeepUpright )

◆ SetLineSpacing()

void EDA_TEXT::SetLineSpacing ( double aLineSpacing )

Definition at line 487 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), and m_attributes.

Referenced by ORCAD_CONVERTER::applyMultilineSpacing(), PCB_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), and SCH_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT().

◆ SetMirrored()

void EDA_TEXT::SetMirrored ( bool isMirrored )

Definition at line 349 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), and m_attributes.

Referenced by CADSTAR_PCB_ARCHIVE_LOADER::addAttribute(), PCAD2KICAD::PCAD_FOOTPRINT::AddToBoard(), PCAD2KICAD::PCAD_TEXT::AddToBoard(), ALTIUM_PCB::ConvertTexts6ToEdaTextSettings(), CADSTAR_PCB_ARCHIVE_LOADER::drawCadstarText(), DRAWING_TOOL::DrawDimension(), EaglePcbTextToKiCadAlignment(), EDA_TEXT_DESC::EDA_TEXT_DESC(), PCB_TEXT::Flip(), PCB_TEXTBOX::Flip(), PCB_IO_KICAD_LEGACY::loadMODULE_TEXT(), PCB_IO_KICAD_LEGACY::loadPCB_TEXT(), PCB_DIMENSION_BASE::Mirror(), PCB_IO_EAGLE::packageText(), PCB_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), PCB_TABLECELL::PCB_TABLECELL(), FABMASTER::setupText(), PCB_FIELDS_GRID_TABLE::SetValueAsBool(), PCB_FIELDS_GRID_TABLE::SetValueAsLong(), PCB_TEXT::StyleFromSettings(), PCB_TEXTBOX::StyleFromSettings(), and DIALOG_DIMENSION_PROPERTIES::updateDimensionFromDialog().

◆ SetMultilineAllowed()

void EDA_TEXT::SetMultilineAllowed ( bool aAllow )

Parameters

aAllow true if ok to use multiline option, false if ok to use only single line text. (Single line is faster in calculations than multiline.)

Definition at line 357 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), and m_attributes.

Referenced by BOOST_AUTO_TEST_CASE(), SCH_IO_LTSPICE_PARSER::CreateSCH_TEXT(), CADSTAR_SCH_ARCHIVE_LOADER::loadSymdef(), SCH_IO_LTSPICE_PARSER::Parse(), PCB_TEXT::PCB_TEXT(), PCB_TEXTBOX::PCB_TEXTBOX(), ORCAD_CONVERTER::placeGraphics(), SCH_LABEL_BASE::SCH_LABEL_BASE(), SCH_LABEL_BASE::SCH_LABEL_BASE(), SCH_TEXT::SCH_TEXT(), and SCH_TEXTBOX::SCH_TEXTBOX().

◆ SetText()

void EDA_TEXT::SetText ( const wxString & aText )

virtual

Reimplemented in SCH_FIELD.

Definition at line 231 of file eda_text.cpp.

References cacheShownText(), and m_text.

◆ SetTextAngle()

void EDA_TEXT::SetTextAngle ( const EDA_ANGLE & aAngle )

virtual

Reimplemented in PCB_TEXT, and PCB_TEXTBOX.

Definition at line 263 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), and m_attributes.

Referenced by AdjustFieldForSymbolOrientation(), SYMBOL_FIELDS_EDITOR_GRID_DATA_MODEL::ApplyData(), CADSTAR_SCH_ARCHIVE_LOADER::applyTextSettings(), SCH_SHEET::AutoplaceFields(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), SCH_DRAWING_TOOLS::createNewText(), EaglePcbTextToKiCadAlignment(), eagleToKicadAlignment(), PCB_TEXT::Flip(), PCB_TEXTBOX::Flip(), ALTIUM_PCB::HelperSetTextAlignmentAndPos(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadField(), SCH_IO_KICAD_LEGACY::loadSymbol(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadText(), PCB_TEXTBOX::Mirror(), DIALOG_SHEET_PROPERTIES::OnAddField(), DIALOG_SYMBOL_PROPERTIES::OnAddField(), PCB_TEXTBOX::OnFootprintTransformed(), SCH_IO_ALTIUM::ParsePowerPort(), SCH_IO_KICAD_SEXPR_PARSER::parseSchTextBoxContent(), ORCAD_CONVERTER::placeHierarchicalBlockFields(), ORCAD_CONVERTER::placePowerSymbol(), ORCAD_CONVERTER::placeSymbolFields(), SCH_TEXTBOX::Plot(), PCB_TEXTBOX::Rotate(), SCH_EDIT_TOOL::Rotate(), SCH_FIELD::Rotate(), SCH_TEXTBOX::Rotate(), SCH_TEXT::Rotate90(), SCH_TEXTBOX::Rotate90(), SCH_LABEL_BASE::SetSpinStyle(), PCB_TEXT::SetTextAngle(), SetTextAngleDegrees(), SCH_IO_LTSPICE_PARSER::setTextJustification(), FIELDS_GRID_TABLE::SetValue(), swapFieldPositionsWithMatching(), and DIALOG_FIELD_PROPERTIES::updateText().

◆ SetTextAngleDegrees()

void EDA_TEXT::SetTextAngleDegrees ( double aOrientation )

inline

Definition at line 181 of file eda_text.h.

References DEGREES_T, and SetTextAngle().

Referenced by PADS_SCH::PADS_SCH_SCHEMATIC_BUILDER::ApplyFieldSettings(), PCB_DIMENSION_BASE::ChangeTextAngleDegrees(), PADS_SCH::PADS_SCH_SCHEMATIC_BUILDER::CreateCustomFields(), createSchText(), PADS_SCH::PADS_SCH_SYMBOL_BUILDER::createSymbolText(), EDA_TEXT_DESC::EDA_TEXT_DESC(), PCB_IO_EASYEDAPRO_PARSER::ParseBoard(), PCB_IO_EASYEDAPRO_V3_PARSER::ParseBoard(), SCH_EASYEDA_PARSER::ParseSchematic(), and SCH_EASYEDA_PARSER::ParseSymbolShapes().

◆ SetTextColor()

void EDA_TEXT::SetTextColor ( const COLOR4D & aColor )

inline

Definition at line 309 of file eda_text.h.

References m_attributes.

Referenced by DS_DRAW_ITEM_TEXT::DS_DRAW_ITEM_TEXT(), EDA_TEXT_DESC::EDA_TEXT_DESC(), SCH_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SCH_EASYEDAPRO_V3_PARSER::ParseSymbol(), ORCAD_CONVERTER::placeHierarchicalBlockFields(), ORCAD_CONVERTER::placeOffpageConnectors(), ORCAD_CONVERTER::placePageFrame(), ORCAD_CONVERTER::placePorts(), ORCAD_CONVERTER::placePowerSymbol(), ORCAD_CONVERTER::placeSymbolFields(), FIELDS_GRID_TABLE::SetValue(), and DIALOG_FIELD_PROPERTIES::updateText().

◆ SetTextHeight()

void EDA_TEXT::SetTextHeight ( int aHeight )

virtual

Definition at line 528 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), m_attributes, m_IuScale, TEXT_MAX_SIZE_MM, and TEXT_MIN_SIZE_MM.

Referenced by CADSTAR_SCH_ARCHIVE_LOADER::applyTextCodeIfExists(), EDA_TEXT_DESC::EDA_TEXT_DESC(), CADSTAR_SCH_ARCHIVE_LOADER::loadDocumentationSymbols(), FABMASTER::setupText(), PCB_FIELDS_GRID_TABLE::SetValue(), and DIALOG_DIMENSION_PROPERTIES::updateDimensionFromDialog().

◆ SetTextPos()

void EDA_TEXT::SetTextPos ( const VECTOR2I & aPoint )

virtual

Definition at line 539 of file eda_text.cpp.

References GetTextPos(), Offset(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by PCAD2KICAD::PCAD_TEXT::AddToBoard(), BOARD_CONSTRAINT_ADAPTER::Apply(), BACK_ANNOTATE::applyChangelist(), SYMBOL_FIELDS_EDITOR_GRID_DATA_MODEL::ApplyData(), CADSTAR_SCH_ARCHIVE_LOADER::applyTextSettings(), CADSTAR_SCH_ARCHIVE_LOADER::applyToLibraryFieldAttribute(), SCH_SHEET::AutoplaceFields(), SCH_FIELD::BeginEdit(), SCH_TEXT::BeginEdit(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_FIXTURE_TEST_CASE(), buildCoincidentFootprint(), SCH_FIELD::CalcEdit(), SCH_TEXT::CalcEdit(), SCH_EDIT_TOOL::ChangeTextType(), Deserialize(), CADSTAR_PCB_ARCHIVE_LOADER::drawCadstarText(), DRAWING_TOOL::DrawDimension(), DS_DRAW_ITEM_TEXT::DS_DRAW_ITEM_TEXT(), ALTIUM_PCB::HelperSetTextAlignmentAndPos(), ORCAD_CONVERTER::kicadSymbolFor(), CADSTAR_PCB_ARCHIVE_LOADER::loadDimensions(), SCH_IO_EAGLE::loadInstance(), PCB_IO_KICAD_LEGACY::loadPCB_TEXT(), PCB_IO_EAGLE::loadPlain(), SCH_IO_KICAD_LEGACY::loadSymbol(), CADSTAR_SCH_ARCHIVE_LOADER::loadSymdef(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadText(), PCB_DIMENSION_BASE::Mirror(), SCH_TEXT::NormalizeJustification(), PCB_IO_EAGLE::orientFPText(), SCH_IO_ALTIUM::ParseLibParameter(), PCB_IO_KICAD_SEXPR_PARSER::parsePCB_TEXT_effects(), SCH_IO_KICAD_SEXPR_PARSER::parseSchText(), SCH_EASYEDA_PARSER::ParseSymbolShapes(), PCB_TEXT::PCB_TEXT(), DIALOG_CHANGE_SYMBOLS::processSymbols(), PCB_DIMENSION_BASE::Rotate(), PCB_TEXT::Rotate(), SCH_LABEL_BASE::Rotate(), SCH_SHEET_PIN::Rotate(), SCH_TEXT::Rotate(), SCH_SHEET_PIN::SCH_SHEET_PIN(), SCH_TEXT::SCH_TEXT(), DS_DRAW_ITEM_TEXT::SetPosition(), PCB_TEXT::SetPosition(), SCH_FIELD::SetPosition(), SCH_TEXT::SetPosition(), FABMASTER::setupText(), FIELDS_GRID_TABLE::SetValue(), EASYEDA_PARSER_BASE::TransformTextToBaseline(), DIALOG_DIMENSION_PROPERTIES::updateDimensionFromDialog(), DIALOG_FIELD_PROPERTIES::UpdateField(), SCH_SYMBOL::UpdateFields(), PCB_DIM_ALIGNED::updateText(), PCB_DIM_CENTER::updateText(), and PCB_DIM_ORTHOGONAL::updateText().

◆ SetTextSize()

void EDA_TEXT::SetTextSize	(	VECTOR2I	aNewSize,
		bool	aEnforceMinTextSize = true )

virtual

Reimplemented in PCB_TEXT, and PCB_TEXTBOX.

Definition at line 495 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), m_attributes, m_IuScale, TEXT_MAX_SIZE_MM, TEXT_MIN_SIZE_MM, unityScale, VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by SCH_IO_EAGLE::addImplicitConnections(), SCH_IO_ALTIUM::AddLibTextBox(), SCH_IO_ALTIUM::AddTextBox(), PADS_SCH::PADS_SCH_SCHEMATIC_BUILDER::ApplyFieldSettings(), CADSTAR_PCB_ARCHIVE_LOADER::applyTextCode(), 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(), SCH_EDIT_TOOL::ChangeTextType(), ALTIUM_PCB::ConvertTexts6ToEdaTextSettings(), PADS_SCH::PADS_SCH_SCHEMATIC_BUILDER::CreateCustomFields(), SCH_IO_LTSPICE_PARSER::CreateFields(), PADS_SCH::PADS_SCH_SCHEMATIC_BUILDER::CreateNetLabel(), SCH_DRAWING_TOOLS::createNewLabel(), SCH_DRAWING_TOOLS::createNewText(), SCH_IO_LTSPICE_PARSER::CreatePowerSymbol(), SCH_IO_LTSPICE_PARSER::CreateSCH_LABEL(), SCH_IO_LTSPICE_PARSER::CreateSCH_TEXT(), createSchText(), PADS_SCH::PADS_SCH_SYMBOL_BUILDER::createSymbolText(), SCH_DRAWING_TOOLS::DrawTable(), DS_DRAW_ITEM_TEXT::DS_DRAW_ITEM_TEXT(), EDA_TEXT(), SCH_IO_GEDA::flushPendingComponent(), PCB_IO_KICAD_SEXPR::format(), CADSTAR_SCH_ARCHIVE_LOADER::getScaledLibPart(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadField(), SCH_IO_EAGLE::loadFrame(), SCH_IO_EAGLE::loadInstance(), CADSTAR_SCH_ARCHIVE_LOADER::loadNets(), SCH_IO_PADS::LoadSchematicFile(), CADSTAR_SCH_ARCHIVE_LOADER::loadSchematicSymbolInstances(), SCH_IO_KICAD_LEGACY::loadSheet(), SCH_IO_KICAD_LEGACY::loadSymbol(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadText(), SCH_IO_EAGLE::loadTextAttributes(), makeText200(), DIALOG_LIB_SYMBOL_PROPERTIES::OnAddField(), PCB_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SCH_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SCH_IO_ALTIUM::ParseLabel(), SCH_IO_ALTIUM::ParseLibDesignator(), SCH_IO_ALTIUM::ParseLibParameter(), SCH_EASYEDA_PARSER::ParseSchematic(), SCH_EASYEDA_PARSER::ParseSymbolShapes(), ORCAD_CONVERTER::placeHierarchicalBlockFields(), ORCAD_CONVERTER::placeOffpageConnectors(), ORCAD_CONVERTER::placePageFrame(), ORCAD_CONVERTER::placePorts(), ORCAD_CONVERTER::placePowerSymbol(), ORCAD_CONVERTER::placeSymbolFields(), BACK_ANNOTATE::processNetNameChange(), SCH_FIELD::SCH_FIELD(), PCB_TEXT::SetLibTextSize(), SCH_FIELD::SetSchTextSize(), SCH_TEXT::SetSchTextSize(), SCH_TEXTBOX::SetSchTextSize(), PCB_TEXT::SetTextSize(), PCB_TEXTBOX::SetTextSize(), PCAD2KICAD::SetTextSizeFromStrokeFontHeight(), PCAD2KICAD::SetTextSizeFromTrueTypeFontHeight(), FIELDS_GRID_TABLE::SetValue(), SCH_DRAWING_TOOLS::TwoClickPlace(), and DIALOG_FIELD_PROPERTIES::updateText().

◆ SetTextThickness()

void EDA_TEXT::SetTextThickness ( int aWidth )

virtual

The TextThickness is that set by the user.

The EffectiveTextPenWidth also factors in bold text and thickness clamping.

Reimplemented in PCB_TEXT, and PCB_TEXTBOX.

Definition at line 245 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), and m_attributes.

Referenced by PADS_SCH::PADS_SCH_SCHEMATIC_BUILDER::ApplyFieldSettings(), CADSTAR_PCB_ARCHIVE_LOADER::applyTextCode(), CADSTAR_SCH_ARCHIVE_LOADER::applyTextCodeIfExists(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), SCH_EDIT_TOOL::ChangeTextType(), ALTIUM_PCB::ConvertTexts6ToEdaTextSettings(), createSchText(), DS_DRAW_ITEM_TEXT::DS_DRAW_ITEM_TEXT(), EDA_TEXT_DESC::EDA_TEXT_DESC(), PCB_IO_KICAD_SEXPR::format(), CADSTAR_SCH_ARCHIVE_LOADER::loadDocumentationSymbols(), MigrateLegacyBoldStrokeWidth(), PCB_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SCH_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SetAutoThickness(), PCB_TEXT::SetLibTextThickness(), PCB_TEXT::SetTextThickness(), and PCB_TEXTBOX::SetTextThickness().

◆ SetTextWidth()

void EDA_TEXT::SetTextWidth ( int aWidth )

virtual

Definition at line 517 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), m_attributes, m_IuScale, TEXT_MAX_SIZE_MM, and TEXT_MIN_SIZE_MM.

Referenced by CADSTAR_SCH_ARCHIVE_LOADER::applyTextCodeIfExists(), EDA_TEXT_DESC::EDA_TEXT_DESC(), CADSTAR_SCH_ARCHIVE_LOADER::loadDocumentationSymbols(), FABMASTER::setupText(), PCB_FIELDS_GRID_TABLE::SetValue(), and DIALOG_DIMENSION_PROPERTIES::updateDimensionFromDialog().

◆ SetTextX()

void EDA_TEXT::SetTextX ( int aX )

virtual

Definition at line 546 of file eda_text.cpp.

References GetTextPos(), and Offset().

Referenced by SCH_SHEET_PIN::ConstrainOnEdge(), PCB_TEXT::Flip(), PCB_TEXT::Mirror(), SCH_DIRECTIVE_LABEL::MirrorHorizontally(), SCH_FIELD::MirrorHorizontally(), SCH_SHEET_PIN::MirrorHorizontally(), SCH_TEXT::MirrorHorizontally(), and SCH_SHEET_PIN::SetSide().

◆ SetTextY()

void EDA_TEXT::SetTextY ( int aY )

virtual

Definition at line 552 of file eda_text.cpp.

References GetTextPos(), and Offset().

Referenced by SCH_SHEET_PIN::ConstrainOnEdge(), PCB_TEXT::Flip(), PCB_TEXT::Mirror(), SCH_DIRECTIVE_LABEL::MirrorVertically(), SCH_FIELD::MirrorVertically(), SCH_SHEET_PIN::MirrorVertically(), SCH_TEXT::MirrorVertically(), and SCH_SHEET_PIN::SetSide().

◆ SetUnresolvedFontName()

void EDA_TEXT::SetUnresolvedFontName ( const wxString & aFontName )

inline

Definition at line 288 of file eda_text.h.

References m_unresolvedFontName.

Referenced by BOOST_AUTO_TEST_CASE(), PCB_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), and SCH_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT().

◆ SetupRenderCache()

void EDA_TEXT::SetupRenderCache	(	const wxString &	aResolvedText,
		const KIFONT::FONT *	aFont,
		const EDA_ANGLE &	aAngle,
		const VECTOR2I &	aOffset )

Definition at line 705 of file eda_text.cpp.

References IsMirrored(), and m_render_cache.

◆ SetVertJustify()

void EDA_TEXT::SetVertJustify ( GR_TEXT_V_ALIGN_T aType )

Definition at line 373 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), and m_attributes.

Referenced by CADSTAR_PCB_ARCHIVE_LOADER::addAttribute(), AdjustTextForSymbolOrientation(), PADS_SCH::PADS_SCH_SCHEMATIC_BUILDER::ApplyFieldSettings(), CADSTAR_SCH_ARCHIVE_LOADER::applyTextSettings(), SCH_SHEET::AutoplaceFields(), FOOTPRINT::AutoPositionFields(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), SCH_IO_ALTIUM::CreateAliases(), SCH_DRAWING_TOOLS::createNewText(), createSchText(), CADSTAR_PCB_ARCHIVE_LOADER::drawCadstarText(), EaglePcbTextToKiCadAlignment(), eagleToKicadAlignment(), EDA_TEXT_DESC::EDA_TEXT_DESC(), ALTIUM_PCB::HelperSetTextAlignmentAndPos(), ALTIUM_PCB::HelperSetTextboxAlignmentAndPos(), AUTOPLACER::justifyField(), PCB_TEXT::KeepUpright(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadField(), PCB_IO_PADS::loadFootprints(), PCB_IO_PADS_BINARY::loadFootprints(), SCH_IO_EAGLE::loadFrame(), PCB_IO_KICAD_LEGACY::loadMODULE_TEXT(), PCB_IO_KICAD_LEGACY::loadPCB_TEXT(), SCH_IO_PADS::LoadSchematicFile(), SCH_IO_KICAD_LEGACY::loadSymbol(), CADSTAR_SCH_ARCHIVE_LOADER::loadSymdef(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadText(), SCH_EDIT_TOOL::Mirror(), SYMBOL_EDITOR_EDIT_TOOL::Mirror(), SCH_TEXT::MirrorHorizontally(), SCH_TEXT::MirrorVertically(), PCB_IO_EAGLE::packageText(), SCH_IO_LTSPICE_PARSER::Parse(), PCB_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SCH_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SCH_EASYEDA_PARSER::ParseSchematic(), SCH_EASYEDAPRO_V3_PARSER::ParseSymbol(), SCH_EASYEDA_PARSER::ParseSymbolShapes(), PCB_TEXTBOX::PCB_TEXTBOX(), ORCAD_CONVERTER::placePageFrame(), SCH_GLOBALLABEL::SCH_GLOBALLABEL(), SCH_TEXTBOX::SCH_TEXTBOX(), SCH_FIELD::SetEffectiveVertJustify(), SCH_GLOBALLABEL::SetSpinStyle(), SCH_HIERLABEL::SetSpinStyle(), SCH_LABEL_BASE::SetSpinStyle(), SCH_IO_LTSPICE_PARSER::setTextJustification(), PCAD2KICAD::SetTextJustify(), FABMASTER::setupText(), FIELDS_GRID_TABLE::SetValue(), SimulateRenderTransform(), SCH_EDIT_TOOL::Swap(), swapFieldPositionsWithMatching(), DIALOG_FIELD_PROPERTIES::UpdateField(), and DIALOG_FIELD_PROPERTIES::UpdateField().

◆ SetVisible()

void EDA_TEXT::SetVisible ( bool aVisible )

virtual

Definition at line 342 of file eda_text.cpp.

References ClearRenderCache(), and m_visible.

Referenced by CADSTAR_PCB_ARCHIVE_LOADER::addAttribute(), PCB_PROPERTIES_PANEL::addBlankField(), SCH_PROPERTIES_PANEL::addBlankField(), CADSTAR_SCH_ARCHIVE_LOADER::addNewFieldToSymbol(), PCAD2KICAD::PCAD_FOOTPRINT::AddToBoard(), BACK_ANNOTATE::applyChangelist(), SYMBOL_FIELDS_EDITOR_GRID_DATA_MODEL::ApplyData(), FOOTPRINT_FIELDS_EDITOR_GRID_DATA_MODEL::applyDataToFootprint(), PADS_SCH::PADS_SCH_SCHEMATIC_BUILDER::ApplyFieldSettings(), SCH_EDITOR_CONTROL::AssignFootprints(), 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(), ALLEGRO::BOARD_BUILDER::buildFootprint(), PADS_SCH::PADS_SCH_SYMBOL_BUILDER::BuildKiCadPowerSymbol(), MULTICHANNEL_TOOL::copyRuleAreaContents(), PADS_SCH::PADS_SCH_SCHEMATIC_BUILDER::CreateCustomFields(), SCH_IO_LTSPICE_PARSER::CreateFields(), DIPTRACE::PCB_PARSER::CreateFootprint(), PCB_BASE_FRAME::CreateNewFootprint(), SCH_DRAWING_TOOLS::createNewLabel(), SCH_IO_LTSPICE_PARSER::CreatePowerSymbol(), SCH_IO_LTSPICE_PARSER::CreateSCH_LABEL(), SCH_IO_LTSPICE_PARSER::CreateSCH_TEXT(), DIPTRACE::SCH_PARSER::createSymbolInstance(), EDIT_TOOL::DeleteItems(), PCB_FIELD::Deserialize(), SCH_FIELD::Deserialize(), SYMBOL_EDITOR_EDIT_TOOL::DoDelete(), EDA_TEXT_DESC::EDA_TEXT_DESC(), PCB_IO_EASYEDAPRO_PARSER::FillFootprintModelInfo(), SCH_IO_GEDA::flushPendingComponent(), FOOTPRINT::FOOTPRINT(), SCH_IO_EAGLE::getEagleSymbolFieldAttributes(), SCH_FIELD::ImportValues(), ORCAD_CONVERTER::kicadSymbolFor(), LIB_SYMBOL::LIB_SYMBOL(), CADSTAR_SCH_ARCHIVE_LOADER::loadBusses(), PCB_IO_EAGLE::loadElements(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadField(), FABMASTER::loadFootprints(), PCB_IO_PADS::loadFootprints(), PCB_IO_PADS_BINARY::loadFootprints(), SCH_IO_EAGLE::loadInstance(), SCH_IO_EAGLE::loadLibrary(), PCB_IO_KICAD_LEGACY::loadMODULE_TEXT(), CADSTAR_SCH_ARCHIVE_LOADER::loadNets(), SCH_IO_KICAD_LEGACY_LIB_CACHE::LoadPart(), PCB_IO_EAGLE::loadPlain(), SCH_IO_ALTIUM::LoadSchematicFile(), SCH_IO_PADS::LoadSchematicFile(), CADSTAR_SCH_ARCHIVE_LOADER::loadSchematicSymbolInstances(), SCH_IO_EAGLE::loadSymbol(), SCH_IO_KICAD_LEGACY::loadSymbol(), CADSTAR_SCH_ARCHIVE_LOADER::loadSymbolFieldAttribute(), SCH_IO_HTTP_LIB::loadSymbolFromPart(), SCH_IO_DATABASE::loadSymbolFromRow(), CADSTAR_SCH_ARCHIVE_LOADER::loadSymbolGateAndPartFields(), CADSTAR_SCH_ARCHIVE_LOADER::loadSymdef(), PCB_IO_PADS::loadTestPoints(), SCH_IO_KICAD_LEGACY_LIB_CACHE::loadText(), SIM_MODEL::MigrateSimModel(), DIALOG_FOOTPRINT_PROPERTIES::OnAddField(), DIALOG_LABEL_PROPERTIES::OnAddField(), DIALOG_LIB_SYMBOL_PROPERTIES::OnAddField(), DIALOG_SHEET_PROPERTIES::OnAddField(), DIALOG_SYMBOL_PROPERTIES::OnAddField(), SCH_IO_LTSPICE_PARSER::Parse(), PCB_IO_EASYEDAPRO_PARSER::ParseBoard(), PCB_IO_EASYEDAPRO_V3_PARSER::ParseBoard(), SCH_IO_ALTIUM::ParseDesignator(), PCB_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SCH_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), SCH_IO_ALTIUM::ParseFileName(), PCB_IO_KICAD_SEXPR_PARSER::parseFOOTPRINT_unchecked(), SCH_IO_ALTIUM::ParseLibParameter(), SCH_IO_ALTIUM::ParseParameter(), PCB_IO_KICAD_SEXPR_PARSER::parsePCB_TEXT_effects(), SCH_IO_ALTIUM::ParsePortHelper(), SCH_IO_ALTIUM::ParsePowerPort(), SCH_EASYEDAPRO_V3_PARSER::ParseSchematic(), SCH_IO_KICAD_SEXPR_PARSER::parseSchText(), SCH_IO_ALTIUM::ParseSheetName(), SCH_EASYEDA_PARSER::ParseSymbol(), SCH_EASYEDAPRO_PARSER::ParseSymbol(), SCH_EASYEDAPRO_V3_PARSER::ParseSymbol(), SCH_EASYEDA_PARSER::ParseSymbolShapes(), PCB_IO_EASYEDA_PARSER::ParseToBoardItemContainer(), ORCAD_CONVERTER::placeHierarchicalBlockFields(), ORCAD_CONVERTER::placePowerSymbol(), ORCAD_CONVERTER::placeSymbolFields(), SCH_IO_PCAD::populateScreen(), SCH_EDITOR_CONTROL::processCmpToFootprintLinkFile(), DIALOG_GLOBAL_EDIT_TEXT_AND_GRAPHICS::processItem(), SPRINT_LAYOUT_PARSER::processPad(), DIALOG_CHANGE_SYMBOLS::processSymbols(), processTextItem(), SCH_IO_KICAD_SEXPR_LIB_CACHE::saveDcmInfoAsFields(), SCH_FIELD::SCH_FIELD(), SCH_IO_LTSPICE_PARSER::setTextJustification(), FIELDS_GRID_TABLE::SetValue(), FIELDS_GRID_TABLE::SetValueAsBool(), PCB_FIELDS_GRID_TABLE::SetValueAsBool(), DIALOG_LIB_SYMBOL_PROPERTIES::TransferDataToWindow(), DIALOG_SYMBOL_PROPERTIES::TransferDataToWindow(), SCH_SHEET_PATH::UpdateAllScreenReferences(), BOARD_NETLIST_UPDATER::updateFootprintParameters(), and DIALOG_FIELD_PROPERTIES::updateText().

◆ Similarity()

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

Definition at line 1287 of file eda_text.cpp.

References EDA_TEXT(), Levenshtein(), m_attributes, and m_pos.

Referenced by PCB_DIMENSION_BASE::Similarity(), PCB_FIELD::Similarity(), PCB_TEXT::Similarity(), PCB_TEXTBOX::Similarity(), SCH_FIELD::Similarity(), SCH_TEXT::Similarity(), and SCH_TEXTBOX::Similarity().

◆ SwapAttributes()

void EDA_TEXT::SwapAttributes ( EDA_TEXT & aTradingPartner )

Swap the text attributes of the two involved instances.

Definition at line 409 of file eda_text.cpp.

References ClearBoundingBoxCache(), ClearRenderCache(), EDA_TEXT(), m_attributes, and m_pos.

Referenced by SCH_FIELD::swapData(), SCH_TEXT::swapData(), and SCH_TEXTBOX::swapData().

◆ SwapText()

void EDA_TEXT::SwapText ( EDA_TEXT & aTradingPartner )

Definition at line 401 of file eda_text.cpp.

References cacheShownText(), EDA_TEXT(), and m_text.

Referenced by SCH_FIELD::swapData(), SCH_TEXT::swapData(), and SCH_TEXTBOX::swapData().

◆ TextHitTest() [1/2]

bool EDA_TEXT::TextHitTest	(	const BOX2I &	aRect,
		bool	aContains,
		int	aAccuracy = 0 ) const

virtual

Test if object bounding box is contained within or intersects aRect.

Parameters

aRect	Rect to test against.
aContains	Test for containment instead of intersection if true.
aAccuracy	Amount to inflate the bounding box.

Returns: true if a hit, else false.

Reimplemented in PCB_TEXT.

Definition at line 881 of file eda_text.cpp.

References BOX2< Vec >::Contains(), GetDrawRotation(), BOX2< Vec >::GetInflated(), GetTextBox(), and BOX2< Vec >::Intersects().

◆ TextHitTest() [2/2]

bool EDA_TEXT::TextHitTest	(	const VECTOR2I &	aPoint,
		int	aAccuracy = 0 ) const

virtual

Test if aPoint is within the bounds of this object.

Parameters

aPoint	A VECTOR2I to test.
aAccuracy	Amount to inflate the bounding box.

Returns: true if a hit, else false.

Reimplemented in PCB_TEXT.

Definition at line 873 of file eda_text.cpp.

References BOX2< Vec >::Contains(), GetDrawPos(), GetDrawRotation(), BOX2< Vec >::GetInflated(), GetRotated(), GetTextBox(), and location.

Referenced by DS_DRAW_ITEM_TEXT::HitTest(), DS_DRAW_ITEM_TEXT::HitTest(), and PCB_TEXT::TextHitTest().

◆ ValidateHyperlink()

bool EDA_TEXT::ValidateHyperlink ( const wxString & aURL )

static

Check if aURL is a valid hyperlink.

Parameters

aURL	String to validate

Returns: true if aURL is a valid hyperlink

Definition at line 1232 of file eda_text.cpp.

References IsGotoPageHref().

Referenced by SCH_IO_KICAD_SEXPR_PARSER::parseEDA_TEXT(), and DIALOG_TEXT_PROPERTIES::TransferDataFromWindow().

Member Data Documentation

◆ m_activeUrl

wxString EDA_TEXT::m_activeUrl

mutableprotected

Definition at line 503 of file eda_text.h.

Referenced by SCH_TEXT::DoHypertextAction(), SCH_TEXTBOX::DoHypertextAction(), SCH_TEXT::HasHoveredHypertext(), SCH_TEXTBOX::HasHoveredHypertext(), and SetActiveUrl().

◆ m_attributes

TEXT_ATTRIBUTES EDA_TEXT::m_attributes

private

◆ m_bbox_cache

std::map<int, BBOX_CACHE_ENTRY> EDA_TEXT::m_bbox_cache

mutableprivate

Definition at line 526 of file eda_text.h.

Referenced by ClearBoundingBoxCache(), EDA_TEXT(), GetTextBox(), and operator=().

◆ m_bbox_cacheMutex

std::mutex EDA_TEXT::m_bbox_cacheMutex

mutableprivate

Definition at line 527 of file eda_text.h.

Referenced by ClearBoundingBoxCache(), EDA_TEXT(), GetTextBox(), and operator=().

◆ m_hyperlink

wxString EDA_TEXT::m_hyperlink

protected

A hyperlink URL.

If empty, this text object is not a hyperlink.

Definition at line 501 of file eda_text.h.

Referenced by SCH_TEXT::DoHypertextAction(), SCH_TEXTBOX::DoHypertextAction(), GetHyperlink(), HasHyperlink(), RemoveHyperlink(), and SetHyperlink().

◆ m_IuScale

std::reference_wrapper<const EDA_IU_SCALE> EDA_TEXT::m_IuScale

private

Definition at line 516 of file eda_text.h.

Referenced by EDA_TEXT(), EDA_TEXT(), Format(), SetTextHeight(), SetTextSize(), and SetTextWidth().

◆ m_pos

VECTOR2I EDA_TEXT::m_pos

private

Definition at line 531 of file eda_text.h.

Referenced by EDA_TEXT(), GetTextPos(), Offset(), operator=(), SetAttributes(), Similarity(), and SwapAttributes().

◆ m_render_cache

std::unique_ptr<EDA_TEXT_RENDER_CACHE_DATA> EDA_TEXT::m_render_cache

mutableprivate

Definition at line 518 of file eda_text.h.

Referenced by AddRenderCacheGlyph(), ClearRenderCache(), EDA_TEXT(), GetRenderCache(), Offset(), operator=(), ResolveFont(), and SetupRenderCache().

◆ m_shown_text

wxString EDA_TEXT::m_shown_text

private

Definition at line 507 of file eda_text.h.

Referenced by cacheShownText(), EDA_TEXT(), GetShownText(), and operator=().

◆ m_shown_text_has_text_var_refs

bool EDA_TEXT::m_shown_text_has_text_var_refs = false

private

Definition at line 508 of file eda_text.h.

Referenced by cacheShownText(), EDA_TEXT(), HasTextVars(), and operator=().

◆ m_text

wxString EDA_TEXT::m_text

private

Definition at line 506 of file eda_text.h.

Referenced by cacheShownText(), Compare(), CopyText(), EDA_TEXT(), EDA_TEXT(), Empty(), GetShownText(), GetText(), operator=(), Replace(), SetText(), and SwapText().

◆ m_text_var_refs

std::vector<TEXT_VAR_REF_KEY> EDA_TEXT::m_text_var_refs

private

Definition at line 514 of file eda_text.h.

Referenced by cacheShownText(), EDA_TEXT(), GetTextVarReferences(), and operator=().

◆ m_unresolvedFontName

wxString EDA_TEXT::m_unresolvedFontName

private

Definition at line 530 of file eda_text.h.

Referenced by EDA_TEXT(), GetUnresolvedFontName(), isStrokeFont(), operator=(), ResolveFont(), and SetUnresolvedFontName().

◆ m_visible

bool EDA_TEXT::m_visible

private

Definition at line 532 of file eda_text.h.

Referenced by EDA_TEXT(), EDA_TEXT(), IsVisible(), operator=(), and SetVisible().

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

Classes

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ EDA_TEXT() [1/2]

◆ EDA_TEXT() [2/2]

◆ ~EDA_TEXT()

Member Function Documentation

◆ AddRenderCacheGlyph()

◆ cacheShownText()

◆ ClearBoundingBoxCache()

◆ ClearRenderCache()

◆ Compare()

◆ containsURL()

◆ CopyText()

◆ Deserialize() [1/3]

◆ Deserialize() [2/3]

◆ Deserialize() [3/3]

◆ Empty()

◆ EvaluateText()

◆ FlipHJustify()

◆ Format()

◆ GetAttributes()

◆ GetAutoThickness()

◆ GetDrawFont()

◆ GetDrawPos()

◆ GetDrawRotation()

◆ GetEffectiveTextPenWidth()

◆ GetEffectiveTextShape()

◆ GetFont()

◆ getFontMetrics()

◆ GetFontName()

◆ GetFontProp()

◆ GetHorizJustify()

◆ GetHyperlink()

◆ GetInterline()

◆ GetLinePositions()

◆ GetLineSpacing()

◆ GetRenderCache()

◆ GetShownText()

◆ GetText()

◆ GetTextAngle()

◆ GetTextAngleDegrees()

◆ GetTextBox()

◆ GetTextColor()

◆ GetTextHeight()

◆ GetTextPos()

◆ GetTextSize()

◆ GetTextStyleName()

◆ GetTextThickness()

◆ GetTextThicknessProperty()

◆ GetTextVarReferences()

◆ GetTextWidth()

◆ GetUnresolvedFontName()

◆ GetVertJustify()

◆ GotoPageHref()

◆ HasHyperlink()

◆ HasTextVars()

◆ IsBold()

◆ IsDefaultFormatting()

◆ IsGotoPageHref()

◆ IsItalic()

◆ IsKeepUpright()

◆ IsMirrored()

◆ IsMultilineAllowed()

◆ isStrokeFont()

◆ IsVisible()

◆ Levenshtein()

◆ MapHorizJustify()

◆ MapVertJustify()

◆ MigrateLegacyBoldStrokeWidth()

◆ Offset()

◆ operator<()

◆ operator=()

◆ operator==()

◆ operator>()