home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 June / PCWorld_1999-06_cd.bin / software / temacd / basilisk / Readme.win32 < prev    next >
Text File  |  1999-04-25  |  10KB  |  355 lines
  1. Basilisk II for Windows NT 4.0, early alpha version
  2. A free, portable Mac II emulator.
  3.  
  4. Copyright (C) 1997-1999 Christian Bauer et al.
  5. Freely distributable.
  6.  
  7.  
  8.  
  9. These are just quick notes describing the differences
  10. to the other Basilisk II ports. Please read the other 
  11. Basilisk II documentation first to get a general idea 
  12. of the emulator.
  13.  
  14.  
  15.  
  16. Overview
  17. --------
  18.  
  19. A Windows NT 4.0 (later WinNT) port of Christian Bauer's
  20. Basilisk II Macintosh II emulator.
  21.  
  22. Windows 95 and Windows 98 (later Win98) can be used too, 
  23. with a somewhat reduced set of features.
  24.  
  25. This is an early alpha version and probably full of bugs. 
  26.  
  27. A list of features of Basilisk II for WinNT follows.
  28. If a feature cannot currently be used under Win9x, 
  29. it is marked as (X) in the list.
  30.  
  31.   - Runs MacOS 7.x and 8.x (7.0 not recommended)
  32.   - FPU is currently disabled
  33.   - Processor is currently 68020 only, with some
  34.     limitations (among others, OpenTransport).
  35.   - Color video 8, 15, 16, 24 and 32 bits. Uses the
  36.     Windows "Display Control Panel" video mode setting.
  37.     Depending on you display adapter, some options may work
  38.     incorrectly or not at all. Runs always full screen.
  39.   - Floppy disk driver (only 1.44MB disks supported) (X)
  40.   - Driver for HFS and FAT partitions (X)
  41.   - Driver for HFS physical drives
  42.   - Driver for HFS hardfiles 
  43.   - CD-ROM driver 
  44.   - CD-ROM audio functions (X)
  45.   - Serial driver
  46.   - SCSI Manager
  47.   - SCSI device remapping
  48.   - Emulates extended ADB keyboard and 1-button mouse
  49.   - Uses UAE 68k emulation
  50.   - Mac clipboard text transfer to Windows
  51.   - If the program freezes, you can try to kill it with
  52.     Alt-F4. Normally you should not quit this way to
  53.     avoid losing data (MacOS may not have saved all your
  54.     data when you kill the program).
  55.   - DirectX support (prefers version 5 or later, version 3 *may*
  56.     work, depending on your display adapter)
  57.   - Non-refreshed linear frame buffer support (X)
  58.  
  59.  
  60.  
  61. Installation
  62. ------------
  63.  
  64. Copy the BasiliskII.exe file to a directory of your
  65. choice. Put the ROM file into the same directory.
  66.  
  67. Start the program. You will see a flashing icon indicating
  68. that no bootable HFS volume was found. Kill the program
  69. with Alt-F4.
  70.  
  71. A preferences file "BasiliskII_prefs" was written to the
  72. startup directory. Open it in your favorite text editor
  73. (Notepad is just fine), and edit the entries as described 
  74. in the following "Configuration" section. Start the program again.
  75.  
  76. To access CD-ROM's under WinNT, the driver file "cdenable.sys"
  77. must be copied to your "\WinNT\System32\drivers" directory.
  78.  
  79. To access CD-ROM's under Win9x, the driver file "cdenable.vxd"
  80. must be copied to your "\Windows\System" directory.
  81.  
  82. Disable sound control panel and in every application.
  83. If you don't, the program will freeze often when trying to access
  84. sound hardware.
  85.  
  86. Important: see the chapter "Keyboard".
  87.  
  88.  
  89.  
  90. Configuration
  91. -------------
  92.  
  93. The configuration file "BasiliskII_prefs" must be in
  94. the working directory. If no preferences file is present, 
  95. Basilisk II will create one with the default settings upon startup.
  96.  
  97. disk <volume description>
  98.   Example on how to define a hardfile:
  99.   
  100.   disk c:\hardfiles\sys755.hfv
  101.  
  102.   Example on how to define a logical volume;
  103.   as for now, for safety reasons the volume is mounted
  104.   as read-only. This is due to the bugs in PC Exchange.
  105.   Implemented for WinNT only.
  106.    
  107.   disk c:\
  108.  
  109.   Example on how to define a physical volume;
  110.   as for now, for safety reasons the volume is mounted
  111.   as read-only. This is due to the bugs in PC Exchange.
  112.   Implemented for WinNT and Win9x.
  113.   
  114.   disk physical c:\
  115.  
  116.   if not defined, the files *.hfv and *.dsk is searched
  117.   from the current directory. Note that in this case,
  118.   the program tries to boot from the first volume file
  119.   found which is random, and may not be the one you want.
  120.  
  121.   Iomega ZIP disks may be mounted either with the disk
  122.   command, or installing the IomegaWare on the Mac.
  123.   Do *not* use both ways simultaneously. Under Win9x,
  124.   IomegaWare is currently the only option; it is the preferred
  125.   way anyway.
  126.  
  127.  
  128.  
  129. bootdrive <drive number>
  130.   as in other ports
  131.  
  132.  
  133. bootdriver <driver number>
  134.   as in other ports
  135.  
  136.  
  137. ramsize 75000000
  138.   as in other ports. Aligns the value to 4 MB boundaries.
  139.  
  140.  
  141. frameskip <frames to skip>
  142.   ignored.
  143.  
  144.  
  145. modelid <MacOS model ID>
  146.   as in other ports
  147.  
  148.  
  149. nogui <"true" or "false">
  150.   ignored. There's currently no GUI.
  151.  
  152.  
  153. seriala <serial port description>
  154.   To use com port 1 as a Mac modem port:
  155.   seriala COM1
  156.  
  157.  
  158. serialb <serial port description>
  159.   To use com port 2 as a Mac printer port:
  160.   serialb COM2
  161.  
  162.  
  163. nocdrom <"true" or "false">
  164.   as in other ports
  165.   
  166.   
  167. cdrom <CD-ROM drive description>
  168.  
  169.   cdrom v:\
  170.   
  171.   if not defined, the CD-ROM drives are
  172.   detected automatically
  173.  
  174.  
  175. floppy <floppy drive description>
  176.  
  177.   floppy a:\
  178.   
  179.   if not defined, the floppy drives are
  180.   detected automatically
  181.   
  182.   To change a floppy disk, drag and drop it to the
  183.   wastebasket. Remove the disk from the drive.
  184.   After inserting a new disk, press Control-Shift-F11
  185.   and the program will mount the new disk.
  186.  
  187.  
  188. scsi0 <SCSI target> ... scsi6 <SCSI target>
  189.   ignored. The windows port scans for all
  190.   SCSI devices and up to 6 first devices are
  191.   made visible. You cannot explicitly enable
  192.   a device, but you can disable a device,
  193.   see "disablescsi" command.
  194.  
  195.  
  196. screen <video mode>
  197.   video mode may be either nothing, "dx" or "fb".
  198.  
  199.   Nothing is a refreshed screen mode that uses Windows GDI calls to 
  200.   write to the screen. You may have other windows on top of Basilisk II.
  201.  
  202.   "dx" is a refreshed DirectX mode (minimum version 5.0). There are 
  203.   ways to install DirectX 5 on NT 4. Some new display adapters work
  204.   fine even with DirectX 3.
  205.  
  206.   "fb" is a non-refreshed video mode that works only on NT. It accesses 
  207.   the linear frame buffer directly. This is for true Mac experience,
  208.   smooth mouse movement and screen updates are "real".
  209.   Use the hotkey Control-Shift-F12 to switch between Windows and Mac.
  210.   Fast task switch (Alt-tab) and Explorer start menu (Control-escape)
  211.   are disabled, control-alt-del is enabled. If the program crashes so
  212.   badly that even alt-f4 doesn't work, use the three finger salute
  213.   (control-alt-del) to log off and back on again.
  214.  
  215.   Since this option grabs the Win16Lock for an extended period of time, 
  216.   it would instantly hang the system if attempted under Win9x, 
  217.   and is therefore disabled. It also creates a new desktop which is
  218.   supported only on NT.
  219.  
  220.   To use DirectX mode:
  221.  
  222.   screen dx
  223.  
  224.   To use linear frame buffer mode:
  225.  
  226.   screen fb
  227.  
  228.   The windows port checks what display mode
  229.   you are currently running an uses that one. The
  230.   screen is always full screen. You can freely task
  231.   switch with Alt-Tab between BasiliskII and other
  232.   application. When you switch out, BasiliskII is put
  233.   into a "snooze" mode; that is, it uses less processor
  234.   time but still keeps processing possible background
  235.   tasks. Normal operation is resumed when the BasiliskII
  236.   windows is reactivated.
  237.  
  238.   If you have a fast display adapter, don't expect to get a huge 
  239.   performance boost using dx or fb. The screen updates are usually
  240.   not the performance bottleneck anymore.
  241.  
  242.  
  243.  
  244. Windows specific commands
  245. -------------------------
  246.  
  247. noscsi <"true" or "false">
  248.   to completely disable SCSI devices:
  249.   
  250.   noscsi true
  251.   
  252.   Note that currently all SCSI operations are executed
  253.   synchronously, even if Mac application has requested
  254.   asynchronous operation. What this means is that the
  255.   control is not returned to the application until the command
  256.   is completely finished. Normally this is not an issue,
  257.   but when a CDR/CDRW is closed or erased the burner
  258.   program typically wants to wait in some progress dialog
  259.   The result may be that the application reports
  260.   a time-out error, but the operation completes
  261.   all right anyway.
  262.   
  263.   
  264. nofloppyboot <"true" or "false">
  265.   to disable booting from a floppy:
  266.   
  267.   nofloppyboot true
  268.  
  269.  
  270. replacescsi <"Vendor1"> <"Model1"> <"Vendor2"> <"Model2">
  271.   This command tricks the Mac to believe that you have
  272.   a SCSI device Model2 from vendor Vendor2, although your
  273.   real hardware is Model1 from Vendor1. This is very useful
  274.   since many devices have almost identical ATAPI and SCSI
  275.   versions of their hardware, and MacOS applications usually
  276.   support the SCSI version only. The example below is typical:
  277.   
  278.   replacescsi "HP" "CD-Writer+ 7100" "PHILIPS" "CDD3600"
  279.   
  280.   Note the use of quotes.
  281.  
  282.  
  283. disablescsi <"Vendor"> <"Model">
  284.   Disables this vendor/model combination. You may need this
  285.   simply because you have more than 6 SCSI devices, or the
  286.   particular device has problems under BasiliskII.
  287.  
  288.   disablescsi "HP" "CD-Writer+ 7100"
  289.   
  290.   Again, note the use of quotes.
  291.  
  292.  
  293. ntdx5hack <"true" or "false">
  294.   Default is false.
  295.   You may need this on NT if your display adapter driver has a bug
  296.   in DirectX palette support. Black and white are reversed.
  297.   It fixes the palette issue by using GDI palette instead of D3D palette.
  298.  
  299.  
  300.  
  301. Keyboard
  302. --------
  303.  
  304. Alt-F4
  305.   Kill the program (promts for confirmation)
  306.  
  307. Alt-tab, Control-esacpe, Alt-esacpe
  308.   Windows functions disabled under WinNT.
  309.  
  310. Shift-Control-F12
  311.   Desktop hotkey, Windows <-> Mac
  312.  
  313. Shift-Control-F11
  314.   Floppy reload hotkey. Previous version used both control keys;
  315.   this is not supported any more.
  316.  
  317. Pause/break
  318.   Mac Power off key.
  319.  
  320. Right control
  321.   Option under WinNT
  322.  
  323. Left Winkey
  324.   Option
  325.  
  326. Print Screen
  327.   Copies a bitmap image of the screen to Windows clipboard.
  328.  
  329.  
  330.  
  331. Compiling
  332. ---------
  333.  
  334. Requires Microsoft Visual C++ 5.0 or later. Symantec C++ 
  335. should work too, with some modifications. See the sysdeps.h
  336. file in "Windows" directory.
  337.  
  338. There is no tech document for WinNT port yet. Use the force, Luke.
  339.  
  340.  
  341.  
  342. Ported by
  343. ---------
  344.  
  345. Lauri Pesonen
  346. lpesonen@nic.fi
  347.  
  348.  
  349.  
  350. License
  351. -------
  352.  
  353. Basilisk II is available under the terms of the GNU General Public License.
  354. See the file "COPYING" that is included in this archive for details.
  355.