Audacity 3.2.0
AboutDialog.cpp
Go to the documentation of this file.
1/**********************************************************************
2
3 Audacity: A Digital Audio Editor
4
5 AboutDialog.cpp
6
7 Dominic Mazzoni
8 Vaughan Johnson
9 James Crook
10
11********************************************************************//*****************************************************************//********************************************************************/
26
27
28
29#include "AboutDialog.h"
30
31#include <wx/html/htmlwin.h>
32#include <wx/hyperlink.h>
33#include <wx/statbmp.h>
34#include <wx/sstream.h>
35#include <wx/txtstrm.h>
36#include <wx/statbox.h>
37#include <wx/stattext.h>
38
39#include "FileNames.h"
40#include "HelpText.h"
41#include "ShuttleGui.h"
42#include "HelpSystem.h"
44
45#include "AllThemeResources.h"
46#include "Theme.h"
47
48#include "../images/AudacityLogoWithName.xpm"
49
50// Notice this is a "system include". This is on purpose and only until
51// we convert over to CMake. Once converted, the "RevisionIndent.h" file
52// should be deleted and this can be changed back to a user include if
53// desired.
54//
55// RevisionIdent.h may contain #defines like these ones:
56//#define REV_LONG "28864acb238cb3ca71dda190a2d93242591dd80e"
57//#define REV_TIME "Sun Apr 12 12:40:22 2015 +0100"
58#include "RevisionIdent.h"
59
60#ifndef REV_TIME
61#define REV_TIME "unknown date and time"
62#endif
63
64#ifdef REV_LONG
65#define REV_IDENT wxString( "[[https://github.com/audacity/audacity/commit/" )+ REV_LONG + "|" + wxString( REV_LONG ).Left(6) + "]] of " + REV_TIME
66#else
67#define REV_IDENT (XO("No revision identifier was provided").Translation())
68#endif
69
70#if defined(HAS_SENTRY_REPORTING) || defined(HAVE_UPDATES_CHECK) || defined(USE_BREAKPAD)
71#define HAS_PRIVACY_POLICY
72#endif
73
74// To substitute into many other translatable strings
75static const auto ProgramName =
76 //XO("Audacity");
77 Verbatim("Audacity");
78
80{
81 const auto sysAdminFormat =
82 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
83 XO("%s, system administration");
84 const auto coFounderFormat =
85 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
86 XO("%s, co-founder and developer");
87 const auto designerFormat =
88 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
89 XO("%s, designer");
90 const auto developerFormat =
91 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
92 XO("%s, developer");
93 const auto developerAndSupprtFormat =
94 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
95 XO("%s, developer and support");
96 const auto documentationAndSupportFormat =
97 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
98 XO("%s, documentation and support");
99 const auto qaDocumentationAndSupportFormat =
100 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
101 XO("%s, QA tester, documentation and support");
102 const auto documentationAndSupportFrenchFormat =
103 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
104 XO("%s, documentation and support, French");
105 const auto qualityAssuranceFormat =
106 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
107 XO("%s, quality assurance");
108 const auto accessibilityAdvisorFormat =
109 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
110 XO("%s, accessibility advisor");
111 const auto graphicArtistFormat =
112 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
113 XO("%s, graphic artist");
114 const auto composerFormat =
115 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
116 XO("%s, composer");
117 const auto testerFormat =
118 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
119 XO("%s, tester");
120 const auto NyquistPluginsFormat =
121 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
122 XO("%s, Nyquist plug-ins");
123 const auto webDeveloperFormat =
124 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
125 XO("%s, web developer");
126 const auto graphicsFormat =
127 /* i18n-hint: For "About Audacity..." credits, substituting a person's proper name */
128 XO("%s, graphics");
129
130 // The Audacity Team: developers and support
131 AddCredit(wxT("Matthieu Hodgkinson"), developerFormat, roleTeamMember);
132 AddCredit(wxT("Peter Jonas"), developerFormat, roleTeamMember);
133 AddCredit(wxT("Martin Keary"), roleTeamMember);
134 AddCredit(wxT("Sergey Lapysh"), testerFormat, roleTeamMember);
135 AddCredit(wxT("Yana Larina"), roleTeamMember);
136 AddCredit(wxT("Paul Licameli"), developerFormat, roleTeamMember);
137 AddCredit(wxT("Dilson's Pickles"), designerFormat, roleTeamMember);
138 AddCredit(wxT("K. Soze"), developerFormat, roleTeamMember);
139 AddCredit(wxT("Anita Sudan"), roleTeamMember);
140 AddCredit(wxT("Vitaly Sverchinsky"), developerFormat, roleTeamMember);
141 AddCredit(wxT("Dmitry Vedenko"), developerFormat, roleTeamMember);
142 AddCredit(wxT("Leo Wattenberg"), designerFormat, roleTeamMember);
143 AddCredit(wxT("Jessica Williamson"), designerFormat, roleTeamMember);
144
145 // Emeritus: people who were "lead developers" or made an
146 // otherwise distinguished contribution, but who are no
147 // longer active.
148 AddCredit(wxT("Gale Andrews"), qualityAssuranceFormat, roleEmeritusTeam);
149 AddCredit(wxT("Richard Ash"), developerFormat, roleEmeritusTeam);
150 AddCredit(wxT("Christian Brochec"),
151 documentationAndSupportFrenchFormat, roleEmeritusTeam);
152 AddCredit(wxT("Matt Brubeck"), developerFormat, roleEmeritusTeam);
153 AddCredit(wxT("Arturo \"Buanzo\" Busleiman"), sysAdminFormat, roleEmeritusTeam);
154 AddCredit(wxT("Michael Chinen"), developerFormat, roleEmeritusTeam);
155 AddCredit(wxT("James Crook"), developerFormat, roleEmeritusTeam);
156 AddCredit(wxT("Roger Dannenberg"), coFounderFormat, roleEmeritusTeam);
157 AddCredit(wxT("Steve Daulton"), roleEmeritusTeam);
158 AddCredit(wxT("Al Dimond"), developerFormat, roleEmeritusTeam);
159 AddCredit(wxT("Benjamin Drung"), developerFormat, roleEmeritusTeam);
160 AddCredit(wxT("Joshua Haberman"), developerFormat, roleEmeritusTeam);
161 AddCredit(wxT("Ruslan Ijbulatov"), developerFormat, roleEmeritusTeam);
162 AddCredit(wxT("Vaughan Johnson"), developerFormat, roleEmeritusTeam);
163 AddCredit(wxT("Greg Kozikowski"), documentationAndSupportFormat, roleEmeritusTeam);
164 AddCredit(wxT("Leland Lucius"), developerFormat, roleEmeritusTeam);
165 AddCredit(wxT("Dominic Mazzoni"), coFounderFormat, roleEmeritusTeam);
166 AddCredit(wxT("Markus Meyer"), developerFormat, roleEmeritusTeam);
167 AddCredit(wxT("Monty Montgomery"), developerFormat, roleEmeritusTeam);
168 AddCredit(wxT("Shane Mueller"), developerFormat, roleEmeritusTeam);
169 AddCredit(wxT("Tony Oetzmann"), documentationAndSupportFormat, roleEmeritusTeam);
170 AddCredit(wxT("Alexandre Prokoudine"), documentationAndSupportFormat, roleEmeritusTeam);
171 AddCredit(wxT("Peter Sampson"), qaDocumentationAndSupportFormat, roleEmeritusTeam);
172 AddCredit(wxT("Martyn Shaw"), developerFormat, roleEmeritusTeam);
173 AddCredit(wxT("Bill Wharrie"), documentationAndSupportFormat, roleEmeritusTeam);
174
175 // Contributors
176 AddCredit(wxT("Lynn Allan"), developerFormat, roleContributor);
177 AddCredit(wxT("Brian Armstrong"), developerFormat, roleContributor);
178 AddCredit(wxT("David Avery"), developerFormat, roleContributor);
179 AddCredit(wxT("David Bailes"), accessibilityAdvisorFormat, roleContributor);
180 AddCredit(wxT("William Bland"), developerFormat, roleContributor);
181 AddCredit(wxT("Sami Boukortt"), developerFormat, roleContributor);
182 AddCredit(wxT("Jeremy R. Brown"), developerFormat, roleContributor);
183 AddCredit(wxT("Alex S. Brown"), developerFormat, roleContributor);
184 AddCredit(wxT("David Bryant"), developerFormat, roleContributor);
185 AddCredit(wxT("Chris Cannam"), developerFormat, roleContributor);
186 AddCredit(wxT("Subhradeep Chakraborty"), developerFormat, roleContributor);
187 AddCredit(wxT("Cory Cook"), developerFormat, roleContributor);
188 AddCredit(wxT("Craig DeForest"), developerFormat, roleContributor);
189 AddCredit(wxT("Edgar Franke (Edgar-RFT)"), developerFormat, roleContributor);
190 AddCredit(wxT("Anton Gerasimov"), developerFormat, roleContributor);
191 AddCredit(wxT("Mitch Golden"), developerFormat, roleContributor);
192 AddCredit(wxT("Brian Gunlogson"), developerFormat, roleContributor);
193 AddCredit(wxT("Gonzalo Guzm\u00E1n"), documentationAndSupportFormat, roleContributor);
194 AddCredit(wxT("Andrew Hallendorff"), developerFormat, roleContributor);
195 AddCredit(wxT("Robert H\u00E4nggi"), developerFormat, roleContributor);
196 AddCredit(wxT("Jouni Helminen"), designerFormat, roleContributor);
197 AddCredit(wxT("Daniel Horgan"), developerFormat, roleContributor);
198 AddCredit(wxT("David Hostetler"), developerFormat, roleContributor);
199 AddCredit(wxT("Edward Hui"), developerFormat, roleContributor);
200 AddCredit(wxT("Steve Jolly"), developerFormat, roleContributor);
201 AddCredit(wxT("Steven Jones"), developerFormat, roleContributor);
202 AddCredit(wxT("Henric Jungheim"), developerFormat, roleContributor);
203 AddCredit(wxT("Myungchul Keum"), developerFormat, roleContributor);
204 AddCredit(wxT("Arun Kishore"), developerFormat, roleContributor);
205 AddCredit(wxT("Paul Livesey"), developerFormat, roleContributor);
206 AddCredit(wxT("Harvey Lubin"), graphicArtistFormat, roleContributor);
207 AddCredit(wxT("Max Maisel"), developerFormat, roleContributor);
208 AddCredit(wxT("Pietro Marcello"), developerFormat, roleContributor);
209 AddCredit(wxT("Greg Mekkes"), developerFormat, roleContributor);
210 AddCredit(wxT("Abe Milde"), developerFormat, roleContributor);
211 AddCredit(wxT("Ryan Miller"), testerFormat, roleContributor);
212 AddCredit(wxT("Paul Nasca"), developerFormat, roleContributor);
213 AddCredit(wxT("Clayton Otey"), developerFormat, roleContributor);
214 AddCredit(wxT("Pavel Penikov"), testerFormat, roleContributor);
215 AddCredit(wxT("Mark Phillips"), developerFormat, roleContributor);
216 AddCredit(wxT("Andr\u00E9 Pinto"), developerFormat, roleContributor);
217 AddCredit(wxT("Pokechu22"), developerFormat, roleContributor);
218 AddCredit(wxT("Jean Claude Risset"), composerFormat, roleContributor);
219 AddCredit(wxT("RuRo"), developerFormat, roleContributor);
220 AddCredit(wxT("Augustus Saunders"), developerFormat, roleContributor);
221 AddCredit(wxT("Benjamin Schwartz"), developerFormat, roleContributor);
222 AddCredit(wxT("Cliff Scott"), testerFormat, roleContributor);
223 AddCredit(wxT("David R. Sky"), NyquistPluginsFormat, roleContributor);
224 AddCredit(wxT("Rob Sykes"), developerFormat, roleContributor);
225 AddCredit(wxT("Mike Underwood"), developerFormat, roleContributor);
226 AddCredit(wxT("Philip Van Baren"), developerFormat, roleContributor);
227 AddCredit(wxT("Salvo Ventura"), developerFormat, roleContributor);
228 AddCredit(wxT("Darrell Walisser"), developerFormat, roleContributor);
229 AddCredit(wxT("Jun Wan"), developerFormat, roleContributor);
230 AddCredit(wxT("Daniel Winzen"), developerFormat, roleContributor);
231 AddCredit(wxT("Tom Woodhams"), developerFormat, roleContributor);
232 AddCredit(wxT("Mark Young"), developerFormat, roleContributor);
233 AddCredit(wxT("Wing Yu"), developerFormat, roleContributor);
234
235 // Website and Graphics
236 AddCredit(wxT("Shinta Carolinasari"), webDeveloperFormat, roleGraphics);
237 AddCredit(wxT("Bayu Rizaldhan Rayes"), graphicsFormat, roleGraphics);
238
239 // Libraries
240
241 AddCredit(wxT("[[https://libexpat.github.io/|expat]]"), roleLibrary);
242 AddCredit(wxT("[[https://xiph.org/flac/|FLAC]]"), roleLibrary);
243 AddCredit(wxT("[[http://lame.sourceforge.net/|LAME]]"), roleLibrary);
244 AddCredit(wxT("[[https://www.underbit.com/products/mad/|libmad]]"), roleLibrary);
245 AddCredit(wxT("[[http://www.mega-nerd.com/libsndfile/|libsndfile]]"), roleLibrary);
246 AddCredit(wxT("[[https://sourceforge.net/p/soxr/wiki/Home/|libsoxr]]"), roleLibrary);
247 AddCredit(
248 XO("%s (incorporating %s, %s, %s, %s and %s)")
249 .Format(
250 "[[http://lv2plug.in/|lv2]]",
251 "lilv",
252 "msinttypes",
253 "serd",
254 "sord",
255 "sratom"
256 ).Translation(),
258 AddCredit(wxT("[[https://www.cs.cmu.edu/~music/nyquist/|Nyquist]]"), roleLibrary);
259 AddCredit(wxT("[[https://xiph.org/vorbis/|Ogg Vorbis]]"), roleLibrary);
260 AddCredit(wxT("[[http://www.portaudio.com/|PortAudio]]"), roleLibrary);
261 AddCredit(wxT("[[http://www.portmedia.sourceforge.net/portmidi/|PortMidi]]"), roleLibrary);
262 AddCredit(wxT("[[https://sourceforge.net/p/portmedia/wiki/portsmf/|portsmf]]"), roleLibrary);
263 AddCredit(wxT("[[http://sbsms.sourceforge.net/|sbsms]]"), roleLibrary);
264 AddCredit(wxT("[[https://www.surina.net/soundtouch/|SoundTouch]]"), roleLibrary);
265 AddCredit(wxT("[[http://www.twolame.org/|TwoLAME]]"), roleLibrary);
266 AddCredit(wxT("[[http://www.vamp-plugins.org/|Vamp]]"), roleLibrary);
267 AddCredit(wxT("[[https://wxwidgets.org/|wxWidgets]]"), roleLibrary);
268
269 // Thanks
270
271 AddCredit(wxT("Dave Beydler"), roleThanks);
272 AddCredit(wxT("Brian Cameron"), roleThanks);
273 AddCredit(wxT("Jason Cohen"), roleThanks);
274 AddCredit(wxT("Dave Fancella"), roleThanks);
275 AddCredit(wxT("Steve Harris"), roleThanks);
276 AddCredit(wxT("Daniel James"), roleThanks);
277 AddCredit(wxT("Daniil Kolpakov"), roleThanks);
278 AddCredit(wxT("Robert Leidle"), roleThanks);
279 AddCredit(wxT("Logan Lewis"), roleThanks);
280 AddCredit(wxT("David Luff"), roleThanks);
281 AddCredit(wxT("Jason Pepas"), roleThanks);
282 AddCredit(wxT("Jonathan Ryshpan"), roleThanks);
283 AddCredit(wxT("Michael Schwendt"), roleThanks);
284 AddCredit(wxT("Patrick Shirkey"), roleThanks);
285 AddCredit(wxT("Tuomas Suutari"), roleThanks);
286 AddCredit(wxT("Mark Tomlinson"), roleThanks);
287 AddCredit(wxT("David Topper"), roleThanks);
288 AddCredit(wxT("Rudy Trubitt"), roleThanks);
289 AddCredit(wxT("StreetIQ.com"), roleThanks);
290 AddCredit(wxT("UmixIt Technologies, LLC"), roleThanks);
291 AddCredit(wxT("Verilogix, Inc."), roleThanks);
292}
293
294// ----------------------------------------------------------------------------
295
296BEGIN_EVENT_TABLE(AboutDialog, wxDialogWrapper)
299
301
302namespace {
304}
305
307{
308 return sActiveInstance;
309}
310
311AboutDialog::AboutDialog(wxWindow * parent)
312 /* i18n-hint: information about the program */
313 : wxDialogWrapper(parent, -1, XO("About %s").Format( ProgramName ),
314 wxDefaultPosition, wxDefaultSize,
315 wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER)
316{
317 wxASSERT(!sActiveInstance);
318 sActiveInstance = this;
319
320 SetName();
321 this->SetBackgroundColour(theTheme.Colour( clrAboutBoxBackground ));
322 //this->SetBackgroundColour(theTheme.Colour( clrMedium ));
323 icon = NULL;
324 ShuttleGui S( this, eIsCreating );
325 S.StartNotebook();
326 {
330 }
331 S.EndNotebook();
332
333 S.Id(wxID_OK)
334 .Prop(0)
335 .AddButton(XXO("OK"), wxALIGN_CENTER, true);
336
337 Layout();
338 Fit();
339 this->Centre();
340}
341
342#define ABOUT_DIALOG_WIDTH 506
343
345{
347
348
349 /* i18n-hint: The translation of "translator_credits" will appear
350 * in the credits in the About Audacity window. Use this to add
351 * your own name(s) to the credits.
352 *
353 * For example: "English translation by Dominic Mazzoni." */
354 auto translatorCreditsMsgid = XO("translator_credits");
355 auto translatorCredits = translatorCreditsMsgid.Translation();
356 if ( translatorCredits == translatorCreditsMsgid.MSGID().GET() )
357 // We're in an English locale
358 translatorCredits.clear();
359 else
360 translatorCredits += wxT("<br>");
361
362 wxStringOutputStream o;
363 wxTextOutputStream informationStr( o ); // string to build up list of information in
364 informationStr
365 << wxT("<center>")
366 << XO("<h3>")
367 << ProgramName
368 << wxT(" ")
369 << wxString(AUDACITY_VERSION_STRING)
370 << wxT("</center></h3>")
371 /* i18n-hint: The program's name substitutes for %s */
372 << XO("%s the free, open source, cross-platform software for recording and editing sounds.")
373 .Format(ProgramName)
374
375 << wxT("<h3>")
376 << XO("Credits")
377 << wxT("</h3>")
378
379 << wxT("<p><b>")
380 /* i18n-hint: The program's name substitutes for %s */
381 << XO("%s Team Members").Format( ProgramName )
382 << wxT("</b><br>")
384
385 << wxT("<p><b> ")
386 << XO("Emeritus:")
387 << wxT("</b><br>")
388 /* i18n-hint: The program's name substitutes for %s */
389 << XO("Distinguished %s Team members, not currently active")
390 .Format( ProgramName )
391 << wxT("<br><br>")
393
394 << wxT("<p><b>")
395 << XO("Contributors")
396 << wxT("</b><br>")
398
399 << wxT("<p><b>")
400 << XO("Website and Graphics")
401 << wxT("</b><br>")
403 ;
404
405 if(!translatorCredits.empty()) informationStr
406 << wxT("<p><b>")
407 << XO("Translators")
408 << wxT("</b><br>")
409 << translatorCredits
410 ;
411
412 informationStr
413 << wxT("<p><b>")
414 << XO("Libraries")
415 << wxT("</b><br>")
416 /* i18n-hint: The program's name substitutes for %s */
417 << XO("%s includes code from the following projects:").Format( ProgramName )
418 << wxT("<br><br>")
420
421 << wxT("<p><b>")
422 << XO("Special thanks:")
423 << wxT("</b><br>")
425
426 << wxT("<p><br>")
427 /* i18n-hint: The program's name substitutes for %s */
428 << XO("%s website: ").Format( ProgramName )
429 << wxT("[[https://www.audacityteam.org/|https://www.audacityteam.org/]]")
430
431 << wxT("<p><br>&nbsp; &nbsp; ")
432 /* i18n-hint Audacity's name substitutes for first and third %s,
433 and a "copyright" symbol for the second */
434 << XO("%s software is copyright %s 1999-2023 %s Team.")
435 .Format(
436 Verbatim("<b>%s<sup>&reg;</sup></b>").Format( ProgramName ),
437 wxT("&copy;"),
439 << wxT("<br>")
440
441 << wxT("&nbsp; &nbsp; ")
442 /* i18n-hint Audacity's name substitutes for %s */
443 << XO("The name %s is a registered trademark.")
444 .Format( Verbatim("<b>%s</b>").Format( ProgramName ) )
445 << wxT("<br><br>")
446 << wxT("</center>")
447 ;
448
449 auto pPage = S.StartNotebookPage( ProgramName );
450 S.StartVerticalLay(1);
451 {
452 //v For now, change to AudacityLogoWithName via old-fashioned way, not Theme.
453 wxBitmap logo(AudacityLogoWithName_xpm); //v
454
455 // JKC: Resize to 50% of size. Later we may use a smaller xpm as
456 // our source, but this allows us to tweak the size - if we want to.
457 // It also makes it easier to revert to full size if we decide to.
458 const float fScale = 0.5f;// smaller size.
459 wxImage RescaledImage(logo.ConvertToImage());
460 wxColour MainColour(
461 RescaledImage.GetRed(1,1),
462 RescaledImage.GetGreen(1,1),
463 RescaledImage.GetBlue(1,1));
464 pPage->SetBackgroundColour(MainColour);
465 // wxIMAGE_QUALITY_HIGH not supported by wxWidgets 2.6.1, or we would use it here.
466 RescaledImage.Rescale((int)(LOGOWITHNAME_WIDTH * fScale), (int)(LOGOWITHNAME_HEIGHT *fScale));
467 wxBitmap RescaledBitmap(RescaledImage);
468
469 icon =
470 safenew wxStaticBitmap(S.GetParent(), -1,
471 //*logo, //v
472 //v theTheme.Bitmap(bmpAudacityLogo), wxPoint(93, 10), wxSize(215, 190));
473 //v theTheme.Bitmap(bmpAudacityLogoWithName),
474 RescaledBitmap,
475 wxDefaultPosition,
476 wxSize((int)(LOGOWITHNAME_WIDTH*fScale), (int)(LOGOWITHNAME_HEIGHT*fScale)));
477 }
478 S.Prop(0).AddWindow( icon );
479
480 HtmlWindow *html = safenew LinkingHtmlWindow(S.GetParent(), -1,
481 wxDefaultPosition,
482 wxSize(ABOUT_DIALOG_WIDTH, 359),
483 wxHW_SCROLLBAR_AUTO | wxSUNKEN_BORDER);
484 html->SetPage( FormatHtmlText( o.GetString() ) );
485
486 /* locate the html renderer where it fits in the dialogue */
487 S.Prop(1).Position( wxEXPAND ).Focus()
488 .AddWindow( html );
489
490 S.EndVerticalLay();
491 S.EndNotebookPage();
492}
493
494
501{
502 wxStringOutputStream o;
503 wxTextOutputStream informationStr( o ); // string to build up list of information in
504 S.StartNotebookPage( XO("Build Information") ); // start the tab
505 S.StartVerticalLay(2); // create the window
506 HtmlWindow *html = safenew LinkingHtmlWindow(S.GetParent(), -1, wxDefaultPosition,
507 wxSize(ABOUT_DIALOG_WIDTH, 264),
508 wxHW_SCROLLBAR_AUTO | wxSUNKEN_BORDER);
509 // create a html pane in it to put the content in.
510 auto enabled = XO("Enabled");
511 auto disabled = XO("Disabled");
512 wxString blank;
513
514 /* this builds up the list of information to go in the window in the string
515 * informationStr */
516 informationStr
517 << wxT("<h2><center>")
518 << XO("Build Information")
519 << wxT("</center></h2>\n")
520 << VerCheckHtml();
521
522 informationStr
523 << wxT("<h3>")
524 /* i18n-hint: Information about when audacity was compiled follows */
525 << XO("The Build")
526 << wxT("</h3>\n<table>"); // start build info table
527
528 // Current date
529 AddBuildinfoRow(&informationStr, XO("Program build date:"), __TDATE__);
530 AddBuildinfoRow(&informationStr, XO("Commit Id:"), REV_IDENT );
531
532 auto buildType =
533#ifdef _DEBUG
534 XO("Debug build (debug level %d)").Format(wxDEBUG_LEVEL);
535#else
536 XO("Release build (debug level %d)").Format(wxDEBUG_LEVEL);
537#endif
538 ;
539 if( (sizeof(void*) == 8) ) {
540 buildType = XO("%s, 64 bits").Format( buildType );
541 } else {
542 buildType = XO("%s, 32 bits").Format( buildType );
543 }
544// Remove this once the transition to CMake is complete
545#if defined(CMAKE)
546 buildType = Verbatim("CMake %s").Format( buildType );
547#endif
548
549 AddBuildinfoRow(&informationStr, XO("Build type:"), buildType.Translation());
550
551#ifdef _MSC_FULL_VER
552 AddBuildinfoRow(&informationStr, XO("Compiler:"),
553 wxString::Format(wxT("MSVC %02d.%02d.%05d.%02d"), _MSC_VER / 100, _MSC_VER % 100, _MSC_FULL_VER % 100000, _MSC_BUILD));
554#endif
555
556#ifdef __GNUC_PATCHLEVEL__
557#ifdef __MINGW32__
558 AddBuildinfoRow(&informationStr, XO("Compiler:"), wxT("MinGW ") wxMAKE_VERSION_DOT_STRING_T(__GNUC__, __GNUC_MINOR__, __GNUC_PATCHLEVEL__));
559#else
560 AddBuildinfoRow(&informationStr, XO("Compiler:"), wxT("GCC ") wxMAKE_VERSION_DOT_STRING_T(__GNUC__, __GNUC_MINOR__, __GNUC_PATCHLEVEL__));
561#endif
562#endif
563
564#ifdef __clang_version__
565 AddBuildinfoRow(&informationStr, XO("Compiler:"), wxT("clang ") __clang_version__);
566#endif
567
568 // Install prefix
569#ifdef __WXGTK__
570 /* i18n-hint: The directory audacity is installed into (on *nix systems) */
571 AddBuildinfoRow(&informationStr, XO("Installation Prefix:"), \
572 wxT(INSTALL_PREFIX));
573#endif
574
575 // Location of cache
576 AddBuildinfoRow(&informationStr, XO("Cache folder:"), \
578 // Location of settings
579 AddBuildinfoRow(&informationStr, XO("Settings folder:"), \
581 // Location of data
582 AddBuildinfoRow(&informationStr, XO("Data folder:"), \
584 // Location of data
585 AddBuildinfoRow(&informationStr, XO("State folder:"), \
587
588 informationStr << wxT("</table>\n"); // end of build info table
589
590
591 informationStr
592 << wxT("<h3>")
593 /* i18n-hint: Libraries that are essential to audacity */
594 << XO("Core Libraries")
595 << wxT("</h3>\n<table>"); // start table of core libraries
596
597 AddBuildinfoRow(&informationStr, wxT("wxWidgets"),
598 XO("Cross-platform GUI library"), Verbatim(wxVERSION_NUM_DOT_STRING_T));
599
600 AddBuildinfoRow(&informationStr, wxT("PortAudio"),
601 XO("Audio playback and recording"), Verbatim(wxT("v19")));
602
603 AddBuildinfoRow(&informationStr, wxT("libsoxr"),
604 XO("Sample rate conversion"), enabled);
605
606 informationStr << wxT("</table>\n"); // end table of core libraries
607
608 informationStr
609 << wxT("<h3>")
610 << XO("File Format Support")
611 << wxT("</h3>\n<p>");
612
613 informationStr
614 << wxT("<table>"); // start table of file formats supported
615
616 #if defined(USE_LIBID3TAG)
617 AddBuildinfoRow(&informationStr, wxT("libmpg123"), XO("MP3 Importing"), enabled);
618 #else
619 AddBuildinfoRow(&informationStr, wxT("libmad"), XO("MP3 Importing"), disabled);
620 #endif
621
622 #ifdef USE_LIBVORBIS
623 AddBuildinfoRow(&informationStr, wxT("libvorbis"),
624 /* i18n-hint: Ogg is the container format. Vorbis is the compression codec.
625 * Both are proper nouns and shouldn't be translated */
626 XO("Ogg Vorbis Import and Export"), enabled);
627 #else
628 AddBuildinfoRow(&informationStr, wxT("libvorbis"),
629 XO("Ogg Vorbis Import and Export"), disabled);
630 #endif
631
632 #ifdef USE_LIBID3TAG
633 AddBuildinfoRow(&informationStr, wxT("libid3tag"), XO("ID3 tag support"),
634 enabled);
635 #else
636 AddBuildinfoRow(&informationStr, wxT("libid3tag"), XO("ID3 tag support"),
637 disabled);
638 #endif
639
640 # if USE_LIBFLAC
641 /* i18n-hint: FLAC stands for Free Lossless Audio Codec, but is effectively
642 * a proper noun and so shouldn't be translated */
643 AddBuildinfoRow(&informationStr, wxT("libflac"), XO("FLAC import and export"),
644 enabled);
645 # else
646 AddBuildinfoRow(&informationStr, wxT("libflac"), XO("FLAC import and export"),
647 disabled);
648 # endif
649
650 # if USE_LIBTWOLAME
651 AddBuildinfoRow(&informationStr, wxT("libtwolame"), XO("MP2 export"),
652 enabled);
653 # else
654 AddBuildinfoRow(&informationStr, wxT("libtwolame"), XO("MP2 export"),
655 disabled);
656 # endif
657
658 # if USE_QUICKTIME
659 AddBuildinfoRow(&informationStr, wxT("QuickTime"), XO("Import via QuickTime"),
660 enabled);
661 # else
662 AddBuildinfoRow(&informationStr, wxT("QuickTime"), XO("Import via QuickTime"),
663 disabled);
664 # endif
665
666 #ifdef USE_FFMPEG
667 AddBuildinfoRow(&informationStr, wxT("ffmpeg"), XO("FFmpeg Import/Export"), enabled);
668 #else
669 AddBuildinfoRow(&informationStr, wxT("ffmpeg"), XO("FFmpeg Import/Export"), disabled);
670 #endif
671
672 informationStr << wxT("</table>\n"); //end table of file formats supported
673
674 informationStr
675 << wxT("<h3>")
676 << XO("Features")
677 << wxT("</h3>\n<table>"); // start table of features
678
679 # if USE_NYQUIST
680 AddBuildinfoRow(&informationStr, wxT("Nyquist"), XO("Plug-in support"),
681 enabled);
682 # else
683 AddBuildinfoRow(&informationStr, wxT("Nyquist"), XO("Plug-in support"),
684 disabled);
685 # endif
686
687 # if USE_LADSPA
688 AddBuildinfoRow(&informationStr, wxT("LADSPA"), XO("Plug-in support"),
689 enabled);
690 # else
691 AddBuildinfoRow(&informationStr, wxT("LADSPA"), XO("Plug-in support"),
692 disabled);
693 # endif
694
695 # if USE_VAMP
696 AddBuildinfoRow(&informationStr, wxT("Vamp"), XO("Plug-in support"),
697 enabled);
698 # else
699 AddBuildinfoRow(&informationStr, wxT("Vamp"), XO("Plug-in support"),
700 disabled);
701 # endif
702
703 # if USE_AUDIO_UNITS
704 AddBuildinfoRow(&informationStr, wxT("Audio Units"), XO("Plug-in support"),
705 enabled);
706 # else
707 AddBuildinfoRow(&informationStr, wxT("Audio Units"), XO("Plug-in support"),
708 disabled);
709 # endif
710
711 # if USE_VST
712 AddBuildinfoRow(&informationStr, wxT("VST"), XO("Plug-in support"),
713 enabled);
714 # else
715 AddBuildinfoRow(&informationStr, wxT("VST"), XO("Plug-in support"),
716 disabled);
717 # endif
718
719 # if USE_LV2
720 AddBuildinfoRow(&informationStr, wxT("LV2"), XO("Plug-in support"),
721 enabled);
722 # else
723 AddBuildinfoRow(&informationStr, wxT("LV2"), XO("Plug-in support"),
724 disabled);
725 # endif
726
727 # if USE_PORTMIXER
728 AddBuildinfoRow(&informationStr, wxT("PortMixer"), XO("Sound card mixer support"),
729 enabled);
730 # else
731 AddBuildinfoRow(&informationStr, wxT("PortMixer"), XO("Sound card mixer support"),
732 disabled);
733 # endif
734
735 # if USE_SOUNDTOUCH
736 AddBuildinfoRow(&informationStr, wxT("SoundTouch"), XO("Pitch and Tempo Change support"),
737 enabled);
738 # else
739 AddBuildinfoRow(&informationStr, wxT("SoundTouch"), XO("Pitch and Tempo Change support"),
740 disabled);
741 # endif
742
743 # if USE_SBSMS
744 AddBuildinfoRow(&informationStr, wxT("SBSMS"), XO("Extreme Pitch and Tempo Change support"),
745 enabled);
746 # else
747 AddBuildinfoRow(&informationStr, wxT("SBSMS"), XO("Extreme Pitch and Tempo Change support"),
748 disabled);
749 # endif
750
751 informationStr << wxT("</table>\n"); // end of table of features
752
753 html->SetPage( FormatHtmlText( o.GetString() ) ); // push the page into the html renderer
754 S.Prop(2)
755 .Position( wxEXPAND )
756 .AddWindow( html ); // make it fill the page
757 // I think the 2 here goes with the StartVerticalLay() call above?
758 S.EndVerticalLay(); // end window
759 S.EndNotebookPage(); // end the tab
760}
761
762
763const wxString GPL_TEXT();
764
766{
767#if defined(HAS_PRIVACY_POLICY)
768 S.StartNotebookPage(XC("Legal", "about dialog"));
769#else
770 S.StartNotebookPage(XO("GPL License"));
771#endif
772
773#if defined(HAS_PRIVACY_POLICY)
774 S.Prop(0).StartPanel();
775 {
776 S.AddSpace(0, 8);
777 /* i18n-hint: For "About Audacity...": Title for Privacy Policy section */
778 S.AddVariableText(XC("PRIVACY POLICY", "about dialog"), true);
779
780 S.AddFixedText(
781 XO("App update checking and error reporting require network access. "
782 "These features are optional."));
783
784 /* i18n-hint: %s will be replaced with "our Privacy Policy" */
785 AccessibleLinksFormatter privacyPolicy(XO("See %s for more info."));
786
787 privacyPolicy.FormatLink(
788 /* i18n-hint: Title of hyperlink to the privacy policy. This is an object of "See". */
789 wxT("%s"), XO("our Privacy Policy"),
790 "https://www.audacityteam.org/about/desktop-privacy-notice/");
791
792 privacyPolicy.Populate(S);
793 }
794 S.EndPanel();
795
796 S.AddSpace(0, 8);
797#endif
798
799 S.Prop(1).StartPanel();
800 {
802 S.GetParent(), -1, wxDefaultPosition, wxSize(ABOUT_DIALOG_WIDTH, 264),
803 wxHW_SCROLLBAR_AUTO | wxSUNKEN_BORDER);
804
805 html->SetPage(FormatHtmlText(GPL_TEXT()));
806
807 S.Prop(1).Position(wxEXPAND).AddWindow( html );
808 }
809 S.EndPanel();
810
811 S.EndNotebookPage();
812}
813
814void AboutDialog::AddCredit( const wxString &name, Role role )
815{
816 AddCredit( name, {}, role );
817}
818
820 const wxString &name, TranslatableString format, Role role )
821{
822 auto str = format.empty()
823 ? Verbatim( name )
824 : TranslatableString{ format }.Format( name );
825 creditItems.emplace_back(std::move(str), role);
826}
827
829{
830 wxString s;
831
832 for (const auto &item : creditItems)
833 {
834 if (item.role == role)
835 {
836 s += item.description.Translation();
837 s += wxT("<br>");
838 }
839 }
840
841 // Strip last <br>, if any
842 if (s.Right(4) == wxT("<br>"))
843 s = s.Left(s.length() - 4);
844
845 return s;
846}
847
853 wxTextOutputStream *str, const wxChar * libname,
854 const TranslatableString &libdesc, const TranslatableString &status)
855{
856 *str
857 << wxT("<tr><td>")
858 << libname
859 << wxT("</td><td>(")
860 << libdesc
861 << wxT(")</td><td>")
862 << status
863 << wxT("</td></tr>");
864}
865
871 wxTextOutputStream *str,
872 const TranslatableString &description, const wxChar *spec)
873{
874 *str
875 << wxT("<tr><td>")
876 << description
877 << wxT("</td><td>")
878 << spec
879 << wxT("</td></tr>");
880}
881
883{
884 sActiveInstance = {};
885}
886
887void AboutDialog::OnOK(wxCommandEvent & WXUNUSED(event))
888{
889#ifdef __WXMAC__
890 Destroy();
891#else
892 EndModal(wxID_OK);
893#endif
894}
#define REV_IDENT
Definition: AboutDialog.cpp:67
static const auto ProgramName
Definition: AboutDialog.cpp:75
#define ABOUT_DIALOG_WIDTH
const wxString GPL_TEXT()
wxImage(22, 22)
wxT("CloseDown"))
#define LOGOWITHNAME_WIDTH
#define LOGOWITHNAME_HEIGHT
END_EVENT_TABLE()
#define str(a)
EVT_BUTTON(wxID_NO, DependencyDialog::OnNo) EVT_BUTTON(wxID_YES
const TranslatableString name
Definition: Distortion.cpp:76
XO("Cut/Copy/Paste")
XXO("&Cut/Copy/Paste Toolbar")
wxString FormatHtmlText(const wxString &Text)
Definition: HelpText.cpp:335
const wxString VerCheckHtml()
Definition: HelpText.cpp:359
#define XC(s, c)
Definition: Internat.h:37
#define safenew
Definition: MemoryX.h:10
IMPLEMENT_CLASS(cloud::ShareAudioToolbar, ToolBar)
@ eIsCreating
Definition: ShuttleGui.h:37
THEME_API Theme theTheme
Definition: Theme.cpp:82
#define S(N)
Definition: ToChars.cpp:64
TranslatableString Verbatim(wxString str)
Require calls to the one-argument constructor to go through this distinct global function name.
The AboutDialog shows the program version and developer credits.
Definition: AboutDialog.h:32
virtual ~AboutDialog()
@ roleEmeritusTeam
Definition: AboutDialog.h:50
void OnOK(wxCommandEvent &event)
void AddCredit(const wxString &name, Role role)
wxStaticBitmap * icon
Definition: AboutDialog.h:43
wxString GetCreditsByRole(AboutDialog::Role role)
AboutDialogCreditItemsList creditItems
Definition: AboutDialog.h:58
void AddBuildinfoRow(wxTextOutputStream *str, const wxChar *libname, const TranslatableString &libdesc, const TranslatableString &status)
Add a table row saying if a library is used or not.
void PopulateInformationPage(ShuttleGui &S)
: Fills out the "Information" tab of the preferences dialogue
AboutDialog(wxWindow *parent)
void CreateCreditsList()
Definition: AboutDialog.cpp:79
static AboutDialog * ActiveIntance()
void PopulateLicensePage(ShuttleGui &S)
void PopulateAudacityPage(ShuttleGui &S)
Abstract base class used in importing a file.
HtmlWindow Class.
Definition: HtmlWindow.h:37
An HtmlWindow that handles linked clicked - usually the link will go to our own local copy of the man...
Definition: HelpSystem.h:126
Derived from ShuttleGuiBase, an Audacity specific class for shuttling data to and from GUI.
Definition: ShuttleGui.h:630
wxColour & Colour(int iIndex)
Holds a msgid for the translation catalog; may also bind format arguments.
TranslatableString & Format(Args &&...args) &
Capture variadic format arguments (by copy) when there is no plural.
FILES_API FilePath ConfigDir()
Audacity user config directory.
FILES_API FilePath StateDir()
Audacity user state directory.
FILES_API FilePath CacheDir()
Audacity user cache directory.
FILES_API FilePath DataDir()
Audacity user data directory.