- Name
-
SaveSample -- save sample to disk (V5.0)
- Synopsis
-
SaveSample(id, f$[, fmt, t])
- Function
-
This command saves the sample specified in
id
to the file specified
in f$
. The optional argument fmt
specifies the format in which the
sample should be exported. Currently, only #SMPFMT_WAVE
is supported here.
This will save the sample in the RIFF WAVE format.
Starting with Hollywood 10.0, SaveSample()
accepts an optional table argument
that allows you to pass additional arguments to the function. The following
tags are currently supported by the optional table argument:
Adapter:
-
This tag allows you to specify one or more file adapters that
should be asked if they want to save the specified file. If
you use this tag, you must set it to a string containing the name(s)
of one or more adapter(s). Defaults to the adapter set using SetDefaultAdapter().
See Loaders and adapters for details. (V10.0)
UserTags:
-
This tag can be used to specify additional data that should be passed to loaders
and adapters. If you use this tag, you must set it to a table of key-value pairs
that contain the additional data that should be passed to plugins. See User tags for details. (V10.0)
- Inputs
-
- id
- identifier of sample to save
- f$
- path to save location
- fmt
- optional: format in which to export the sample (defaults to
#SMPFMT_WAVE
)
- t
- optional: table containing further options (see above) (V10.0)
- Example
-
@SAMPLE 1, "ouch.8svx"
SaveSample(1, "ouch.wav")
The code above loads a sample in the IFF 8SVX format and saves it as
a RIFF WAVE sample.