
xmp.hwp
=======

This plugin allows Hollywood to load and play all tracker module formats that
are supported by the Extended Module Player library (XMP) by Claudio Matsuoka
and Hipolito Carraro Jr. For example FastTracker II, ScreamTracker, OctaMED,
The Player, NoisePacker, ProRunner, Oktalyzer, Impulse Tracker, Ultra Tracker,
Ice Tracker, Liquid Tracker, Quadra Composer, and many more.

Once this plugin is installed, OpenMusic() will "automagically" be able to open
all tracker modules supported by libxmp. 

This plugin also exports one command, namely: xmp.SetPlayingTime(). This
function can be used to set the playback duration of the music in milliseconds.
If the script doesn't call xmp.SetPlayingTime() to set a specific playing time,
all modules played by the plugin will automatically loop forever if Hollywood
9.0 or better is used, otherwise they will play for 10 minutes.

New in Hollywood 10: Alternatively to calling xmp.SetPlayingTime() you can also
just pass the desired playing duration to OpenMusic() or LoadSample() in the
"PlayingTime" tag in the optional "UserTags" table argument of those functions,
e.g.:

    ; play test.xm for 15 minutes
    OpenMusic(1, "test.xm", {UserTags = {PlayingTime = 1000 * 60 * 15}})
    PlayMusic(1)

A demo applet is also included. You can run this applet using the freely
available Hollywood Player.


History
=======

Version 1.1:    (08-May-26)
- New: Version string in the binary contains the precise CPU architecture specification now, e.g.
  "x64-linux" instead of just "Linux"
- New [Linux]: Added build for the Linux arm64 platform
- New [macOS]: Added build for macOS arm64 (Apple Silicon)  
- Change: Amiga installer will now also copy the plugins for all platforms to the linker plugins
  directory so that they can be easily linked to executables
- Change [iOS]: Added arm64 build for the iOS simulator and removed x86 build for the iOS simulator
  because the iOS simulator is no longer compatible with x86
- New: Plugin supports Hollywood 10's user tag interface for file adapters now; all user tags
  will be forwarded to the corresponding file adapters now
- New: Alternatively to calling xmp.SetPlayingTime() you can now also just pass the desired
  duration to OpenMusic() or LoadSample() in the new "PlayingTime" tag in the optional "UserTags"
  table argument of those functions; this is possible by Hollywood 10's new user tag interface
  so Hollywood 10 is required for this feature  
- Change: Plugin supports Hollywood 9.0's infinite looping mode now; if xmp.SetPlayingTime()
  hasn't been used to set a specific playing time, all modules played by the plugin will now
  automatically loop forever if Hollywood 9.0 or better is used
- Fix: Some Digibooster modules couldn't be loaded at all (reported by Lazar Zoltan)
- Fix: Fixed some playback errors in several formats (e.g. The Player 6.x)

Version 1.0:    (05-Apr-20)
- First release


Copyright
=========

This plugin was written by Andreas Falkenhahn <andreas@airsoftsoftwair.de>
See the COPYING file in this package for conditions concerning distribution
of this plugin. Visit http://www.hollywood-mal.com/ for more information
on Hollywood and more plugins.
