212 lines
8.5 KiB
C++
212 lines
8.5 KiB
C++
/**************************/
|
|
/* class_aperture_macro.h */
|
|
/**************************/
|
|
|
|
#ifndef _APERTURE_MACRO_H_
|
|
#define _APERTURE_MACRO_H_
|
|
|
|
/*
|
|
* This program source code file is part of KICAD, a free EDA CAD application.
|
|
*
|
|
* Copyright (C) 1992-2010 Jean-Pierre Charras <jean-pierre.charras@gipsa-lab.inpg.fr>
|
|
* Copyright (C) 2010 SoftPLC Corporation, Dick Hollenbeck <dick@softplc.com>
|
|
* Copyright (C) 1992-2010 Kicad Developers, see change_log.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
|
|
*/
|
|
|
|
#include <vector>
|
|
#include <set>
|
|
|
|
#include "base_struct.h"
|
|
|
|
|
|
/**
|
|
* Enum AM_PRIMITIVE_ID
|
|
* is the set of all "aperture macro primitives" (primitive numbers). See
|
|
* Table 3 in http://gerbv.sourceforge.net/docs/rs274xrevd_e.pdf
|
|
* aperture macro primitives are basic shapes which can be combined to create a complex shape
|
|
* This complex shape is flashed.
|
|
*/
|
|
enum AM_PRIMITIVE_ID {
|
|
AMP_UNKNOWN = -1, // A value for uninitialized AM_PRIMITIVE.
|
|
AMP_COMMENT = 0, // A primitive description is not really a primitive, this is a comment
|
|
AMP_CIRCLE = 1, // Circle. (diameter and position)
|
|
AMP_LINE2 = 2, // Line with rectangle ends. (Width, start and end pos + rotation)
|
|
AMP_LINE20 = 20, // Same as AMP_LINE2
|
|
AMP_LINE_CENTER = 21, // Rectangle. (height, width and center pos + rotation)
|
|
AMP_LINE_LOWER_LEFT = 22, // Rectangle. (height, width and left bottom corner pos + rotation)
|
|
AMP_EOF = 3, // End Of File marquer: not really a shape
|
|
AMP_OUTLINE = 4, // Free polyline (n corners + rotation)
|
|
AMP_POLYGON = 5, // Closed regular polygon(diameter, number of vertices (3 to 10), rotation)
|
|
AMP_MOIRE = 6, // A cross hair with n concentric circles + rotation
|
|
AMP_THERMAL = 7 // Thermal shape (pos, outer and inner diameter, cross hair thickness + rotation)
|
|
};
|
|
|
|
|
|
/**
|
|
* Struct AM_PRIMITIVE
|
|
* holds an aperture macro primitive as given in Table 3 of
|
|
* http://gerbv.sourceforge.net/docs/rs274xrevd_e.pdf
|
|
*/
|
|
class AM_PRIMITIVE
|
|
{
|
|
public:
|
|
AM_PRIMITIVE_ID primitive_id; ///< The primitive type
|
|
DCODE_PARAMS params; ///< A sequence of parameters used by
|
|
// the primitive
|
|
bool m_GerbMetric; // units for this primitive:
|
|
// false = Inches, true = metric
|
|
|
|
public:
|
|
AM_PRIMITIVE( bool aGerbMetric, AM_PRIMITIVE_ID aId = AMP_UNKNOWN )
|
|
{
|
|
primitive_id = aId;
|
|
m_GerbMetric = aGerbMetric;
|
|
}
|
|
|
|
|
|
~AM_PRIMITIVE() {}
|
|
|
|
/**
|
|
* Function GetExposure
|
|
* returns the first parameter in integer form. Some but not all primitives
|
|
* use the first parameter as an exposure control.
|
|
*/
|
|
int GetExposure( GERBER_DRAW_ITEM* aParent ) const;
|
|
|
|
/**
|
|
* Function mapExposure
|
|
* translates the first parameter from an aperture macro into a current
|
|
* exposure setting.
|
|
* @param aParent = a GERBER_DRAW_ITEM that handle:
|
|
* ** m_Exposure A dynamic setting which can change throughout the
|
|
* reading of the gerber file, and it indicates whether the current tool
|
|
* is lit or not.
|
|
* ** m_ImageNegative A dynamic setting which can change throughout the reading
|
|
* of the gerber file, and it indicates whether the current D codes are to
|
|
* be interpreted as erasures or not.
|
|
* @return true to draw with current color, false to draw with alt color (erase)
|
|
*/
|
|
bool mapExposure( GERBER_DRAW_ITEM* aParent );
|
|
|
|
/* Draw functions: */
|
|
|
|
/** function DrawBasicShape
|
|
* Draw the primitive shape for flashed items.
|
|
* @param aParent = the parent GERBER_DRAW_ITEM which is actually drawn
|
|
* @param aClipBox = DC clip box (NULL is no clip)
|
|
* @param aDC = device context
|
|
* @param aColor = the normal color to use
|
|
* @param aAltColor = the color used to draw with "reverse" exposure mode (used in aperture macros only)
|
|
* @param aShapePos = the actual shape position
|
|
* @param aFilledShape = true to draw in filled mode, false to draw in skecth mode
|
|
*/
|
|
void DrawBasicShape( GERBER_DRAW_ITEM* aParent, EDA_Rect* aClipBox, wxDC* aDC,
|
|
int aColor, int aAltColor, wxPoint aShapePos, bool aFilledShape );
|
|
|
|
/** GetShapeDim
|
|
* Calculate a value that can be used to evaluate the size of text
|
|
* when displaying the D-Code of an item
|
|
* due to the complexity of the shape of some primitives
|
|
* one cannot calculate the "size" of a shape (only a bounding box)
|
|
* but here, the "dimension" of the shape is the diameter of the primitive
|
|
* or for lines the width of the line
|
|
* @param aParent = the parent GERBER_DRAW_ITEM which is actually drawn
|
|
* @return a dimension, or -1 if no dim to calculate
|
|
*/
|
|
int GetShapeDim( GERBER_DRAW_ITEM* aParent );
|
|
|
|
private:
|
|
|
|
/** function ConvertShapeToPolygon
|
|
* convert a shape to an equivalent polygon.
|
|
* Arcs and circles are approximated by segments
|
|
* Useful when a shape is not a graphic primitive (shape with hole,
|
|
* rotated shape ... ) and cannot be easily drawn.
|
|
*/
|
|
void ConvertShapeToPolygon( GERBER_DRAW_ITEM* aParent, std::vector<wxPoint>& aBuffer );
|
|
};
|
|
|
|
|
|
typedef std::vector<AM_PRIMITIVE> AM_PRIMITIVES;
|
|
|
|
/**
|
|
* Struct APERTURE_MACRO
|
|
* helps support the "aperture macro" defined within standard RS274X.
|
|
*/
|
|
struct APERTURE_MACRO
|
|
{
|
|
wxString name; ///< The name of the aperture macro
|
|
AM_PRIMITIVES primitives; ///< A sequence of AM_PRIMITIVEs
|
|
|
|
/** function DrawApertureMacroShape
|
|
* Draw the primitive shape for flashed items.
|
|
* When an item is flashed, this is the shape of the item
|
|
* @param aParent = the parent GERBER_DRAW_ITEM which is actually drawn
|
|
* @param aClipBox = DC clip box (NULL is no clip)
|
|
* @param aDC = device context
|
|
* @param aColor = the normal color to use
|
|
* @param aAltColor = the color used to draw with "reverse" exposure mode (used in aperture macros only)
|
|
* @param aShapePos = the actual shape position
|
|
* @param aFilledShape = true to draw in filled mode, false to draw in skecth mode
|
|
*/
|
|
void DrawApertureMacroShape( GERBER_DRAW_ITEM* aParent, EDA_Rect* aClipBox, wxDC* aDC,
|
|
int aColor, int aAltColor, wxPoint aShapePos, bool aFilledShape );
|
|
|
|
/** GetShapeDim
|
|
* Calculate a value that can be used to evaluate the size of text
|
|
* when displaying the D-Code of an item
|
|
* due to the complexity of a shape using many primitives
|
|
* one cannot calculate the "size" of a shape (only abounding box)
|
|
* but most of aperture macro are using one or few primitives
|
|
* and the "dimension" of the shape is the diameter of the primitive
|
|
* (or the max diameter of primitives)
|
|
* @param aParent = the parent GERBER_DRAW_ITEM which is actually drawn
|
|
* @return a dimension, or -1 if no dim to calculate
|
|
*/
|
|
int GetShapeDim( GERBER_DRAW_ITEM* aParent );
|
|
};
|
|
|
|
|
|
/**
|
|
* Struct APERTURE_MACRO_less_than
|
|
* is used by std:set<APERTURE_MACRO> instantiation which uses
|
|
* APERTURE_MACRO.name as its key.
|
|
*/
|
|
struct APERTURE_MACRO_less_than
|
|
{
|
|
// a "less than" test on two APERTURE_MACROs (.name wxStrings)
|
|
bool operator()( const APERTURE_MACRO& am1, const APERTURE_MACRO& am2 ) const
|
|
{
|
|
return am1.name.Cmp( am2.name ) < 0; // case specific wxString compare
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* Type APERTURE_MACRO_SET
|
|
* is a sorted collection of APERTURE_MACROS whose key is the name field in
|
|
* the APERTURE_MACRO.
|
|
*/
|
|
typedef std::set<APERTURE_MACRO, APERTURE_MACRO_less_than> APERTURE_MACRO_SET;
|
|
typedef std::pair<APERTURE_MACRO_SET::iterator, bool> APERTURE_MACRO_SET_PAIR;
|
|
|
|
|
|
#endif // ifndef _APERTURE_MACRO_H_
|