Emaculation.com

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
sheepshaver_mac_os_x_setup [2018/11/07 02:33] – [Version 2.5 build, 11 July 2018] ronald_p._regensburgsheepshaver_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 September 19, 2018)+(Last updated April 12, 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 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 changes in preferences, always quit the SheepShaver application and launch it again. Only then will the changes take effect, with only a restart in the emulated machine new settings will not be used.+**Changing settings:** After saving changes in preferences, always quit the SheepShaver application, shut down the emulated machine, and launch SheepShaver again. Only then will the changes take effect, after only a restart of the emulated machine new settings will not be used.
  
 **CD-ROMs:** Up to Mac OS X 10.7, physical CD-ROMs can be mounted within SheepShaver. Just insert the CD on the host system and the CD will be mounted on the guest desktop. OS X 10.8 and later prevents mounting of physical CD-ROMs in SheepShaver but disk images created from CD-ROMs will work fine. **CD-ROMs:** Up to Mac OS X 10.7, physical CD-ROMs can be mounted within SheepShaver. Just insert the CD on the host system and the CD will be mounted on the guest desktop. OS X 10.8 and later prevents mounting of physical CD-ROMs in SheepShaver but disk images created from CD-ROMs will work fine.
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 338: Line 339:
 === === === ===
  
-Some available features are not mentioned elsewhere in this manual:+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 in window mode** (Version 2.5 build only)\\ +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). 
-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 (~/.sheepshaver_prefs in classic setup or prefs in a VM):+===== 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). 
 + 
 +**• 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 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** (Version 2.5 build only)\\+**• 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 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, 9 July 2018 ====+==== Version 2.4 (9 July 2018) build ====
  
 === === === ===
Line 398: Line 432:
  
 When you switch from full-screen to window mode using Control-Return, the cursor may be displayed twice. Also here, one click on the desktop or pressing the control key will solve the issue. When you switch from full-screen to window mode using Control-Return, the cursor may be displayed twice. Also here, one click on the desktop or pressing the control key will solve the issue.
-==== Version 2.5 build, 11 July 2018 ====+==== Version 2.5 builds ====
  
 === === === ===