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();
 }
 
 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 */