graphics_importer.h

Go to the documentation of this file.

/*
 * This program source code file is part of KICAD, a free EDA CAD application.
 *
 * Copyright (C) 2016 CERN
 * Copyright (C) 2019-2023 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, you may find one here:
 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 * or you may search the http://www.gnu.org website for the version 2 license,
 * or you may write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
 */
 
#ifndef GRAPHICS_IMPORTER_H
#define GRAPHICS_IMPORTER_H
 
#include "graphics_import_mgr.h"
#include "graphics_import_plugin.h"
 
#include <eda_text.h>
#include <math/vector2d.h>
#include <gal/color4d.h>
#include <stroke_params.h>
 
#include <list>
#include <memory>
#include <vector>
 
class EDA_ITEM;
 
class IMPORTED_STROKE
{
public:
    IMPORTED_STROKE( double aWidth = 0, LINE_STYLE aPlotStyle = LINE_STYLE::DEFAULT,
                     const KIGFX::COLOR4D& aColor = KIGFX::COLOR4D::UNSPECIFIED ) :
            m_width( aWidth ),
            m_plotstyle( aPlotStyle ), m_color( aColor )
    {
    }
 
    double GetWidth() const { return m_width; }
    void   SetWidth( double aWidth ) { m_width = aWidth; }
 
    LINE_STYLE GetPlotStyle() const { return m_plotstyle; }
    void       SetPlotStyle( LINE_STYLE aPlotStyle ) { m_plotstyle = aPlotStyle; }
 
    KIGFX::COLOR4D GetColor() const { return m_color; }
    void           SetColor( const KIGFX::COLOR4D& aColor ) { m_color = aColor; }
 
private:
    double         m_width;
    LINE_STYLE     m_plotstyle;
    KIGFX::COLOR4D m_color;
};
 
class GRAPHICS_IMPORTER
{
public:
    enum POLY_FILL_RULE
    {
        PF_NONZERO = 0,
        PF_EVEN_ODD
    };
 
    GRAPHICS_IMPORTER();
 
    virtual ~GRAPHICS_IMPORTER()
    {
    }
 
    void SetPlugin( std::unique_ptr<GRAPHICS_IMPORT_PLUGIN> aPlugin )
    {
        m_plugin = std::move( aPlugin );
 
        if( m_plugin )
            m_plugin->SetImporter( this );
    }
 
    bool Load( const wxString& aFileName );
 
 
    bool Import( const VECTOR2D& aScale = VECTOR2D( 1.0, 1.0 ) );
 
    const wxString& GetMessages() const
    {
        return m_plugin->GetMessages();
    }
 
    void ReportMsg( const wxString& aMessage )
    {
        m_plugin->ReportMsg( aMessage );
    }
 
    double GetImageWidthMM() const
    {
        return m_originalWidth;
    }
 
    double GetImageHeightMM() const
    {
        return m_originalHeight;
    }
 
    void SetLineWidthMM( double aWidth )
    {
        m_lineWidth = aWidth;
    }
 
    double GetLineWidthMM() const
    {
        return m_lineWidth;
    }
 
    VECTOR2D GetScale() const
    {
        return m_scale;
    }
 
    const VECTOR2D& GetImportOffsetMM() const
    {
        return m_offsetCoordmm;
    }
 
    void SetImportOffsetMM( const VECTOR2D& aOffset )
    {
        m_offsetCoordmm = aOffset;
    }
 
    void SetScale( const VECTOR2D& aScale )
    {
        m_scale = aScale;
    }
 
    double GetMillimeterToIuFactor()
    {
        return m_millimeterToIu;
    }
 
    VECTOR2D ImportScalingFactor() const
    {
        return m_scale * m_millimeterToIu;
    }
 
    std::list<std::unique_ptr<EDA_ITEM>>& GetItems()
    {
        return m_items;
    }
 
    void ClearItems()
    {
        m_items.clear();
    }
 
    static constexpr unsigned int DEFAULT_LINE_WIDTH_DFX = 1;
 
    virtual void NewShape( POLY_FILL_RULE aFillRule = PF_NONZERO );
 
    virtual void AddLine( const VECTOR2D& aOrigin, const VECTOR2D& aEnd,
                          const IMPORTED_STROKE& aStroke ) = 0;
 
    virtual void AddCircle( const VECTOR2D& aCenter, double aRadius, const IMPORTED_STROKE& aStroke,
                            bool aFilled, const COLOR4D& aFillColor ) = 0;
 
    virtual void AddArc( const VECTOR2D& aCenter, const VECTOR2D& aStart, const EDA_ANGLE& aAngle,
                         const IMPORTED_STROKE& aStroke ) = 0;
 
    virtual void AddPolygon( const std::vector<VECTOR2D>& aVertices, const IMPORTED_STROKE& aStroke,
                             bool aFilled, const COLOR4D& aFillColor ) = 0;
 
    virtual void AddText( const VECTOR2D& aOrigin, const wxString& aText, double aHeight,
                          double aWidth, double aThickness, double aOrientation,
                          GR_TEXT_H_ALIGN_T aHJustify, GR_TEXT_V_ALIGN_T aVJustify,
                          const COLOR4D& aColor ) = 0;
 
    virtual void AddSpline( const VECTOR2D& aStart, const VECTOR2D& aBezierControl1,
                            const VECTOR2D& aBezierControl2, const VECTOR2D& aEnd,
                            const IMPORTED_STROKE& aStroke ) = 0;
 
protected:
    void addItem( std::unique_ptr<EDA_ITEM> aItem )
    {
        m_items.emplace_back( std::move( aItem ) );
    }
 
    double m_millimeterToIu;
 
    VECTOR2D m_offsetCoordmm;
 
    std::vector<POLY_FILL_RULE> m_shapeFillRules;
 
private:
    std::list<std::unique_ptr<EDA_ITEM>> m_items;
 
    std::unique_ptr<GRAPHICS_IMPORT_PLUGIN> m_plugin;
 
    double m_originalWidth;
 
    double m_originalHeight;
 
    VECTOR2D m_scale;
 
    double m_lineWidth;
};
 
#endif /* GRAPHICS_IMPORTER_H */