Historically, Max developers have used the search path
for convenient access to files by name, but this is not sufficient for managing files in Live presets
object was designed to be added to Max devices that work with files.
When you drag an audio file from either the Live file browser or your operating system's
file manager, live.drop
will output the complete file path as a single symbol. You can then pass this symbol to a buffer~
object, as shown in the example below.
object also stores
the name and location of the most recently dropped file in a way that Live understands. By default, live.drop
Parameter Mode enabled
, so any files dropped onto it will be saved in the current Live document. When the document is re-opened, the name will be sent out live.drop
's outlet. When saving a preset for a device containing a live.drop
, Live will copy any referenced audio files to the Live library if they are not already there. When a user opens the preset, the file's path in the Library, not the file's original path, will be sent out live.drop
If you perform a Collect All and Save
on your Live Set, any audio files referenced by live.drop
objects with Parameter Mode enabled will be copied into a newly created folder.
This permits Live users to move documents containing Max devices written with live.drop
to different computers without losing the audio files the devices were using.
A Live user can, however, choose to turn off the program's default file-copying behavior.