
SAMPLING 2 / SAMPLE LOADER (DSP & GUI)
--------------------------------------

Loads a mono, stereo or multi-channel .wav file.

8, 16, 24, 32 bits PCM and 32 or 64 bits FLOAT .wav formats are supported.

Every channel present in a wav file will be sent to a separate auto-duplicating output in standard ED Sample v2 BLOB format.

Samples are always converted to standard native 32 bits float format, no matter which the original depth.

To know the sample length, please use the Sample Length modules.

Please check the general Sampling V2 doc included for the max supported sample length.

If more outputs than loaded channels are connected, the unused channels will transmit a void blob.
If the Replicate option is enabled instead, the last channel will be replicated to all remaining connected outputs.
This is particularly convenient when loading mono samples in a stereo circuit.

Operation is always triggered by the Trigger pin. However, if Auto Trig is enabled, triggering also occurs automatically every time any File Name pin is set (default).



WHICH ROUTE TO PREFER ?
-----------------------

The DSP route (no GUI lines involved, no Patch Memory BLOB) has the advantage that there is not any theorical limit (up to 2GB) as for the sample size, despite handling very long recordings has the potential of causing hiccups and audio drop-outs. WE ADVISE AGAINST LOADING LONG SAMPLES USING THE DSP ROUTE !

The GUI route on the other hand allows (preferably short) samples to be stored in Patch Memories (i.e in presets), plus several offline editing and display operations allowed by (present or future) GUI modules only. Also, being the GUI executed on a different thread than the Audio process, there are less chances to interfer with the audio thread. The drawback is that the infamous 5MB limit of the internal SynthEdit DSP<->GUI queue is at risk of saturation (this should be fixed in SynthEdit 1.6 though).

->WHEN STORING SAMPLES INTO PRESETS IS *NOT* REQUIRED (EG. ROMPLERS, NON-EDITABLE DRUM-MACHINES, ETC), ALWAYS PREFER THE DSP ROUTE !
->WHEN A PALETTE OF FIXED AND MODERATELY SHORT WAVEFORMS IS REQUIRED INSTEAD, YOU SHOULD REALLY CONSIDER HARD-CODING SAMPLES INTO PINS (SEE SAMPLE TO UU64)




DSP VERSION:
------------

Connect the needed output(s) to suitable Sampling modules accepting standard BLOB sample2 data.

No more than one sample can be loaded per audio block.


GUI VERSION:
------------

Always connect the needed output(s) to one or more Patch Memory Sample modules, for usage with other GUI based sampling modules and/or to interface with DSP sampling modules.
The File Name pin with non-empty content will be used. In case both are non-empty, the content of the latest File Name pin set will be used.


LOCATING SAMPLES IN THE VST FOLDER:
-----------------------------------

A file name without path will be located inside the plugin folder (in plugins only).
However, you can specify the full path of the file on your hard disc (i.e E:\WORK\Samples\MySample.wav); if such file can't be located at the original path (eg. by an user of your plugin who has no E:\WORK\Samples\MySample.wav on his hard disc), the loader will look for "MySample.wav" in the plugin folder. This makes embedding files easy, in conjunction with "Copy additional files" feature in SynthEdit Export dialog. This way, removing the file path parts before exporting your plugin is NO LONGER REQUIRED !


USING A FILE REQUESTER MODULE:
------------------------------

An annoying "bug-feature" of SynthEdit prevents a pin being updated whenever it is set with the same value. This prevents the module being triggered when Auto Trigger is enabled and the same filename is set, for example to reload a same sample. To circumvent this issue, a better File Requester module is included in EDM package (GUI/FileOperations) providing an additional User OK pin, which is set to true (and then to false) everytime the user presses the OK button in the file requester.
This pin can be connected to Trigger pin of the Wav loaders and savers. When doing so, please also disabled Auto Trig.




