render_settings.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2019-2020 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 RENDER_SETTINGS_H
#define RENDER_SETTINGS_H

#include <map>
#include <set>

#include <gal/color4d.h>
#include <layer_ids.h>
#include <memory>

#include <wx/dc.h>

class COLOR_SETTINGS;

namespace KIGFX
{
class VIEW_ITEM;

class RENDER_SETTINGS
{
public:
 RENDER_SETTINGS();
 virtual ~RENDER_SETTINGS();

 virtual void LoadColors( const COLOR_SETTINGS* aSettings ) { }

 inline void SetLayerIsHighContrast( int aLayerId, bool aEnabled = true )
 {
 if( aEnabled )
 m_highContrastLayers.insert( aLayerId );
 else
 m_highContrastLayers.erase( aLayerId );
 }

 inline bool GetLayerIsHighContrast( int aLayerId ) const
 {
 return ( m_highContrastLayers.count( aLayerId ) > 0 );
 }

 const std::set<unsigned int> GetHighContrastLayers() const
 {
 return m_highContrastLayers;
 }

 PCB_LAYER_ID GetPrimaryHighContrastLayer() const
 {
 for( int layer : m_highContrastLayers )
 {
 if( layer >= PCBNEW_LAYER_ID_START && layer < PCB_LAYER_ID_COUNT )
 return (PCB_LAYER_ID) layer;
 }

 return UNDEFINED_LAYER;
 }

 PCB_LAYER_ID GetActiveLayer() const { return m_activeLayer; }
 void SetActiveLayer( PCB_LAYER_ID aLayer ) { m_activeLayer = aLayer; }

 inline void ClearHighContrastLayers()
 {
 m_highContrastLayers.clear();
 }

 inline bool IsHighlightEnabled() const
 {
 return m_highlightEnabled;
 }

 inline const std::set<int>& GetHighlightNetCodes() const
 {
 return m_highlightNetcodes;
 }

 inline void SetHighlight( bool aEnabled, int aNetcode = -1, bool aMulti = false )
 {
 m_highlightEnabled = aEnabled;

 if( aEnabled )
 {
 if( !aMulti )
 m_highlightNetcodes.clear();

 m_highlightNetcodes.insert( aNetcode );
 }
 else
 m_highlightNetcodes.clear();
 }

 inline void SetHighlight( std::set<int>& aHighlight, bool aEnabled = true )
 {
 m_highlightEnabled = aEnabled;

 if( aEnabled )
 m_highlightNetcodes = aHighlight;
 else
 m_highlightNetcodes.clear();
 }

 void SetHighContrast( bool aEnabled ) { m_hiContrastEnabled = aEnabled; }
 bool GetHighContrast() const { return m_hiContrastEnabled; }

 virtual COLOR4D GetColor( const VIEW_ITEM* aItem, int aLayer ) const = 0;

 float GetDrawingSheetLineWidth() const { return m_drawingSheetLineWidth; }

 int GetDefaultPenWidth() const { return m_defaultPenWidth; }
 void SetDefaultPenWidth( int aWidth ) { m_defaultPenWidth = aWidth; }

 int GetMinPenWidth() const { return m_minPenWidth; }
 void SetMinPenWidth( int aWidth ) { m_minPenWidth = aWidth; }

 bool GetShowPageLimits() const { return m_showPageLimits; }
 void SetShowPageLimits( bool aDraw ) { m_showPageLimits = aDraw; }

 bool IsPrinting() const { return m_isPrinting; }
 void SetIsPrinting( bool isPrinting ) { m_isPrinting = isPrinting; }

 virtual const COLOR4D& GetBackgroundColor() = 0;

 virtual void SetBackgroundColor( const COLOR4D& aColor ) = 0;

 virtual const COLOR4D& GetGridColor() = 0;

 virtual const COLOR4D& GetCursorColor() = 0;

 inline const COLOR4D& GetLayerColor( int aLayer ) const
 {
 return m_layerColors[aLayer];
 }

 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;
 }

 void SetOutlineWidth( float aWidth )
 {
 m_outlineWidth = aWidth;
 }

 void SetHighlightFactor( float aFactor ) { m_highlightFactor = aFactor; }
 void SetSelectFactor( float aFactor ) { m_selectFactor = aFactor; }
 void SetHighContrastFactor( float aFactor ) { m_hiContrastFactor = aFactor; }

 // TODO: these can go away once the drawing sheet is moved to Cairo-based printing
 wxDC* GetPrintDC() const { return m_printDC; }
 void SetPrintDC( wxDC* aDC ) { m_printDC = aDC; }

protected:
 virtual void update();

 PCB_LAYER_ID m_activeLayer; // The active layer (as shown by appearance mgr)
 std::set<unsigned int> m_highContrastLayers; // High-contrast layers (both board layers and
 // synthetic GAL layers)
 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

 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<int> m_highlightNetcodes; // Set of net cods to be highlighted
 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_drawingSheetLineWidth;// Line width used for borders and titleblock

 int m_defaultPenWidth;
 int m_minPenWidth; // Some clients (such as PDF) don't like ultra-thin
 // lines. This sets an absolute minimum.
 bool m_showPageLimits;
 bool m_isPrinting;

 wxDC* m_printDC; // This can go away once the drawing sheet is moved to
 // Cairo-based printing.
};

}

#endif /* RENDER_SETTINGS_H */