dialog_line_properties.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2017 Seth Hillbrand <[email protected]>
 * 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 <bitmaps.h>
#include <sch_line.h>
#include <dialog_line_properties.h>
#include <dialogs/dialog_color_picker.h>
#include <settings/color_settings.h>
#include <settings/settings_manager.h>
#include <sch_edit_frame.h>
#include <stroke_params.h>
#include <widgets/color_swatch.h>
#include <widgets/line_ending_bitmap.h>
#include <sch_commit.h>
#include <line_ending.h>
 
 
void DIALOG_LINE_PROPERTIES::createLineEndingControls( SCH_EDIT_FRAME* aParent )
{
    wxSizer* mainSizer = GetSizer();
    wxCHECK_RET( mainSizer, wxT( "Line properties dialog has no main sizer" ) );
 
    wxGridBagSizer* gbSizerEndings = new wxGridBagSizer( 3, 0 );
    gbSizerEndings->SetFlexibleDirection( wxBOTH );
    gbSizerEndings->SetNonFlexibleGrowMode( wxFLEX_GROWMODE_SPECIFIED );
    gbSizerEndings->SetEmptyCellSize( wxSize( 20, -1 ) );
 
    m_startShapeLabel = new wxStaticText( this, wxID_ANY, _( "Start Shape:" ) );
    gbSizerEndings->Add( m_startShapeLabel, wxGBPosition( 0, 0 ), wxGBSpan( 1, 1 ),
                         wxALIGN_CENTER_VERTICAL | wxRIGHT, 5 );
 
    m_startShapeChoice = new wxBitmapComboBox( this, wxID_ANY, wxEmptyString, wxDefaultPosition, wxDefaultSize, 0,
                                               nullptr, wxCB_READONLY );
    gbSizerEndings->Add( m_startShapeChoice, wxGBPosition( 0, 1 ), wxGBSpan( 1, 2 ),
                         wxALIGN_CENTER_VERTICAL | wxEXPAND, 5 );
 
    m_endShapeLabel = new wxStaticText( this, wxID_ANY, _( "End Shape:" ) );
    gbSizerEndings->Add( m_endShapeLabel, wxGBPosition( 0, 4 ), wxGBSpan( 1, 1 ),
                         wxALIGN_CENTER_VERTICAL | wxRIGHT, 5 );
 
    m_endShapeChoice = new wxBitmapComboBox( this, wxID_ANY, wxEmptyString, wxDefaultPosition, wxDefaultSize, 0,
                                             nullptr, wxCB_READONLY );
    gbSizerEndings->Add( m_endShapeChoice, wxGBPosition( 0, 5 ), wxGBSpan( 1, 2 ),
                         wxALIGN_CENTER_VERTICAL | wxEXPAND, 5 );
 
    auto addEndingValue =
            [&]( int aRow, int aCol, const wxString& aLabel, wxStaticText*& aLabelCtrl, wxTextCtrl*& aValueCtrl,
                 wxStaticText*& aUnitsCtrl, int aFlags )
            {
                aLabelCtrl = new wxStaticText( this, wxID_ANY, aLabel );
                gbSizerEndings->Add( aLabelCtrl, wxGBPosition( aRow, aCol ), wxGBSpan( 1, 1 ),
                                     wxALIGN_CENTER_VERTICAL | wxLEFT | aFlags, 15 );
 
                aValueCtrl = new wxTextCtrl( this, wxID_ANY, wxEmptyString, wxDefaultPosition, wxSize( -1, -1 ), 0 );
                gbSizerEndings->Add( aValueCtrl, wxGBPosition( aRow, aCol + 1 ), wxGBSpan( 1, 1 ),
                                     wxALIGN_CENTER_VERTICAL | wxLEFT | wxEXPAND, 15 );
 
                aUnitsCtrl = new wxStaticText( this, wxID_ANY, _( "unit" ) );
                gbSizerEndings->Add( aUnitsCtrl, wxGBPosition( aRow, aCol + 2 ), wxGBSpan( 1, 1 ),
                                     wxALIGN_CENTER_VERTICAL | wxLEFT, 3 );
            };
 
    addEndingValue( 1, 0, _( "Length:" ), m_startLengthLabel, m_startLengthCtrl, m_startLengthUnits, wxRIGHT );
    addEndingValue( 1, 4, _( "Length:" ), m_endLengthLabel, m_endLengthCtrl, m_endLengthUnits, wxLEFT | wxRIGHT );
    addEndingValue( 2, 0, _( "Width:" ), m_startWidthLabel, m_startWidthCtrl, m_startWidthUnits, wxRIGHT );
    addEndingValue( 2, 4, _( "Width:" ), m_endWidthLabel, m_endWidthCtrl, m_endWidthUnits, wxLEFT | wxRIGHT );
    addEndingValue( 3, 0, _( "Thickness:" ), m_startThicknessLabel, m_startThicknessCtrl, m_startThicknessUnits,
                    wxRIGHT );
    addEndingValue( 3, 4, _( "Thickness:" ), m_endThicknessLabel, m_endThicknessCtrl, m_endThicknessUnits,
                    wxLEFT | wxRIGHT );
 
    gbSizerEndings->AddGrowableCol( 1 );
    gbSizerEndings->AddGrowableCol( 5 );
 
    m_endingsSizer->Add( gbSizerEndings, 0, wxEXPAND, 0 );
 
    m_endingsHelpLabel = new wxStaticText( this, wxID_ANY, wxEmptyString );
    m_endingsSizer->Add( m_endingsHelpLabel, 0, wxLEFT | wxRIGHT | wxTOP | wxBOTTOM, 10 );
 
    wxColour fg = wxSystemSettings::GetColour( wxSYS_COLOUR_WINDOWTEXT );
    wxSize   iconSize = GetTextExtent( wxT( "XXXXXX" ) );
 
    struct
    {
        wxString          name;
        LINE_ENDING_STYLE style;
    } shapeItems[] = {
        { _( "None" ),       LINE_ENDING_STYLE::NONE       },
        { _( "Arrow" ),      LINE_ENDING_STYLE::ARROW      },
        { _( "Open Arrow" ), LINE_ENDING_STYLE::ARROW_OPEN },
        { _( "Circle" ),     LINE_ENDING_STYLE::CIRCLE     },
        { _( "Square" ),     LINE_ENDING_STYLE::SQUARE     },
    };
 
    for( const auto& item : shapeItems )
    {
        wxBitmap startBmp = MakeLineEndingBitmap( item.style, iconSize, fg, this, false );
        wxBitmap endBmp = MakeLineEndingBitmap( item.style, iconSize, fg, this, true );
        m_startShapeChoice->Append( item.name, startBmp );
        m_endShapeChoice->Append( item.name, endBmp );
    }
 
    m_startShapeChoice->SetSelection( 0 );
    m_endShapeChoice->SetSelection( 0 );
 
    m_startLength = std::make_unique<UNIT_BINDER>( aParent, m_startLengthLabel, m_startLengthCtrl, m_startLengthUnits,
                                                   true );
    m_startWidth = std::make_unique<UNIT_BINDER>( aParent, m_startWidthLabel, m_startWidthCtrl, m_startWidthUnits,
                                                  true );
    m_startThickness = std::make_unique<UNIT_BINDER>( aParent, m_startThicknessLabel, m_startThicknessCtrl,
                                                      m_startThicknessUnits, true );
    m_endLength = std::make_unique<UNIT_BINDER>( aParent, m_endLengthLabel, m_endLengthCtrl, m_endLengthUnits, true );
    m_endWidth = std::make_unique<UNIT_BINDER>( aParent, m_endWidthLabel, m_endWidthCtrl, m_endWidthUnits, true );
    m_endThickness = std::make_unique<UNIT_BINDER>( aParent, m_endThicknessLabel, m_endThicknessCtrl,
                                                    m_endThicknessUnits, true );
}
 
 
DIALOG_LINE_PROPERTIES::DIALOG_LINE_PROPERTIES( SCH_EDIT_FRAME* aParent, std::deque<SCH_LINE*>& aLines ) :
        DIALOG_LINE_PROPERTIES_BASE( aParent ),
        m_frame( aParent ),
        m_lines( aLines ),
        m_width( aParent, m_staticTextWidth, m_lineWidth, m_staticWidthUnits, true )
{
    createLineEndingControls( aParent );
 
    m_colorSwatch->SetDefaultColor( COLOR4D::UNSPECIFIED );
 
    KIGFX::COLOR4D canvas = m_frame->GetColorSettings()->GetColor( LAYER_SCHEMATIC_BACKGROUND );
    m_colorSwatch->SetSwatchBackground( canvas.ToColour() );
 
    m_helpLabel1->SetFont( KIUI::GetInfoFont( this ).Italic() );
    m_helpLabel2->SetFont( KIUI::GetInfoFont( this ).Italic() );
 
    m_endingsHelpLabel->SetFont( KIUI::GetInfoFont( this ).Italic() );
    m_endingsHelpLabel->SetLabel( wxString::Format( _( "Set line ending sizes to 0 for automatic (%g\u00d7 line width)." ),
                                                    LINE_ENDING::DEFAULT_RATIO_LENGTH ) );
 
    SetInitialFocus( m_lineWidth );
 
    for( const auto& [ lineStyle, lineStyleDesc ] : lineTypeNames )
        m_typeCombo->Append( lineStyleDesc.name, KiBitmapBundle( lineStyleDesc.bitmap ) );
 
    SetupStandardButtons();
 
    // Now all widgets have the size fixed, call FinishDialogSettings
    finishDialogSettings();
}
 
 
bool DIALOG_LINE_PROPERTIES::TransferDataToWindow()
{
    SCH_LINE* first_stroke_item = m_lines.front();
 
    if( std::all_of( m_lines.begin() + 1, m_lines.end(),
            [&]( const SCH_LINE* r )
            {
                return r->GetStroke().GetWidth() == first_stroke_item->GetStroke().GetWidth();
            } ) )
    {
        m_width.SetValue( first_stroke_item->GetStroke().GetWidth() );
    }
    else
    {
        m_width.SetValue( INDETERMINATE_ACTION );
    }
 
    if( std::all_of( m_lines.begin() + 1, m_lines.end(),
            [&]( const SCH_LINE* r )
            {
                return r->GetStroke().GetColor() == first_stroke_item->GetStroke().GetColor();
            } ) )
    {
        m_colorSwatch->SetSwatchColor( first_stroke_item->GetStroke().GetColor(), false );
    }
    else
    {
        m_colorSwatch->SetIndeterminate();
    }
 
    if( std::all_of( m_lines.begin() + 1, m_lines.end(),
            [&]( const SCH_LINE* r )
            {
                return r->GetStroke().GetLineStyle() == first_stroke_item->GetStroke().GetLineStyle();
            } ) )
    {
        int style = static_cast<int>( first_stroke_item->GetStroke().GetLineStyle() );
 
        if( style >= 0 && style < (int) lineTypeNames.size() )
            m_typeCombo->SetSelection( style );
        else
            m_typeCombo->SetSelection( 0 );
    }
    else
    {
        m_typeCombo->Append( INDETERMINATE_STYLE );
        m_typeCombo->SetStringSelection( INDETERMINATE_STYLE );
    }
 
    // Line endings - Start Shape
    if( std::all_of( m_lines.begin() + 1, m_lines.end(),
                     [&]( const SCH_LINE* r )
                     {
                         return r->GetStartEndingStyle() == first_stroke_item->GetStartEndingStyle();
                     } ) )
    {
        m_startShapeChoice->SetSelection( LINE_ENDING::StyleToChoiceIndex( first_stroke_item->GetStartEndingStyle() ) );
    }
    else
    {
        m_startShapeChoice->Append( INDETERMINATE_STYLE );
        m_startShapeChoice->SetStringSelection( INDETERMINATE_STYLE );
    }
 
    // End Shape
    if( std::all_of( m_lines.begin() + 1, m_lines.end(),
                     [&]( const SCH_LINE* r )
                     {
                         return r->GetEndEndingStyle() == first_stroke_item->GetEndEndingStyle();
                     } ) )
    {
        m_endShapeChoice->SetSelection( LINE_ENDING::StyleToChoiceIndex( first_stroke_item->GetEndEndingStyle() ) );
    }
    else
    {
        m_endShapeChoice->Append( INDETERMINATE_STYLE );
        m_endShapeChoice->SetStringSelection( INDETERMINATE_STYLE );
    }
 
    // Start Length
    if( std::all_of( m_lines.begin() + 1, m_lines.end(),
                     [&]( const SCH_LINE* r )
                     {
                         return r->GetStartEndingLength() == first_stroke_item->GetStartEndingLength();
                     } ) )
    {
        m_startLength->SetValue( first_stroke_item->GetStartEndingLength() );
    }
    else
    {
        m_startLength->SetValue( INDETERMINATE_ACTION );
    }
 
    // Start Width
    if( std::all_of( m_lines.begin() + 1, m_lines.end(),
                     [&]( const SCH_LINE* r )
                     {
                         return r->GetStartEndingWidth() == first_stroke_item->GetStartEndingWidth();
                     } ) )
    {
        m_startWidth->SetValue( first_stroke_item->GetStartEndingWidth() );
    }
    else
    {
        m_startWidth->SetValue( INDETERMINATE_ACTION );
    }
 
    // Start Stroke Width
    if( std::all_of( m_lines.begin() + 1, m_lines.end(),
                     [&]( const SCH_LINE* r )
                     {
                         return r->GetStartEndingStrokeWidth() == first_stroke_item->GetStartEndingStrokeWidth();
                     } ) )
    {
        m_startThickness->SetValue( first_stroke_item->GetStartEndingStrokeWidth() );
    }
    else
    {
        m_startThickness->SetValue( INDETERMINATE_ACTION );
    }
 
    // End Length
    if( std::all_of( m_lines.begin() + 1, m_lines.end(),
                     [&]( const SCH_LINE* r )
                     {
                         return r->GetEndEndingLength() == first_stroke_item->GetEndEndingLength();
                     } ) )
    {
        m_endLength->SetValue( first_stroke_item->GetEndEndingLength() );
    }
    else
    {
        m_endLength->SetValue( INDETERMINATE_ACTION );
    }
 
    // End Width
    if( std::all_of( m_lines.begin() + 1, m_lines.end(),
                     [&]( const SCH_LINE* r )
                     {
                         return r->GetEndEndingWidth() == first_stroke_item->GetEndEndingWidth();
                     } ) )
    {
        m_endWidth->SetValue( first_stroke_item->GetEndEndingWidth() );
    }
    else
    {
        m_endWidth->SetValue( INDETERMINATE_ACTION );
    }
 
    // End Stroke Width
    if( std::all_of( m_lines.begin() + 1, m_lines.end(),
                     [&]( const SCH_LINE* r )
                     {
                         return r->GetEndEndingStrokeWidth() == first_stroke_item->GetEndEndingStrokeWidth();
                     } ) )
    {
        m_endThickness->SetValue( first_stroke_item->GetEndEndingStrokeWidth() );
    }
    else
    {
        m_endThickness->SetValue( INDETERMINATE_ACTION );
    }
 
    return true;
}
 
 
void DIALOG_LINE_PROPERTIES::resetDefaults( wxCommandEvent& event )
{
    m_width.SetValue( 0 );
    m_colorSwatch->SetSwatchColor( COLOR4D::UNSPECIFIED, false );
 
    m_typeCombo->SetStringSelection( DEFAULT_LINE_STYLE_LABEL );
 
    m_startShapeChoice->SetSelection( 0 );
    m_endShapeChoice->SetSelection( 0 );
    m_startLength->SetValue( 0 );
    m_startWidth->SetValue( 0 );
    m_startThickness->SetValue( 0 );
    m_endLength->SetValue( 0 );
    m_endWidth->SetValue( 0 );
    m_endThickness->SetValue( 0 );
 
    Refresh();
}
 
 
bool DIALOG_LINE_PROPERTIES::TransferDataFromWindow()
{
    SCH_COMMIT commit( m_frame );
 
    for( SCH_LINE* line : m_lines )
    {
        // Commit the change only if the line is not new. If new this is useless
        // and can create dangling pointers if the line creation is aborted
        if( !line->HasFlag( IS_NEW ) )
            commit.Modify( line, m_frame->GetScreen() );
 
        if( !m_width.IsIndeterminate() )
            line->SetLineWidth( std::max( 0, m_width.GetIntValue() ) );
 
        if( m_typeCombo->GetStringSelection() != INDETERMINATE_STYLE )
        {
            auto it = lineTypeNames.begin();
            std::advance( it, m_typeCombo->GetSelection() );
 
            if( it == lineTypeNames.end() )
                line->SetLineStyle( LINE_STYLE::DEFAULT );
            else
                line->SetLineStyle( it->first );
        }
 
        if( !m_colorSwatch->IsIndeterminate() )
            line->SetLineColor( m_colorSwatch->GetSwatchColor() );
 
        // Line endings
        if( m_startShapeChoice->GetStringSelection() != INDETERMINATE_STYLE )
        {
            int startSel = m_startShapeChoice->GetSelection();
 
            if( startSel >= 0 && startSel < LINE_ENDING::s_defaultChoiceCount )
                line->SetStartEndingStyle( LINE_ENDING::s_defaultChoiceOrder[startSel] );
        }
 
        if( m_endShapeChoice->GetStringSelection() != INDETERMINATE_STYLE )
        {
            int endSel = m_endShapeChoice->GetSelection();
 
            if( endSel >= 0 && endSel < LINE_ENDING::s_defaultChoiceCount )
                line->SetEndEndingStyle( LINE_ENDING::s_defaultChoiceOrder[endSel] );
        }
 
        if( !m_startLength->IsIndeterminate() )
            line->SetStartEndingLength( std::max( 0, m_startLength->GetIntValue() ) );
 
        if( !m_startWidth->IsIndeterminate() )
            line->SetStartEndingWidth( std::max( 0, m_startWidth->GetIntValue() ) );
 
        if( !m_startThickness->IsIndeterminate() )
            line->SetStartEndingStrokeWidth( std::max( 0, m_startThickness->GetIntValue() ) );
 
        if( !m_endLength->IsIndeterminate() )
            line->SetEndEndingLength( std::max( 0, m_endLength->GetIntValue() ) );
 
        if( !m_endWidth->IsIndeterminate() )
            line->SetEndEndingWidth( std::max( 0, m_endWidth->GetIntValue() ) );
 
        if( !m_endThickness->IsIndeterminate() )
            line->SetEndEndingStrokeWidth( std::max( 0, m_endThickness->GetIntValue() ) );
    }
 
    commit.Push( m_lines.size() == 1 ? _( "Edit Line" ) : _( "Edit Lines" ) );
    return true;
}