/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2019 KiCad Developers, see CHANGELOG.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 RENDER_SETTINGS_H #define RENDER_SETTINGS_H #include #include #include #include #include class EDA_ITEM; class COLOR_SETTINGS; namespace KIGFX { class VIEW_ITEM; /** * RENDER_SETTINGS * Contains all the knowledge about how graphical objects are drawn on any output * surface/device. This includes: * - color/transparency settings * - highlighting and high contrast mode control * - drawing quality control (sketch/outline mode) * - text processing flags * The class acts as an interface between the PAINTER object and the GUI (i.e. Layers/Items * widget or display options dialog). */ class RENDER_SETTINGS { public: RENDER_SETTINGS(); virtual ~RENDER_SETTINGS(); virtual void LoadColors( const COLOR_SETTINGS* aSettings ) { } /** * Function SetActiveLayer * Sets the specified layer as active - it means that it can be drawn in a specific mode * (eg. highlighted, so it differs from other layers). * @param aLayerId is a layer number that should be displayed in a specific mode. * @param aEnabled is the new layer state ( true = active or false = not active). */ inline void SetActiveLayer( int aLayerId, bool aEnabled = true ) { if( aEnabled ) m_activeLayers.insert( aLayerId ); else m_activeLayers.erase( aLayerId ); } /** * Function GetActiveLayers() * Returns the set of currently active layers. * @return The set of currently active layers. */ const std::set GetActiveLayers() { return m_activeLayers; } /** * Function ClearActiveLayers * Clears the list of active layers. */ inline void ClearActiveLayers() { m_activeLayers.clear(); } /** * Function IsActiveLayer * Returns information whether the queried layer is marked as active. * @return True if the queried layer is marked as active. */ inline bool IsActiveLayer( int aLayerId ) const { return ( m_activeLayers.count( aLayerId ) > 0 ); } /** * Function IsHighlightEnabled * Returns current highlight setting. * @return True if highlight is enabled, false otherwise. */ inline bool IsHighlightEnabled() const { return m_highlightEnabled; } /** * Function GetHighlightNetCode * Returns netcode of currently highlighted net. * @return Netcode of currently highlighted net. */ inline const std::set& GetHighlightNetCodes() const { return m_highlightNetcodes; } /** * Function SetHighlight * Turns on/off highlighting - it may be done for the active layer, the specified net, or * items with their HIGHLIGHTED flags set. * @param aEnabled tells if highlighting should be enabled. * @param aNetcode is optional and if specified, turns on higlighting only for the net with * number given as the parameter. */ inline void SetHighlight( bool aEnabled, int aNetcode = -1, bool aHighlightItems = false, bool aMulti = false ) { m_highlightEnabled = aEnabled; if( aEnabled ) { if( !aMulti ) m_highlightNetcodes.clear(); m_highlightNetcodes.insert( aNetcode ); } else m_highlightNetcodes.clear(); m_highlightItems = aEnabled ? aHighlightItems : false; } /** * Function SetHighContrast * Turns on/off high contrast display mode. */ void SetHighContrast( bool aEnabled ) { m_hiContrastEnabled = aEnabled; } bool GetHighContrast() const { return m_hiContrastEnabled; } /** * Function GetColor * Returns the color that should be used to draw the specific VIEW_ITEM on the specific layer * using currently used render settings. * @param aItem is the VIEW_ITEM. * @param aLayer is the layer. * @return The color. */ virtual const COLOR4D& GetColor( const VIEW_ITEM* aItem, int aLayer ) const = 0; float GetWorksheetLineWidth() const { return m_worksheetLineWidth; } int GetDefaultPenWidth() const { return m_defaultPenWidth; } void SetDefaultPenWidth( int aWidth ) { m_defaultPenWidth = aWidth; } bool GetShowPageLimits() const { return m_showPageLimits; } void SetShowPageLimits( bool aDraw ) { m_showPageLimits = aDraw; } /** * Function GetBackgroundColor * Returns current background color settings. */ virtual const COLOR4D& GetBackgroundColor() = 0; /** * Sets the background color. */ virtual void SetBackgroundColor( const COLOR4D& aColor ) = 0; /** * Function GetGridColor * Returns current grid color settings. */ virtual const COLOR4D& GetGridColor() = 0; /** * Function GetCursorColor * Returns current cursor color settings. */ virtual const COLOR4D& GetCursorColor() = 0; /** * Function GetLayerColor * Returns the color used to draw a layer. * @param aLayer is the layer number. */ inline const COLOR4D& GetLayerColor( int aLayer ) const { return m_layerColors[aLayer]; } /** * Function SetLayerColor * Changes the color used to draw a layer. * @param aLayer is the layer number. * @param aColor is the new color. */ inline void SetLayerColor( int aLayer, const COLOR4D& aColor ) { m_layerColors[aLayer] = aColor; update(); // recompute other shades of the color } virtual bool IsBackgroundDark() const { return false; } /** * Set line width used for drawing outlines. * * @param aWidth is the new width. */ void SetOutlineWidth( float aWidth ) { m_outlineWidth = aWidth; } // TODO: these can go away once we have Cairo-based printing wxDC* GetPrintDC() { return m_printDC; } void SetPrintDC( wxDC* aDC ) { m_printDC = aDC; } protected: /** * Function update * Precalculates extra colors for layers (e.g. highlighted, darkened and any needed version * of base colors). */ virtual void update(); std::set m_activeLayers; ///< Stores active layers number COLOR4D m_layerColors[LAYER_ID_COUNT]; // Layer colors COLOR4D m_layerColorsHi[LAYER_ID_COUNT]; // Layer colors for highlighted objects COLOR4D m_layerColorsSel[LAYER_ID_COUNT]; // Layer colors for selected objects COLOR4D m_hiContrastColor[LAYER_ID_COUNT]; // High-contrast mode layer colors COLOR4D m_layerColorsDark[LAYER_ID_COUNT]; // Darkened layer colors (for high-contrast mode) COLOR4D m_backgroundColor; // The background color /// Parameters for display modes bool m_hiContrastEnabled; // High contrast display mode on/off float m_hiContrastFactor; // Factor used for computing high contrast color bool m_highlightEnabled; // Highlight display mode on/off std::set m_highlightNetcodes; // Set of net cods to be highlighted bool m_highlightItems; // Highlight items with their HIGHLIGHT flags set float m_highlightFactor; // Factor used for computing highlight color float m_selectFactor; // Specifies how color of selected items is changed float m_outlineWidth; // Line width used when drawing outlines float m_worksheetLineWidth; // Line width used when drawing worksheet int m_defaultPenWidth; bool m_showPageLimits; wxDC* m_printDC; // This can go away once we have Cairo-based printing. }; } #endif /* RENDER_SETTINGS_H */