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 [2019/01/16 07:50] – [Additional features] ronald_p._regensburgsheepshaver_mac_os_x_setup [2019/02/26 02:07] – [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 349: Line 349:
 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**\\+**• 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): 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**\\+**• 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 368:
   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 and/or nearest-neighbour scaling may improve display quality (crispier, but more jagged) when a low resolution screen of the emulator is displayed full screen on a high resolution monitor. Integer and 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 of these lines to the preferences file:
-  scale_integer true+
   scale_nearest true   scale_nearest true
  
-**Changing reported CPU speed** (16 January 2019 and later builds)\\+  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: 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 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 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 392: Line 400:
 =====Known issues===== =====Known issues=====
  
-==== Both July 2018 builds ====+==== All 2018 and later builds ====
  
 === === === ===
Line 406: 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 414: 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 ====
  
 === === === ===