ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/cebix/BasiliskII/README
(Generate patch)

Comparing BasiliskII/README (file contents):
Revision 1.1 by cebix, 1999-10-03T14:16:25Z vs.
Revision 1.6 by cebix, 1999-10-21T13:19:11Z

# Line 10 | Line 10 | License
10   -------
11  
12   Basilisk II is available under the terms of the GNU General Public License.
13 < See the file "COPYING" that is included in this archive for details.
13 > See the file "COPYING" that is included in the distribution for details.
14  
15  
16   Overview
# Line 45 | Line 45 | The emulator is not yet complete. See th
45   unimplemented stuff.
46  
47  
48 < Requirements
49 < ------------
50 <
51 < To use Basilisk II, you need either a 512K Mac Classic ROM image or a
52 < 512K or 1MB 32-bit clean Macintosh ROM image. You also need a copy of MacOS
53 < (0.x thru 7.5 for Classic emulation, 7.x or 8.0/8.1 for Mac II emulation).
54 < For copyright reasons, none of these items are included with Basilisk II.
55 < MacOS 7.5.3 and earlier versions can be downloaded from Apple and various
56 < other Internet sites. Mac ROM files are not freely available. You have to
57 < own a real Mac and read out its ROM. No, I don't know where you can download
58 < ROM files. No, I won't send you one.
59 <
60 < Depending on the platform you use, Basilisk II has additional requirements:
61 <
62 < BeOS:
63 <  You need BeOS R4 or better. On a PowerPC system you also need the
64 <  "sheep" driver that comes with SheepShaver. To use Ethernet, you need
65 <  the "sheep_net" add-on that also comes with SheepShaver (both items
66 <  are included in the SheepShaver Trial Versions). The PowerPC version of
67 <  Basilisk II cannot do Mac Classic emulation.
68 <
69 < Unix:
70 <  You need X11R4, pthreads support and GNU make. To use the GUI preferences
71 <  editor, you also need GTK+ version 1.2 or better. On Linux, you need
72 <  glibc 2.0 or better.
73 <
74 < AmigaOS:
75 <  You need at least a 68020 and AmigaOS 3.0 or better. To get the GUI
76 <  preferences editor, you need gtlayout.library V39 or later. To get sound
77 <  output, you need AHI V2 or later. Both items can be found on Aminet. You
78 <  also need the "PrepareEmul" utility that somes with ShapeShifter (or any
79 <  equivalent PrepareEmul substitute). The AmigaOS version of Basilisk II
80 <  cannot do Mac Classic emulation.
81 <
82 < Windows:
83 <  You need at least Windows NT 4.0. Windows 95 and 98 can be used too, with a
84 <  somewhat reduced set of features. Basilisk II supports DirectX version 5 or
85 <  later, but version 3 may also work, depending on your graphics card.
86 <
87 <
88 < Installation
89 < ------------
90 <
91 < BeOS:
92 <  If you have a binary distribution of Basilisk II for BeOS, there are
93 <  executables for BeOS/PPC and BeOS/x86 included. If you have the source
94 <  distribution, cd to "src/BeOS", and type "make". Basilisk II cannot run
95 <  concurrently with SheepShaver. Trying to do so will crash Basilisk II,
96 <  or SheepShaver, or both. On a PowerPC system you must have installed the
97 <  "sheep" driver that comes with SheepShaver. To use Ethernet, you must have
98 <  installed the "sheep_net" add-on that also comes with SheepShaver
99 <
100 < Unix:
101 <  To compile Basilisk II, cd to "src/Unix", and type "./configure" followed
102 <  by "make" and (optionally) "make install". To use Ethernet networking under
103 <  Linux, you either have to configure your kernel for ethertap support or make
104 <  and install the "sheep_net" driver: cd to "src/Unix/Linux/NetDriver" and
105 <  type "make". This should produce a kernel module "sheep_net.o". Now su root
106 <  and type "./MAKEDEV" which will install the device node "/dev/sheep_net".
107 <  Then say "/sbin/insmod sheep_net.o" and the driver should be ready for use.
108 <  You should give appropriate access rights to /dev/sheep_net if you don't
109 <  want to run Basilisk II as root.
110 <
111 <  This is what Brian J. Johnson says about compiling for IRIX:
112 <   "I recommend compiling with "-Ofast".  This requires changing "-g"
113 <    to "-Ofast" in the Makefile, and adding "-ipa" to LDFLAGS.  This
114 <    turns on massive interprocedural optimization, and makes for much
115 <    better performance."
48 > Requirements and Installation
49 > -----------------------------
50  
51 < AmigaOS:
52 <  If you have a binary distribution of Basilisk II for AmigaOS, there is an
119 <  executable included. You must also have the "PrepareEmul" utility installed
120 <  that comes with ShapeShifter (or any equivalent PrepareEmul substitute,
121 <  see the ShapeShifter docs). If you have the source distribution, cd to
122 <  "src/AmigaOS" and type "smake". To recompile Basilisk II, you need SAS/C
123 <  6.58. Earlier versions may not work.
124 <
125 < Windows NT:
126 <  If you have a binary distribution of Basilisk II for Windows, there is a
127 <  Windows NT binary included. To access CD-ROMs under Windows NT, the driver
128 <  "cdenable.sys" must be copied to your "\WinNT\System32\drivers" directory.
129 <  To access CD-ROMs under Windows 9x, the driver "cdenable.vxd" must be copied
130 <  to the "\Windows\System" directory. To recompile Basilisk II, you need
131 <  MS Visual V++ 5.0 or later. Symantec C++ should work, too, with some
132 <  modifications. See the "sysdeps.h" file in the "Windows" directory.
133 <
134 < The ROM file has to be named "ROM" and put in the same directory as the
135 < Basilisk II executable but you can specify a different location for the ROM
136 < file with the "rom" option in the preferences file.
51 > Please consult the file "INSTALL" for a list of system requirements and
52 > installation instructions.
53  
54  
55   Configuration
# Line 250 | Line 166 | scsi0 <SCSI target> ... scsi6 <SCSI targ
166      "scsi.device/2").
167  
168    Windows:
169 <    Ignored. Basilisk II scans for all SCSI devices and the first 6 found
170 <    devices are made visible to the MacOS. You cannot explicitly enable a
255 <    device, but you can disable a device (see the "disablescsi" command).
169 >    The "SCSI target" has the format <"Vendor"> <"Model"> (e.g.
170 >    scsi0 "HP" "CD-Writer+ 7100"). Note the use of quotes.
171  
172   screen <video mode>
173  
# Line 282 | Line 197 | screen <video mode>
197          Color display in an X11 window of the given size. The color depth
198          (8/15/24 bit) depends on the depth of the underlying X11 screen.
199          This is the default.
200 <      dga
200 >      dga/<width>/<height>
201          Full-screen display using the X11 DGA extensions. The color depth
202          (8/15/24 bit) depends on the depth of the underlying X11 screen.
203 <        For DGA to work, Basilisk II must be compiled with DGA support
204 <        enabled (selectable in the configure script).
203 >        "width" and "height" specify the maximum width/height to use.
204 >        Saying "dga/0/0" means "complete screen". For DGA to work, Basilisk II
205 >        must be compiled with DGA support enabled (selectable in the configure
206 >        script).
207  
208    AmigaOS:
209      The "video mode" is one of the following:
# Line 552 | Line 469 | Windows:
469    
470      Note the use of quotes.
471  
472 <  disablescsi <"Vendor"> <"Model">
472 >  rightmouse <0/1>
473  
474 <    Disables this vendor/model combination. You may need this simply because
475 <    you have more than 6 SCSI devices, or the particular device has problems
476 <    under BasiliskII. E.g.
474 >    Defines what the right mouse button is used for. The default values of 0
475 >    means that it is used to move windowed mode BasiliskII screen.
476 >    Value 1 sends a combination Control and mouse click to the MacOS.
477 >    This may be useful under OS versions 8 and above.
478  
479 <      disablescsi "HP" "CD-Writer+ 7100"
480 <  
481 <    Again, note the use of quotes.
479 >  keyboardfile <path>
480 >
481 >    Defines the path of the customized keyboard code file.
482 >
483 >  pollmedia <"true" or "false">
484 >
485 >    If true (default), tries to automatically detect new media.
486 >    Applies to all "floppy", "cd" or "disk" removable media except
487 >    1.44 MB floppies. May cause modest slow down. If unchecked,
488 >    use Ctrl-Shift-F11 to manually mount new media.
489 >    If you have auto-insert notification (AIN) enabled, you may turn this
490 >    option off. Note that some CD related software require AIN,
491 >    and some other need it to be turned off. Consult the documentation
492 >    of your CD software to learn which one is optimal for you.
493 >
494 >  framesleepticks <milliseconds>    
495 >
496 >    The amount of time between video frames.
497 >
498 >  showfps <true/false>
499 >
500 >    If true, the real frame rate is displayed.
501 >
502 >  stickymenu <true/false>
503 >
504 >    If true, the main menu bar is kept open even after the mouse button is released,
505 >    under all OS versions (OS 8 has this feature already). There are extensions to do
506 >    the same thing, but it's faster to handle this in native code.
507 >    Default is "true".
508  
509    ntdx5hack <"true" or "false">
510  
# Line 663 | Line 607 | Contributions by:
607   - Bill Huey <billh@mag.ucsd.edu>: 15/16 bit DGA and 15/16/32 bit X11
608     window support
609   - David Lawrence <davidl@jlab.org>: incremental window refresh code
610 + - Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and
611 +   fbdev video code
612 + - and others...
613  
614   Special thanks to:
615   - Bernd Schmidt for letting me use his UAE 68k emulation
# Line 707 | Line 654 | There is no user-level support for Basil
654   History
655   -------
656  
657 < Please consult the file "CHANGES" for the release history.
657 > Please consult the file "ChangeLog" for the release history.
658  
659  
660   Christian Bauer

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines