NOTES:

	This plugin is capable to decode Super Audio CD ISO image content.
	This plugin contains code from SACD Ripper http://code.google.com/p/sacd-ripper/ project.
	This plugin contains code from WavPack http://www.wavpack.com project.


USE:

	Install foo_input_sacd.fb2k-component file and restart foobar. Then open *.ISO image file for playback.
	When needed adjust output volume and samplerate at "File->Preferences->Tools->SACD".
	To use editable tags check it at "File->Preferences->Tools->SACD".
	To playback SACD-R/RW discs create the new playlist, insert disc into DVD drive and drag-n-drop
	DVD drive letter (root folder) on the created playlist. Or, if UDF file system exists on SACD-R/RW,
	open MASTER1.TOC file.

	If your DAC supports DoP through ASIO/WASAPI/DS driver you can set up DSD playback:
	1. Open "File->Preferences->Tools->SACD" page.
	2. Select "DSD" for "Type" in "Output (per device)"section.
	3. If your DAC doesn't support multichannel playback use "Downmix channels to stereo" DSP.
	4. If your DAC doesn't support DSD source samplerate use DSP Processor plugin. Add "DSD Processor" to active
	   DSPs at any position and set it up. This DSP plugin is applied after all other DSPs in chain.

	If playback is in DSD mode you should get samplerates 2822400, 5644800, etc. and silence on VU Meter.
	In DSD+PCM mode output is DSD and all bells and whistles show up as expected.
	
	For PCM playback it is possible to use custom FIR filters. Some filter samples are put in filters subfolder.

	For WavPack playback in DSD mode move "Super Audio CD Decoder" upper than "foobar2000 WavPack Decoder" on
	"File->Preferences->Playback->Decoding" page.

	To produce DoPed PCMs check "DoP for Converter".

	If your DAC happens to not play beginning of the track wnen switching between DSD and PCM content set
	"Output (per device)" Transition [s] to appropriate value.  


CHANGELOG:

	02/23/24:
	Version 1.5.11 - WavPack tagging changed.

	11/15/23:
	Version 1.5.10 - RapidXml metabase parser changed to pugixml.

	10/31/23:
	Version 1.5.9 - Debug console output removed.

	10/28/23:
	Version 1.5.8 - SACD Metabase XML parser replaced by RapidXml.

	10/24/23:
	Version 1.5.7 - CUE playback fixed.

	10/21/23:
	Version 1.5.6 - DSDIFF DSD seek operation fixed.

	08/23/23:
	Version 1.5.5 - Ramp parameter for DSD to PCM converter added.

	02/07/23:
	Version 1.5.4 - DSD512, DSD1024 playback fixed.

	02/02/23:
	Version 1.5.3 - Excessive trace fixed.

	11/01/23:
	Version 1.5.2 - DSD/PCM transition delay added.

	09/05/22:
	Version 1.5.1 - Dark mode support added.

	09/01/22:
	Version 1.5.0 - Experimental: foobar2000 v2.0 support.

	06/20/22:
	Version 1.4.13 - SACD ISO last area sector reading fixed.

	06/14/22:
	Version 1.4.12 - DSD to PCM converter fixed.

	06/07/22:
	Version 1.4.11 - Experimental: Seamless DSD to PCM for multiple converter threads.

	04/29/22:
	Version 1.4.10 - ReplayGain scan at 0 dB gain again.

	04/27/22:
	Version 1.4.9 - ReplayGain handling is reverted back to 1.3.1 version.

	03/18/22:
	Version 1.4.8 - Multiline tagging fixed.

	01/24/22:
	Version 1.4.7 - Experimental: Decimation parameter for installable FIR added.

	01/19/22:
	Version 1.4.6 - Metabase handling fixed.

	01/17/22:
	Version 1.4.5 - DSD to PCM converter mode selection fixed.

	01/14/22:
	Version 1.4.4 - New SDK.

	12/24/21:
	Version 1.4.3 - DSD to PCM converter samplerates extended.

	11/12/21:
	Version 1.4.2 - Crash at the end of the track fixed.

	11/11/21:
	Version 1.4.1 - DST decoder fixed.

	11/09/21:
	Version 1.4.0 - Experimental: Output (per device) configuration added.

	09/28/21:
	Version 1.3.8 - PCM-only audio device selector added.

	06/17/21:
	Version 1.3.7 - Crash on stereo/multichannel transition with PCM output fixed. Built with the new Intel compiler.

	05/19/21:
	Version 1.3.6 - Volume handling slightly altered.

	05/16/21:
	Version 1.3.5 - Experimental: Volume handling changed, DoP input processing added.

	03/12/21:
	Version 1.3.4 - WavPack updated to version 5.4.0.

	03/11/21:
	Version 1.3.3 - Bit depth while converting from CUE fixed.

	02/28/21:
	Version 1.3.2 - ReplayGain scan at 0 dB gain (doesn't depend on "PCM Volume" value).

	02/23/21:
	Version 1.3.1 - Compatibility with foo_out_asio2, foo_out_wasap2 output components.

	02/16/21:
	Version 1.3.0 - Experimental: Automatic output setup for DSD playback added.

	01/17/21:
	Version 1.2.7 - Fading for DSD output is in somewhat fixed (nevertheless doesn't work for DSD tracks).

	11/23/20:
	Version 1.2.6 - MD5 hash generation fixed.

	11/13/20:
	Version 1.2.5 - DSD to PCM filter delay compensation removed.

	11/08/20:
	Version 1.2.4 - Seamless DSD to PCM for single converter thread.

	05/01/20:
	Version 1.2.3 - More compatibility with DSP plugins.

	04/04/20:
	Version 1.2.2 - DSDIFF/DSF file handling fixed.

	03/31/20:
	Version 1.2.1 - UPnP playback fixed.

	03/25/20:
	Version 1.2.0 - Experimental: Samplerate neutral DST decoder.

	03/21/20:
	Version 1.1.12 - COM initialization model reverted back to apartment threaded.

	03/09/20:
	Version 1.1.11 - COM initialization fixed.

	03/06/20:
	Version 1.1.10 - Experimental: DSD1024 playback.

	01/03/20:
	Version 1.1.9 - DSDIFF last DST frame reading fixed.

	12/01/19:
	Version 1.1.8 - 1/75s track padding removed.

	11/13/19:
	Version 1.1.7 - Tag handling skipped for multitrack WavPacks.

	11/12/19:
	Version 1.1.6 - Experimental: Album art supported.

	10/19/19:
	Version 1.1.5 - DSF read/seek fixed.

	07/26/19:
	Version 1.1.4 - Experimental: Foobar 1.5.x SDK, no Windows XP support.

	05/26/19:
	Version 1.1.3 - Subsong indexing changed from 0-based to 1-based. Song infos need to be reloaded.

	05/11/19:
	Version 1.1.2 - "DoP for Converter" option and support for WavPack embedded CUE added.

	02/25/19:
	Version 1.1.1 - Uneven padding error in DSDIFF fixed.

	01/26/18:
	Version 1.1.0 - Experimental: Foobar 1.4.x SDK.

	11/07/17:
	Version 1.0.11 - Experimental: Upgraded DSD processor plugin.

	08/14/17:
	Version 1.0.10 - DSD stream handling reverted back to 1.0.7.

	06/04/17:
	Version 1.0.9 - DSD stream handling modified.

	05/31/17:
	Version 1.0.8 - WavPack library updated to 5.1.0.

	03/24/17:
	Version 1.0.7 - DSD stream handling simplified.

	02/22/17:
	Version 1.0.6 - +-10dB volume adjustment for LFE channel.

	12/31/16:
	Version 1.0.5 - Experimental: DFF/DSF ID3v2 tags supported.

	12/30/16:
	Version 1.0.4 - Experimental: WavPack DSD playback.

	12/15/16:
	Version 1.0.3 - DSDIFF track length fixed.

	10/19/16:
	Version 1.0.2 - SACD metabase creation fixed.

	10/18/16:
	Version 1.0.1 - Freezing on pause fixed.

	10/13/16:
	Version 1.0.0 - Experimental: Installable DSD Processor plugins.

	08/10/16:
	Version 0.9.11 - Crash when no output device fixed.

	08/08/16:
	Version 0.9.10 - WASAPI push/event output mixup fixed.

	08/03/16:
	Version 0.9.9 - Metadata setup fixed.

	06/17/16:
	Version 0.9.8 - DSD and PCM modes have the same number of output channels.

	04/29/16:
	Version 0.9.7 - DoP for ASIO/WASAPI/DS, direct DSD for ASIO removed.

	12/09/15:
	Version 0.9.6 - Monoaural playback supported.

	11/23/15:
	Version 0.9.5 - Crash when no ASIO devices are presented in the system fixed.

	11/20/15:
	Version 0.9.4 - Device channel names/types in channel mapping fixed.

	11/13/15:
	Version 0.9.3 - DSD output trace into foobar console added.

	10/28/15:
	Version 0.9.2 - PCM overload fixed.

	10/27/15:
	Version 0.9.1 - ASIO handling changed.

	10/22/15:
	Version 0.9.0 - Sketchy: Direct DSD output for compatible ASIO devices (ASIO Proxy driver is not required).

	09/04/15:
	Version 0.8.4 - "dynamic range" tag unlinked.

	08/05/15:
	Version 0.8.3 - Replaygain info for linked stereo/multichannel tags fixed.

	08/04/15:
	Version 0.8.2 - Intel IPP in DSD to PCM converter, linked stereo/multichannel tags.

	06/30/15:
	Version 0.8.1 - Experimental: Multithreaded DSD to PCM converter.

	04/06/15:
	Version 0.7.8 - Log overloads in DSD to PCM converter.

	03/16/15:
	Version 0.7.7 - DSDIFF CRC chunk reading fixed.

	03/04/15:
	Version 0.7.6 - SACD metabase creation fixed.

	03/03/15:
	Version 0.7.5 - DSD samplerate fix for DSD USB DACs.

	02/10/15:
	Version 0.7.4 - New foobar2000 SDK, some fixes.

	09/29/14:
	Version 0.7.3 - DSDIFF odd chunk length bug fixed, Windows XP compatibility.
	
	09/25/14:
	Version 0.7.2 - Experimental: DSDIFF DST-compressed file playback with non-standart frame rates added.

	05/05/14:
	Version 0.7.1 - Experimental: DSD to DSD converter, DSD path redesigned.

	11/11/13:
	Version 0.6.6 - Random channel rearrangement in DSD mode (for stereo<->multi transition) fixed.
                        Installable filter description added.

	07/29/13:
	Version 0.6.5 - "Store Tags With ISO" option added.

	04/20/13:
	Version 0.6.4 - Windows XP compatibility, DSD512 playback fixed.

	04/17/13:
	Version 0.6.3 - Experimental: DSD256/512 DSDIFF and DSF file playback added (for PCM mode only).

	02/19/13:
	Version 0.6.2 - Phase inverse in Multistage (Fixed-Point) DSD to PCM converter fixed.

	11/01/12:
	Version 0.6.1 - DSF read last block fixed, ASIO proxy updated.

	08/28/12:
	Version 0.6.0 - Installable FIR filters for direct DSD to PCM decimation.

	06/27/12:
	Version 0.5.11 - Some protection against reading bad data added.

	05/28/12:
	Version 0.5.10 - Switching between DSD and PCM tracks fixed.

	05/21/12:
	Version 0.5.9 - ISO track codec type fixed.

	05/17/12:
	Version 0.5.8 - File buffering fixed.

	04/27/12:
	Version 0.5.7 - SACD-R/RW discs with UDF file system supported.

	04/24/12:
	Version 0.5.6 - Metabase reading fixed.

	04/23/12:
	Version 0.5.5 - SACD-R/RW discs playback added.

	04/14/12:
	Version 0.5.4 - On demand DST decoder initialization.

	03/21/12:
	Version 0.5.3 - DSD to PCM converter double precision modes added.

	03/19/12:
	Version 0.5.2 - DSDIFF DSD file reader fixed.

	03/15/12:
	Version 0.5.1 - Multitrack DSDIFF file playback fixed.

	03/07/12:
	Version 0.5.0 - DSF track playback added.

	03/01/12:
	Version 0.4.9 - DSD Autodetection removed. Better switching between DSD and PCM tracks.

	02/24/12:
	Version 0.4.8 - Mytek Stereo 192-DSD DAC is believed to be supported.

	02/23/12:
	Version 0.4.7 - Experimental: dCS DSD-over-PCM playback methods supported.

	02/18/12:
	Version 0.4.6 - Experimental: ASIO proxy driver for DSD direct playback.

	11/30/11:
	Version 0.4.5 - Editable ID3 tags for DSDIFF files implemented.

	11/28/11:
	Version 0.4.4 - Experimental: Multitrack DSDIFF files with Marker and ID3 chunks.

	11/11/11:
	Version 0.4.3 - Experimental: Exact search for DSDIFF files with DST Sound Index chunk added.

	11/11/11:
	Version 0.4.2 - Experimental: Lookup table based DST decoder design.

	10/31/11:
	Version 0.4.1 - DSDIFF playback crash fixed.

	10/21/11:
	Version 0.4.0 - Experimental: Direct DSD to PCM decimation with 30kHz cutoff.

	10/20/11:
	Version 0.3.14 - Multichannel playback area selection bug fixed.

	10/20/11:
	Version 0.3.13 - Gibbs artifacts reduced.

	10/17/11:
	Version 0.3.12 - Playback area is made preferable.

	10/17/11:
	Version 0.3.11 - Playback area selector added.

	10/14/11:
	Version 0.3.10 - Gapless playback (of ISO images) control added.

	10/02/11:
	Version 0.3.9 - Replaygain metadata dependence of "PCM Volume" control fixed.

	09/30/11:
	Version 0.3.8 - Large ISO (> 4GB) playback fixed.

	09/29/11:
	Version 0.3.7 - 44 kHz lowpass filter at 176400 samplerate added. Polyphase filters removed.

	09/26/11:
	Version 0.3.6 - Editable tags for ISO images added.

	09/25/11:
	Version 0.3.5 - Polyphase filters in DSD to PCM converter.

	09/20/11:
	Version 0.3.4 - Floating point SSE in DSD to PCM converter.

	09/18/11:
	Version 0.3.3 - NSL support in tags added.

	09/15/11:
	Version 0.3.2 - DSD to PCM converter fixed/floating point mode selector added.

	09/09/11:
	Version 0.3.1 - DSD to PCM converter performance a bit improved.

	09/07/11:
	Version 0.3.0 - Experimental: new DSD to PCM converter.

	08/25/11:
	Version 0.2.9 - DSDIFF tag reader added.

	08/25/11:
	Version 0.2.8 - DSD Fs128 support added.

	08/24/11:
	Version 0.2.7 - Tag mapping fixed.

	08/23/11:
	Version 0.2.6 - Seek in DSD mode fixed.

	08/22/11:
	Version 0.2.5 - Memory leak in DST decoder fixed.

	08/21/11:
	Version 0.2.4 - Experimental: SSE enabled DST decoder.

	08/06/11:
	Version 0.2.3 - Experimental: ASIO DSD/PCM autodetection.

	08/02/11:
	Version 0.2.2 - More seamless playback.

	08/01/11:
	Version 0.2.1 - Output PCM samplerate selector added.

	07/29/11:
	Version 0.2.0 - Experimental: ASIO direct DSD support added. PCM volume adjuct gauge added.

	07/19/11:
	Version 0.1.3 - DSDIFF file playback added.

	07/16/11:
	Version 0.1.2 - DSD track playback added.

	07/15/11:
	Version 0.1.1 - Reading of 2064 bytes sector images (Philips SuperAuthor) added.

	07/14/11:
	Version 0.1.0 - Playback added.

	07/07/11:
	Version 0.0.0 - DST decoder performance test, no real playback.


Maxim V.Anisiutkin <maxim.anisiutkin@gmail.com>
