121 lines
4.7 KiB
C++
121 lines
4.7 KiB
C++
/*
|
|
* This program source code file is part of KiCad, a free EDA CAD application.
|
|
*
|
|
* Copyright (C) 2010-2016 Jean-Pierre Charras jp.charras at wanadoo.fr
|
|
* Copyright (C) 1992-2016 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
|
|
*/
|
|
|
|
#ifndef CLASS_GERBER_FILE_IMAGE_LIST_H
|
|
#define CLASS_GERBER_FILE_IMAGE_LIST_H
|
|
|
|
#include <vector>
|
|
#include <set>
|
|
|
|
#include <class_gerber_draw_item.h>
|
|
#include <class_aperture_macro.h>
|
|
|
|
/* gerber files have different parameters to define units and how items must be plotted.
|
|
* some are for the entire file, and other can change along a file.
|
|
* In Gerber world:
|
|
* an image is the entire gerber file and its "global" parameters
|
|
* a layer (that is very different from a board layer) is just a sub set of a file that
|
|
* have specific parameters
|
|
* if a Image parameter is set more than once, only the last value is used
|
|
* Some parameters can change along a file and are not layer specific: they are stored
|
|
* in GERBER_ITEM items, when instancied.
|
|
*
|
|
* In GerbView, to handle these parameters, there are 2 classes:
|
|
* GERBER_FILE_IMAGE : the main class containing most of parameters and data to plot a graphic layer
|
|
* Some of them can change along the file
|
|
* There is one GERBER_FILE_IMAGE per file and one graphic layer per file or GERBER_FILE_IMAGE
|
|
* GerbView does not read and merge 2 gerber file in one graphic layer:
|
|
* I believe this is not possible due to the constraints in Image parameters.
|
|
* GERBER_LAYER : containing the subset of parameters that is layer speficic
|
|
* A GERBER_FILE_IMAGE must include one GERBER_LAYER to define all parameters to plot a file.
|
|
* But a GERBER_FILE_IMAGE can use more than one GERBER_LAYER.
|
|
*/
|
|
|
|
class GERBER_FILE_IMAGE;
|
|
|
|
/**
|
|
* @brief GERBER_FILE_IMAGE_LIST is a helper class to handle a list of GERBER_FILE_IMAGE files
|
|
* which are loaded and can be displayed
|
|
* there are 32 images max which can be loaded
|
|
*/
|
|
class GERBER_FILE_IMAGE_LIST
|
|
{
|
|
// the list of loaded images (1 image = 1 gerber file)
|
|
std::vector<GERBER_FILE_IMAGE*> m_GERBER_List;
|
|
|
|
public:
|
|
GERBER_FILE_IMAGE_LIST();
|
|
~GERBER_FILE_IMAGE_LIST();
|
|
|
|
//Accessor
|
|
static GERBER_FILE_IMAGE_LIST& GetImagesList();
|
|
GERBER_FILE_IMAGE* GetGbrImage( int aIdx );
|
|
|
|
unsigned ImagesMaxCount() { return m_GERBER_List.size(); }
|
|
|
|
/**
|
|
* Add a GERBER_FILE_IMAGE* at index aIdx
|
|
* or at the first free location if aIdx < 0
|
|
* @param aGbrImage = the image to add
|
|
* @param aIdx = the location to use ( 0 ... GERBER_DRAWLAYERS_COUNT-1 )
|
|
* @return true if the index used, or -1 if no room to add image
|
|
*/
|
|
int AddGbrImage( GERBER_FILE_IMAGE* aGbrImage, int aIdx );
|
|
|
|
|
|
/**
|
|
* remove all loaded data in list, and delete all images. Memory is freed
|
|
*/
|
|
void DeleteAllImages();
|
|
|
|
/**
|
|
* delete the loaded data of image aIdx. Memory is freed
|
|
* @param aIdx = the index ( 0 ... GERBER_DRAWLAYERS_COUNT-1 )
|
|
*/
|
|
void DeleteImage( int aIdx );
|
|
|
|
/**
|
|
* @return a name for image aIdx which can be used in layers manager
|
|
* and layer selector or in the status bar
|
|
* if a file is loaded, the name is:
|
|
* "<aIdx+1> <short filename> <X2 FileFunction info> if a X2 FileFunction info is found"
|
|
* or (if no FileFunction info)
|
|
* "<aIdx+1> <short filename> *"
|
|
* if no file loaded, the name is:
|
|
* "Layer n" with n = aIdx+1
|
|
* @param aIdx = the index ( 0 ... GERBER_DRAWLAYERS_COUNT-1 )
|
|
* @param aNameOnly = false (default) to add the layer number (for layers manager)
|
|
* or true to return only the name without layer name (status bar)
|
|
*/
|
|
const wxString GetDisplayName( int aIdx, bool aNameOnly = false );
|
|
|
|
/**
|
|
* Sort loaded images by Z order priority, if they have the X2 FileFormat info
|
|
* (SortImagesByZOrder updates the graphic layer of these items)
|
|
*/
|
|
void SortImagesByZOrder();
|
|
};
|
|
|
|
#endif // ifndef CLASS_GERBER_FILE_IMAGE_LIST_H
|