edit_constraints.h

Go to the documentation of this file.

/*
 * This program source code file is part of KICAD, a free EDA CAD application.
 *
 * Copyright (C) 2014 CERN
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 *
 * @author Maciej Suminski <[email protected]>
 *
 * 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/>.
 */
 
#ifndef EDIT_CONSTRAINTS_H_
#define EDIT_CONSTRAINTS_H_
 
#include <math/vector2d.h>
#include <tool/grid_helper.h>
#include <functional>
 
class EDIT_POINT;
class EDIT_LINE;
class EDIT_POINTS;
 

enum class POLYGON_LINE_MODE
{
    CONVERGING,    
    FIXED_LENGTH   
};
 
 
enum GRID_CONSTRAINT_TYPE
{
    IGNORE_GRID,
    SNAP_TO_GRID,
    SNAP_BY_GRID    // Keep it on grid if it started on grid (treat x and y independently)
};
 
 
enum SNAP_CONSTRAINT_TYPE
{
    IGNORE_SNAPS,
    OBJECT_LAYERS,
    ALL_LAYERS
};
 

template<class EDIT_TYPE>
class EDIT_CONSTRAINT
{
public:
    EDIT_CONSTRAINT( EDIT_TYPE& aConstrained ) :
            m_constrained( aConstrained )
    {};
 
    virtual ~EDIT_CONSTRAINT() {};

    virtual void Apply( EDIT_TYPE& aHandle, const GRID_HELPER& aGrid ) = 0;

    void Apply( const GRID_HELPER& aGrid )
    {
        Apply( m_constrained, aGrid );
    }
 
protected:
    EDIT_TYPE& m_constrained;      
};
 

class EC_VERTICAL : public EDIT_CONSTRAINT<EDIT_POINT>
{
public:
    EC_VERTICAL( EDIT_POINT& aConstrained, const EDIT_POINT& aConstrainer ) :
            EDIT_CONSTRAINT<EDIT_POINT>( aConstrained ),
            m_constrainer( aConstrainer )
    {}

    virtual void Apply( EDIT_POINT& aHandle, const GRID_HELPER& aGrid ) override;
 
private:
    const EDIT_POINT& m_constrainer;      
};
 

class EC_HORIZONTAL : public EDIT_CONSTRAINT<EDIT_POINT>
{
public:
    EC_HORIZONTAL( EDIT_POINT& aConstrained, const EDIT_POINT& aConstrainer ) :
            EDIT_CONSTRAINT<EDIT_POINT>( aConstrained ),
            m_constrainer( aConstrainer )
    {}

    virtual void Apply( EDIT_POINT& aHandle, const GRID_HELPER& aGrid ) override;
 
private:
    const EDIT_POINT& m_constrainer;    
};
 

class EC_45DEGREE : public EDIT_CONSTRAINT<EDIT_POINT>
{
public:
    EC_45DEGREE( EDIT_POINT& aConstrained, const EDIT_POINT& aConstrainer ) :
            EDIT_CONSTRAINT<EDIT_POINT>( aConstrained ),
            m_constrainer( aConstrainer )
    {}

    virtual void Apply( EDIT_POINT& aHandle, const GRID_HELPER& aGrid ) override;
 
private:
    const EDIT_POINT& m_constrainer;    
};
 

class EC_90DEGREE : public EDIT_CONSTRAINT<EDIT_POINT>
{
public:
    EC_90DEGREE( EDIT_POINT& aConstrained, const EDIT_POINT& aConstrainer ) :
            EDIT_CONSTRAINT<EDIT_POINT>( aConstrained ),
            m_constrainer( aConstrainer )
    {};

    virtual void Apply( EDIT_POINT& aHandle, const GRID_HELPER& aGrid ) override;
 
private:
    const EDIT_POINT& m_constrainer;    
};

class EC_LINE : public EDIT_CONSTRAINT<EDIT_POINT>
{
public:
    EC_LINE( EDIT_POINT& aConstrained, const EDIT_POINT& aConstrainer );

    virtual void Apply( EDIT_POINT& aHandle, const GRID_HELPER& aGrid ) override;
 
    const EDIT_POINT& GetConstrainer() const { return m_constrainer; }
    VECTOR2I GetLineVector() const { return m_line; }
 
private:
    const EDIT_POINT& m_constrainer;    
    VECTOR2I m_line;                    
};
 

class EC_CIRCLE : public EDIT_CONSTRAINT<EDIT_POINT>
{
public:
    EC_CIRCLE( EDIT_POINT& aConstrained, const EDIT_POINT& aCenter, const EDIT_POINT& aEnd ) :
            EDIT_CONSTRAINT<EDIT_POINT>( aConstrained ),
            m_center( aCenter ),
            m_end( aEnd )
    {}

    virtual void Apply( EDIT_POINT& aHandle, const GRID_HELPER& aGrid ) override;
 
private:
    const EDIT_POINT& m_center;

    const EDIT_POINT& m_end;
};
 

class EC_CONVERGING : public EDIT_CONSTRAINT<EDIT_LINE>
{
public:
    EC_CONVERGING( EDIT_LINE& aLine, EDIT_POINTS& aPoints,
                   POLYGON_LINE_MODE aMode = POLYGON_LINE_MODE::CONVERGING );
 
    virtual ~EC_CONVERGING();

    virtual void Apply( EDIT_LINE& aHandle, const GRID_HELPER& aGrid ) override;

    POLYGON_LINE_MODE GetMode() const { return m_mode; }

    void SetMode( POLYGON_LINE_MODE aMode ) { m_mode = aMode; }

    const VECTOR2I& GetOriginalCenter() const { return m_originalCenter; }

    const VECTOR2I& GetPerpVector() const { return m_perpVector; }
 
private:
    void applyConverging( EDIT_LINE& aHandle );

    void applyFixedLength( EDIT_LINE& aHandle );

    POLYGON_LINE_MODE m_mode;

    std::unique_ptr<EDIT_CONSTRAINT<EDIT_POINT>> m_originSideConstraint;

    std::unique_ptr<EDIT_CONSTRAINT<EDIT_POINT>> m_endSideConstraint;

    EDIT_CONSTRAINT<EDIT_POINT>* m_colinearConstraint;

    EDIT_POINTS& m_editPoints;

    VECTOR2I m_draggedVector;

    VECTOR2I m_originalCenter;

    VECTOR2I m_perpVector;

    double m_halfLength;

    bool m_originCollinear;
    bool m_endCollinear;

    EDIT_POINT* m_prevOrigin;
    EDIT_POINT* m_nextEnd;

    VECTOR2I m_convergencePoint;

    VECTOR2I m_midVector;
};
 

class EC_PERPLINE : public EDIT_CONSTRAINT<EDIT_LINE>
{
public:
 
    EC_PERPLINE( EDIT_LINE& aLine );
 
    virtual ~EC_PERPLINE()
    {}

    virtual void Apply( EDIT_LINE& aHandle, const GRID_HELPER& aGrid ) override;
 
private:
    VECTOR2I m_mid;
    VECTOR2I m_line;
};
 
#endif /* EDIT_CONSTRAINTS_H_ */