/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2013-2019 Jean-Pierre Charras, jp.charras at wanadoo.fr * Copyright (C) 1992-2019 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, 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 */ /** * @file worksheet_dataitem.h * @brief description of graphic items and texts to build a title block */ #ifndef WORKSHEET_DATA_ITEM_H #define WORKSHEET_DATA_ITEM_H #include #include #include #include #include "ws_draw_item.h" class WS_DRAW_ITEM_TEXT; // Forward declaration #define TB_DEFAULT_TEXTSIZE 1.5 // default worksheet text size in mm /** * A coordinate is relative to a page corner. * Any of the 4 corners can be a reference. * The default is the right bottom corner */ enum CORNER_ANCHOR { RB_CORNER, // right bottom corner RT_CORNER, // right top corner LB_CORNER, // left bottom corner LT_CORNER, // left top corner }; enum PAGE_OPTION { ALL_PAGES, FIRST_PAGE_ONLY, SUBSEQUENT_PAGES }; /** * A coordinate point * The position is always relative to the corner anchor * Note the coordinate is from the anchor point to the opposite corner. */ class POINT_COORD { public: DPOINT m_Pos; int m_Anchor; public: POINT_COORD() { m_Anchor = RB_CORNER; } POINT_COORD( DPOINT aPos, enum CORNER_ANCHOR aAnchor = RB_CORNER ) { m_Pos = aPos; m_Anchor = aAnchor; } }; /** * Work sheet structure type definitions. * Basic items are: * * segment and rect (defined by 2 points) * * text (defined by a coordinate), the text and its justifications * * poly polygon defined by a coordinate, and a set of list of corners * ( because we use it for logos, there are more than one polygon * in this description */ class WS_DATA_ITEM { public: enum WS_ITEM_TYPE { WS_TEXT, WS_SEGMENT, WS_RECT, WS_POLYPOLYGON, WS_BITMAP }; protected: WS_ITEM_TYPE m_type; PAGE_OPTION m_pageOption; std::vector m_drawItems; public: wxString m_Name; // a item name used in page layout // editor to identify items wxString m_Info; // a comment, only useful in page // layout editor POINT_COORD m_Pos; POINT_COORD m_End; double m_LineWidth; int m_RepeatCount; // repeat count for duplicate items DPOINT m_IncrementVector; // For duplicate items: move vector // for position increment int m_IncrementLabel; public: WS_DATA_ITEM( WS_ITEM_TYPE aType ); virtual ~WS_DATA_ITEM() {} const std::vector& GetDrawItems() const { return m_drawItems; } virtual void SyncDrawItems( WS_DRAW_ITEM_LIST* aCollector, KIGFX::VIEW* aView ); void SetStart( double aPosx, double aPosy, enum CORNER_ANCHOR aAnchor = RB_CORNER ) { m_Pos.m_Pos.x = aPosx; m_Pos.m_Pos.y = aPosy; m_Pos.m_Anchor = aAnchor; } void SetEnd( double aPosx, double aPosy, enum CORNER_ANCHOR aAnchor = RB_CORNER ) { m_End.m_Pos.x = aPosx; m_End.m_Pos.y = aPosy; m_End.m_Anchor = aAnchor; } // Accessors: WS_ITEM_TYPE GetType() const { return m_type; } /** * @return true if the item has a end point (segment; rect) * of false (text, polugon) */ PAGE_OPTION GetPage1Option() const { return m_pageOption; } void SetPage1Option( PAGE_OPTION aChoice ) { m_pageOption = aChoice; } // Coordinate handling const wxPoint GetStartPosUi( int ii = 0 ) const; const wxPoint GetEndPosUi( int ii = 0 ) const; const DPOINT GetStartPos( int ii = 0 ) const; const DPOINT GetEndPos( int ii = 0 ) const; virtual int GetPenSizeUi(); /** * move item to a new position * @param aPosition = the new position of item, in mm */ void MoveTo( DPOINT aPosition ); /** * move item to a new position * @param aPosition = the new position of the starting point in graphic units */ void MoveToUi( wxPoint aPosition ); /** * move the starting point of the item to a new position * @param aPosition = the new position of the starting point, in mm */ void MoveStartPointTo( DPOINT aPosition ); /** * move the starting point of the item to a new position * @param aPosition = the new position of item in graphic units */ void MoveStartPointToUi( wxPoint aPosition ); /** * move the ending point of the item to a new position * has meaning only for items defined by 2 points * (segments and rectangles) * @param aPosition = the new position of the ending point, in mm */ void MoveEndPointTo( DPOINT aPosition ); /** * move the ending point of the item to a new position * has meaning only for items defined by 2 points * (segments and rectangles) * @param aPosition = the new position of the ending point in graphic units */ void MoveEndPointToUi( wxPoint aPosition ); /** * @return true if the item is inside the rectangle defined by the * 4 corners, false otherwise. */ virtual bool IsInsidePage( int ii ) const; const wxString GetClassName() const; }; class WS_DATA_ITEM_POLYGONS : public WS_DATA_ITEM { public: double m_Orient; // Orientation in degrees std::vector m_Corners; // corner list private: std::vector m_polyIndexEnd; // index of the last point of each polygon DPOINT m_minCoord; // min coord of corners, relative to m_Pos DPOINT m_maxCoord; // max coord of corners, relative to m_Pos public: WS_DATA_ITEM_POLYGONS( ); void SyncDrawItems( WS_DRAW_ITEM_LIST* aCollector, KIGFX::VIEW* aView ) override; virtual int GetPenSizeUi() override; /** * add a corner in corner list * @param aCorner: the item to append */ void AppendCorner( const DPOINT& aCorner ) { m_Corners.push_back( aCorner ); } /** * Closes the current contour, by storing the index of the last corner * of the current polygon in m_polyIndexEnd. */ void CloseContour() { m_polyIndexEnd.push_back( m_Corners.size() -1 ); } /** * @return the count of contours in the poly polygon */ int GetPolyCount() const { return (int) m_polyIndexEnd.size(); } /** * @return the index of the first corner of the contour aCountour * @param aContour = the index of the contour */ unsigned GetPolyIndexStart( unsigned aContour) const { if( aContour == 0 ) return 0; else return m_polyIndexEnd[aContour-1] + 1; } /** * @return the index of the last corner of the contour aCountour * @param aContour = the index of the contour */ unsigned GetPolyIndexEnd( unsigned aContour) const { return m_polyIndexEnd[aContour]; } /** * @return the coordinate (in mm) of the corner aIdx, * for the repeated item aRepeat */ const DPOINT GetCornerPosition( unsigned aIdx, int aRepeat = 0 ) const; /** * @return the coordinate (in draw/plot units) of the corner aIdx, * for the repeated item aRepeat */ const wxPoint GetCornerPositionUi( unsigned aIdx, int aRepeat = 0 ) const; /** * calculate the bounding box of the set polygons */ void SetBoundingBox(); bool IsInsidePage( int ii ) const override; }; class WS_DATA_ITEM_TEXT : public WS_DATA_ITEM { public: wxString m_TextBase; // The basic text, with format symbols wxString m_FullText; // The expanded text, shown on screen double m_Orient; // Orientation in degrees EDA_TEXT_HJUSTIFY_T m_Hjustify; EDA_TEXT_VJUSTIFY_T m_Vjustify; bool m_Italic; bool m_Bold; DSIZE m_TextSize; DSIZE m_BoundingBoxSize; // When not null, this is the max // size of the full text. // the text size will be modified // to keep the full text insite this // bound. DSIZE m_ConstrainedTextSize; // Actual text size, if constrained by // the m_BoundingBoxSize constraint public: WS_DATA_ITEM_TEXT( const wxString& aTextBase ); void SyncDrawItems( WS_DRAW_ITEM_LIST* aCollector, KIGFX::VIEW* aView ) override; virtual int GetPenSizeUi() override; /** * move item to a new position * @param aPosition = the new position of item */ void MoveTo( DPOINT aPosition ); /** * Try to build text wihich is an increment of m_TextBase * has meaning only if m_TextBase is a basic text (one char) * If the basic char is a digit, build a number * If the basic char is a letter, use the letter with ascii code * aIncr + (basic char ascc code) * @param aIncr = the increment value * return the incremented label in m_FullText */ void IncrementLabel( int aIncr ); /** * Calculates m_ConstrainedTextSize from m_TextSize * to keep the X size and the full Y size of the text * smaller than m_BoundingBoxSize * if m_BoundingBoxSize.x or m_BoundingBoxSize.y > 0 * if m_BoundingBoxSize.x or m_BoundingBoxSize.y == 0 * the corresponding text size is not constrained */ void SetConstrainedTextSize(); /** Replace the '\''n' sequence by EOL * and the sequence '\''\' by only one '\' * inside m_FullText * @return true if the EOL symbol is found or is inserted (multiline text) */ bool ReplaceAntiSlashSequence(); }; class BITMAP_BASE; class WS_DATA_ITEM_BITMAP : public WS_DATA_ITEM { public: BITMAP_BASE* m_ImageBitmap; public: WS_DATA_ITEM_BITMAP(BITMAP_BASE* aImage) : WS_DATA_ITEM( WS_BITMAP ) { m_ImageBitmap = aImage; } void SyncDrawItems( WS_DRAW_ITEM_LIST* aCollector, KIGFX::VIEW* aView ) override; int GetPPI() const; void SetPPI( int aBitmapPPI ); }; #endif // WORKSHEET_DATA_ITEM_H