eda_text.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2016 Jean-Pierre Charras, jp.charras at wanadoo.fr
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
#include <algorithm>   // for max
#include <stddef.h>    // for NULL
#include <type_traits> // for swap
#include <vector>
#include <mutex>
 
#include <eda_item.h>
#include <base_units.h>
#include <callback_gal.h>
#include <api/api_utils.h>
#include <eda_text.h>    // for EDA_TEXT, TEXT_EFFECTS, GR_TEXT_VJUSTIF...
#include <gal/color4d.h> // for COLOR4D, COLOR4D::BLACK
#include <font/glyph.h>
#include <gr_text.h>
#include <string_utils.h> // for UnescapeString
#include <text_eval/text_eval_wrapper.h>
#include <common.h>
#include <math/util.h> // for KiROUND
#include <math/vector2d.h>
#include <core/kicad_algo.h>
#include <richio.h>
#include <render_settings.h>
#include <trigo.h> // for RotatePoint
#include <i18n_utility.h>
#include <geometry/shape_segment.h>
#include <geometry/shape_compound.h>
#include <geometry/shape_simple.h>
#include <font/outline_font.h>
#include <geometry/shape_poly_set.h>
#include <properties/property_validators.h>
#include <properties/property.h>
#include <properties/property_mgr.h>
#include <ctl_flags.h>
#include <markup_parser.h>
#include <api/api_enums.h>
#include <api/api_utils.h>
#include <api/common/types/base_types.pb.h>
 
#include <wx/debug.h> // for wxASSERT
#include <wx/string.h>
#include <wx/url.h> // for wxURL
#include <io/kicad/kicad_io_utils.h>
#include "font/kicad_font_name.h"
#include "font/fontconfig.h"
#include "pgm_base.h"
 
class OUTPUTFORMATTER;
 
 
GR_TEXT_H_ALIGN_T EDA_TEXT::MapHorizJustify( int aHorizJustify )
{
    wxASSERT( aHorizJustify >= GR_TEXT_H_ALIGN_LEFT && aHorizJustify <= GR_TEXT_H_ALIGN_RIGHT );
 
    if( aHorizJustify > GR_TEXT_H_ALIGN_RIGHT )
        return GR_TEXT_H_ALIGN_RIGHT;
 
    if( aHorizJustify < GR_TEXT_H_ALIGN_LEFT )
        return GR_TEXT_H_ALIGN_LEFT;
 
    return static_cast<GR_TEXT_H_ALIGN_T>( aHorizJustify );
}
 
 
GR_TEXT_V_ALIGN_T EDA_TEXT::MapVertJustify( int aVertJustify )
{
    wxASSERT( aVertJustify >= GR_TEXT_V_ALIGN_TOP && aVertJustify <= GR_TEXT_V_ALIGN_BOTTOM );
 
    if( aVertJustify > GR_TEXT_V_ALIGN_BOTTOM )
        return GR_TEXT_V_ALIGN_BOTTOM;
 
    if( aVertJustify < GR_TEXT_V_ALIGN_TOP )
        return GR_TEXT_V_ALIGN_TOP;
 
    return static_cast<GR_TEXT_V_ALIGN_T>( aVertJustify );
}
 
 
EDA_TEXT::EDA_TEXT( const EDA_IU_SCALE& aIuScale, const wxString& aText ) :
        m_text( aText ),
        m_IuScale( aIuScale ),
        m_visible( true )
{
    SetTextSize( VECTOR2I( EDA_UNIT_UTILS::Mils2IU( m_IuScale, DEFAULT_SIZE_TEXT ),
                           EDA_UNIT_UTILS::Mils2IU( m_IuScale, DEFAULT_SIZE_TEXT ) ) );
 
    cacheShownText();
}
 
 
EDA_TEXT::EDA_TEXT( const EDA_TEXT& aText ) :
        m_IuScale( aText.m_IuScale )
{
    m_text = aText.m_text;
    m_shown_text = aText.m_shown_text;
    m_shown_text_has_text_var_refs = aText.m_shown_text_has_text_var_refs;
    m_text_var_refs = aText.m_text_var_refs;
 
    m_hyperlink = aText.m_hyperlink;
 
    m_attributes = aText.m_attributes;
    m_pos = aText.m_pos;
    m_visible = aText.m_visible;
 
    m_render_cache.reset();
 
    {
        std::lock_guard<std::mutex> bboxLock( aText.m_bbox_cacheMutex );
        m_bbox_cache = aText.m_bbox_cache;
    }
 
    m_unresolvedFontName = aText.m_unresolvedFontName;
}
 
 
EDA_TEXT::~EDA_TEXT()
{
}
 
 
EDA_TEXT& EDA_TEXT::operator=( const EDA_TEXT& aText )
{
    if( this == &aText )
        return *this;
 
    m_text = aText.m_text;
    m_shown_text = aText.m_shown_text;
    m_shown_text_has_text_var_refs = aText.m_shown_text_has_text_var_refs;
    m_text_var_refs = aText.m_text_var_refs;
 
    m_hyperlink = aText.m_hyperlink;
    m_activeUrl = wxEmptyString;
 
    m_attributes = aText.m_attributes;
    m_pos = aText.m_pos;
    m_visible = aText.m_visible;
 
    m_render_cache.reset();
 
    {
        std::scoped_lock<std::mutex, std::mutex> bboxLock( m_bbox_cacheMutex, aText.m_bbox_cacheMutex );
        m_bbox_cache = aText.m_bbox_cache;
    }
 
    m_unresolvedFontName = aText.m_unresolvedFontName;
 
    return *this;
}
 
 
void EDA_TEXT::Serialize( google::protobuf::Any& aContainer ) const
{
    Serialize( aContainer, pcbIUScale );
}
 
 
void EDA_TEXT::Serialize( kiapi::common::types::Text& text, const EDA_IU_SCALE& aScale ) const
{
    using namespace kiapi::common;
 
    text.set_text( GetText().ToUTF8() );
    text.set_hyperlink( GetHyperlink().ToUTF8() );
    PackVector2( *text.mutable_position(), GetTextPos(), aScale );
 
    types::TextAttributes* attrs = text.mutable_attributes();
 
    PackTextAttributes( *attrs, GetAttributes(), aScale );
    attrs->set_visible( true );
 
}
 
 
void EDA_TEXT::Serialize( google::protobuf::Any& aContainer, const EDA_IU_SCALE& aScale ) const
{
    kiapi::common::types::Text text;
    Serialize( text, aScale );
    aContainer.PackFrom( text );
}
 
 
bool EDA_TEXT::Deserialize( const google::protobuf::Any& aContainer )
{
    return Deserialize( aContainer, pcbIUScale );
}
 
 
bool EDA_TEXT::Deserialize( const kiapi::common::types::Text& text, const EDA_IU_SCALE& aScale )
{
    using namespace kiapi::common;
 
    SetText( wxString( text.text().c_str(), wxConvUTF8 ) );
    SetHyperlink( wxString( text.hyperlink().c_str(), wxConvUTF8 ) );
    SetTextPos( UnpackVector2( text.position(), aScale ) );
 
    if( text.has_attributes() )
    {
        TEXT_ATTRIBUTES attrs = GetAttributes();
        UnpackTextAttributes( attrs, text.attributes(), aScale );
        SetAttributes( attrs );
    }
 
    return true;
}
 
 
bool EDA_TEXT::Deserialize( const google::protobuf::Any& aContainer, const EDA_IU_SCALE& aScale )
{
    kiapi::common::types::Text text;
 
    if( !aContainer.UnpackTo( &text ) )
        return false;
 
    return Deserialize( text, aScale );
}
 
 
void EDA_TEXT::SetText( const wxString& aText )
{
    m_text = aText;
    cacheShownText();
}
 
 
void EDA_TEXT::CopyText( const EDA_TEXT& aSrc )
{
    m_text = aSrc.m_text;
    cacheShownText();
}
 
 
void EDA_TEXT::SetTextThickness( int aWidth )
{
    m_attributes.m_StrokeWidth = aWidth;
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::SetAutoThickness( bool aAuto )
{
    if( GetAutoThickness() != aAuto )
    {
        // Freeze the base width, not the effective one; Bold still multiplies at render time.
        SetTextThickness( aAuto ? 0 : GetPenSizeForNormal( GetTextWidth() ) );
    }
}
 
 
void EDA_TEXT::SetTextAngle( const EDA_ANGLE& aAngle )
{
    m_attributes.m_Angle = aAngle;
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
bool EDA_TEXT::isStrokeFont() const
{
    if( const KIFONT::FONT* font = GetFont() )
        return font->IsStroke();
 
    // The font is usually unresolved during load; key off the stored face name so callers
    // that run before font resolution (e.g. migration) still classify correctly.
    if( !m_unresolvedFontName.IsEmpty() )
        return KIFONT::FONT::IsStroke( m_unresolvedFontName );
 
    return true;
}
 
 
void EDA_TEXT::SetItalic( bool aItalic )
{
    if( m_attributes.m_Italic != aItalic )
    {
        // For outline fonts, italic-ness is determined by the font itself.
        if( const KIFONT::FONT* font = GetFont(); font && !isStrokeFont() )
            SetFont( KIFONT::FONT::GetFont( font->GetName(), IsBold(), aItalic ) );
    }
 
    SetItalicFlag( aItalic );
}
 
void EDA_TEXT::SetItalicFlag( bool aItalic )
{
    m_attributes.m_Italic = aItalic;
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::SetBold( bool aBold )
{
    if( m_attributes.m_Bold != aBold )
    {
        // Outline fonts carry weight in the typeface; switch variant. Stroke fonts leave the
        // stored width alone and scale it at render time.
        if( const KIFONT::FONT* font = GetFont(); font && !isStrokeFont() )
            SetFont( KIFONT::FONT::GetFont( font->GetName(), aBold, IsItalic() ) );
    }
 
    SetBoldFlag( aBold );
}
 
 
void EDA_TEXT::SetBoldFlag( bool aBold )
{
    m_attributes.m_Bold = aBold;
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::MigrateLegacyBoldStrokeWidth()
{
    int thickness = GetTextThickness();
 
    // Outline faces never baked bold into the width; skip them.
    if( !IsBold() || thickness <= 1 || !isStrokeFont() )
        return;
 
    // Keep the base above the auto threshold so a very thin width doesn't become auto. Legacy
    // widths below ~3 IU (well under any physically meaningful stroke) can't round-trip exactly
    // through this floor; the effective width comes out slightly larger than before migration.
    SetTextThickness( std::max( 2, KiROUND( thickness / BOLD_STROKE_MULTIPLIER ) ) );
}
 
 
void EDA_TEXT::SetVisible( bool aVisible )
{
    m_visible = aVisible;
    ClearRenderCache();
}
 
 
void EDA_TEXT::SetMirrored( bool isMirrored )
{
    m_attributes.m_Mirrored = isMirrored;
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::SetMultilineAllowed( bool aAllow )
{
    m_attributes.m_Multiline = aAllow;
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::SetHorizJustify( GR_TEXT_H_ALIGN_T aType )
{
    m_attributes.m_Halign = aType;
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::SetVertJustify( GR_TEXT_V_ALIGN_T aType )
{
    m_attributes.m_Valign = aType;
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::SetKeepUpright( bool aKeepUpright )
{
    m_attributes.m_KeepUpright = aKeepUpright;
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::SetAttributes( const EDA_TEXT& aSrc, bool aSetPosition )
{
    m_attributes = aSrc.m_attributes;
 
    if( aSetPosition )
        m_pos = aSrc.m_pos;
 
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::SwapText( EDA_TEXT& aTradingPartner )
{
    std::swap( m_text, aTradingPartner.m_text );
    cacheShownText();
    aTradingPartner.cacheShownText();
}
 
 
void EDA_TEXT::SwapAttributes( EDA_TEXT& aTradingPartner )
{
    std::swap( m_attributes, aTradingPartner.m_attributes );
    std::swap( m_pos, aTradingPartner.m_pos );
 
    ClearRenderCache();
    aTradingPartner.ClearRenderCache();
 
    ClearBoundingBoxCache();
    aTradingPartner.ClearBoundingBoxCache();
}
 
 
int EDA_TEXT::GetEffectiveTextPenWidth( int aDefaultPenWidth ) const
{
    int penWidth = GetTextThickness();
 
    if( penWidth <= 1 )
    {
        penWidth = aDefaultPenWidth;
 
        if( IsBold() )
            penWidth = GetPenSizeForBold( GetTextWidth() );
        else if( penWidth <= 1 )
            penWidth = GetPenSizeForNormal( GetTextWidth() );
    }
    else if( IsBold() && isStrokeFont() )
        penWidth = KiROUND( penWidth * BOLD_STROKE_MULTIPLIER );
 
    // Clip pen size for small texts:
    penWidth = ClampTextPenSize( penWidth, GetTextSize() );
 
    return penWidth;
}
 
 
bool EDA_TEXT::Replace( const EDA_SEARCH_DATA& aSearchData )
{
    bool retval = EDA_ITEM::Replace( aSearchData, m_text );
 
    cacheShownText();
 
    ClearRenderCache();
    ClearBoundingBoxCache();
 
    return retval;
}
 
 
void EDA_TEXT::SetAttributes( const TEXT_ATTRIBUTES& aTextAttrs )
{
    m_attributes = aTextAttrs;
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::SetFont( KIFONT::FONT* aFont )
{
    m_attributes.m_Font = aFont;
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
bool EDA_TEXT::ResolveFont( const std::vector<wxString>* aEmbeddedFonts )
{
    if( !m_unresolvedFontName.IsEmpty() )
    {
        m_attributes.m_Font = KIFONT::FONT::GetFont( m_unresolvedFontName, IsBold(), IsItalic(), aEmbeddedFonts );
 
        // The resolved font may not be the same as the original font, so we want to continue to
        // use the existing glyph cache to preserve the existing geometry (important on the board,
        // even if not so much on the schematic).  We need to update the font so that KiCad will
        // decide the cache is still valid.  (It will get regenerated if the user edits the text.)
        if( m_render_cache && !m_render_cache->glyphs.empty() )
            m_render_cache->font = m_attributes.m_Font;
 
        // The bbox cache isn't keyed on the font, so a box measured against the fallback font
        // before resolution would otherwise survive until the next setter.
        ClearBoundingBoxCache();
 
        m_unresolvedFontName = wxEmptyString;
        return true;
    }
 
    return false;
}
 
 
void EDA_TEXT::SetLineSpacing( double aLineSpacing )
{
    m_attributes.m_LineSpacing = aLineSpacing;
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::SetTextSize( VECTOR2I aNewSize, bool aEnforceMinTextSize )
{
    // Plotting uses unityScale and independently scales the text.  If we clamp here we'll
    // clamp to *really* small values.
    if( m_IuScale.get().IU_PER_MM == unityScale.IU_PER_MM )
        aEnforceMinTextSize = false;
 
    if( aEnforceMinTextSize )
    {
        int min = m_IuScale.get().mmToIU( TEXT_MIN_SIZE_MM );
        int max = m_IuScale.get().mmToIU( TEXT_MAX_SIZE_MM );
 
        aNewSize = VECTOR2I( std::clamp( aNewSize.x, min, max ), std::clamp( aNewSize.y, min, max ) );
    }
 
    m_attributes.m_Size = aNewSize;
 
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::SetTextWidth( int aWidth )
{
    int min = m_IuScale.get().mmToIU( TEXT_MIN_SIZE_MM );
    int max = m_IuScale.get().mmToIU( TEXT_MAX_SIZE_MM );
 
    m_attributes.m_Size.x = std::clamp( aWidth, min, max );
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::SetTextHeight( int aHeight )
{
    int min = m_IuScale.get().mmToIU( TEXT_MIN_SIZE_MM );
    int max = m_IuScale.get().mmToIU( TEXT_MAX_SIZE_MM );
 
    m_attributes.m_Size.y = std::clamp( aHeight, min, max );
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::SetTextPos( const VECTOR2I& aPoint )
{
    VECTOR2I current = GetTextPos();
    Offset( VECTOR2I( aPoint.x - current.x, aPoint.y - current.y ) );
}
 
 
void EDA_TEXT::SetTextX( int aX )
{
    Offset( VECTOR2I( aX - GetTextPos().x, 0 ) );
}
 
 
void EDA_TEXT::SetTextY( int aY )
{
    Offset( VECTOR2I( 0, aY - GetTextPos().y ) );
}
 
 
void EDA_TEXT::Offset( const VECTOR2I& aOffset )
{
    if( aOffset.x == 0 && aOffset.y == 0 )
        return;
 
    m_pos += aOffset;
 
    if( m_render_cache )
    {
        for( std::unique_ptr<KIFONT::GLYPH>& glyph : m_render_cache->glyphs )
        {
            if( KIFONT::OUTLINE_GLYPH* outline = dynamic_cast<KIFONT::OUTLINE_GLYPH*>( glyph.get() ) )
                outline->Move( aOffset );
            else if( KIFONT::STROKE_GLYPH* stroke = dynamic_cast<KIFONT::STROKE_GLYPH*>( glyph.get() ) )
                glyph = stroke->Transform( { 1.0, 1.0 }, aOffset, 0, ANGLE_0, false, { 0, 0 } );
        }
    }
 
    ClearBoundingBoxCache();
}
 
 
void EDA_TEXT::Empty()
{
    m_text.Empty();
    cacheShownText();
}
 
 
void EDA_TEXT::cacheShownText()
{
    if( m_text.IsEmpty() )
    {
        m_shown_text = wxEmptyString;
        m_shown_text_has_text_var_refs = false;
    }
    else
    {
        m_shown_text = UnescapeString( m_text );
        m_shown_text_has_text_var_refs = m_shown_text.Contains( wxT( "${" ) ) || m_shown_text.Contains( wxT( "@{" ) );
    }
 
    // Extract against raw m_text so backslash-escaped ${...} literals do not
    // fabricate dependency edges. Eager population keeps the read path
    // lock-free for concurrent workers.
    if( m_text.IsEmpty() )
        m_text_var_refs.clear();
    else
        m_text_var_refs = ExtractTextVarReferences( m_text );
 
    ClearRenderCache();
    ClearBoundingBoxCache();
}
 
 
const std::vector<TEXT_VAR_REF_KEY>& EDA_TEXT::GetTextVarReferences() const
{
    return m_text_var_refs;
}
 
 
wxString EDA_TEXT::EvaluateText( const wxString& aText ) const
{
    // Must not be static. EvaluateText runs on parallel workers (e.g.
    // CONNECTION_GRAPH resolving label text) and a shared evaluator races on
    // its internal error collector.
    EXPRESSION_EVALUATOR evaluator;
 
    return evaluator.Evaluate( aText );
}
 
 
KIFONT::FONT* EDA_TEXT::GetDrawFont( const RENDER_SETTINGS* aSettings ) const
{
    KIFONT::FONT* font = GetFont();
 
    if( !font )
    {
        if( aSettings )
            font = KIFONT::FONT::GetFont( aSettings->GetDefaultFont(), IsBold(), IsItalic() );
        else
            font = KIFONT::FONT::GetFont( wxEmptyString, IsBold(), IsItalic() );
    }
 
    return font;
}
 
 
const KIFONT::METRICS& EDA_TEXT::getFontMetrics() const
{
    return KIFONT::METRICS::Default();
}
 
 
void EDA_TEXT::ClearRenderCache()
{
    m_render_cache.reset();
}
 
 
void EDA_TEXT::ClearBoundingBoxCache()
{
    std::lock_guard<std::mutex> bboxLock( m_bbox_cacheMutex );
    m_bbox_cache.clear();
}
 
 
std::vector<std::unique_ptr<KIFONT::GLYPH>>*
EDA_TEXT::GetRenderCache( const KIFONT::FONT* aFont, const wxString& forResolvedText, const VECTOR2I& aOffset ) const
{
    if( aFont->IsOutline() )
    {
        EDA_ANGLE resolvedAngle = GetDrawRotation();
        bool      mirrored = IsMirrored();
 
        if( !m_render_cache )
            m_render_cache = std::make_unique<EDA_TEXT_RENDER_CACHE_DATA>();
 
        if( m_render_cache->glyphs.empty() || m_render_cache->font != aFont
            || m_render_cache->text != forResolvedText
            || m_render_cache->angle != resolvedAngle || m_render_cache->offset != aOffset
            || m_render_cache->mirrored != mirrored )
        {
            m_render_cache->glyphs.clear();
 
            const KIFONT::OUTLINE_FONT* font = static_cast<const KIFONT::OUTLINE_FONT*>( aFont );
            TEXT_ATTRIBUTES             attrs = GetAttributes();
 
            attrs.m_Angle = resolvedAngle;
            attrs.m_Size = GetTextSize();
 
            font->GetLinesAsGlyphs( &m_render_cache->glyphs, forResolvedText, GetDrawPos() + aOffset, attrs,
                                    getFontMetrics() );
            m_render_cache->font = aFont;
            m_render_cache->angle = resolvedAngle;
            m_render_cache->text = forResolvedText;
            m_render_cache->offset = aOffset;
            m_render_cache->mirrored = mirrored;
        }
 
        return &m_render_cache->glyphs;
    }
 
    return nullptr;
}
 
 
void EDA_TEXT::SetupRenderCache( const wxString& aResolvedText, const KIFONT::FONT* aFont, const EDA_ANGLE& aAngle,
                                 const VECTOR2I& aOffset )
{
    if( !m_render_cache )
        m_render_cache = std::make_unique<EDA_TEXT_RENDER_CACHE_DATA>();
 
    m_render_cache->text = aResolvedText;
    m_render_cache->font = aFont;
    m_render_cache->angle = aAngle;
    m_render_cache->offset = aOffset;
    m_render_cache->mirrored = IsMirrored();
    m_render_cache->glyphs.clear();
}
 
 
void EDA_TEXT::AddRenderCacheGlyph( const SHAPE_POLY_SET& aPoly )
{
    if( !m_render_cache )
        m_render_cache = std::make_unique<EDA_TEXT_RENDER_CACHE_DATA>();
 
    m_render_cache->glyphs.emplace_back( std::make_unique<KIFONT::OUTLINE_GLYPH>( aPoly ) );
    static_cast<KIFONT::OUTLINE_GLYPH*>( m_render_cache->glyphs.back().get() )->CacheTriangulation();
}
 
 
int EDA_TEXT::GetInterline( const RENDER_SETTINGS* aSettings ) const
{
    return KiROUND( GetDrawFont( aSettings )->GetInterline( GetTextHeight(), getFontMetrics() )
                    * GetLineSpacing() );
}
 
 
BOX2I EDA_TEXT::GetTextBox( const RENDER_SETTINGS* aSettings, int aLine ) const
{
    VECTOR2I drawPos = GetDrawPos();
 
    {
        std::lock_guard<std::mutex> bboxLock( m_bbox_cacheMutex );
        auto                        cache_it = m_bbox_cache.find( aLine );
 
        if( cache_it != m_bbox_cache.end() && cache_it->second.m_pos == drawPos )
            return cache_it->second.m_bbox;
    }
 
    BOX2I         bbox;
    wxArrayString strings;
    wxString      text = GetShownText( FOR_CANVAS );
    int           thickness = GetEffectiveTextPenWidth();
 
    if( IsMultilineAllowed() )
    {
        wxStringSplit( text, strings, '\n' );
 
        if( strings.GetCount() ) // GetCount() == 0 for void strings with multilines allowed
        {
            if( aLine >= 0 && ( aLine < static_cast<int>( strings.GetCount() ) ) )
                text = strings.Item( aLine );
            else
                text = strings.Item( 0 );
        }
    }
 
    // calculate the H and V size
    KIFONT::FONT* font = GetDrawFont( aSettings );
    VECTOR2D      fontSize( GetTextSize() );
    bool          bold = IsBold();
    bool          italic = IsItalic();
    VECTOR2I      extents = font->StringBoundaryLimits( text, fontSize, thickness, bold, italic, getFontMetrics() );
    int           overbarOffset = 0;
 
    // Creates bounding box (rectangle) for horizontal, left and top justified text. The
    // bounding box will be moved later according to the actual text options
    VECTOR2I textsize = VECTOR2I( extents.x, extents.y );
    VECTOR2I pos = drawPos;
    int      fudgeFactor = KiROUND( extents.y * 0.17 );
 
    if( font->IsStroke() )
        textsize.y += fudgeFactor;
 
    int interline = KiROUND( font->GetInterline( fontSize.y, getFontMetrics() ) * GetLineSpacing() );
 
    if( IsMultilineAllowed() && aLine > 0 && aLine < (int) strings.GetCount() )
        pos.y -= aLine * interline;
 
    if( text.Contains( wxT( "~{" ) ) )
        overbarOffset = extents.y / 6;
 
    bbox.SetOrigin( pos );
 
    // for multiline texts and aLine < 0, merge all rectangles (aLine == -1 signals all lines)
    if( IsMultilineAllowed() && aLine < 0 && strings.GetCount() > 1 )
    {
        for( unsigned ii = 1; ii < strings.GetCount(); ii++ )
        {
            text = strings.Item( ii );
            extents = font->StringBoundaryLimits( text, fontSize, thickness, bold, italic, getFontMetrics() );
            textsize.x = std::max( textsize.x, extents.x );
        }
 
        // interline spacing is only *between* lines, so total height is the height of the first
        // line plus the interline distance (with interline spacing) for all subsequent lines
        textsize.y += ( strings.GetCount() - 1 ) * interline;
    }
 
    textsize.y += overbarOffset;
 
    bbox.SetSize( textsize );
 
    /*
     * At this point the rectangle origin is the text origin (m_Pos).  This is correct only for
     * left and top justified, non-mirrored, non-overbarred texts. Recalculate for all others.
     */
    int italicOffset = IsItalic() ? KiROUND( fontSize.y * ITALIC_TILT ) : 0;
 
    switch( GetHorizJustify() )
    {
    case GR_TEXT_H_ALIGN_LEFT:
        if( IsMirrored() )
            bbox.SetX( bbox.GetX() - ( bbox.GetWidth() - italicOffset ) );
 
        break;
 
    case GR_TEXT_H_ALIGN_CENTER:
        bbox.SetX( bbox.GetX() - ( bbox.GetWidth() - italicOffset ) / 2 );
        break;
 
    case GR_TEXT_H_ALIGN_RIGHT:
        if( !IsMirrored() )
            bbox.SetX( bbox.GetX() - ( bbox.GetWidth() - italicOffset ) );
 
        break;
 
    case GR_TEXT_H_ALIGN_INDETERMINATE:
        wxFAIL_MSG( wxT( "Indeterminate state legal only in dialogs." ) );
        break;
    }
 
    switch( GetVertJustify() )
    {
    case GR_TEXT_V_ALIGN_TOP:
        bbox.Offset( 0, -fudgeFactor );
        break;
 
    case GR_TEXT_V_ALIGN_CENTER:
        bbox.SetY( bbox.GetY() - bbox.GetHeight() / 2 );
        break;
 
    case GR_TEXT_V_ALIGN_BOTTOM:
        bbox.SetY( bbox.GetY() - bbox.GetHeight() );
        bbox.Offset( 0, fudgeFactor );
        break;
 
    case GR_TEXT_V_ALIGN_INDETERMINATE:
        wxFAIL_MSG( wxT( "Indeterminate state legal only in dialogs." ) );
        break;
    }
 
    bbox.Normalize(); // Make h and v sizes always >= 0
 
    {
        std::lock_guard<std::mutex> bboxLock( m_bbox_cacheMutex );
        m_bbox_cache[aLine] = { drawPos, bbox };
    }
 
    return bbox;
}
 
 
bool EDA_TEXT::TextHitTest( const VECTOR2I& aPoint, int aAccuracy ) const
{
    const BOX2I    rect = GetTextBox( nullptr ).GetInflated( aAccuracy );
    const VECTOR2I location = GetRotated( aPoint, GetDrawPos(), -GetDrawRotation() );
    return rect.Contains( location );
}
 
 
bool EDA_TEXT::TextHitTest( const BOX2I& aRect, bool aContains, int aAccuracy ) const
{
    const BOX2I rect = aRect.GetInflated( aAccuracy );
 
    if( aContains )
        return rect.Contains( GetTextBox( nullptr ) );
 
    return rect.Intersects( GetTextBox( nullptr ), GetDrawRotation() );
}
 
 
void EDA_TEXT::Print( const RENDER_SETTINGS* aSettings, const VECTOR2I& aOffset, const COLOR4D& aColor )
{
    if( IsMultilineAllowed() )
    {
        std::vector<VECTOR2I> positions;
        wxArrayString         strings;
        wxStringSplit( GetShownText( FOR_CANVAS ), strings, '\n' );
 
        positions.reserve( strings.Count() );
 
        GetLinePositions( aSettings, positions, (int) strings.Count() );
 
        for( unsigned ii = 0; ii < strings.Count(); ii++ )
            printOneLineOfText( aSettings, aOffset, aColor, strings[ii], positions[ii] );
    }
    else
    {
        printOneLineOfText( aSettings, aOffset, aColor, GetShownText( FOR_CANVAS ), GetDrawPos() );
    }
}
 
 
void EDA_TEXT::GetLinePositions( const RENDER_SETTINGS* aSettings, std::vector<VECTOR2I>& aPositions,
                                 int aLineCount ) const
{
    VECTOR2I pos = GetDrawPos(); // Position of first line of the multiline text according
                                 // to the center of the multiline text block
 
    VECTOR2I offset; // Offset to next line.
 
    offset.y = GetInterline( aSettings );
 
    if( aLineCount > 1 )
    {
        switch( GetVertJustify() )
        {
        case GR_TEXT_V_ALIGN_TOP:
            break;
 
        case GR_TEXT_V_ALIGN_CENTER:
            pos.y -= ( aLineCount - 1 ) * offset.y / 2;
            break;
 
        case GR_TEXT_V_ALIGN_BOTTOM:
            pos.y -= ( aLineCount - 1 ) * offset.y;
            break;
 
        case GR_TEXT_V_ALIGN_INDETERMINATE:
            wxFAIL_MSG( wxT( "Indeterminate state legal only in dialogs." ) );
            break;
        }
    }
 
    // Rotate the position of the first line around the center of the multiline text block
    RotatePoint( pos, GetDrawPos(), GetDrawRotation() );
 
    // Rotate the offset lines to increase happened in the right direction
    RotatePoint( offset, GetDrawRotation() );
 
    for( int ii = 0; ii < aLineCount; ii++ )
    {
        aPositions.push_back( (VECTOR2I) pos );
        pos += offset;
    }
}
 
 
void EDA_TEXT::printOneLineOfText( const RENDER_SETTINGS* aSettings, const VECTOR2I& aOffset, const COLOR4D& aColor,
                                   const wxString& aText, const VECTOR2I& aPos )
{
    wxDC* DC = aSettings->GetPrintDC();
    int   penWidth = GetEffectiveTextPenWidth( aSettings->GetDefaultPenWidth() );
 
    VECTOR2I size = GetTextSize();
 
    if( IsMirrored() )
        size.x = -size.x;
 
    KIFONT::FONT* font = GetDrawFont( aSettings );
 
    GRPrintText( DC, aOffset + aPos, aColor, aText, GetDrawRotation(), size, GetHorizJustify(), GetVertJustify(),
                 penWidth, IsItalic(), IsBold(), font, getFontMetrics() );
}
 
 
bool recursiveDescent( const std::unique_ptr<MARKUP::NODE>& aNode )
{
    if( aNode->isURL() )
        return true;
 
    for( const std::unique_ptr<MARKUP::NODE>& child : aNode->children )
    {
        if( recursiveDescent( child ) )
            return true;
    }
 
    return false;
}
 
 
bool EDA_TEXT::containsURL() const
{
    wxString showntext = GetShownText( FOR_GUI );
    MARKUP::MARKUP_PARSER markupParser( TO_UTF8( showntext ) );
    return recursiveDescent( markupParser.Parse() );
}
 
 
wxString EDA_TEXT::GetTextStyleName() const
{
    int style = 0;
 
    if( IsItalic() )
        style = 1;
 
    if( IsBold() )
        style += 2;
 
    wxString stylemsg[4] = { _( "Normal" ), _( "Italic" ), _( "Bold" ), _( "Bold+Italic" ) };
 
    return stylemsg[style];
}
 
 
wxString EDA_TEXT::GetFontName() const
{
    if( GetFont() )
        return GetFont()->GetName();
    else
        return wxEmptyString;
}
 
 
wxString EDA_TEXT::GetFontProp() const
{
    if( KIFONT::FONT* font = GetFont() )
        return font->GetName();
 
    if( IsEeschemaType( dynamic_cast<const EDA_ITEM*>( this )->Type() ) )
        return _( "Default Font" );
    else
        return KICAD_FONT_NAME;
}
 
 
void EDA_TEXT::SetFontProp( const wxString& aFontName )
{
    if( IsEeschemaType( dynamic_cast<const EDA_ITEM*>( this )->Type() ) )
    {
        if( aFontName == _( "Default Font" ) )
            SetFont( nullptr );
        else
            SetFont( KIFONT::FONT::GetFont( aFontName, IsBold(), IsItalic() ) );
    }
    else
    {
        if( aFontName == KICAD_FONT_NAME )
            SetFont( nullptr );
        else
            SetFont( KIFONT::FONT::GetFont( aFontName, IsBold(), IsItalic() ) );
    }
}
 
 
bool EDA_TEXT::IsDefaultFormatting() const
{
    return ( !IsMirrored() && GetHorizJustify() == GR_TEXT_H_ALIGN_CENTER && GetVertJustify() == GR_TEXT_V_ALIGN_CENTER
             && GetAutoThickness() && !IsItalic() && !IsBold() && !IsMultilineAllowed() && GetFontName().IsEmpty() );
}
 
 
void EDA_TEXT::Format( OUTPUTFORMATTER* aFormatter, int aControlBits ) const
{
    aFormatter->Print( "(effects" );
 
    aFormatter->Print( "(font" );
 
    if( GetFont() && !GetFont()->GetName().IsEmpty() )
        aFormatter->Print( "(face %s)", aFormatter->Quotew( GetFont()->NameAsToken() ).c_str() );
 
    // Text size
    aFormatter->Print( "(size %s %s)", EDA_UNIT_UTILS::FormatInternalUnits( m_IuScale, GetTextHeight() ).c_str(),
                       EDA_UNIT_UTILS::FormatInternalUnits( m_IuScale, GetTextWidth() ).c_str() );
 
    if( GetLineSpacing() != 1.0 )
    {
        aFormatter->Print( "(line_spacing %s)", FormatDouble2Str( GetLineSpacing() ).c_str() );
    }
 
    if( !GetAutoThickness() )
    {
        aFormatter->Print( "(thickness %s)",
                           EDA_UNIT_UTILS::FormatInternalUnits( m_IuScale, GetTextThickness() ).c_str() );
    }
 
    if( IsBold() )
        KICAD_FORMAT::FormatBool( aFormatter, "bold", true );
 
    if( IsItalic() )
        KICAD_FORMAT::FormatBool( aFormatter, "italic", true );
 
    if( !( aControlBits & CTL_OMIT_COLOR ) && GetTextColor() != COLOR4D::UNSPECIFIED )
    {
        aFormatter->Print( "(color %d %d %d %s)", KiROUND( GetTextColor().r * 255.0 ),
                           KiROUND( GetTextColor().g * 255.0 ), KiROUND( GetTextColor().b * 255.0 ),
                           FormatDouble2Str( GetTextColor().a ).c_str() );
    }
 
    aFormatter->Print( ")" ); // (font
 
    if( IsMirrored() || GetHorizJustify() != GR_TEXT_H_ALIGN_CENTER || GetVertJustify() != GR_TEXT_V_ALIGN_CENTER )
    {
        aFormatter->Print( "(justify" );
 
        if( GetHorizJustify() != GR_TEXT_H_ALIGN_CENTER )
            aFormatter->Print( GetHorizJustify() == GR_TEXT_H_ALIGN_LEFT ? " left" : " right" );
 
        if( GetVertJustify() != GR_TEXT_V_ALIGN_CENTER )
            aFormatter->Print( GetVertJustify() == GR_TEXT_V_ALIGN_TOP ? " top" : " bottom" );
 
        if( IsMirrored() )
            aFormatter->Print( " mirror" );
 
        aFormatter->Print( ")" ); // (justify
    }
 
    if( !( aControlBits & CTL_OMIT_HYPERLINK ) && HasHyperlink() )
        aFormatter->Print( "(href %s)", aFormatter->Quotew( GetHyperlink() ).c_str() );
 
    aFormatter->Print( ")" ); // (effects
}
 
 
std::shared_ptr<SHAPE_COMPOUND> EDA_TEXT::GetEffectiveTextShape( bool aTriangulate, const BOX2I& aBBox,
                                                                 const EDA_ANGLE& aAngle ) const
{
    std::shared_ptr<SHAPE_COMPOUND> shape = std::make_shared<SHAPE_COMPOUND>();
    KIGFX::GAL_DISPLAY_OPTIONS      empty_opts;
    KIFONT::FONT*                   font = GetDrawFont( nullptr );
    int                             penWidth = GetEffectiveTextPenWidth();
    wxString                        shownText( GetShownText( FOR_CANVAS ) );
    VECTOR2I                        drawPos = GetDrawPos();
    TEXT_ATTRIBUTES                 attrs = GetAttributes();
 
    attrs.m_Size = GetTextSize();
 
    std::vector<std::unique_ptr<KIFONT::GLYPH>>* cache = nullptr;
 
    if( aBBox.GetWidth() )
    {
        drawPos = aBBox.GetCenter();
        attrs.m_Halign = GR_TEXT_H_ALIGN_CENTER;
        attrs.m_Valign = GR_TEXT_V_ALIGN_CENTER;
        attrs.m_Angle = aAngle;
    }
    else
    {
        attrs.m_Angle = GetDrawRotation();
 
        if( font->IsOutline() )
            cache = GetRenderCache( font, shownText, VECTOR2I() );
    }
 
    if( aTriangulate )
    {
        CALLBACK_GAL callback_gal(
                empty_opts,
                // Stroke callback
                [&]( const VECTOR2I& aPt1, const VECTOR2I& aPt2 )
                {
                    shape->AddShape( new SHAPE_SEGMENT( aPt1, aPt2, penWidth ) );
                },
                // Triangulation callback
                [&]( const VECTOR2I& aPt1, const VECTOR2I& aPt2, const VECTOR2I& aPt3 )
                {
                    SHAPE_SIMPLE* triShape = new SHAPE_SIMPLE;
 
                    for( const VECTOR2I& point : { aPt1, aPt2, aPt3 } )
                        triShape->Append( point.x, point.y );
 
                    shape->AddShape( triShape );
                } );
 
        if( cache )
            callback_gal.DrawGlyphs( *cache );
        else
            font->Draw( &callback_gal, shownText, drawPos, attrs, getFontMetrics() );
    }
    else
    {
        CALLBACK_GAL callback_gal(
                empty_opts,
                // Stroke callback
                [&]( const VECTOR2I& aPt1, const VECTOR2I& aPt2 )
                {
                    shape->AddShape( new SHAPE_SEGMENT( aPt1, aPt2, penWidth ) );
                },
                // Outline callback
                [&]( const SHAPE_LINE_CHAIN& aPoly )
                {
                    shape->AddShape( aPoly.Clone() );
                } );
 
        if( cache )
            callback_gal.DrawGlyphs( *cache );
        else
            font->Draw( &callback_gal, shownText, drawPos, attrs, getFontMetrics() );
    }
 
    return shape;
}
 
 
int EDA_TEXT::Compare( const EDA_TEXT* aOther ) const
{
    wxCHECK( aOther, 1 );
 
    int val = m_attributes.Compare( aOther->m_attributes );
 
    if( val != 0 )
        return val;
 
    const VECTOR2I pos = GetTextPos();
    const VECTOR2I otherPos = aOther->GetTextPos();
 
    if( pos.x != otherPos.x )
        return pos.x - otherPos.x;
 
    if( pos.y != otherPos.y )
        return pos.y - otherPos.y;
 
    val = GetFontName().Cmp( aOther->GetFontName() );
 
    if( val != 0 )
        return val;
 
    val = m_hyperlink.Cmp( aOther->m_hyperlink );
 
    if( val != 0 )
        return val;
 
    return m_text.Cmp( aOther->m_text );
}
 
 
bool EDA_TEXT::ValidateHyperlink( const wxString& aURL )
{
    if( aURL.IsEmpty() || IsGotoPageHref( aURL ) )
        return true;
 
    wxURI uri;
 
    return ( uri.Create( aURL ) && uri.HasScheme() );
}
 
double EDA_TEXT::Levenshtein( const EDA_TEXT& aOther ) const
{
    // Compute the Levenshtein distance between the two strings
    const wxString& str1 = GetText();
    const wxString& str2 = aOther.GetText();
 
    int m = str1.length();
    int n = str2.length();
 
    if( n == 0 || m == 0 )
        return 0.0;
 
    // Create a matrix to store the distance values
    std::vector<std::vector<int>> distance( m + 1, std::vector<int>( n + 1 ) );
 
    // Initialize the matrix
    for( int i = 0; i <= m; i++ )
        distance[i][0] = i;
    for( int j = 0; j <= n; j++ )
        distance[0][j] = j;
 
    // Calculate the distance
    for( int i = 1; i <= m; i++ )
    {
        for( int j = 1; j <= n; j++ )
        {
            if( str1[i - 1] == str2[j - 1] )
            {
                distance[i][j] = distance[i - 1][j - 1];
            }
            else
            {
                distance[i][j] = std::min( { distance[i - 1][j], distance[i][j - 1], distance[i - 1][j - 1] } ) + 1;
            }
        }
    }
 
    // Calculate similarity score
    int    maxLen = std::max( m, n );
    double similarity = 1.0 - ( static_cast<double>( distance[m][n] ) / maxLen );
 
    return similarity;
}
 
 
double EDA_TEXT::Similarity( const EDA_TEXT& aOther ) const
{
    double retval = 1.0;
 
    if( !( m_attributes == aOther.m_attributes ) )
        retval *= 0.9;
 
    if( !m_hyperlink.IsSameAs( aOther.m_hyperlink, false ) )
        retval *= 0.9;
 
    if( m_pos != aOther.m_pos )
        retval *= 0.9;
 
    retval *= Levenshtein( aOther );
 
    return retval;
}
 
 
bool EDA_TEXT::IsGotoPageHref( const wxString& aHref, wxString* aDestination )
{
    return aHref.StartsWith( wxT( "#" ), aDestination );
}
 
 
wxString EDA_TEXT::GotoPageHref( const wxString& aDestination )
{
    return wxT( "#" ) + aDestination;
}
 
 
std::ostream& operator<<( std::ostream& aStream, const EDA_TEXT& aText )
{
    aStream << aText.GetText();
 
    return aStream;
}
 
 
static struct EDA_TEXT_DESC
{
    EDA_TEXT_DESC()
    {
        // These are defined in SCH_FIELD as well but initialization order is
        // not defined, so this needs to be conditional.  Defining in both
        // places leads to duplicate symbols.
        auto& h_inst = ENUM_MAP<GR_TEXT_H_ALIGN_T>::Instance();
 
        if( h_inst.Choices().GetCount() == 0 )
        {
            h_inst.Map( GR_TEXT_H_ALIGN_LEFT, _HKI( "Left" ) );
            h_inst.Map( GR_TEXT_H_ALIGN_CENTER, _HKI( "Center" ) );
            h_inst.Map( GR_TEXT_H_ALIGN_RIGHT, _HKI( "Right" ) );
        }
 
        auto& v_inst = ENUM_MAP<GR_TEXT_V_ALIGN_T>::Instance();
 
        if( v_inst.Choices().GetCount() == 0 )
        {
            v_inst.Map( GR_TEXT_V_ALIGN_TOP, _HKI( "Top" ) );
            v_inst.Map( GR_TEXT_V_ALIGN_CENTER, _HKI( "Center" ) );
            v_inst.Map( GR_TEXT_V_ALIGN_BOTTOM, _HKI( "Bottom" ) );
        }
 
        PROPERTY_MANAGER& propMgr = PROPERTY_MANAGER::Instance();
        REGISTER_TYPE( EDA_TEXT );
 
        propMgr.AddProperty( new PROPERTY<EDA_TEXT, double>( _HKI( "Orientation" ),
                    &EDA_TEXT::SetTextAngleDegrees, &EDA_TEXT::GetTextAngleDegrees, PROPERTY_DISPLAY::PT_DEGREE ) );
 
        const wxString textProps = _HKI( "Text Properties" );
 
        propMgr.AddProperty( new PROPERTY<EDA_TEXT, wxString>( _HKI( "Text" ),
                    &EDA_TEXT::SetText, &EDA_TEXT::GetText ),
                    textProps );
 
        propMgr.AddProperty( new PROPERTY<EDA_TEXT, wxString>( _HKI( "Font" ),
                    &EDA_TEXT::SetFontProp, &EDA_TEXT::GetFontProp ),
                    textProps )
                .SetIsHiddenFromRulesEditor()
                .SetChoicesFunc(
                        []( INSPECTABLE* aItem )
                        {
                            EDA_ITEM*                eda_item = static_cast<EDA_ITEM*>( aItem );
                            wxPGChoices              fonts;
                            std::vector<std::string> fontNames;
 
                            Fontconfig()->ListFonts( fontNames, std::string( Pgm().GetLanguageTag().utf8_str() ),
                                                     eda_item->GetEmbeddedFonts() );
 
                            if( IsEeschemaType( eda_item->Type() ) )
                                fonts.Add( _( "Default Font" ) );
 
                            fonts.Add( KICAD_FONT_NAME );
 
                            for( const std::string& fontName : fontNames )
                                fonts.Add( wxString( fontName ) );
 
                            return fonts;
                        } ).SetIsCopyable();
 
        propMgr.AddProperty( new PROPERTY<EDA_TEXT, bool>( _HKI( "Auto Thickness" ),
                    &EDA_TEXT::SetAutoThickness, &EDA_TEXT::GetAutoThickness ),
                    textProps );
        propMgr.AddProperty( new PROPERTY<EDA_TEXT, int>( _HKI( "Thickness" ),
                    &EDA_TEXT::SetTextThickness, &EDA_TEXT::GetTextThicknessProperty, PROPERTY_DISPLAY::PT_SIZE ),
                    textProps ).SetIsCopyable();
        propMgr.AddProperty( new PROPERTY<EDA_TEXT, bool>( _HKI( "Italic" ),
                    &EDA_TEXT::SetItalic, &EDA_TEXT::IsItalic ),
                    textProps ).SetIsCopyable();
        propMgr.AddProperty( new PROPERTY<EDA_TEXT, bool>( _HKI( "Bold" ),
                    &EDA_TEXT::SetBold, &EDA_TEXT::IsBold ),
                    textProps ).SetIsCopyable();
        propMgr.AddProperty( new PROPERTY<EDA_TEXT, bool>( _HKI( "Mirrored" ),
                    &EDA_TEXT::SetMirrored, &EDA_TEXT::IsMirrored ),
                    textProps );
 
        auto isField =
                []( INSPECTABLE* aItem ) -> bool
                {
                    if( EDA_ITEM* item = dynamic_cast<EDA_ITEM*>( aItem ) )
                        return item->Type() == SCH_FIELD_T || item->Type() == PCB_FIELD_T;
 
                    return false;
                };
 
        propMgr.AddProperty( new PROPERTY<EDA_TEXT, bool>( _HKI( "Visible" ),
                    &EDA_TEXT::SetVisible, &EDA_TEXT::IsVisible ),
                    textProps )
                .SetAvailableFunc( isField ).SetIsCopyable();
 
        propMgr.AddProperty( new PROPERTY<EDA_TEXT, int>( _HKI( "Width" ),
                    &EDA_TEXT::SetTextWidth, &EDA_TEXT::GetTextWidth, PROPERTY_DISPLAY::PT_SIZE ),
                    textProps ).SetIsCopyable();
 
        propMgr.AddProperty( new PROPERTY<EDA_TEXT, int>( _HKI( "Height" ),
                    &EDA_TEXT::SetTextHeight, &EDA_TEXT::GetTextHeight, PROPERTY_DISPLAY::PT_SIZE ),
                    textProps ).SetIsCopyable();
 
        propMgr.AddProperty( new PROPERTY_ENUM<EDA_TEXT, GR_TEXT_H_ALIGN_T>( _HKI( "Horizontal Justification" ),
                    &EDA_TEXT::SetHorizJustify, &EDA_TEXT::GetHorizJustify ),
                    textProps ).SetIsCopyable();
        propMgr.AddProperty( new PROPERTY_ENUM<EDA_TEXT, GR_TEXT_V_ALIGN_T>( _HKI( "Vertical Justification" ),
                    &EDA_TEXT::SetVertJustify, &EDA_TEXT::GetVertJustify ),
                    textProps ).SetIsCopyable();
 
        propMgr.AddProperty( new PROPERTY<EDA_TEXT, COLOR4D>( _HKI( "Color" ),
                    &EDA_TEXT::SetTextColor, &EDA_TEXT::GetTextColor ),
                    textProps );
 
        propMgr.AddProperty( new PROPERTY<EDA_TEXT, wxString>( _HKI( "Hyperlink" ),
                    &EDA_TEXT::SetHyperlink, &EDA_TEXT::GetHyperlink ),
                    textProps );
    }
} _EDA_TEXT_DESC;
 
ENUM_TO_WXANY( GR_TEXT_H_ALIGN_T )
ENUM_TO_WXANY( GR_TEXT_V_ALIGN_T )