This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
sheepshaver_mac_os_x_setup [2019/02/02 08:06] ronald_p._regensburg [Introduction] |
sheepshaver_mac_os_x_setup [2019/05/04 02:54] (current) ronald_p._regensburg [Setting up SheepShaver for OSX/macOS on Intel Macs] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Setting up SheepShaver for OSX/macOS on Intel Macs ====== | ====== Setting up SheepShaver for OSX/macOS on Intel Macs ====== | ||
| - | (Last updated January 16, 2019) | + | (Last updated May 4, 2019) |
| (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 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 ~/.sheepshaver_prefs file.) | + | (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 ~/.sheepshaver_prefs file.) |
| === 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 "Save" to save the settings and to close the Preferences window. | + | Click "Save" to save the settings and to close the Preferences window.\\ |
| + | (In 2 February 2019 and later builds the "Save" button is replaced by a "Save and Quit" button. It will remind the user that SheepShaver needs to be quit and shut down after changes in Preferences are saved.) | ||
| === 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 and quit SheepShaver. | + | Save the change and shut down the emulated machine to quit SheepShaver. |
| //(If you used a real install CD, you can now remove it in OSX/macOS.)// | //(If you used a real install CD, you can now remove it in OSX/macOS.)// | ||
| Line 343: | Line 344: | ||
| 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. | ||
| + | Cursor grab is fully functional in version 2.4 builds. In 2.5 version builds it will only work with the (default) software cursor, not if the hardware cursor is enabled (see below under Advanced features). | ||
| ===== Advanced features (Version 2.5 builds only) ===== | ===== Advanced features (Version 2.5 builds only) ===== | ||
| === === | === === | ||
| - | These features can be activated by manually editing the preferences file (**~/.sheepshaver_prefs** in a classic setup or **prefs** in a VM). | + | **These features can be activated by manually editing the preferences file** (**~/.sheepshaver_prefs** in a classic setup or **prefs** in a VM). |
| - | **Hard cursor in window mode**\\ | + | **• Hardware cursor in window mode**\\ |
| - | The version 2.5 builds use a different way to display the cursor in window mode, they use 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 (~/.sheepshaver_prefs in classic setup or prefs in a VM): | + | The version 2.5 builds use a different way to display the cursor in window mode, they use the software cursor that is also used in full-screen mode. If you prefer the hardware cursor in window mode, you can add this line to the preferences file: |
| 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 cursor only in window mode, the cursor issues in version 2.4 when switching between window mode and full-screen mode will also return. (See below under Known issues.) |
| - | **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 scaling algorithm" below. | ||
| + | |||
| + | **• Changing the hotkey**\\ | ||
| By default, the hotkey used with window/full-screen toggle and mouse grabbing toggle is the Control key (Control-Return and Control-F5). You can change the hotkey by adding a "hotkey" item to the preferences file: | By default, the hotkey used with window/full-screen toggle and mouse grabbing toggle is the Control key (Control-Return and Control-F5). You can change the hotkey by adding a "hotkey" item to the preferences file: | ||
| Line 368: | Line 377: | ||
| hotkey 5 | hotkey 5 | ||
| | | ||
| - | **Changing scaling algorithm** (16 January 2019 and later builds)\\ | + | **• Changing scaling algorithm** (Works as intended in 24 February 2019 and later builds)\\ |
| - | Using integer or nearest-neighbour scaling will improve display quality when a low resolution emulator screen is displayed full screen on a high resolution monitor. For best results, the emulator screen resolution needs to be half of the resolution of the host's monitor or lower. Integer and/or nearest-neighbour scaling can be applied by adding these lines to the preferences file: | + | 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_integer true | ||
| scale_nearest true | scale_nearest true | ||
| - | **Changing reported CPU speed** (16 January 2019 and later builds)\\ | + | **• 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: | 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 | cpuclock 200 | ||
| - | This line wil make SheepShaver identify itself as a 200MHz machine. Note that this setting does not change the actual speed! | + | 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 ===== | ||
