gr_text.h File Reference

#include <eda_item.h>
#include <eda_text.h>

Go to the source code of this file.

Macros
#define	MIN_TEXT_SIZE   5
	Minimum dimension in pixel for drawing/no drawing a text used in Pcbnew to decide to draw (or not) some texts ( like net names on pads/tracks ). More...
#define	MIN_DRAWABLE_TEXT_SIZE   3

Functions
int	Clamp_Text_PenSize (int aPenSize, int aSize, bool aBold=true)
	As a rule, pen width should not be >1/4em, otherwise the character will be cluttered up in its own fatness. More...
float	Clamp_Text_PenSize (float aPenSize, int aSize, bool aBold=true)
int	Clamp_Text_PenSize (int aPenSize, const wxSize &aSize, bool aBold=true)
int	GetPenSizeForBold (int aTextSize)
int	GetPenSizeForNormal (int aTextSize)
int	GraphicTextWidth (const wxString &aText, const wxSize &aSize, bool italic, bool bold)
	The full X size is GraphicTextWidth + the thickness of graphic lines. More...
void	GRText (wxDC *aDC, const wxPoint &aPos, const COLOR4D &aColor, const wxString &aText, double aOrient, const wxSize &aSize, enum EDA_TEXT_HJUSTIFY_T aH_justify, enum EDA_TEXT_VJUSTIFY_T aV_justify, int aWidth, bool aItalic, bool aBold, void(*aCallback)(int x0, int y0, int xf, int yf, void *aData)=nullptr, void *aCallbackData=nullptr, PLOTTER *aPlotter=nullptr)
	Draw a graphic text (like footprint text) More...
void	GRHaloText (wxDC *aDC, const wxPoint &aPos, const COLOR4D &aBgColor, const COLOR4D &aColor1, const COLOR4D &aColor2, const wxString &aText, double aOrient, const wxSize &aSize, enum EDA_TEXT_HJUSTIFY_T aH_justify, enum EDA_TEXT_VJUSTIFY_T aV_justify, int aWidth, bool aItalic, bool aBold, void(*aCallback)(int x0, int y0, int xf, int yf, void *aData)=nullptr, void *aCallbackData=nullptr, PLOTTER *aPlotter=nullptr)
	Draw graphic text with a border so that it can be read on different backgrounds. More...

Macro Definition Documentation

MIN_DRAWABLE_TEXT_SIZE

#define MIN_DRAWABLE_TEXT_SIZE   3

Definition at line 49 of file gr_text.h.

MIN_TEXT_SIZE

#define MIN_TEXT_SIZE   5

Minimum dimension in pixel for drawing/no drawing a text used in Pcbnew to decide to draw (or not) some texts ( like net names on pads/tracks ).

When a text height is smaller than MIN_TEXT_SIZE, it is not drawn by Pcbnew.

Definition at line 43 of file gr_text.h.

Function Documentation

Clamp_Text_PenSize() [1/3]

int Clamp_Text_PenSize	(	int	aPenSize,
		int	aSize,
		bool	aBold
	)

As a rule, pen width should not be >1/4em, otherwise the character will be cluttered up in its own fatness.

The pen width max is aSize/4 for bold texts, and aSize/6 for normal texts. The "best" pen width is aSize/5 for bold texts so the clamp is consistent with bold option.

Parameters

aPenSize	the pen size to clamp.
aSize	the char size (height or width, or its wxSize).
aBold	true if text accept bold pen size.

Returns

the max pen size allowed.

As a rule, pen width should not be >1/4em, otherwise the character will be cluttered up in its own fatness.

Bold fonts are generally around aSize/5 in width, so we limit them to aSize/4, and normal text to aSize/6.

Parameters

aPenSize	is the pen size to clamp.
aSize	is the character size (height or width).
aBold	use true if text accept bold pen size.

Returns

the max pen size allowed.

Definition at line 67 of file gr_text.cpp.

{
    double scale    = aBold ? 4.0 : 6.0;
    int    maxWidth = KiROUND( (double) aSize / scale );

    return std::min( aPenSize, maxWidth );
}

References KiROUND(), and scale.

Referenced by Clamp_Text_PenSize(), KIGFX::SCH_PAINTER::draw(), EDA_TEXT::GetEffectiveTextPenWidth(), LIB_PIN::PlotPinTexts(), LIB_PIN::printPinTexts(), and DIALOG_TEXT_PROPERTIES::TransferDataFromWindow().

Clamp_Text_PenSize() [2/3]

float Clamp_Text_PenSize	(	float	aPenSize,
		int	aSize,
		bool	aBold = true
	)

Definition at line 76 of file gr_text.cpp.

{
    float scale    = aBold ? 4.0 : 6.0;
    float maxWidth = (float) aSize / scale;

    return std::min( aPenSize, maxWidth );
}

References scale.

Clamp_Text_PenSize() [3/3]

int Clamp_Text_PenSize	(	int	aPenSize,
		const wxSize &	aSize,
		bool	aBold = true
	)

Definition at line 85 of file gr_text.cpp.

{
    int size = std::min( std::abs( aSize.x ), std::abs( aSize.y ) );

    return Clamp_Text_PenSize( aPenSize, size, aBold );
}

References Clamp_Text_PenSize().

GetPenSizeForBold()

int GetPenSizeForBold

(

int

aTextSize

)

Parameters

aTextSize

the char size (height or width).

Returns

the "best" value for a pen size to draw/plot a bold text.

Parameters

aTextSize

is the char size (height or width).

Returns

the "best" value for a pen size to draw/plot a bold text.

Definition at line 46 of file gr_text.cpp.

{
    return KiROUND( aTextSize / 5.0 );
}

References KiROUND().

Referenced by EDA_TEXT::GetEffectiveTextPenWidth(), GRText(), SCH_LEGACY_PLUGIN::loadText(), SCH_EAGLE_PLUGIN::loadTextAttributes(), DS_DATA_ITEM_TEXT::SyncDrawItems(), and DIALOG_TEXT_AND_LABEL_PROPERTIES::TransferDataFromWindow().

GetPenSizeForNormal()

int GetPenSizeForNormal

(

int

aTextSize

)

Parameters

aTextSize

= the char size (height or width).

Returns

the "best" value for a pen size to draw/plot a non-bold text.

Definition at line 52 of file gr_text.cpp.

{
    return KiROUND( aTextSize / 8.0 );
}

References KiROUND().

Referenced by EDA_TEXT::GetEffectiveTextPenWidth().

GraphicTextWidth()

int GraphicTextWidth	(	const wxString &	aText,
		const wxSize &	aSize,
		bool	italic,
		bool	bold
	)

The full X size is GraphicTextWidth + the thickness of graphic lines.

Returns

the X size of the graphic text.

Definition at line 93 of file gr_text.cpp.

{
    basic_gal.SetFontItalic( aItalic );
    basic_gal.SetFontBold( aBold );
    basic_gal.SetGlyphSize( VECTOR2D( aSize ) );

    VECTOR2D tsize = basic_gal.GetTextLineSize( aText );

    return KiROUND( tsize.x );
}

References basic_gal, KIGFX::GAL::GetTextLineSize(), KiROUND(), KIGFX::GAL::SetFontBold(), KIGFX::GAL::SetFontItalic(), KIGFX::GAL::SetGlyphSize(), and VECTOR2< T >::x.

Referenced by SVG_PLOTTER::Text().

GRHaloText()

void GRHaloText	(	wxDC *	aDC,
		const wxPoint &	aPos,
		const COLOR4D &	aBgColor,
		const COLOR4D &	aColor1,
		const COLOR4D &	aColor2,
		const wxString &	aText,
		double	aOrient,
		const wxSize &	aSize,
		enum EDA_TEXT_HJUSTIFY_T	aH_justify,
		enum EDA_TEXT_VJUSTIFY_T	aV_justify,
		int	aWidth,
		bool	aItalic,
		bool	aBold,
		void(*)(int x0, int y0, int xf, int yf, void *aData)	aCallback = nullptr,
		void *	aCallbackData = nullptr,
		PLOTTER *	aPlotter = nullptr
	)

Draw graphic text with a border so that it can be read on different backgrounds.

See GRText for most of the parameters. If aBgColor is a dark color text is drawn in aColor2 with aColor1 border. Otherwise colors are swapped.

Definition at line 173 of file gr_text.cpp.

{
    COLOR4D color1 = aColor1;
    COLOR4D color2 = aColor2;

    // Swap color if contrast would be better
    // TODO: Maybe calculate contrast some way other than brightness
    if( aBgColor.GetBrightness() > 0.5 )
    {
        COLOR4D c = color1;
        color1 = color2;
        color2 = c;
    }

    // Draw the background
    GRText( aDC, aPos, color1, aText, aOrient, aSize, aH_justify, aV_justify, aWidth, aItalic,
            aBold, aCallback, aCallbackData, aPlotter );

    // Draw the text
    GRText( aDC, aPos, color2, aText, aOrient, aSize, aH_justify, aV_justify, aWidth / 4, aItalic,
            aBold, aCallback, aCallbackData, aPlotter );
}

References KIGFX::COLOR4D::GetBrightness(), and GRText().

GRText()

void GRText	(	wxDC *	aDC,
		const wxPoint &	aPos,
		const COLOR4D &	aColor,
		const wxString &	aText,
		double	aOrient,
		const wxSize &	aSize,
		enum EDA_TEXT_HJUSTIFY_T	aH_justify,
		enum EDA_TEXT_VJUSTIFY_T	aV_justify,
		int	aWidth,
		bool	aItalic,
		bool	aBold,
		void(*)(int x0, int y0, int xf, int yf, void *aData)	aCallback,
		void *	aCallbackData,
		PLOTTER *	aPlotter
	)

Draw a graphic text (like footprint text)

Parameters

aClipBox	the clipping rect, or NULL if no clipping.
aDC	the current Device Context. NULL if draw within a 3D GL Canvas.
aPos	text position (according to h_justify, v_justify).
aColor	(COLOR4D) = text color.
aText	text to draw.
aOrient	angle in 0.1 degree.
aSize	text size (size.x or size.y can be < 0 for mirrored texts).
aH_justify	horizontal justification (Left, center, right).
aV_justify	vertical justification (bottom, center, top).
aWidth	line width (pen width) (default = 0). If width < 0 : draw segments in sketch mode, width = abs(width). Use a value min(aSize.x, aSize.y) / 5 for a bold text.
aItalic	true to simulate an italic font.
aBold	true to use a bold font.
aCallback	( int x0, int y0, int xf, int yf, void* aData ) is a function called (if non null) to draw each segment. used to draw 3D texts or for plotting. NULL for normal drawings.
aCallbackData	is the auxiliary parameter aData for the callback function. This can be nullptr if no auxiliary parameter is needed.
aPlotter	= a pointer to a PLOTTER instance, when this function is used to plot the text. NULL to draw this text.

Draw a graphic text (like footprint text)

Parameters

aDC	is the current Device Context. NULL if draw within a 3D GL Canvas.
aPos	is the text position (according to h_justify, v_justify).
aColor	is the text color.
aText	is the text to draw.
aOrient	is the angle in 0.1 degree.
aSize	is the text size (size.x or size.y can be < 0 for mirrored texts).
aH_justify	is the horizontal justification (Left, center, right).
aV_justify	is the vertical justification (bottom, center, top).
aWidth	is the line width (pen width) (use default width if aWidth = 0). if width < 0 : draw segments in sketch mode, width = abs(width) Use a value min(aSize.x, aSize.y) / 5 for a bold text.
aItalic	is the true to simulate an italic font.
aBold	use true to use a bold font. Useful only with default width value (aWidth = 0).
aCallback(	int x0, int y0, int xf, int yf, void* aData ) is a function called (if non null) to draw each segment. used to draw 3D texts or for plotting. NULL for normal drawings
aCallbackData	is the auxiliary parameter aData for the callback function. can be nullptr if no auxiliary parameter is needed
aPlotter	is a PLOTTER instance, when this function is used to plot the text. NULL to draw this text.

Definition at line 129 of file gr_text.cpp.

{
    bool fill_mode = true;

    if( aWidth == 0 && aBold ) // Use default values if aWidth == 0
        aWidth = GetPenSizeForBold( std::min( aSize.x, aSize.y ) );

    if( aWidth < 0 )
    {
        aWidth = -aWidth;
        fill_mode = false;
    }

    basic_gal.SetIsFill( fill_mode );
    basic_gal.SetLineWidth( aWidth );

    EDA_TEXT dummy;
    dummy.SetItalic( aItalic );
    dummy.SetBold( aBold );
    dummy.SetHorizJustify( aH_justify );
    dummy.SetVertJustify( aV_justify );

    wxSize size = aSize;
    dummy.SetMirrored( size.x < 0 );

    if( size.x < 0 )
        size.x = - size.x;

    dummy.SetTextSize( size );

    basic_gal.SetTextAttributes( &dummy );
    basic_gal.SetPlotter( aPlotter );
    basic_gal.SetCallback( aCallback, aCallbackData );
    basic_gal.m_DC = aDC;
    basic_gal.m_Color = aColor;
    basic_gal.SetClipBox( nullptr );
    basic_gal.StrokeText( aText, VECTOR2D( aPos ), aOrient * M_PI/1800 );
}

References basic_gal, dummy(), GetPenSizeForBold(), BASIC_GAL::m_Color, BASIC_GAL::m_DC, BASIC_GAL::SetCallback(), BASIC_GAL::SetClipBox(), KIGFX::GAL::SetIsFill(), KIGFX::GAL::SetLineWidth(), BASIC_GAL::SetPlotter(), KIGFX::GAL::SetTextAttributes(), and KIGFX::GAL::StrokeText().

Referenced by BOARD_ADAPTER::addFootprintShapesWithClearance(), BOARD_ADAPTER::addShapeWithClearance(), GRHaloText(), LIB_TEXT::print(), SCH_FIELD::Print(), LIB_FIELD::print(), EDA_TEXT::printOneLineOfText(), LIB_PIN::printPinElectricalTypeName(), LIB_PIN::printPinTexts(), PLOTTER::Text(), PCB_TEXT::TransformTextShapeWithClearanceToPolygon(), FP_TEXT::TransformTextShapeWithClearanceToPolygon(), and EDA_TEXT::TransformToSegmentList().