Nyquist Prompt
From Audacity Development Manual
Revision as of 10:48, 9 October 2014 by Windinthew (talk | contribs) (Added text for new Preview button (and reorganised/added some extra text).)
Nyquist Prompt lets you run and debug code snippets for your own plug-ins created using the Nyquist programming language. See Nyquist Plug-ins Reference - Audacity Wiki for more information about writing Nyquist code.
To use Nyquist Prompt, first select some audio. If the code you want to test generates audio, you can avoid the initial steps of preparing an audio selection by installing the Nyquist Generate Prompt plug-in instead.
Gale 14May13: There is some discussion of adding Steve's improved Nyquist Generate Prompt to Audacity. If this is only offered on Wiki, we should link to it here http://wiki.audacityteam.org/wiki/Nyquist_Generate_Plug-ins#Nyquist_Generate_Prompt.
- Accessed by:
Enter Nyquist Command
Type the command as required. Enter on the keyboard moves the cursor to a new line. The code is lost after quitting Audacity, so you may want to copy any valuable code before quit.
Buttons
- Preview: Previews what the code would sound like if applied. As with preview in all effects, playback lasts for the length of preview specified in Playback Preferences.
Plug-in authors should use this button to test if a Preview button in their plug-in would accurately preview the effect as applied to the waveform. Preview should not be used in effects that change over time (such as a fade effect) because Audacity's preview as currently implemented only applies the effect to the length of the previewed selection.
- Debug: The Debug button works as it does in all Nyquist effects. Clicking this button shows a progress dialog for processing the code, followed by an uneditable "Nyquist Output" window listing any errors or other output. Click to close the output window and process the command, or use Enter on the keyboard. Hold Ctrl on Windows or Command on Mac before pressing Enter.
- OK: Applies the code to the waveform selection without debug output. Your entered code will be retained next time you open Nyquist Prompt in the Audacity session. Using the keyboard, hold Ctrl on Windows (or Command on Mac) then press Enter.
- Cancel: No code is processed or debugged. Any code you entered after opening the window this time will be discarded.
|
If the code you enter cannot be recognized as Nyquist code, an error message "Error in Nyquist code" will appear with a hint about making a correction. |
Peter 25Aug13: Modules Preferences were made experimental in r12363 and remain so for 2.0.4.
Advanced users: An experimental "Nyquist Workbench" graphical editor module is available if you compile the module and Audacity from source code, then enable the module in Modules Preferences.
- Peter 06Sep14: ToDo-1 Modules Preferences has been turned on again for 2.0.7
