klayout/src/laybasic/layStipplePalette.h

166 lines
3.9 KiB
C++

/*
KLayout Layout Viewer
Copyright (C) 2006-2017 Matthias Koefferlein
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, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef HDR_layStipplePalette
#define HDR_layStipplePalette
#include "laybasicCommon.h"
#include "layViewOp.h"
#include <vector>
#include <string>
namespace lay
{
class LAYBASIC_PUBLIC StipplePalette
{
public:
/**
* @brief Default constructor
*
* This initializes the palette with the standard stipples.
*/
StipplePalette ();
/**
* @brief Constructor from the data
*
* @param stipples The stipples as a vector
* @param standard The list of standard stipple indices as a vector
*/
StipplePalette (const std::vector<unsigned int> &stipples, const std::vector<unsigned int> &standard);
/**
* @brief Copy constructor
*/
StipplePalette (const StipplePalette &d);
/**
* @brief Assignment operator
*/
StipplePalette operator= (const StipplePalette &d);
/**
* @brief Equality operator
*/
bool operator== (const StipplePalette &d) const;
/**
* @brief Inequality operator
*/
bool operator!= (const StipplePalette &d) const
{
return ! operator== (d);
}
/**
* @brief Change a specific stipple
*/
void set_stipple (unsigned int n, unsigned int s);
/**
* @brief Clear the stipple list
*/
void clear_stipples ();
/**
* @brief Set a standard stipple index
*/
void set_standard_stipple_index (unsigned int n, unsigned int si);
/**
* @brief Clear the standard stipple list
*/
void clear_standard_stipples ();
/**
* @brief Retrieve the stipple by index
*/
unsigned int stipple_by_index (unsigned int n) const;
/**
* @brief Retrieve the number of stipples in the palette
*
* Warning: it is not guaranteed that this number is non-zero.
*/
unsigned int stipples () const;
/**
* @brief Retrieve the standard stipple by index
*/
unsigned int
standard_stipple_by_index (unsigned int n) const
{
return stipple_by_index (standard_stipple_index_by_index (n));
}
/**
* @brief Retrieve the standard stipple index by index (0 to standard_stipples()-1)
*
* The index returned is the index of the stipple referenced. The actual stipple
* can be obtained with stipple_by_index().
*/
unsigned int standard_stipple_index_by_index (unsigned int n) const;
/**
* @brief Retrieve the number of standard stipples in the palette
*
* The standard stipples are used for automatically selecting stipples for the
* layers for example. They are accessible by stipple index 0..st-1,
* where st is the number returned by this functions.
* Warning: it is not guaranteed that this number is non-zero.
*/
unsigned int standard_stipples () const;
/**
* @brief Conversion to a string
*/
std::string to_string () const;
/**
* @brief Conversion from a string
*
* This method will throw an exception if the string does not have a valid format
* like the one returned by the to_string method.
*/
void from_string (const std::string &s);
/**
* @brief Deliver the default palette
*/
static StipplePalette default_palette ();
private:
std::vector <unsigned int> m_stipples;
std::vector <unsigned int> m_standard;
};
}
#endif