Magician 2.1.2 Release Notes for Windows 95/98/NT ================================================= Welcome to the 2.1.2 release of Magician for Windows 95/98/NT! 0. License 1. Supported Platforms 2. OpenGL Requirements 3. Installing Magician 4. Testing Magician 5. Changes from Earlier Versions 6. Purchasing Magician 7. Known Problems 0. License ---------- Please read the following license information. If you do not agree to this license, please do not install Magician on your computer. Magician Free / Non-Commercial / Evaluation Software License ============================================================ 1. Definitions Licensor: Arcane Technologies Ltd. PO Box 3738, Glasgow, G41 4YD, Scotland Licensee: Program: The binary release of the software package known as ``Magician'' or ``Magician Java OpenGL Interface'' for use in writing 3D graphics based software. The version of this software described is the ``Evaluation'' or ``Free'' version and is explictly not the ``Licensed'' version. Also included in this definition is the document titled ``The Magician Programmer's Guide for Java'' and any ``Javadoc''- or ``Polardoc''-generated API references. PC: A personal computer or workstation. This expressly excludes devices known as ``network computers'' or ``JavaStations(TM)''. 2. Licence In consideration of your acceptance of the terms and conditions herein contained, the Licensor grants you a personal non-exclusive non-transferable licence to use and execute the Program on a PC without right to sub-licence or distribute the Program ( except as provided in Clause 4 below ). You agree that you will not modify, reverse engineer, decompile or disassemble any portion of the Program. 3. Extent of Licence In order to effect your license rights hereunder, you may install the Program by duplicating in onto the hard disk drive or into the CPU memory of a PC for use thereon, and you may make full or partial copies of the Program, but only as necessary for back-up or archival purposes or for purposes of distribution pursuant to Clause 4 below. You agree that (i) your use and possession of such copies shall be solely under the terms and conditions of this Agreement and (ii) you shall place the same proprietary and copyright notices and legends on all such copies as included by the Licensor on any media containing an authorised copy of the Program originally provided by the Licensor. Commercial, non-profit and government bodies may only use the Program for evaluation purposes for a period of 30 days from installation. To use the Program after this period has elapsed, you must purchase suitable licensing from the Licensor. 4. Distribution of the Program to others You may redistribute copies of the Program to others provided that all such copies are in the form originally distributed by the Licensor and include a copy of the License Agreement. In addition, the application with which the Program is to be redistributed must incur no charge to a third party, that is, it must be free although the source code of the application need not be made available. You may not include the Program on any form of media for distribution including, but not limited to, compact disc, tape or floppy disk without the express permission of the Licensor. You may not resell the Program in any form without the express permission of the Licensor. Commercial, non-profit and government bodies may not distribute this software for private and internal use. 5. Proprietary Rights You acknowledge that title, copyright and all other proprietary rights in the program shall remain vested in the Licensor and the Licensor reserves all rights not expressly granted hereby. 6. Transfer Restrictions This Licence is personal to you. Except as provided in Clause 4 above, you may not transfer the Program and/or assign the Licence to any third party. If you attempt to transfer or assign this Licence, such transfer or assignment will be void and without effect. 7. Term This Agreement shall commence when you accept this Licence and install the Program and shall continue thereafter. If you fail to fulfil any of your material obligations under this Agreement, the Licensor may pursue all available legal remedies to enforce this Agreement and the Licensor may, at any time after your default in terms of this Agreement, terminate this Agreement and all licences and rights granted to you hereunder. You further agree that if the Licensor terminates this Agreement on the grounds of your default, you will within thirty days after such termination deliver to the Licensor or render unusable all software originally provided to you hereunder and any copies thereof embodied in any medium. 8. Disclaimer You will be deemed to have satisfied yourself on all aspects of the Program and consequently the Licensor provides the Program to you ``as is'' and without warranty of any kind, express statutory implied or otherwise, including without limitation any warranty as to merchantability, fitness for a particular purposes or non-infringement of third-party rights. No information or advice, whether oral or written given to you by any employee of the Licensor or by any representative or distributor will create a warranty for the Program and consequently you must not rely on any such information or advice. 9. Limitation of Liability In no event shall the Licensor be liable to you for any special, consequential, incidental or indirect damages of any kind ( including without limitation the cost of cover, damages arising from loss of data, use profits or goodwill, or property damage ) whether or not the Licensor has been advised of the possibility of such loss and irrespective of the cause of such loss. 10. Governing Law This Agreement shall be subject to and construed in accordance with Scots Law and shall be subject to the jurisdiction of the Scottish Courts. --oOo-- Copyright (c)1997-1999 Arcane Technologies Ltd. 1. Supported Platforms ---------------------- Magician 2.1.2 for Windows 95/98/NT supports the following Java Virtual Machines and WWW Browsers: Sun JDK-1.1.3 / JRE-1.1.3 Sun JDK-1.1.5 / JRE-1.1.5 Sun JDK-1.1.5 Native Performance Pack / JRE-1.1.5 + Native Perf. Pack Sun JDK-1.1.6 / JRE-1.1.3 Sun JDK-1.1.7 / JRE-1.1.7 Sun Java-2 Sun HotSpot Sun HotJava Microsoft Virtual Machine 2.x / 3.x o Used defaultly by Microsoft Internet Explorer 4.x o Can be installed for Microsoft Internet Explorer 3.x. The upgrade is downloadable from: http://www.microsoft.com/java/ o Must be release 3167 or higher! You can determine which build you have installed by typing jview /? Netscape Communicator 4.5 + Various IDEs These systems may require that Netscape support is disabled as it will attempt, and fail, to resolve Netscape-specific classes such as netscape.security.PrivilegeManager. To circumvent this problem, after installation of Magician, you should also download and install: http://www.arcana.co.uk/products/magician/shipped/212/nonetscapepatch.zip which removes all references to the Netscape security classes. 2. OpenGL Requirements ---------------------- Magician primarily supports Silicon Graphics' OpenGL implementation as opposed to Microsoft OpenGL. Silicon Graphics' OpenGL can be downloaded at the same time as Magician from Arcane Technologies WWW site. It should be installed and tested prior to using Magician. You may have libraries called opengl32.dll and glu32.dll installed on your machine already. These are Microsoft OpenGL libraries and should not be renamed to opengl.dll and glu.dll which are the names that Silicon Graphics' OpenGL libraries are called. This may result in your operating system behaving erraticaly or crashing. It will also give misleading results when running Magician. You can short-circuit Magician to use Microsoft's OpenGL implementation. The procedure to do this is listed on the online ``Frequently Asked Questions'' at: http://www.arcana.co.uk/products/magician Microsoft OpenGL is currently not recommended under Windows 95/98 because of instabilities when running heavily multi-threaded applications. We have reported these problems to Microsoft who have yet to promise us a fix. Microsoft OpenGL runs stably under Windows NT. 3. Installing Magician ---------------------- ``Standard'' Installation ------------------------- Magician can be installed by simply unzipping the file called mag212win32.zip. This will create a new directory on your hard disk called ``magician'' and various subdirectories called ``classes'' and ``lib''. You should take care to unzip the file *retaining the directory structure*. In PKUNZIP, specify the -d flag. If you are using WinZip, ensure that the ``Use Folder Names'' box is checked. If all goes well, the resulting directory tree will look like: c:\magician\ classes\... lib\... You should add the directory called c:\magician\lib ( in this example ) to your PATH environment variable. This can be achieved by using either the ``Console'' control panel in NT4.0 or in your autoexec.bat file. For example, adding the line: set PATH=%PATH%;c:\magician\lib to your autoexec.bat will set your path up correctly after a reboot. You should also add the directory c:\magician\classes to your CLASSPATH environment variable in order for Java to locate the Magician class files. Again, this can be done within your autoexec.bat file or NT control panel. After making these changes to your system, you should reboot your machine. Installation for use with Netscape ---------------------------------- Installing Magician for use with Netscape is slightly more involved than usual. The *.dll files present in the ``magician\lib'' directory after unarchiving the files should be copied to the ``java\bin'' directory within Netscape's installation tree. For example, if Netscape is installed in: c:\program files\netscape\communicator then the *.dll files should be copied to: c:\program files\netscape\communicator\program\java\bin for Netscape to correctly locate them. Otherwise, the installation instructions remain the same. 4. Testing Magician ------------------- After installing Magician, you can test that your installation works correctly by running a simple demo program. If you are using a ``standard'' Java Virtual Machine such as the Sun JDK or Microsoft JVM, you can run the appropriate command from the following two: java com.hermetica.magician.demos.bootFrame <-- Sun VM jview com.hermetica.magician.demos.bootFrame <-- Microsoft VM This should pop up a new window. If it doesn't, check your CLASSPATH setting. It might be wrong. Select the entry in the middle list box that says ``Simple OpenGL Test''. The text box on the right-hand side should be filled with information. Click on the button that should say ``Run ``Simple OpenGL Test''''. A new window should appear smoothly coloured from black to blue. If you see this, Magician is correctly installed and fully-functional. You can now proceed with playing around with the other demonstration programs. If you do not see this window appear and instead get a box saying ``Magician Error'', then check your PATH environment variable. It is likely that you have incorrectly set this value. If the value of PATH is correct and the library is present in that directory, ensure that OpenGL has been correctly installed. If not, install it now. If so, contact Arcane Technologies with the error messages and we will help you fix the problem. 5. Changes from Earlier Versions -------------------------------- All changes from earlier versions of Magician are listed in the file called ``CHANGES'' supplied in this distribution. There are no application-level changes to Magician 2.1.2 that invalidates backward binary compatibility. 6. Purchasing Magician Media, Licenses & Support ------------------------------------------------ There are various licenses available for Magician that are tailored to suit all types of user from the hobby or shareware programmer to large corporations. We offer extremely competitive rates for the redistribution of Magician with commercial applications and also offer cost price media purchasing for all licensing types. The following table summaries the various licenses and prices. Draft licenses are available via our Licensing WWW page at http://www.arcana.co.uk/products/magician/licenses/ License Type Suitable For Price Free Runtime License Personal, non-commercial Free! use. Can be redistributed with free software without charge. Shareware Redistribution Personal, non-commercial GBP 100 License use. Allows unlimited redistribution of Magician with one *shareware* application. This is basically the Commercial License at a discounted price. Commercial Redistribution Allows commercial and GBP 1000 government use. Allows unlimited redistribution of Magician> with *one application or development project*. We also offer two levels of support for Magician. Free Support ------------ The first level is via our public mailing lists such as the ``Magician Java Users'' list. This support entitles you to email us with questions or problems to either the ``Magician Java Users'' mailing list or to our support email address. magician-support@arcana.co.uk With Free Support we do not guarantee that we will fix your problem or answer your question but it is likely that this will happen. Free Support also does not entail you to receive patches on demand for problems reported. For example, if you report a problem, we may not release a patch immediately to you. We may wait until a ``jumbo'' patch is publicly released covering several problem fixes. All licensees of Magician are entitled to use our Free Support programme. Gold Support ------------ If our Free Support programme is not sufficient for your needs, you may optionally acquire a Gold Support agreement. Gold Support runs for a 12 month period and is associated with a Shareware Redistribution License or Commercial Redistribution License on a per application or development project basis. Gold Support gives you high-priority response to problems reported to or questions asked to either our public mailing lists or support email address. We also guarantee a response within 48 hours. Gold Support members can also rely on us releasing patches as and when fixed for any problems reported to us concerning Magician whether those problems were reported by you or another person. Gold Support can be acquired for the following prices. License Price Shareware Redistribution License GBP100 Commercial Redistribution License GBP1000 If you are interested in either acquiring Magician licenses or support, please contact our sales department at magician-sales@arcana.co.uk 7. Known Problems ----------------- o Using the Sun VM on 8-bit displays may result in the colours being wrong in the display. o The Microsoft VM sometimes fails to correctly size a frame containing a GLComponent. o When running the demo harness program, you may encounter a GLContextError to the effect that the underlying context could not be created. This is a known problem with the Sun JVM ( and derivatives ). We are looking into a workaround for this bug. The Microsoft JVM is not affected. o Offscreen buffering can fail on certain graphics accelerators. We think this is a driver problem. Cards to known to fail include Permedia2-based cards. $Id: README.win32,v 1.9 1999/07/22 09:01:40 descarte Exp descarte $