mirror of
https://gitlab.com/kicad/code/kicad.git
synced 2025-09-14 18:23:15 +02:00
695cdbbde8
Also make a shorter version of the version info string and some other shortening edits to the issue template to fix occasional 500 errors thrown by Cloudflare due to excessively long URLs Fixes https://gitlab.com/kicad/code/kicad/-/issues/3953 Fixes https://gitlab.com/kicad/code/kicad/-/issues/4272
456 lines
17 KiB
C++
456 lines
17 KiB
C++
/*
|
|
* This program source code file is part of KiCad, a free EDA CAD application.
|
|
*
|
|
* Copyright (C) 2010 Rafael Sokolowski <Rafael.Sokolowski@web.de>
|
|
* Copyright (C) 2017-2020 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
|
|
*/
|
|
|
|
|
|
#include <config.h>
|
|
#include <string>
|
|
|
|
#include <wx/clipbrd.h>
|
|
#include <wx/msgdlg.h>
|
|
#include <wx/hyperlink.h>
|
|
|
|
/* All KiCad icons are linked into shared library 'libbitmaps.a'.
|
|
* Icons:
|
|
* preference_xpm; // Icon for 'Developers' tab
|
|
* editor_xpm; // Icon for 'Doc Writers' tab
|
|
* palette_xpm; // Icon for 'Artists' tab
|
|
* language_xpm; // Icon for 'Translators' tab
|
|
* right_xpm; // Right arrow icon for list items
|
|
* info_xpm; // Bulb for description tab
|
|
* tools_xpm; // Sheet of paper icon for license info tab
|
|
*/
|
|
#include <bitmaps.h>
|
|
#include <build_version.h>
|
|
#include <html_messagebox.h>
|
|
#include <tool/tool_manager.h>
|
|
|
|
#include "dialog_about.h"
|
|
|
|
|
|
DIALOG_ABOUT::DIALOG_ABOUT( EDA_BASE_FRAME *aParent, ABOUT_APP_INFO& aAppInfo )
|
|
: DIALOG_ABOUT_BASE( aParent ), m_info( aAppInfo )
|
|
{
|
|
wxASSERT( aParent != nullptr );
|
|
|
|
m_picInformation = KiBitmap( info_xpm );
|
|
m_picVersion = KiBitmap( recent_xpm );
|
|
m_picDevelopers = KiBitmap( preference_xpm );
|
|
m_picDocWriters = KiBitmap( editor_xpm );
|
|
m_picArtists = KiBitmap( palette_xpm );
|
|
m_picTranslators = KiBitmap( language_xpm );
|
|
m_picLicense = KiBitmap( tools_xpm );
|
|
m_picPackagers = KiBitmap( zip_xpm );
|
|
|
|
if( m_info.GetAppIcon().IsOk() )
|
|
{
|
|
SetIcon( m_info.GetAppIcon() );
|
|
m_bitmapApp->SetBitmap( m_info.GetAppIcon() );
|
|
}
|
|
else
|
|
{
|
|
wxIcon icon;
|
|
icon.CopyFromBitmap( KiBitmap( icon_kicad_xpm ) );
|
|
SetIcon( icon );
|
|
m_bitmapApp->SetBitmap( icon );
|
|
}
|
|
|
|
m_titleName = aParent->GetAboutTitle();
|
|
m_staticTextAppTitle->SetLabel( m_titleName );
|
|
m_staticTextCopyright->SetLabel( m_info.GetCopyright() );
|
|
m_staticTextBuildVersion->SetLabel( "Version: " + m_info.GetBuildVersion() );
|
|
m_staticTextLibVersion->SetLabel( m_info.GetLibVersion() );
|
|
|
|
SetTitle( wxString::Format( _( "About %s" ), m_titleName ) );
|
|
createNotebooks();
|
|
|
|
GetSizer()->SetSizeHints( this );
|
|
m_auiNotebook->Update();
|
|
SetFocus();
|
|
Centre();
|
|
}
|
|
|
|
|
|
DIALOG_ABOUT::~DIALOG_ABOUT()
|
|
{
|
|
}
|
|
|
|
|
|
wxFlexGridSizer* DIALOG_ABOUT::createFlexGridSizer()
|
|
{
|
|
// three columns with vertical and horizontal extra space of two pixels
|
|
wxFlexGridSizer* fgSizer = new wxFlexGridSizer( 3, 2, 2 );
|
|
fgSizer->SetFlexibleDirection( wxHORIZONTAL );
|
|
fgSizer->SetNonFlexibleGrowMode( wxFLEX_GROWMODE_SPECIFIED );
|
|
|
|
return fgSizer;
|
|
}
|
|
|
|
|
|
void DIALOG_ABOUT::createNotebooks()
|
|
{
|
|
createNotebookHtmlPage( m_auiNotebook, _( "About" ), m_picInformation,
|
|
m_info.GetDescription() );
|
|
|
|
wxString version = GetVersionInfoData( m_titleName, true );
|
|
|
|
createNotebookHtmlPage( m_auiNotebook, _( "Version" ), m_picVersion, version, true );
|
|
|
|
createNotebookPage( m_auiNotebook, _( "Developers" ) , m_picDevelopers,
|
|
m_info.GetDevelopers() );
|
|
createNotebookPage( m_auiNotebook, _( "Doc Writers" ), m_picDocWriters,
|
|
m_info.GetDocWriters() );
|
|
|
|
createNotebookPageByCategory( m_auiNotebook, _( "Artists" ), m_picArtists,
|
|
m_info.GetArtists() );
|
|
createNotebookPageByCategory( m_auiNotebook, _( "Translators" ), m_picTranslators,
|
|
m_info.GetTranslators() );
|
|
createNotebookPageByCategory( m_auiNotebook, _( "Packagers" ), m_picPackagers,
|
|
m_info.GetPackagers() );
|
|
|
|
createNotebookHtmlPage( m_auiNotebook, _( "License" ), m_picLicense, m_info.GetLicense() );
|
|
}
|
|
|
|
void DIALOG_ABOUT::createNotebookPage( wxAuiNotebook* aParent, const wxString& aCaption,
|
|
const wxBitmap& aIcon, const CONTRIBUTORS& aContributors )
|
|
{
|
|
wxBoxSizer* bSizer = new wxBoxSizer( wxHORIZONTAL );
|
|
|
|
wxScrolledWindow* m_scrolledWindow1 = new wxScrolledWindow( aParent, wxID_ANY,
|
|
wxDefaultPosition,
|
|
wxDefaultSize,
|
|
wxHSCROLL|wxVSCROLL );
|
|
m_scrolledWindow1->SetScrollRate( 5, 5 );
|
|
|
|
/* Panel for additional space at the left,
|
|
* but can also be used to show an additional bitmap.
|
|
*/
|
|
wxPanel* panel1 = new wxPanel( m_scrolledWindow1 );
|
|
|
|
wxFlexGridSizer* fgSizer1 = createFlexGridSizer();
|
|
|
|
for( size_t i=0; i<aContributors.GetCount(); ++i )
|
|
{
|
|
CONTRIBUTOR* contributor = &aContributors.Item( i );
|
|
|
|
// Icon at first column
|
|
wxStaticBitmap* m_bitmap1 = createStaticBitmap( m_scrolledWindow1, contributor->GetIcon() );
|
|
fgSizer1->Add( m_bitmap1, 0, wxALIGN_CENTER|wxLEFT|wxRIGHT, 5 );
|
|
|
|
// Name of contributor at second column
|
|
if ( contributor->GetName() != wxEmptyString )
|
|
{
|
|
wxStaticText* m_staticText1 = new wxStaticText( m_scrolledWindow1, wxID_ANY,
|
|
contributor->GetName(),
|
|
wxDefaultPosition, wxDefaultSize, 0 );
|
|
m_staticText1->Wrap( -1 );
|
|
fgSizer1->Add( m_staticText1, 0, wxALIGN_LEFT|wxBOTTOM, 2 );
|
|
}
|
|
else
|
|
{
|
|
fgSizer1->AddSpacer( 5 );
|
|
}
|
|
|
|
// Email address of contributor at third column
|
|
if ( contributor->GetEMail() != wxEmptyString )
|
|
{
|
|
wxStaticText* hyperlink = wxStaticTextMail( m_scrolledWindow1,
|
|
contributor->GetEMail() );
|
|
fgSizer1->Add( hyperlink, 0, wxALIGN_LEFT|wxBOTTOM, 2 );
|
|
}
|
|
else
|
|
{
|
|
fgSizer1->AddSpacer( 5 );
|
|
}
|
|
}
|
|
|
|
bSizer->Add( panel1, 1, wxEXPAND|wxALL, 10 );
|
|
bSizer->Add( fgSizer1, 7, wxEXPAND|wxALL, 10 ); // adjust width of panel with first int value
|
|
m_scrolledWindow1->SetSizer( bSizer );
|
|
m_scrolledWindow1->Layout();
|
|
bSizer->Fit( m_scrolledWindow1 );
|
|
aParent->AddPage( m_scrolledWindow1, aCaption, false, aIcon );
|
|
}
|
|
|
|
|
|
void DIALOG_ABOUT::createNotebookPageByCategory(wxAuiNotebook* aParent, const wxString& aCaption,
|
|
const wxBitmap& aIcon,
|
|
const CONTRIBUTORS& aContributors)
|
|
{
|
|
wxBoxSizer* bSizer = new wxBoxSizer( wxHORIZONTAL );
|
|
|
|
wxScrolledWindow* m_scrolledWindow1 = new wxScrolledWindow( aParent, wxID_ANY,
|
|
wxDefaultPosition,
|
|
wxDefaultSize,
|
|
wxHSCROLL|wxVSCROLL );
|
|
m_scrolledWindow1->SetScrollRate( 5, 5 );
|
|
|
|
/* Panel for additional space at the left,
|
|
* but can also be used to show an additional bitmap.
|
|
*/
|
|
wxPanel* panel1 = new wxPanel( m_scrolledWindow1 );
|
|
|
|
wxFlexGridSizer* fgSizer1 = createFlexGridSizer();
|
|
|
|
for( size_t i=0; i < aContributors.GetCount(); ++i )
|
|
{
|
|
CONTRIBUTOR* contributor = &aContributors.Item( i );
|
|
|
|
wxBitmap* icon = contributor->GetIcon();
|
|
wxString category = contributor->GetCategory();
|
|
|
|
/* to construct the next row we expect to have
|
|
* a category and a contributor that was not considered up to now
|
|
*/
|
|
if( ( category != wxEmptyString ) && !( contributor->IsChecked() ) )
|
|
{
|
|
// Icon at first column
|
|
wxStaticBitmap* m_bitmap1 = createStaticBitmap( m_scrolledWindow1, icon );
|
|
fgSizer1->Add( m_bitmap1, 0, wxALIGN_CENTER|wxLEFT|wxRIGHT, 5 );
|
|
|
|
// Category name at second column
|
|
wxStaticText* m_staticText1 = new wxStaticText( m_scrolledWindow1, wxID_ANY,
|
|
contributor->GetCategory() + wxT( ":" ),
|
|
wxDefaultPosition, wxDefaultSize, 0 );
|
|
m_staticText1->SetFont( wxFont( -1, wxFONTFAMILY_DEFAULT, wxFONTSTYLE_NORMAL,
|
|
wxFONTWEIGHT_BOLD, false,
|
|
wxEmptyString ) ); // bold font
|
|
m_staticText1->Wrap( -1 );
|
|
fgSizer1->Add( m_staticText1, 0, wxALIGN_LEFT|wxBOTTOM, 2 );
|
|
|
|
// Nothing at third column
|
|
fgSizer1->AddSpacer( 5 );
|
|
|
|
// Now, all contributors of the same category will follow
|
|
for( size_t j=0; j < aContributors.GetCount(); ++j )
|
|
{
|
|
CONTRIBUTOR* sub_contributor = &aContributors.Item( j );
|
|
|
|
if ( sub_contributor->GetCategory() == category )
|
|
{
|
|
// First column is empty
|
|
fgSizer1->AddSpacer(5);
|
|
|
|
wxControl* ctrl;
|
|
|
|
// No URL supplied, display normal text control
|
|
if( sub_contributor->GetUrl().IsEmpty() )
|
|
{
|
|
ctrl = new wxStaticText( m_scrolledWindow1, wxID_ANY,
|
|
wxT( " • " ) + sub_contributor->GetName(),
|
|
wxDefaultPosition,
|
|
wxDefaultSize, 0 );
|
|
}
|
|
else
|
|
{
|
|
// Display a hyperlink control instead
|
|
ctrl = new wxHyperlinkCtrl( m_scrolledWindow1, wxID_ANY,
|
|
wxT( "• " ) + sub_contributor->GetName(),
|
|
sub_contributor->GetUrl(),
|
|
wxDefaultPosition,
|
|
wxDefaultSize, wxHL_ALIGN_LEFT );
|
|
}
|
|
|
|
m_staticText1->Wrap( -1 );
|
|
|
|
fgSizer1->Add( ctrl, 0, wxALIGN_LEFT|wxBOTTOM, 2 );
|
|
|
|
// Email address of contributor at third column
|
|
if( sub_contributor->GetEMail() != wxEmptyString )
|
|
{
|
|
wxStaticText* mail = wxStaticTextMail( m_scrolledWindow1,
|
|
sub_contributor->GetEMail() );
|
|
fgSizer1->Add( mail, 0, wxALIGN_LEFT|wxBOTTOM, 2 );
|
|
}
|
|
else
|
|
{
|
|
fgSizer1->AddSpacer( 5 );
|
|
}
|
|
|
|
/* this contributor was added to the GUI,
|
|
* thus can be ignored next time
|
|
*/
|
|
sub_contributor->SetChecked( true );
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
continue;
|
|
}
|
|
}
|
|
|
|
/* Now, lets list the remaining contributors that have not been considered
|
|
* because they were not assigned to any category.
|
|
*/
|
|
for ( size_t k=0; k < aContributors.GetCount(); ++k )
|
|
{
|
|
CONTRIBUTOR* contributor = &aContributors.Item( k );
|
|
|
|
if ( contributor->IsChecked() )
|
|
continue;
|
|
|
|
// Icon at first column
|
|
wxStaticBitmap* m_bitmap1 = createStaticBitmap( m_scrolledWindow1, contributor->GetIcon() );
|
|
fgSizer1->Add( m_bitmap1, 0, wxALIGN_CENTER|wxLEFT|wxRIGHT, 5 );
|
|
|
|
// Name of contributor at second column
|
|
if( contributor->GetName() != wxEmptyString )
|
|
{
|
|
wxStaticText* m_staticText1 = new wxStaticText( m_scrolledWindow1, wxID_ANY,
|
|
contributor->GetName(),
|
|
wxDefaultPosition, wxDefaultSize, 0 );
|
|
m_staticText1->Wrap( -1 );
|
|
fgSizer1->Add( m_staticText1, 0, wxALIGN_LEFT|wxBOTTOM, 2 );
|
|
}
|
|
else
|
|
{
|
|
fgSizer1->AddSpacer( 5 );
|
|
}
|
|
|
|
// Email address of contributor at third column
|
|
if ( contributor->GetEMail() != wxEmptyString )
|
|
{
|
|
wxStaticText* mail = wxStaticTextMail( m_scrolledWindow1,
|
|
contributor->GetEMail() );
|
|
fgSizer1->Add( mail, 0, wxALIGN_LEFT|wxBOTTOM, 2 );
|
|
}
|
|
else
|
|
{
|
|
fgSizer1->AddSpacer( 5 );
|
|
}
|
|
}
|
|
|
|
bSizer->Add( panel1, 1, wxEXPAND|wxALL, 10 );
|
|
bSizer->Add( fgSizer1, 7, wxEXPAND|wxALL, 10 ); // adjust width of panel with first int value
|
|
m_scrolledWindow1->SetSizer( bSizer );
|
|
m_scrolledWindow1->Layout();
|
|
bSizer->Fit( m_scrolledWindow1 );
|
|
aParent->AddPage( m_scrolledWindow1, aCaption, false, aIcon );
|
|
}
|
|
|
|
|
|
void DIALOG_ABOUT::createNotebookHtmlPage( wxAuiNotebook* aParent, const wxString& aCaption,
|
|
const wxBitmap& aIcon, const wxString& html,
|
|
bool aSelection )
|
|
{
|
|
wxPanel* panel = new wxPanel( aParent, wxID_ANY, wxDefaultPosition, wxDefaultSize,
|
|
wxTAB_TRAVERSAL );
|
|
|
|
wxBoxSizer* bSizer = new wxBoxSizer( wxVERTICAL );
|
|
|
|
wxString htmlPage = wxEmptyString, htmlContent = html;
|
|
|
|
// to have a unique look background color for HTML pages is set to the default as it is
|
|
// used for all the other widgets
|
|
wxString htmlColor = ( this->GetBackgroundColour() ).GetAsString( wxC2S_HTML_SYNTAX );
|
|
|
|
// beginning of HTML structure
|
|
htmlPage.Append( wxT( "<html><body bgcolor='" ) + htmlColor + wxT( "'>" ) );
|
|
|
|
htmlPage.Append( htmlContent );
|
|
|
|
// end of HTML structure indicated by closing tags
|
|
htmlPage.Append( wxT( "</body></html>" ) );
|
|
|
|
int flags = aSelection ? wxHW_SCROLLBAR_AUTO : ( wxHW_SCROLLBAR_AUTO | wxHW_NO_SELECTION );
|
|
|
|
// the HTML page is going to be created with previously created HTML content
|
|
auto htmlWindow = new wxHtmlWindow( panel, wxID_ANY, wxDefaultPosition, wxDefaultSize, flags );
|
|
|
|
// HTML font set to font properties as they are used for widgets to have an unique look
|
|
// under different platforms with HTML
|
|
wxFont font = this->GetFont();
|
|
htmlWindow->SetStandardFonts( font.GetPointSize(), font.GetFaceName(), font.GetFaceName() );
|
|
htmlWindow->SetPage( htmlPage );
|
|
|
|
// the HTML window shall not be used to open external links, thus this task is delegated
|
|
// to users default browser
|
|
htmlWindow->Connect( wxEVT_COMMAND_HTML_LINK_CLICKED,
|
|
wxHtmlLinkEventHandler( DIALOG_ABOUT::onHtmlLinkClicked ), NULL, this );
|
|
|
|
// no additional space around the HTML window as it is also the case by the other notebook pages
|
|
bSizer->Add( htmlWindow, 1, wxALL|wxEXPAND, 0 );
|
|
panel->SetSizer( bSizer );
|
|
panel->Layout();
|
|
bSizer->Fit( panel );
|
|
aParent->AddPage( panel, aCaption, false, aIcon );
|
|
}
|
|
|
|
|
|
wxStaticText* DIALOG_ABOUT::wxStaticTextMail(wxScrolledWindow* aParent, const wxString& aEmail)
|
|
{
|
|
wxStaticText* text = new wxStaticText( aParent, wxID_ANY,
|
|
wxT( "<" ) + aEmail + wxT( ">" ) );
|
|
|
|
return text;
|
|
}
|
|
|
|
|
|
wxStaticBitmap* DIALOG_ABOUT::createStaticBitmap(wxScrolledWindow* aParent, wxBitmap* aIcon)
|
|
{
|
|
wxStaticBitmap* bitmap = new wxStaticBitmap( aParent, wxID_ANY, wxNullBitmap,
|
|
wxDefaultPosition, wxDefaultSize, 0 );
|
|
|
|
if( aIcon )
|
|
{
|
|
bitmap->SetBitmap( *aIcon );
|
|
}
|
|
else
|
|
{
|
|
bitmap->SetBitmap( KiBitmap( right_xpm ) );
|
|
}
|
|
|
|
return bitmap;
|
|
}
|
|
|
|
|
|
void DIALOG_ABOUT::onHtmlLinkClicked( wxHtmlLinkEvent& event )
|
|
{
|
|
::wxLaunchDefaultBrowser( event.GetLinkInfo().GetHref() );
|
|
}
|
|
|
|
|
|
void DIALOG_ABOUT::onCopyVersionInfo( wxCommandEvent& event )
|
|
{
|
|
if( !wxTheClipboard->Open() )
|
|
{
|
|
wxMessageBox( _( "Could not open clipboard to write version information." ),
|
|
_( "Clipboard Error" ), wxOK | wxICON_EXCLAMATION, this );
|
|
return;
|
|
}
|
|
|
|
wxString msg_version = GetVersionInfoData( m_titleName );
|
|
|
|
wxTheClipboard->SetData( new wxTextDataObject( msg_version ) );
|
|
wxTheClipboard->Close();
|
|
m_btCopyVersionInfo->SetLabel( _( "Copied..." ) );
|
|
}
|
|
|
|
|
|
void DIALOG_ABOUT::onReportBug( wxCommandEvent& event )
|
|
{
|
|
if( TOOL_MANAGER* mgr = static_cast<EDA_BASE_FRAME*>( GetParent() )->GetToolManager() )
|
|
mgr->RunAction( "common.SuiteControl.reportBug", true );
|
|
}
|