| Basilisk II | |
|---|---|
 | |
| General | |
| Author | meetpatty, rsn8887 |
| Type | Computer |
| Version | 0.33h |
| License | GPL-2.0 |
| Last Updated | 2021/04/06 |
| Links | |
| Download | |
| Website | |
| Source | |
| Support Author | |
Port of Basilisk II to the PS Vita. Based off Chilly Willy's port to the PSP.
Basilisk II is an Open Source 68k Macintosh emulator. That is, it allows you to run 68k MacOS software on your computer, even if you are using a different operating system. However, you still need a copy of MacOS and a Macintosh ROM image to use Basilisk II.
Features
- Emulates a Mac II series machine running OS 7.0.1 through 8.1, depending on the ROM used.
- Uses UAE CPU emulation, with new SoftFloat FPU emulation for better compatibility.
- Supports on-the-fly change of colors and resolution (requires Display Manager).
- Has stereo, 16-bit, 44kHz audio (requires Sound Manager 3.0).
- Supports emulated floppy and CDROM with removable media (no CD audio yet).
- Supports up to four hardfiles for use as fixed drives.
- Emulates a Mac Extended ADB keyboard and mouse. Buttons can be remapped on-the-fly.
- Bluetooth keyboard and mouse support.
- On-screen overlay keyboard that controlled with Vita buttons.
- Analog joystick pointer movement with adjustable speed and deadzone.
- Touch pointer controls (front/rear panel) with gestures and selectable direct/indirect mode.
Installation
Note: No Apple Macintosh ROMs or software of any sort is included with this program. You'll have to find them yourself. This emulator is useless without a ROM and MacOS.
Install the VPK in the usual way. Copy the Basilisk II folder in the archive to ux0:data.
If you look at the folder, you'll see the following:
(directories)
- cdroms
- disks
- files
- hardfiles
- imaps
- roms
(files)
- BasiliskII_prefs
- imaps/default
- imaps/dpad_mouse
The cdroms folder is where you copy the bin/cue dumps of Mac CDROMs you wish to use with the emulation. These should be standard MODE1 ISO dumps, not raw dumps. The extension for CDROM images are normally ".bin", ".iso", or ".img".
The disks folder is where you copy floppy images you wish to use with the emulation. These are plain dumps of 1.44 MB high-density Mac or PC format microfloppy disks. PC format requires the appropriate Mac extension to read, such as MacLink (part of OS 8). All files in this folder should have an extension of “.dsk”.
The files folder is mounted on the Mac desktop when enabled in the settings. Files in this folder should be in AppleDouble, hqx, and binhex format.
The hardfiles folder contains the files that are used as fixed hard disks in the emulation. They can be virtually any size, but will generally be between 200 and 400 MB as a basic installation of OS8 takes about 120 MB. You can have any number of files in this directory, but only a maximum of four can be selected at one time. The extension of files in this folder should b “.hfv”, but may also have no extension at all.
The imaps folder holds the input maps for remapping the Vita buttons into Mac input events. This will be explained later.
The roms folder holds the Mac ROM images you might use with the emulation. You select one image in the emulation setup. They can have any file name, but a typical extension is “.rom”.
BasiliskII_prefs is a sample preferences file.
User guide
Note that you can only have one cd-rom and floppy mounted at a time. To mount another, you must first dismount the CD-ROM/floppy which is already mounted.
On the Mac, you dismount disks/cd-roms by throwing them in the trash, or by selecting the disk and then selecting Eject from the Special menu (or pressing the Command + E keys).
Imap file format
Each line has the following format:
<vita key(s) pressed> <vita key(s) not pressed> <mac key 1> <mac key 2> <mac key 3> <mac key 4>
Lines starting with # are treated as comment lines and ignored,
Valid vita key values are (OR keys to combine):
0x0000 No key 0x0008 Start button. 0x0010 Up D-Pad button. 0x0020 Right D-Pad button. 0x0040 Down D-Pad button. 0x0080 Left D-Pad button. 0x0100 Left trigger. 0x0200 Right trigger. 0x1000 Triangle button. 0x2000 Circle button. 0x4000 Cross button. 0x8000 Square button.
See below for Basilisk II key codes.
Example D-Pad Up = cursor up: 0x0010 0x0000 62 255 255 255 Example Triangle = command + q: 0x1000 0x0000 55 12 255 255
See imaps/default and imaps/dpad_mouse for further examples.
Basilisk II Key Codes
0 A 1 S 2 D 3 F 4 H 5 G 6 Z 7 X 8 C 9 V 11 B 12 Q 13 W 14 E 15 R 16 Y 17 T 18 1 19 2 20 3 21 4 22 6 23 5 24 = 25 9 26 7 27 - 28 8 29 0 30 ] 31 O 32 U 33 [ 34 I 35 P 36 Return 37 L 38 J 39 ' 40 K 41 ; 42 \ 43 , 44 / 45 N 46 M 47 . 48 Tab 49 Space 50 ` 51 Backspace 53 Esc 54 Ctrl Left 55 Alt Left (-> Command) 56 Shift Left 57 Caps Lock 58 Logo Left (-> Option) 59 Cursor Left 60 Cursor Right 61 Cursor Down 62 Cursor Up 65 KP . 67 KP * 69 KP + 71 Num Lock 75 KP / 76 KP Enter 78 KP - 82 KP 0 83 KP 1 84 KP 2 85 KP 3 86 KP 4 87 KP 5 88 KP 6 89 KP 7 91 KP 8 92 KP 9 96 F5 97 F6 98 F7 99 F3 100 F8 101 F9 103 F11 105 PrintScrn 107 Scroll Lock 109 F10 111 F12 113 Pause 114 Insert 115 Home 116 Page Up 117 Delete 118 F4 119 End 120 F2 121 Page Down 122 F1 255 No key press 256 Mouse button 1 1024 Slow down analog stick mouse 1025 Speed up analog stick mouse
Indirect Touch Controls
Indirect touch controls are always used on the rear panel. On the front panel, the default is to use direct touch (pointer jumps to finger), but indirect controls can be enabled in the menu.
For multi-touch gestures, the fingers have to be far enough apart from each other, so that the Vita will not erroneously recognize them as a single finger. Otherwise the pointer will jump around.
Controls
Select - Invoke the imap/floppy/cdrom menu
imap/floppy/cdrom menu:
Up/Down - Change between inpot maps/floppies/cdroms
Left/Right - Browse the list of files in the imaps/disks/cdroms directories
Cross - Select an input map, Mount a CD-ROM/floppy
Select - Exit menu
Default controls:
Cross - Mouse button
Square - Enter key
Circle - Command + w (Close Window)
Triangle - Command + q (Quit Application)
R - Control key
L - Option key
D-Pad - Corresponding cursor key
Analog - Mouse
analog_speed controls:
Cross - Mouse button
Square - Enter key
Circle - Control key + mouse button ("right click")
Triangle – command + q (Quit Application)
R - Hold to slow down analog joystick mouse
L - Hold to speed up analog joystick mouse
D-Pad – Corresponding cursor key
Analog - Mouse
dpad_mouse controls:
Cross - Mouse button
Square - Enter key
Circle - Command + w (Close Window)
Triangle - Command + q (Quit Application)
R - Control key
L - Move mouse faster
D-Pad - Mouse
Analog - Mouse
Indirect Touch controls:
Single finger drag - Move the mouse pointer, how far the pointer moves in response to finger motion depends on the Mouse Speed setting
Single finger short tap - Left mouse button
One finger short tap while holding another finger - Right mouse button
Long second finger tap while holding another finger - Initiate left mouse button drag and drop (useful to hold left button down to bring up menus)
Long third finger tap while holding two other fingers - Initiate right mouse button drag and drop (drag and drop stops when last finger is released)
Screenshots
Media
How to run System 7.6.1 and MacOS 8.1 on a Sony PlayStation Vita with Basilisk II (NanoNomad)
Changelog
0.33h
- Implement slow/fast modifiers for analog pointer.
- Allow more memory (>29 MB) for emulated computer.
0.33g
- Further improve pointer motion with analog stick.
0.33f
- Improve pointer response to diagonal stick directions.
0.33e
- Remove bluetooth mouse lag.
- Apply pointer speed setting also to bluetooth mouse.
0.33d
- Prevent accidental clicks when moving pointer using rear touch or indirect front touch.
0.33c
- Implemented rear touch (can be enabled in options).
- Implemented indirect front touch (can be enabled in options).
- Implemented pointer speed option.
- Implemented radial scaled analog joystick deadzone.
- Added cpu speed option to max out all frequencies (CPU, GPU and BUS) for maximum speed.
0.33b
- Now uses the full analog joystick range of the Vita.
0.33a
- Attempt to reduce bluetooth mouse lag (hard to tell if it helped).
- Re-compiled with latest source from MeetPatty, which includes support of uma0:.
0.32c.
- Bugfix with new 640x400 resolution (was added to internal list of modes twice).
0.32b
- Add 640x400 resolution option.
- Improve picture quality for resolutions where mac pixels do not map 1:1 onto vita pixels. Pixels are much less distorted now in those cases.
- Add aspect ratio option "square pixels," useful to achieve a larger display of some fullscreen games without distortion. For example fullscreen games that run in 640x400 fit the Vita screen pretty well, even without stretching.
.The System 7 resolution setting has a higher priority than the Basiliskii settings. So, to change resolution, it is not enough to only change it in the Basilisk prefs. The resolution has to be changed also in the "monitors" extension in system 7. Otherwise, the os will set it back during boot. 0.32a
- More keys accessible in the Danzeff OSK.
- Highlight qualifier keys selected with "select" when OSK is displayed.