Completed Proposal Improvements to Export progress dialogs

From Audacity Wiki
Revision as of 15:40, 18 November 2017 by PeterSampson (talk | contribs) (PCM exporter (WAV): ====Change required==== change "Exporting the entire project" to "'''Exporting the audio ...'''")
Jump to: navigation, search
Proposal pages help us get from feature requests into actual plans. This page is a proposal to ...
Proposal pages are used on an ongoing basis by the Audacity development team and are open to edits from visitors to the wiki. They are a good way to get community feedback on a proposal.

  • Note: Proposals for Google Summer of Code projects are significantly different in structure, are submitted via Google's web app and may or may not have a corresponding proposal page.

The Problem

Because we use a common dialog for Export and Export Multiple we should have a form of words that is applicable to both and accurate in both cases. The current form of words is inaccurate when used for the Export Multiple use case as it refers to "Exporting the entire project..." when if fact it is exporting a labelled section only. We also have inconsistent wording usage between the various export forms with two different variations.

For Export Selected Audio we have a set of messages applicable only the exporting a selection of the audio

Proposed Feature

In the dialogs for Export and Export Multiple change the wording to read "Exporting the audio ..."

This should involve nine simple textual changes - and be very simple and straightforward.

Developer/QA Backing


Use Cases



It's a bit peculiar how this is done, in that the message comes from the exporter, so each exporter has it's own messages. For each exporter there is a choice of two messages, depending on whether the "selectionOnly" flag is set or not.

PCM exporter (WAV)

existing strings

wxString::Format(_("Exporting the selected audio as %s"),
formatStr.c_str()) :
wxString::Format(_("Exporting the entire project as %s"),

Change required

change "Exporting the entire project" to "Exporting the audio ..."

FFmpeg exporter

wxString::Format(_("Exporting selected audio as %s"),
ExportFFmpegOptions::fmts[mSubFormat].Description()) :
wxString::Format(_("Exporting entire file as %s"),

FLAC exporter

_("Exporting the selected audio as FLAC") :
_("Exporting the entire project as FLAC"));

MP2 Exporter

wxString::Format(_("Exporting selected audio at %ld kbps"), bitrate) :
wxString::Format(_("Exporting entire file at %ld kbps"), bitrate));

MP3 Exporter

if (rmode == MODE_SET) {
title.Printf(selectionOnly ?
_("Exporting selected audio with %s preset") :
_("Exporting entire file with %s preset"),
FindName(setRates, WXSIZEOF(setRates), brate).c_str());
else if (rmode == MODE_VBR) {
title.Printf(selectionOnly ?
_("Exporting selected audio with VBR quality %s") :
_("Exporting entire file with VBR quality %s"),
FindName(varRates, WXSIZEOF(varRates), brate).c_str());
else {
title.Printf(selectionOnly ?
_("Exporting selected audio at %d Kbps") :
_("Exporting entire file at %d Kbps"),

OGG exporter

_("Exporting the selected audio as Ogg Vorbis") :
_("Exporting the entire project as Ogg Vorbis"));

Command line exporter

_("Exporting the selected audio using command-line encoder") :
_("Exporting the entire project using command-line encoder"));

MIDI (Note tracks) and Label tracks

There would appear to be no progress dialogs for the Export of Note tracks or Label tracks, presumably because both are so rapid.

It would probably be better if all of these messages were handled in one place rather than multiple (near but inconsistent) duplications.

GUI Examples

Not required

Previous Feature Requests relating to this proposal