View source for Sampler Waveform

= Sample Editor =

Renoise has a strong focus on samples as instruments, featuring many pattern effects to modify their playback, and to aid with this there is a built-in Sample Editor. New samples (mostly for short looping wavetable) can also be created here with the simple drawing function.

Any changes made within the Sample Editor are exclusive to the samples of that particular Renoise song. The source samples are never modified unless you explicitly save and overwrite the file by saving it in the [[Disk Browser]]. Besides being non-destructive to the sample files, the Sample Editor also supports full and endless undo/redo-ing. This can create an unwanted overhead when used with very large samples, so this feature can be disabled. See below for more information.


== Overview ==

[[image:2.7_sample_editor_general.png|frameless|800px|left]]  <br style="clear: both" />

The editor is divided into three parts:

# The upper bar with the sample selection options, sample name, rate and bit-depth on the left. The draw, slice and snapping controls on the right.
# The central area displaying the waveform with two horizontal rulers along the top and bottom. Here you view the sample that is currently selected and choose what you want to edit. Loop points and slice markers (explained below) are also displayed here.
# The lower section featuring the buttons and options used to edit or modify the sample.


== Wave View ==

=== Upper and Lower Rulers ===

You can individually set the upper and lower rulers' display measure by right-clicking on them and selecting an option from the context menu:

[[image:vvoois_renoise_sample_editor_ruler_options.png]]

=== Lower Zoom Bar ===

As an alternative to using the mouse or keyboard shortcuts to navigate around in the waveform, you can use the zoom-bar beneath the Lower Ruler to scroll or zoom. Drag the bar in the middle to scroll and drag the handles to extend/shrink the waveform view. Clicking on a free space next to the bar will jump a page in that direction.

=== Navigate Using the Mouse ===

* Left Mouse Button:
** Single-click sets an offset/cursor position.
** Click and drag spans an area in the editor.
** Click and drag with ''"Left Shift"'' extends/shrinks either side of the selection area.
** Double-click selects the entire visible area of the waveform.
** Click, drag and move the cursor outside the wave editor to the left or right to zoom out. Holding down ''"Left Control"'' while doing so will speed up the zooming. Holding down ''"Left Shift"'' while doing so will scroll instead of zoom.

* Right Mouse Button:
** Single-click opens a context menu.
** Click and drag extends/shrinks either side of the selection area (same as left-click and drag with ''"Left Shift"'').
** Click, drag and move the cursor outside the wave editor to the left or right to zoom out. Holding down ''"Left Control"'' while doing so will speed up the zooming. Holding down ''"Left Shift"'' while doing so will scroll instead of zoom.

* Middle Mouse Button:
** Single-click a point in the sample: Plays the sample from the clicked position to the end of the visible waveform.
** Click and drag plays the selected area of waveform.

* Scroll Wheel:
** Zoom in/out of the waveform view.
** Hold ''"Left Alt"'' while scrolling to scroll horizontally instead of zooming.

Note that the waveform view will zoom from the position of the mouse pointer. So, to get a closer look of a specific area, hold the mouse pointer over that area and start scrolling with the mouse wheel.

=== Navigate Using Keyboard Shortcuts ===

* '''Arrow Left/Right:''' Move cursor to the left/right. In combination with ''"Left Shift"'', a selection is created.
* '''Arrow Down/Up:''' Zoom in/out at the cursor position.
* '''Home/End Key:''' Move cursor to the start/end of the waveform. In combination with ''"Left Shift"'', a selection is created.
* '''Enter:''' Play/restart the sample from cursor position.

Default operations such as Copy/Paste (''"Left Control/Command + C"'', ''"Left Control/Command + V"'') etc. are available as well.


== Drawing ==

With Draw Mode [[image:vvoois_renoise_se_draw.png]] enabled you can freely draw on the central sample waveform area with the mouse. Simply hold down the left mouse button and drag to draw. This can be incredibly useful for making adjustments to existing sounds, such as removing clicks.

To draw a brand new sample, enable draw mode, select an empty instrument slot and then draw in the waveform area. You will then be prompted to create a new sample, whose parameters you can adjust via the dialog box.


== Slicing Markers ==

With Renoise's slice markers you can non-destructively split a sample in slices, which can correspond to individual drum hits, notes, vocal phrases etc. You are then able to trigger them from the keyboard or via the [[Pattern Effect Commands#Sample Commands|09xx Pattern Effect Command]], where the '''''xx''''' value corresponds to a particular slice.

As you add slices to the sample, the [[Sample Keyzones]] editor will automatically lay these out across the keyboard according to its current [[Sample_Keyzones#Automatically_Assigning_Zones_to_Samples|Drum Kit]] settings, allowing you to trigger each slice from a different key on the keyboard.

The individual sample slots in a sliced sample cannot be directly edited. However, all [[Instrument_Settings#Sample_Properties|sample options]] like looping, volume, pan etc. are editable per slice. A newly created slice will inherit the master sample's [[Instrument Settings]] values.

Left-click dragging on the slice tabs at the top of the waveform will allow you to move the markers around. Right-clicking on a slice tab will bring up a menu with the option to select all markers, delete the current marker or delete all markers.

The slicing controls are located at the top right of the Sample Editor.

=== Slice Controls ===

* [[Image:2.7_sample_editor_slice_button.png]] - Activating the Slice button will change the mouse pointer to the Slice Marker Tool. With this you can left-click on the waveform to it into different sections.
* [[Image:2.7_sample_editor_auto_slice_button.png]] - Automatically insert markers into the waveform at points where beats/transients are detected.
* [[Image:2.7_sample_editor_auto_slice_peak_detection_ratio.png]] - The sensitivity of the auto-slicing beat detection can be adjusted using this value box. Higher values will lead to more markers being inserted.
* [[Image:2.7_sample_editor_slice_termination_mode.png]] - Toggles whether a slice will continue playing the rest of the waveform once it has reached the end or not.


== Snapping ==

[[image:2.7_sample_editor_snapping_modes.png]] 

Snapping applies to the waveform when selecting with the mouse, using keyboard shortcuts to navigate, and when applying and dragging loop points. It can be useful to have ''"0 Crossing"'' enabled, as this will ensure that cutting and pasting parts of a sample do not produce clicks in the audio, because the start and end points will always match up at 0.

Selecting ''"09 Effect"'' will snap to the 09 markers typically shown along the bottom of the waveform, while selecting ''"Markers"'' will cause the selection to "stick" to sample slice markers as the mouse pointer approaches them.

Snapping to beats (the length of time for a single beat) is useful when cutting out beats from loops, in combination with the ''"Copy to new Instrument"'' context menu/keyboard shortcut.


== Zooming ==

*[[image:vvoois_renoise_se_view_full.png]] - View full sample (zoom out to show the whole sample, horizontally and vertically).
*[[image:vvoois_renoise_se_zoom_in_vert.png]] - Zoom in one step vertically.
*[[image:vvoois_renoise_se_zoom_out_vert.png]] - Zoom out one step vertically.



== Processing Buttons and Options ==

Most processing options below which change the sample (Cut/Copy/Paste or Fading) will apply to the whole sample unless a specific area has been selected.

=== Undo/Redo Support ===

*[[image:vvoois_renoise_se_trigger_undo.png]] - Enable/disable undo in the Sample Editor. When working with very large samples, temporarily disabling undo may be useful to save time. Renoise saves all undo/redo processing on disk, so running out of memory should not be a problem.

=== Create / Adjust Sample Properties ===

*[[image:vvoois_renoise_se_properties.png]] / [[image:vvoois_renoise_se_create.png]] - Edit sample properties / Create new sample.

When a sample is loaded, you can change basic sample properties here:

[[image:vvoois_renoise_se_sample_properties.png]]  <br style="clear: both" />

When no sample is loaded, you can create a new sample. This can be useful to create small looped hand-drawn samples:

[[image:vvoois_renoise_se_sample_create.png]]  <br style="clear: both" />

=== Cut/Copy/Paste ===

*[[image:vvoois_renoise_se_cut.png]] - Cuts the selection or the whole sample if nothing is selected.
*[[image:vvoois_renoise_se_crop.png]] - Crop to selection (delete everything outside of the selection).
*[[image:vvoois_renoise_se_copy.png]] - Copy the selection or whole sample into the clipboard.
*[[image:vvoois_renoise_se_paste.png]] - Paste the clipboard content into the waveform at the cursor position, or paste over the selected area.
*[[image:vvoois_renoise_se_mix_paste.png]] - Mix-Paste the clipboard content with the selection.

=== Amplitude & Offset ===

*[[image:vvoois_renoise_se_adjust_volume.png]] - Change the volume of the sample or selection (will open up a dialog to specify the exact amount).
*[[image:vvoois_renoise_se_maximize.png]] - Raises the volume of the sample or selection to the maximum possible value without clipping.
*[[image:vvoois_renoise_se_dc_offset.png]] - Centre the sample or selection to the DC-line. Fixes vertical DC offsets.

=== Fading ===

*[[image:vvoois_renoise_se_fade_in.png]] - Fade the sample in linearly (you can also fade in logarithmically via the context menu or shortcuts).
*[[image:vvoois_renoise_se_fade_out.png]] - Fade the sample out linearly (you can also fade out logarithmically via the context menu or shortcuts).
*[[image:vvoois_renoise_se_crossfade.png]] - Mix the left part of the selection with the right part of the selection by fading them together. This is useful to create smooth loops.  Try cross fading the loop range only.

=== Reverse & Swap === 

*[[image:vvoois_renoise_se_reverse.png]] - Reverses the sample or selection.
*[[image:vvoois_renoise_se_stereo_reverse.png]] - Cross-reverse the sample or selection by reversing each stereo channel in the opposite manner (left channel is mirrored to the right, right channel is mirrored to the left). 

=== Process Track FX ===

*[[image:vvoois_renoise_se_trackfx.png]] - Apply the current track's DSP effect chain to the sample. This way you can apply native or plugin effects directly to the sample's waveform. Note that this will not extend the length of the sample (in the case of reverbs, delays etc. where the effect lasts longer than the original sample length).
*[[image:vvoois_renoise_se_smooth.png]] - Smooths the sample. A simple interpolation which removes hiss and sharp edges from the waveform. Useful to smooth out hand-drawn samples.

=== Loop Controls ===

*[[image:vvoois_renoise_se_loopstart.png]] - Set loop start point from the current cursor position. When a selection is present, the loop start and end points will be set to the selection area.
*[[image:vvoois_renoise_se_loop_end.png]] - Set loop end point from the current cursor position. When a selection is present, the loop start and end points will be set to the selection area.
* - Toggles whether a sample will finish its current loop upon a Note-Off.

*[[image:vvoois_renoise_se_looptype.png]] - Set the loop type or turn it off.

*[[image:vvoois_renoise_se_toggle_loopeditor.png]] - Enable/disable the Loop Fine Editor (see [[#Loop_Fine_Editor|Loop Fine Editor]]).

=== Play/Stop and Record ===

*[[image:vvoois_renoise_se_play_stop.png]] - Start/Stop playing sample from the cursor position to the end of the visible waveform, or Start/Stop playing the selection if one is present.
*[[image:vvoois_renoise_se_note.png]] - Set the note that will be played when pressing the Play button or pressing ''"Enter"''.
*[[image:vvoois_renoise_se_prehear.png]] - Select where the sample should be played back: On the Master Track to bypass the current track's effects, or on the selected track to hear the sample with the currently active effects.
*[[image:vvoois_renoise_se_record.png]] - Open up the record dialog box, to record new samples from various sources (e.g. microphone, line-in etc.).

=== Current Selection Range Indicator === 

*[[image:vvoois_renoise_se_offset.png]] - Next to the record button, the current cursor position or selection range positions are shown in the format of the Lower Ruler. To change the format, right-click on the Lower Ruler and choose from the list.


== Mix-Paste and other Copy/Paste Operations ==

=== Mix-Paste ===

Renoise offers a simple Mix-Paste functionality. To use it, simply copy a sample or a selection of a sample into the clipboard, then click on Mix-Paste. A dialog will appear that offers options on how to mix the clipboard content with the existing content:

[[image:vvoois_renoise_se_mix_paste_dialog.png]]  <br style="clear: both" />

=== Copy Into New Sample/Instrument ===

You can automatically copy regions of a sample into either a new sample in the current instrument or a new instrument. This is done via the right-click context menu or keyboard shortcuts. This can be very useful if you want to slice up a loop and create a drum-kit from the selections, or when copying parts of a large sample for further playback and editing.


== Copying/Paste With External Sample Editors (Windows only) ==

Renoise shares its clipboard content with the system on Windows, meaning you can quickly swap around sample data to and from Renoise when using an external sample editor that supports this feature. In many external editors you have to select/activate this feature first. To find out how to do this, please look at the external editor's manual and search for the keywords: ''"System Clipboard"'', ''"Copy"''.


== Loop Fine Editor ==

The Loop Fine Editor shows you a sample-precise overview of the loop start and end points, which is extremely useful for creating smooth loops. In most cases, loops should start and end at the same amplitude value to avoid clicks.

[[image:2.7_sample_editor_loop_fine_editor.png]]  <br style="clear: both" />