Audio Player - Revision history

Oscaracena: /* MIDI Sample Player */

2024-08-15T20:09:28Z

MIDI Sample Player

Riban: Updates supported codecs

2024-02-20T07:34:18Z

Updates supported codecs

Riban: Add configurable root note

2024-02-19T10:42:38Z

Add configurable root note

Riban: Add reverse play/scrub

2024-02-19T10:30:17Z

Add reverse play/scrub

Riban: Add info about file formats and metadata

2024-02-18T17:07:15Z

Add info about file formats and metadata

Riban: Add speed and pitch controls

2024-02-13T11:24:47Z

Add speed and pitch controls

Riban: Change "Beats In File" mode to "Tempo Playback"

2024-02-12T10:27:33Z

Change "Beats In File" mode to "Tempo Playback"

Riban: Update splicer mode.

2024-02-12T10:26:25Z

Update splicer mode.

Riban: Update with varispeed info

2024-02-12T10:25:06Z

Update with varispeed info

Riban: Adds screenshot

2024-02-11T07:54:14Z

Adds screenshot

@@ Line 28: / Line 28: @@
 There is an ADSR amplitude envelope that affects MIDI note-on/off triggered playback. A non-zero release time will cause playback to continue after note-off.
-Playback is monophonic, i.e. only one playback will occur at any time. Legato is implemented, i.e. pressing a new note before releasing the previous will not restart playback or the ADSR envelope whereas releasing a note then pressing the next will restart playback from the start of the file (or crop marker) and restart the ADSR envelope. An exception is playing the same note without sending note-off will restart. (This is not normally ypossible from a single keyboard.)
+Playback is monophonic, i.e. only one playback will occur at any time. Legato is implemented, i.e. pressing a new note before releasing the previous will not restart playback or the ADSR envelope whereas releasing a note then pressing the next will restart playback from the start of the file (or crop marker) and restart the ADSR envelope. An exception is playing the same note without sending note-off will restart. (This is not normally possible from a single keyboard.)
 === Tempo Playback ===

@@ Line 39: / Line 39: @@
 === Files ===
-Audio Player can load and save files using Zynthian's ''presets'' mechanism. Files are stored in the ''capture'' directory on the internal storage and on any USB attached storage. These different volumes appear as ''Banks'' in the presets mechanism. The following file formats can be loaded:
+Audio Player can load and save files using Zynthian's ''presets'' mechanism. Files are stored in the ''capture'' directory on the internal storage and on any USB attached storage. These different volumes appear as ''Banks'' in the presets mechanism. The following file formats (CODECS) can be loaded:
-* WAV
+* WAV (all bit depths)
 * FLAC
-* OGG/VORBIS
+* OGG (/VORBIS)
-* MP3
+* MP3 (MPEG I/II, layer 3)
 * AAC
-(There are actually many more file formats supported but these have been tested.) Any samplerate can be loaded and the audio is converted to Zynthian's native samplerate. Files are always saved as 32-bit float WAV at Zynthian's naitive samplerate.
+Note: The CODEC appreviations listed above are used as the filename extension when searching for audio files.
 Zynthian reads and writes various metadata including:

@@ Line 24: / Line 24: @@
 === MIDI Sample Player ===
-Audio Player will act as a MIDI controlled sample player. A MIDI note-on will start playback which will continue until MIDI note-off is received. The root note is middle C4 (MIDI note 60). Other notes will playback at the associated pitch change, e.g. C5 (MIDI note 72) will play at double pitch. Playback speed remains constant, i.e. the duration would be the same, only the pitch shifted. MIDI sustain pedal will sustain playback after the key is released. This controls the "sustain pedal" control that can also be manually set to sustain playback. MIDI Pitchbend will change the pitch by up to +/- 2 semitones by default. This range can be adjusted with the "bend range" control up to +/- 24 semitones (2 octaves) with a minimum value of 0 (pitchbend disabled).
+Audio Player will act as a MIDI controlled sample player. A MIDI note-on will start playback which will continue until MIDI note-off is received. The default root note is middle C4 (MIDI note 60) but this can be changed. Other notes will playback at the associated pitch change, e.g. C5 (MIDI note 72) will play at double pitch. Playback speed remains constant, i.e. the duration would be the same, only the pitch shifted. MIDI sustain pedal will sustain playback after the key is released. This controls the "sustain pedal" control that can also be manually set to sustain playback. MIDI Pitchbend will change the pitch by up to +/- 2 semitones by default. This range can be adjusted with the "bend range" control up to +/- 24 semitones (2 octaves) with a minimum value of 0 (pitchbend disabled).
 There is an ADSR amplitude envelope that affects MIDI note-on/off triggered playback. A non-zero release time will cause playback to continue after note-off.
@@ Line 35: / Line 35: @@
 === Splicer ===
-As described above, it is possible to add cue point markers. If there are any cue point markers defined then MIDI playback behaviour changes. Instead of MIDI notes playing back at different pitch, the segments of audio between the markers are treated as separate notes. Middle C4 (MIDI note 60) will play the first segment, C#4 the second segment, etc. Playback is monophonic, i.e. only one segment will play at a time. Each segment responds with the (global) ADSR amplitude envelope. Other pitch adjustments will still operate, e.g. pitchbend, varispeed, etc.
+As described above, it is possible to add cue point markers. If there are any cue point markers defined then MIDI playback behaviour changes. Instead of MIDI notes playing back at different pitch, the segments of audio between the markers are treated as separate notes. The ''root note'' will play the first segment, C#4 the second segment, etc. Playback is monophonic, i.e. only one segment will play at a time. Each segment responds with the (global) ADSR amplitude envelope. Other pitch adjustments will still operate, e.g. pitchbend, varispeed, etc.
 === Files ===

@@ Line 19: / Line 19: @@
 By double tapping the screen, markers can be modified. This includes setting the crop and loop markers to the position tapped and adding and removing cue point markers. Cue point markers can be used to identify points of interest in the file and __playhead position can be shifted between these points with the "play cue" controller (not yet implemented)__. These markers can be selected with the "cue point" control and moved with the "cue pos" control or dragged on a touchscreen.
-Playback speed and pitch can be adjusted separately and there is also a ''varispeed'' control which adjusts playback speed and pitch like a tape machine.
+Playback speed and pitch can be adjusted separately and there is also a ''varispeed'' control which adjusts playback speed and pitch like a tape machine. Varispeed can be set zero to pause playback and to a negative value to play backwards. This can be used to ''scrub'' the audio.
 These controls allows manipulation of the playback and most can be used in other modes described below.

← Older revision		Revision as of 17:07, 18 February 2024
Line 38:		Line 38:

	As described above, it is possible to add cue point markers. If there are any cue point markers defined then MIDI playback behaviour changes. Instead of MIDI notes playing back at different pitch, the segments of audio between the markers are treated as separate notes. Middle C4 (MIDI note 60) will play the first segment, C#4 the second segment, etc. Playback is monophonic, i.e. only one segment will play at a time. Each segment responds with the (global) ADSR amplitude envelope. Other pitch adjustments will still operate, e.g. pitchbend, varispeed, etc.		As described above, it is possible to add cue point markers. If there are any cue point markers defined then MIDI playback behaviour changes. Instead of MIDI notes playing back at different pitch, the segments of audio between the markers are treated as separate notes. Middle C4 (MIDI note 60) will play the first segment, C#4 the second segment, etc. Playback is monophonic, i.e. only one segment will play at a time. Each segment responds with the (global) ADSR amplitude envelope. Other pitch adjustments will still operate, e.g. pitchbend, varispeed, etc.
		+
		+	=== Files ===
		+
		+	Audio Player can load and save files using Zynthian's ''presets'' mechanism. Files are stored in the ''capture'' directory on the internal storage and on any USB attached storage. These different volumes appear as ''Banks'' in the presets mechanism. The following file formats can be loaded:
		+
		+	* WAV
		+	* FLAC
		+	* OGG/VORBIS
		+	* MP3
		+	* AAC
		+
		+	(There are actually many more file formats supported but these have been tested.) Any samplerate can be loaded and the audio is converted to Zynthian's native samplerate. Files are always saved as 32-bit float WAV at Zynthian's naitive samplerate.
		+
		+	Zynthian reads and writes various metadata including:
		+
		+	* Cue markers (used for splicing)
		+	* Quantity of beats in sample (used for tempo sync)
		+	* Looping enabled
		+	* Loop start / end markers
		+	* MIDI root key (the note that will trigger playback at naitive pitch)
		+	* Gain (+/-100dB)
		+
		+	These parameters modify configuration of Audio Player and are saved into any new files based on the current settings (including global tempo).
		+
		+	Be aware that a file may contain some metadata that will configure the Audio Player so check it is behaving as expected after loading a new file. It is recommended to resave files to ensure the expected configuration is stored in its metadata.

@@ Line 32: / Line 32: @@
 Playback is monophonic, i.e. only one playback will occur at any time. Legato is implemented, i.e. pressing a new note before releasing the previous will not restart playback or the ADSR envelope whereas releasing a note then pressing the next will restart playback from the start of the file (or crop marker) and restart the ADSR envelope. An exception is playing the same note without sending note-off will restart. (This is not normally ypossible from a single keyboard.)
-=== Beats In File ===
+=== Tempo Playback ===
 There is a control called, "beats" which allows the user to specify the quantity of beats in the audio file (between the crop markers). If this is non-zero then the file will playback at a rate that matches the beats to Zynthian's global tempo, e.g. if the file is set to 4 beats and the tempo is set to 120BPM then the file duration will be adjusted to 2s. The pitch is not changed. This allows an audio clip to be played in sync with Zynthian's sequencer and MIDI player. There is integration with ZynPad to allow a pad to control audio player in this way.

← Older revision		Revision as of 10:26, 12 February 2024
Line 37:		Line 37:
	=== Splicer ===		=== Splicer ===

−	~~'''''Not yet implemented:'''~~ As described above, it is possible to add cue point markers. If there are any cue point markers defined then MIDI playback behaviour changes. Instead of MIDI notes playing back at different pitch, the segments of audio between the markers are treated as separate notes. Middle C4 (MIDI note 60) will play the first segment, C#4 the second segment, etc. Playback is monophonic, i.e. only one segment will play at a time. Each segment responds with the (global) ADSR amplitude envelope.''	+	As described above, it is possible to add cue point markers. If there are any cue point markers defined then MIDI playback behaviour changes. Instead of MIDI notes playing back at different pitch, the segments of audio between the markers are treated as separate notes. Middle C4 (MIDI note 60) will play the first segment, C#4 the second segment, etc. Playback is monophonic, i.e. only one segment will play at a time. Each segment responds with the (global) ADSR amplitude envelope. Other pitch adjustments will still operate, e.g. pitchbend, varispeed, etc.

@@ Line 17: / Line 17: @@
 The information shown in the control view can be switched with the "info" control between: None, file duration, play position, remaining playback time, length of loop, samplerate of file, file audio encoding (CODEC) or filename.
-'''''Not yet implemented:''' By double tapping the screen, cue point markers can be added. These can be used to identify points of interest in the file and playhead position can be shifted between these points with the "play cue" controller. These markers can be selected with the "cue point" control and dragged or moved with the "cue pos" control.''
+By double tapping the screen, markers can be modified. This includes setting the crop and loop markers to the position tapped and adding and removing cue point markers. Cue point markers can be used to identify points of interest in the file and __playhead position can be shifted between these points with the "play cue" controller (not yet implemented)__. These markers can be selected with the "cue point" control and moved with the "cue pos" control or dragged on a touchscreen.
-'''''Not yet implemented:''' A control allows the audio to be played forwards and backwards at the speed of the control to give a scrub or record scratch effect. Another control adjusts playback speed like a tape machine varispeed with pitch and speed changing in unison. (Maybe varispeed, reverse and scrub use the same control?)''
+The __varispeed__ control adjusts playback speed like a tape machine varispeed with pitch and speed changing in unison.
 These controls allows manipulation of the playback and most can be used in other modes described below.

← Older revision		Revision as of 07:54, 11 February 2024
Line 1:		Line 1:
	== Audio Player ==		== Audio Player ==
		+	[[File:Audioplayer.png\|Audio Player\|600px]]

	The Zynthian Audio Player is an engine that loads and plays a variety of formats of audio files including WAV, OGG, MP3, FLAC, etc. In its simplest form it plays the loaded file from start to end or until it is paused or stopped but there are many modes it can operate in which are described here.		The Zynthian Audio Player is an engine that loads and plays a variety of formats of audio files including WAV, OGG, MP3, FLAC, etc. In its simplest form it plays the loaded file from start to end or until it is paused or stopped but there are many modes it can operate in which are described here.