Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
sheepshaver_mac_os_x_setup [2018/11/07 02:33] – [Version 2.5 build, 11 July 2018] ronald_p._regensburg | sheepshaver_mac_os_x_setup [2019/05/04 02:54] – [Additional features] ronald_p._regensburg | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Setting up SheepShaver for OSX/macOS on Intel Macs ====== | ====== Setting up SheepShaver for OSX/macOS on Intel Macs ====== | ||
- | (Last updated | + | (Last updated |
(You can also set up SheepShaver versions [[sheepshaver mac os x setup old|for PPC Mac]], [[sheepshaver setup|for Windows]], [[ubuntu|and for Linux]]) | (You can also set up SheepShaver versions [[sheepshaver mac os x setup old|for PPC Mac]], [[sheepshaver setup|for Windows]], [[ubuntu|and for Linux]]) | ||
Line 17: | Line 17: | ||
However, files and folders can be renamed and/or moved to different locations, provided you make sure the file names and/or full paths to the files are entered in SheepShaver preferences. | However, files and folders can be renamed and/or moved to different locations, provided you make sure the file names and/or full paths to the files are entered in SheepShaver preferences. | ||
- | **Changing settings:** After making | + | **Changing settings:** After saving |
**CD-ROMs: | **CD-ROMs: | ||
Line 126: | Line 126: | ||
Choose Preferences from the SheepShaver menu to open the preferences (Virtual Machine Settings) window. | Choose Preferences from the SheepShaver menu to open the preferences (Virtual Machine Settings) window. | ||
- | (The preferences settings will be saved in a invisible file .sheepshaver_prefs in your Home folder. The following description assumes that SheepShaver is set up for the first time and that there is no pre-existing ~/ | + | (The preferences settings will be saved in an invisible file .sheepshaver_prefs in your Home folder. The following description assumes that SheepShaver is set up for the first time and that there is no pre-existing ~/ |
=== 3. Configure preferences in Setup tab === | === 3. Configure preferences in Setup tab === | ||
Line 195: | Line 195: | ||
=== 6. Save your settings === | === 6. Save your settings === | ||
- | Click " | + | Click " |
+ | (In 2 February 2019 and later builds the " | ||
=== 7. Quit SheepShaver === | === 7. Quit SheepShaver === | ||
Line 226: | Line 227: | ||
Open SheepShaver Preferences and **remove the CD disk image file from the volumes list**, select it and click the Remove button. | Open SheepShaver Preferences and **remove the CD disk image file from the volumes list**, select it and click the Remove button. | ||
- | Shut down the emulated machine | + | Save the change and shut down the emulated machine |
//(If you used a real install CD, you can now remove it in OSX/ | //(If you used a real install CD, you can now remove it in OSX/ | ||
Line 338: | Line 339: | ||
=== === | === === | ||
- | Some available | + | Some features are not mentioned elsewhere in this manual: |
**Grabbing mouse cursor toggle**\\ | **Grabbing mouse cursor toggle**\\ | ||
Using Control-F5 will contain the mouse cursor within the SheepShaver window. This may be useful with some games. | Using Control-F5 will contain the mouse cursor within the SheepShaver window. This may be useful with some games. | ||
- | **Hard cursor | + | Cursor grab is fully functional |
- | The version 2.5 build uses a different way to display the cursor in window mode, it uses the soft cursor that is also used in full-screen mode. If you prefer the hard cursor in window mode, you can add this line to the preferences file (~/ | + | ===== Advanced features |
+ | |||
+ | === === | ||
+ | |||
+ | **These features can be activated by manually editing the preferences file** (**~/ | ||
+ | |||
+ | **• Hardware cursor in window mode**\\ | ||
+ | The version 2.5 builds use a different way to display the cursor in window mode, they use the software | ||
hardcursor true | hardcursor true | ||
- | However, with the hard cursor the cursor issues in version 2.4, when switching between window mode and full-screen mode, will also return. (See below under Known Issues.) | + | However, with the hardware |
- | **Changing the hotkey** | + | **• Hardware cursor in both window mode and full-screen mode** (29 March 2019 and later builds)\\ |
+ | The hardware cursor can also be used in full-screen mode if integer scaling is used. You can enable the hardware cursor in both window mode and full-screen mode by adding these lines to the preferences file | ||
+ | hardcursor true | ||
+ | scale_integer true | ||
+ | scale_nearest true | ||
+ | See also " | ||
+ | |||
+ | **• Changing the hotkey**\\ | ||
By default, the hotkey used with window/ | By default, the hotkey used with window/ | ||
Line 361: | Line 376: | ||
For instance, you can set the hotkey to Control-Command by adding this line to the preferences file: | For instance, you can set the hotkey to Control-Command by adding this line to the preferences file: | ||
hotkey 5 | hotkey 5 | ||
+ | | ||
+ | **• Changing scaling algorithm** (Works as intended in 24 February 2019 and later builds)\\ | ||
+ | Using nearest-neighbour or integer scaling will improve display quality when a low resolution emulator screen is displayed on a high resolution monitor (Retina screen). Nearest-neighbour or integer scaling can be applied by adding one or both of these lines to the preferences file: | ||
+ | scale_integer true | ||
+ | |||
+ | scale_nearest true | ||
+ | |||
+ | **• Changing reported CPU speed** (16 January 2019 and later builds)\\ | ||
+ | SheepShaver identifies itself as a 100MHz machine to software running on it. Although the reported 100MHz is unrelated to the actual speed, some software may show a message that it will not run because it needs a faster machine. The reported CPU speed can be changed by adding a cpuclock item to the preferences file: | ||
+ | cpuclock 200 | ||
+ | This line wil make SheepShaver identify itself as a 200MHz machine.\\ | ||
+ | **Note: **This setting does not change the actual speed! | ||
+ | |||
+ | **• Offset date in years and/or days** (20 February 2019 and later builds)\\ | ||
+ | The date inside SheepShaver can be set in the past or in the future, in years and/or days. This may be needed for using some specific software. | ||
+ | Adding these lines to the preferences file will set the date to 25 February 1989 when the actual date on the host is 20 February 2019: | ||
+ | yearofs -30 | ||
+ | dayofs +5 | ||
+ | **Note: **This feature can mix up relations between older files and newer files and between files' creation dates and modification dates. It should only be used by experienced users who know what they are doing, preferably in a separate (sheepvm VM) setup. | ||
===== Uninstalling SheepShaver ===== | ===== Uninstalling SheepShaver ===== | ||
Line 376: | Line 410: | ||
=====Known issues===== | =====Known issues===== | ||
- | ==== Both July 2018 builds ==== | + | ==== All 2018 and later builds ==== |
=== === | === === | ||
Line 390: | Line 424: | ||
This issue can be avoided by only adding and removing disk images as CD-ROM in the Volumes list in SheepShaver Preferences. (As always: After a change in preferences settings quit SheepShaver and launch it again for the change to take effect.) | This issue can be avoided by only adding and removing disk images as CD-ROM in the Volumes list in SheepShaver Preferences. (As always: After a change in preferences settings quit SheepShaver and launch it again for the change to take effect.) | ||
- | ==== Version 2.4 build, | + | ==== Version 2.4 (9 July 2018) build ==== |
=== === | === === | ||
Line 398: | Line 432: | ||
When you switch from full-screen to window mode using Control-Return, | When you switch from full-screen to window mode using Control-Return, | ||
- | ==== Version 2.5 build, 11 July 2018 ==== | + | ==== Version 2.5 builds |
=== === | === === |