This function will check if the file specified in file$
is in a supported
music format. If it is, this function will return True
in the first
return value, otherwise False
. If this function returns True
, you can
open the music file using OpenMusic().
The second return value is a string containing the music format of the
file.
Starting with Hollywood 6.0 this function accepts an optional table argument
which allows you to configure further options:
Loader:
-
This tag allows you to specify one or more format loaders that should be
asked to load this music object. This must be set to a string containing the name(s)
of one or more loader(s). Defaults to the loader set using SetDefaultLoader().
See Loaders and adapters for details. (V6.0)
Adapter:
-
This tag allows you to specify one or more file adapters that should be asked
to open the specified file. This must be set 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. (V6.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)
See OpenMusic for a list of supported music formats.