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.