WELCOME TO FANTASIA! (C)1997-2000 McNabb Software Arts San Francisco, CA http://www.mcnabb.com info@mcnabb.com This software is distributed free for evaluation purposes, and for not-for-profit use by individuals and non-profit academic institutions. It may not be used for commercial purposes or incorporated into commerical applications without the written permission of McNabb Software Arts. There is no warranty of any kind, but bug reports are appreciated and may be reported to michael@mcnabb.com. Author: Michael McNabb, michael@mcnabb.com __________________________________________________________________________ REQUIREMENTS Fantasia: Download from ftp://ftp.mcnabb.com/fantasia-17.tar.gz or: ftp://ftp.mcnabb.com/fantasia-17.zip Java(TM) Standard Edition 1.4 or later (any platform): Windows: Download from http://java.sun.com/j2se/downloads.html The MIDI Kit (Mac OS X or Windows 2000/XP only) Download from ftp://ftp.mcnabb.com/midikit-29.tar.gz or: ftp://ftp.mcnabb.com/midikit-29.zip See the MIDI Kit README file for more information __________________________________________________________________________ INSTALLATION Install the MIDI Kit and Fantasia parallel in the directory tree, e.g., xx/fantasia/fantasia-17 and xx/midikit/midikit-29. For Windows, the expected Java directory is c:\java \jdk1.4. If you use different location, you may need to edit the fantasia.win and midiserver.win files (see SETUP below). __________________________________________________________________________ SETUP (IMPORTANT) There are native executable files which may be used to launch Fantasia, called "fantasia" (OS X) and "fantasia.exe" (Windows). These launchers read configuration files called "fantasia.unix" or "fantasia.win" . You may need to edit these files to set the locations of your local distribution of the Java runtime and the Java MIDI Kit. You will probably also first need to edit the configuration files for the MIDI Kit as well. Please see the MIDI Kit Readme file for further instructions. __________________________________________________________________________ EXECUTION To launch Fantasia, use the appropriate native launcher, "fantasia.sh" (OS X) or "fantasia.exe" (Windows). When Fantasia launches, it will automatically launch the MIDI Kit when needed. RUNNING FANTASIA AND THE MIDI KIT ON DIFFERENT MACHINES Fantasia is a pure Java application and thus may be run on any machine which has JDK 1.1 or greater, JFC/Swing 1.1, and the MIDI Kit classes installed and/or in the class path. You can require Fantasia to connect to another machine's MIDI Kit server by specifying the host name as the value of the "midikit.host" entry in the fantasia.win or fantasia.unix configuration file. In this case, you will need to launch the midiserver separately on its host machine before runing Fantasia. Note that several copies of Fantasia running on different machines can connect simultaneously to a single midiserver process. Processor objects may be shared by patches in different documents in the various versions of Fantasia, by accessing them through the "server" tab on the object palette. The objects will remain "connected" even across server sessions (as a result of object instances having globally unique identifiers). __________________________________________________________________________ EXAMPLES There are some example fantasia project files in the examples sub-directory. Please also see the document Fantasia.html in the docs directory, and the MIDI Kit documentation. __________________________________________________________________________ __________________________________________________________________________ DISCLAIMERS AND COPYRIGHTS Fantasia incorporates the MDIKit (Multiple Document Interface Kit), a package which greatly facilitates the creation of MDI applications for the Java(TM) platform, (C) 1998-2000 McNabb Software Arts (Except for Sax and Aelfred, see below) All rights reserved internationally. This version of the MDIKit is distributed free for evaluation purposes, and for not-for-profit use by individuals and non-profit academic institutions. It may not be used for commercial purposes or incorporated into commerical applications without the written permission of McNabb Software Arts. There is no warranty of any kind, but bug reports are appreciated and may be reported to michael@mcnabb.com. Licensees may not redistribute this code in any form __________________________________________________________________________ Fantasia incorporates AElfred, Version 1.1 Microstar's Java-Based XML Parser Copyright (c) 1997, 1998 by Microstar Software Ltd. Home Page: http://www.microstar.com/XML/ AElfred is free for both commercial and non-commercial use and redistribution, provided that Microstar's copyright and disclaimer are retained intact. You are free to modify AElfred for your own use and to redistribute AElfred with your modifications, provided that the modifications are clearly documented. DISCLAIMER ---------- This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of merchantability or fitness for a particular purpose. Please use it AT YOUR OWN RISK. __________________________________________________________________________ Fantasia incorporates SAX, the Simple API for XML SAX COPYRIGHT STATUS Version 1.0 of the Simple API for XML (SAX), created collectively by the membership of the XML-DEV mailing list, is hereby released into the public domain. No one owns SAX: you may use it freely in both commercial and non-commercial applications, bundle it with your software distribution, include it on a CD-ROM, list the source code in a book, mirror the documentation at your own web site, or use it in any other way you see fit. NO WARRANTY Because SAX is released to the public domain, there is no warranty for the design or for the software implementation, to the extent permitted by applicable law. Except when otherwise stated in writing the copyright holders and/or other parties provide SAX "as is" without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of SAX is with you. Should SAX prove defective, you assume the cost of all necessary servicing, repair or correction. In no event unless required by applicable law or agreed to in writing will any copyright holder, or any other party who may modify and/or redistribute SAX, be liable to you for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use SAX (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the SAX to operate with any other programs), even if such holder or other party has been advised of the possibility of such damages. David Megginson 1998-05-11 __________________________________________________________________________ Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries