KiCad PCB EDA Suite
Loading...
Searching...
No Matches
panel_color_settings.cpp
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright (C) 2020 Jon Evans <[email protected]>
5 * Copyright (C) 2020-2023 KiCad Developers, see AUTHORS.txt for contributors.
6 *
7 * This program is free software: you can redistribute it and/or modify it
8 * under the terms of the GNU General Public License as published by the
9 * Free Software Foundation, either version 3 of the License, or (at your
10 * option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License along
18 * with this program. If not, see <http://www.gnu.org/licenses/>.
19 */
20
21#include <bitmaps.h>
22#include <launch_ext.h>
23#include <layer_ids.h>
25#include <pgm_base.h>
29#include <validators.h>
31#include <widgets/wx_panel.h>
32
33#include <wx/msgdlg.h>
34#include <wx/textdlg.h>
35
36// Button ID starting point
37constexpr int FIRST_BUTTON_ID = 1800;
38
39
42 m_currentSettings( nullptr ),
43 m_swatches(),
44 m_copied( COLOR4D::UNSPECIFIED ),
45 m_validLayers(),
46 m_backgroundLayer( LAYER_PCB_BACKGROUND ),
47 m_colorNamespace()
48{
49#ifdef __APPLE__
50 m_btnOpenFolder->SetLabel( _( "Reveal Themes in Finder" ) );
51
52 // Simple border is too dark on OSX
53 m_colorsListWindow->SetWindowStyle( wxBORDER_SUNKEN|wxVSCROLL );
54#endif
55
56 m_panel1->SetBorders( false, false, true, false );
57}
58
59
61{
63 LaunchExternal( dir );
64}
65
66
68{
70 return;
71
72 for( const std::pair<const int, COLOR_SWATCH*>& pair : m_swatches )
73 {
74 int layer = pair.first;
75 COLOR_SWATCH* button = pair.second;
76
77 COLOR4D defaultColor = m_currentSettings->GetDefaultColor( layer );
78
79 m_currentSettings->SetColor( layer, defaultColor );
80 button->SetSwatchColor( defaultColor, false );
81 }
82}
83
84
86{
87 if( show )
88 {
89 // In case changes have been made to the current theme in another panel:
90 int idx = m_cbTheme->GetSelection();
91 COLOR_SETTINGS* settings = static_cast<COLOR_SETTINGS*>( m_cbTheme->GetClientData( idx ) );
92
93 if( settings )
94 *m_currentSettings = *settings;
95
98 }
99
100 return PANEL_COLOR_SETTINGS_BASE::Show( show );
101}
102
103
104void PANEL_COLOR_SETTINGS::OnLeftDownTheme( wxMouseEvent& event )
105{
106 // Lazy rebuild of theme menu to catch any colour theme changes made in other panels
108
109 event.Skip();
110}
111
112
113void PANEL_COLOR_SETTINGS::OnThemeChanged( wxCommandEvent& event )
114{
115 int idx = m_cbTheme->GetSelection();
116
117 if( idx == static_cast<int>( m_cbTheme->GetCount() ) - 2 )
118 {
119 m_cbTheme->SetStringSelection( GetSettingsDropdownName( m_currentSettings ) );
120 return;
121 }
122
123 if( idx == (int)m_cbTheme->GetCount() - 1 )
124 {
125 // New Theme...
126
127 if( !saveCurrentTheme( false ) )
128 return;
129
130 FOOTPRINT_NAME_VALIDATOR themeNameValidator;
131 wxTextEntryDialog dlg( this, _( "New theme name:" ), _( "Add Color Theme" ) );
132 dlg.SetTextValidator( themeNameValidator );
133
134 if( dlg.ShowModal() != wxID_OK )
135 return;
136
137 wxString themeName = dlg.GetValue();
138 wxFileName fn( themeName + wxT( ".json" ) );
140
141 if( fn.Exists() )
142 {
143 wxMessageBox( _( "Theme already exists!" ) );
144 return;
145 }
146
147 SETTINGS_MANAGER& settingsMgr = Pgm().GetSettingsManager();
148 COLOR_SETTINGS* newSettings = settingsMgr.AddNewColorSettings( themeName );
149 newSettings->SetName( themeName );
150 newSettings->SetReadOnly( false );
151
152 for( int layer : m_validLayers )
153 newSettings->SetColor( layer, m_currentSettings->GetColor( layer ) );
154
155 newSettings->SaveToFile( settingsMgr.GetPathForSettingsFile( newSettings ) );
156
157 idx = m_cbTheme->Insert( themeName, idx - 1, static_cast<void*>( newSettings ) );
158 m_cbTheme->SetSelection( idx );
159
160 m_optOverrideColors->SetValue( newSettings->GetOverrideSchItemColors() );
161 m_optOverrideColors->Enable( !newSettings->IsReadOnly() );
162
163 *m_currentSettings = *newSettings;
166 }
167 else
168 {
169 COLOR_SETTINGS* selected = static_cast<COLOR_SETTINGS*>( m_cbTheme->GetClientData( idx ) );
170
171 if( selected->GetFilename() != m_currentSettings->GetFilename() )
172 {
173 if( !saveCurrentTheme( false ) )
174 return;
175
176 m_optOverrideColors->SetValue( selected->GetOverrideSchItemColors() );
177 m_optOverrideColors->Enable( !selected->IsReadOnly() );
178
179 *m_currentSettings = *selected;
182 }
183 }
184}
185
186
188{
189 if( m_swatches.empty() )
190 {
192 }
193 else
194 {
195 bool isReadOnly = m_currentSettings->IsReadOnly();
197
198 for( std::pair<int, COLOR_SWATCH*> pair : m_swatches )
199 {
200 pair.second->SetSwatchBackground( background );
201 pair.second->SetSwatchColor( m_currentSettings->GetColor( pair.first ), false );
202 pair.second->SetReadOnly( isReadOnly );
203 }
204 }
205}
206
207
208void PANEL_COLOR_SETTINGS::createThemeList( const wxString& aCurrent )
209{
210 int width = 0;
211 int height = 0;
212
213 m_cbTheme->GetTextExtent( _( "New Theme..." ), &width, &height );
214 int minwidth = width;
215
216 m_cbTheme->Clear();
217
218 for( COLOR_SETTINGS* settings : Pgm().GetSettingsManager().GetColorSettingsList() )
219 {
220 wxString name = GetSettingsDropdownName( settings );
221
222 int pos = m_cbTheme->Append( name, static_cast<void*>( settings ) );
223
224 if( settings->GetFilename() == aCurrent )
225 m_cbTheme->SetSelection( pos );
226
227 m_cbTheme->GetTextExtent( name, &width, &height );
228 minwidth = std::max( minwidth, width );
229 }
230
231 m_cbTheme->Append( wxT( "---" ) );
232 m_cbTheme->Append( _( "New Theme..." ) );
233
234 m_cbTheme->SetMinSize( wxSize( minwidth + 50, -1 ) );
235}
236
237
238void PANEL_COLOR_SETTINGS::createSwatch( int aLayer, const wxString& aName )
239{
240 wxStaticText* label = new wxStaticText( m_colorsListWindow, wxID_ANY, aName );
241
242 // The previously selected theme can be deleted and cannot be selected.
243 // so select the default theme (first theme of the list)
244 if( m_cbTheme->GetSelection() < 0 )
245 {
246 m_cbTheme->SetSelection( 0 );
248 }
249
250 void* clientData = m_cbTheme->GetClientData( m_cbTheme->GetSelection() );
251 COLOR_SETTINGS* selected = static_cast<COLOR_SETTINGS*>( clientData );
252
253 int id = FIRST_BUTTON_ID + aLayer;
254 COLOR4D defaultColor = selected->GetDefaultColor( aLayer );
257
258 COLOR_SWATCH* swatch = new COLOR_SWATCH( m_colorsListWindow, color, id, backgroundColor,
259 defaultColor, SWATCH_MEDIUM );
260 swatch->SetForegroundColour( wxSystemSettings::GetColour( wxSYS_COLOUR_WINDOW ) );
261
262 // Display the swatches in the left column and the layer name in the right column
263 // The right column is sometimes (depending on the translation) truncated for long texts.
264 // We cannot allow swatches to be truncated or not shown
265 m_colorsGridSizer->Add( swatch, 0, wxALIGN_CENTER_VERTICAL | wxALL, 3 );
266 m_colorsGridSizer->Add( label, 0, wxALIGN_CENTER_VERTICAL | wxALIGN_LEFT | wxLEFT, 5 );
267
268 m_labels[aLayer] = label;
269 m_swatches[aLayer] = swatch;
270
271 swatch->Bind( wxEVT_RIGHT_DOWN,
272 [&, aLayer]( wxMouseEvent& aEvent )
273 {
274 ShowColorContextMenu( aEvent, aLayer );
275 } );
276
277 swatch->Bind( COLOR_SWATCH_CHANGED, &PANEL_COLOR_SETTINGS::OnColorChanged, this );
278}
279
280
281void PANEL_COLOR_SETTINGS::ShowColorContextMenu( wxMouseEvent& aEvent, int aLayer )
282{
283 auto selected =
284 static_cast<COLOR_SETTINGS*>( m_cbTheme->GetClientData( m_cbTheme->GetSelection() ) );
285
286 wxCHECK_RET( selected, wxT( "Invalid color theme selected" ) );
287
288 COLOR4D current = m_currentSettings->GetColor( aLayer );
289 COLOR4D saved = selected->GetColor( aLayer );
290 bool readOnly = m_currentSettings->IsReadOnly();
291
292 wxMenu menu;
293
294 KIUI::AddMenuItem( &menu, ID_COPY, _( "Copy color" ), KiBitmap( BITMAPS::copy ) );
295
296 if( !readOnly && m_copied != COLOR4D::UNSPECIFIED )
297 KIUI::AddMenuItem( &menu, ID_PASTE, _( "Paste color" ), KiBitmap( BITMAPS::paste ) );
298
299 if( !readOnly && current != saved )
300 KIUI::AddMenuItem( &menu, ID_REVERT, _( "Revert to saved color" ), KiBitmap( BITMAPS::undo ) );
301
302 menu.Bind( wxEVT_COMMAND_MENU_SELECTED,
303 [&]( wxCommandEvent& aCmd )
304 {
305 switch( aCmd.GetId() )
306 {
307 case ID_COPY:
308 m_copied = current;
309 break;
310
311 case ID_PASTE:
312 updateColor( aLayer, m_copied );
313 break;
314
315 case ID_REVERT:
316 updateColor( aLayer, saved );
317 break;
318
319 default:
320 aCmd.Skip();
321 }
322 } );
323
324 PopupMenu( &menu );
325}
326
327
328void PANEL_COLOR_SETTINGS::OnColorChanged( wxCommandEvent& aEvent )
329{
330 COLOR_SWATCH* swatch = static_cast<COLOR_SWATCH*>( aEvent.GetEventObject() );
331 COLOR4D newColor = swatch->GetSwatchColor();
332 int layer = static_cast<SCH_LAYER_ID>( swatch->GetId() - FIRST_BUTTON_ID );
333
334 updateColor( layer, newColor );
335}
336
337
338void PANEL_COLOR_SETTINGS::updateColor( int aLayer, const KIGFX::COLOR4D& aColor )
339{
341 m_currentSettings->SetColor( aLayer, aColor );
342
343 // Colors must be persisted when edited because multiple PANEL_COLOR_SETTINGS could be
344 // referring to the same theme.
345 saveCurrentTheme( false );
346
347 m_swatches[aLayer]->SetSwatchColor( aColor, false );
348
349 if( m_currentSettings && aLayer == m_backgroundLayer )
350 {
352
353 for( std::pair<int, COLOR_SWATCH*> pair : m_swatches )
354 pair.second->SetSwatchBackground( background );
355 }
356
358}
359
360
362{
364 return true;
365
366 if( aValidate && !validateSave() )
367 return false;
368
369 SETTINGS_MANAGER& settingsMgr = Pgm().GetSettingsManager();
370 COLOR_SETTINGS* selected = settingsMgr.GetColorSettings( m_currentSettings->GetFilename() );
371
372 selected->SetOverrideSchItemColors( m_optOverrideColors->GetValue() );
373
374 for( int layer : m_validLayers )
375 selected->SetColor( layer, m_currentSettings->GetColor( layer ) );
376
377 settingsMgr.SaveColorSettings( selected, m_colorNamespace );
378
379 return true;
380}
381
382
384{
385 wxString name = aSettings->GetName();
386
387 if( aSettings->IsReadOnly() )
388 name += wxS( " " ) + _( "(read-only)" );
389
390 return name;
391}
int color
Definition: DXF_plotter.cpp:58
const char * name
Definition: DXF_plotter.cpp:57
wxBitmap KiBitmap(BITMAPS aBitmap, int aHeightTag)
Construct a wxBitmap from an image identifier Returns the image from the active theme if the image ha...
Definition: bitmap.cpp:104
Color settings are a bit different than most of the settings objects in that there can be more than o...
void SetName(const wxString &aName)
void SetColor(int aLayer, const COLOR4D &aColor)
bool GetOverrideSchItemColors() const
COLOR4D GetColor(int aLayer) const
COLOR4D GetDefaultColor(int aLayer)
void SetOverrideSchItemColors(bool aFlag)
const wxString & GetName() const
A simple color swatch of the kind used to set layer colors.
Definition: color_swatch.h:57
void SetSwatchColor(const KIGFX::COLOR4D &aColor, bool aSendEvent)
Set the current swatch color directly.
KIGFX::COLOR4D GetSwatchColor() const
This class provides a custom wxValidator object for limiting the allowable characters when defining f...
Definition: validators.h:77
bool IsReadOnly() const
Definition: json_settings.h:84
void SetReadOnly(bool aReadOnly)
Definition: json_settings.h:85
virtual bool SaveToFile(const wxString &aDirectory="", bool aForce=false)
wxString GetFilename() const
Definition: json_settings.h:73
A color representation with 4 components: red, green, blue, alpha.
Definition: color4d.h:104
Class PANEL_COLOR_SETTINGS_BASE.
void createThemeList(const wxString &aCurrent)
Builds the theme listbox and sets the selection to the current theme.
void createSwatch(int aLayer, const wxString &aName)
std::vector< int > m_validLayers
A list of layer IDs that are valid for the current color settings dialog.
void OnThemeChanged(wxCommandEvent &aEvent) override
virtual bool saveCurrentTheme(bool aValidate)
std::string m_colorNamespace
A namespace that will be passed to SETTINGS_MANAGER::SaveColorSettings.
virtual void ResetPanel() override
Reset the contents of this panel.
void OnBtnOpenThemeFolderClicked(wxCommandEvent &event) override
void OnColorChanged(wxCommandEvent &aEvent)
std::map< int, wxStaticText * > m_labels
virtual void onNewThemeSelected()
Event fired when a new theme is selected that can be overridden in children.
wxString GetSettingsDropdownName(COLOR_SETTINGS *aSettings)
Retrieves the drop down name to be displayed for a color setting.
void updateColor(int aLayer, const KIGFX::COLOR4D &aColor)
COLOR_SETTINGS * m_currentSettings
PANEL_COLOR_SETTINGS(wxWindow *aParent)
void ShowColorContextMenu(wxMouseEvent &aEvent, int aLayer)
void OnLeftDownTheme(wxMouseEvent &event) override
bool Show(bool show) override
virtual void createSwatches()=0
virtual void onColorChanged()
Event fired when the user changes any color.
virtual bool validateSave(bool aQuiet=false)
Performs a pre-save validation of the current color theme.
std::map< int, COLOR_SWATCH * > m_swatches
wxString GetPathForSettingsFile(JSON_SETTINGS *aSettings)
Returns the path a given settings file should be loaded from / stored to.
COLOR_SETTINGS * GetColorSettings(const wxString &aName="user")
Retrieves a color settings object that applications can read colors from.
void SaveColorSettings(COLOR_SETTINGS *aSettings, const std::string &aNamespace="")
Safely saves a COLOR_SETTINGS to disk, preserving any changes outside the given namespace.
static wxString GetColorSettingsPath()
Returns the path where color scheme files are stored; creating it if missing (normally .
COLOR_SETTINGS * AddNewColorSettings(const wxString &aFilename)
Registers a new color settings object with the given filename.
void SetBorders(bool aLeft, bool aRight, bool aTop, bool aBottom)
Definition: wx_panel.h:39
@ SWATCH_MEDIUM
Definition: color_swatch.h:41
#define _(s)
bool LaunchExternal(const wxString &aPath)
Launches the given file or folder in the host OS.
Definition: launch_ext.cpp:25
@ LAYER_PCB_BACKGROUND
PCB background color.
Definition: layer_ids.h:221
SCH_LAYER_ID
Eeschema drawing layers.
Definition: layer_ids.h:346
wxMenuItem * AddMenuItem(wxMenu *aMenu, int aId, const wxString &aText, const wxBitmap &aImage, wxItemKind aType=wxITEM_NORMAL)
Create and insert a menu item with an icon into aMenu.
Definition: ui_common.cpp:369
constexpr int FIRST_BUTTON_ID
SETTINGS_MANAGER * GetSettingsManager()
see class PGM_BASE
KIWAY Kiway & Pgm(), KFCTL_STANDALONE
The global Program "get" accessor.
Definition: single_top.cpp:119
Custom text control validator definitions.