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/02/24 12:15] – [Advanced features (Version 2.5 builds only)] 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 192018)+(Last updated February 202019)
  
 (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 338: Line 338:
 === === === ===
  
-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)\\ +===== Advanced features (Version 2.5 builds only) ===== 
-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):+ 
 +=== === 
 + 
 +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**\\ 
 +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):
   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 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.)
  
-**Changing the hotkey** (Version 2.5 build only)\\+**• 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 367:
 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 of these lines to the preferences file:
 +  scale_nearest true
 +
 +  scale_integer 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 that 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 the relation 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 400:
 =====Known issues===== =====Known issues=====
  
-==== Both July 2018 builds ====+==== All 2018 and later builds ====
  
 === === === ===
Line 390: Line 414:
 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 422:
  
 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 ====
  
 === === === ===