Talk:Generate Menu

=Former consolidated page contents=

Usage and examples

 * To generate into a new track: If there are no existing tracks, choose the required generator. If there are existing tracks, click outside the tracks in the gray background to deselect them, then Generate. To deselect tracks using the keyboard, press , then to deselect any further tracks, use up or down arrow and  as needed.
 * To insert generated audio at the cursor position: Place the cursor in the track, then Generate. The specified duration of audio will be inserted into the selected tracks at the cursor position, thus extending the length of the selected track(s).
 * To replace an existing selection with generated audio: Select the region, then Generate. The selected region(s) will be replaced with the generated audio. The total length of the selected tracks will remain the same, unless you change the length in the generator to replace the selection with a longer or shorter one. You can select an exact region to replace using Selection Toolbar.

Having placed the cursor or selected the region, there are several ways to select extra tracks so as to generate into those at the same time. The simplest method is to hold down SHIFT then use up or down arrow on the keyboard. See Audacity Selection for more details.

Duration: Type (or use the keyboard arrows) to enter the required Duration. If the first digit you want is highlighted, just type the whole number. If the required first digit is not highlighted, use or  arrow on your keyboard to move to the first digit, then type. You can also increment a highlighted digit with keyboard or  arrow instead of typing.

Selection Format: Whether generating in a selection or not, you can change the Selection Format to another unit of Duration so that the generation will be in those units. To do this, open the context menu by clicking the triangle to right of the digits. You can also open the menu by hovering over or selecting in the Duration digits, then right-clicking or using a keyboard equivalent.

Amplitude: All generators (except of course Silence) let you type in an amplitude value to set the loudness of the generated audio. Permitted values are between 0 (silence) and 1 (the maximum possible volume without clipping), with a default of 0.8.

Example 1: Insert two seconds of silence at the start of the track as a "lead-in":
 * 1) Click the "Skip to Start" button or press HOME to place the cursor at the start of the track.
 * 2) Choose Silence from the Generate Menu.
 * 3) Specify the two seconds silence. This works by the highlighted digit being overtyped with the figure you enter, then the highlight moving to the next digit. So if the value is showing at 30.000 seconds with "3" highlighted, type "02". To change the digit that is highlighted, click on the one you want to highlight or move the highlighted digit using the or  arrow keys on your keyboard.
 * 4) Click OK or press ENTER on your keyboard.

Example 2: Replace a 30 second section of audio starting at 1 minute 15 seconds with a tone:
 * 1) Click in the track at 1 minute 15 seconds (underneath "1:15" in the Timeline above the track).
 * 2) Drag your mouse to the right to select 30 seconds of audio, then release the mouse button.
 * 3) Choose Tone from the Generate menu.
 * 4) If you selected a little too much or not quite enough audio, move the highlighted digit as required using the or  arrow keys on your keyboard, then type over that digit.
 * 5) Specify the Waveform, Frequency and Amplitude in the dialog
 * 6) Click OK or press ENTER on your keyboard.

Chirp...

 * [[Image:ChirpGenerator_dialog_basic7.png|Chirp generator dialog]]

Produces four different types of tone waveform like the Tone Generator, but additionally allows setting of the starting and ending amplitude and frequency. Short tones can thus be made to sound very much like a bird-call. As with Tone, frequencies can be specified anywhere between 1 Hz and half the current project rate, as shown in the Selection Toolbar.

DTMF Tones...

 * [[Image:DTMFToneGenerator_dialog_basic7.png|DTMF tone generator dialog]]

Generates dual-tone multi-frequency (DTMF) tones like those produced by the keypad on telephones. Enter numbers from 0 to 9, lower case letters from a to z, and the * and # characters. You can also type the four "priority" tones used by the US Military (upper case A, B, C and D). As with most of the generators, you can choose the amplitude and overall duration of the sequence. Use the slider to select the ratio between the length of each tone in the series and the length of the silences between them. This ratio is displayed underneath the slider as the "duty cycle", along with the resulting duration of each tone and silence. For example, if you create four tones in a sequence lasting four seconds, with a duty cycle of 50%, the four tones and the three silences between them will all be the same length (571 milliseconds).

Noise...

 * [[Image:NoiseGenerator_dialog_basic7.png|Noise generator dialog]]

Choose amplitude and one of three different "colors" of noise. White noise is that which has the greatest ability to mask other sounds, as it has similar energy at all frequency levels. Pink noise and brown noise both have more energy at lower frequencies, especially brown noise, which has the most muffled, low pitched sound of the three types.

Silence...

 * [[Image:SilenceGenerator_dialog_basic7.png|Silence generator dialog, as it would appear if a region of just under 4.5 seconds had been selected at 44100 Hz project rate]]

Creates audio of zero amplitude, the only configurable setting being duration. When applied to an audio selection, the result is identical to Edit > Remove Audio > Silence Audio.

Tone...

 * [[Image:ToneGenerator_dialog_basic7.png|Tone generator dialog]]

Choose amplitude, one of four different tone waveforms: Sine, Square, Sawtooth or Square (no alias), and a frequency between 1 Hz and half the current project rate (as shown in the Selection Toolbar). One half is chosen because a given sample rate can only carry frequencies up to half that rate. Although frequencies above 20000 Hz cannot be heard by most humans, generating at up to half the sample rate (22050 Hz at Audacity's default 44100 Hz) can have scientific uses, for example in measuring impulse responses. Note that creating tones at or close to half a given sample rate may (correctly) generate either silence or a pulsing rather than steady tone, according to the type of waveform chosen.

Plug-in Generators
Any additional generators which appear underneath the menu divider are Nyquist or LADSPA plug-ins. Audacity includes the following three Nyquist generators, but more are available on Download Nyquist Plug-ins on our Wiki.

Click Track...

 * [[Image:ClickTrackGenerator_dialog_basic7.png|Click track generator dialog]]

Generates a track with regularly spaced sounds at a specified tempo and number of beats per measure (bar). This can be used like a metronome for setting a pulse to record against. To do this, enable "Play other tracks while recording new one" in the Recording Preferences. Any length of track can be created by adjusting "number of measures" accordingly, and the type and pitch of the sound can be customized. Once created, the track can be edited (for example, its volume changed) like any audio track. Note: When exporting your finished recording, use the Track Control Panel to either close or mute the Click Track, so that it's not audible in the recording.

Pluck...

 * [[Image:PluckGenerator_dialog_basic7.png|Pluck generator dialog]]

A synthesized pluck tone with abrupt or gradual fade-out, and selectable pitch corresponding to a MIDI note.

Risset Drum...

 * [[Image:RissetDrumGenerator_dialog_basic7.png|Risset drum generator dialog]]

Produces a realistic drum sound consisting of a sine wave ring-modulated by narrow band noise, an enharmonic tone and a relatively strong sine wave at the fundamental. The length of the drum sound is determined by the "Decay" field.

-- Ed 16 November 2012 this is the outdated content: I'd forgotten about this. I still have doubts when extending this idea to long menus like Effect. Does anyone like this? It has some merit, basically a custom TOC on each menu page, for example it would replace our custom TOC near the top of Edit Menu. Gale- ages ago OK, so are we settled then on the style of these menu pages? We have both an image with quick summary text as a table (and sort out screen reader issues later, or avoid them some other way with CSS) and a more detailed, headered explanation below with examples, maybe including why you might want to use this etc.? I think that is OK with me, it lets the reader skip away quickly if they are not interested (a bit like the "Intro" idea on our main Wiki, which might be useful on some pages). Incidentally, DB has said screenreaders don't read the "legend" tag in these tables so we may as well not bother... The image ideally ought to include Risset Drum as this is in source code and we are currently intending to include it in release builds as users often ask for a quick Drum Generator. James- ages ago Yes, I think we're settled on this style, quick version, then detail. If we want to try variations on styling (widths, borders, colours, TOC enabled/disabled), let's use this page, Generate, as the prototype for the family, and if we agree we like a change apply it to the others later.
 * Gale 16Nov12: