Difference between revisions of "SCORE in OS X"

From CCARH Wiki
Jump to navigation Jump to search
Line 3: Line 3:
 
Download and install Boxer.app from http://boxerapp.com
 
Download and install Boxer.app from http://boxerapp.com
  
The version used for this installation manual was Boxer 1.3 (May 2012).
+
The version used for this installation manual was Boxer 1.3 (May 2012). Open the Boxer.app program.  The first time you run it, a directory called "DOS Games" will be installed in your home directory.  This is the default location for the SCORE 4 installation in the next section although the SCORE installation may be moved anywhere else after it has been created.
 +
 
 +
 
 +
== Setting up SCORE 4 in Boxer.app ==
 +
 
 +
To install SCORE 4 in Boxer.app, start Boxer.  A welcome screen will appear:
 +
 
 +
[[File:boxer_welcome.png||center]]
 +
 
 +
Click on the middle icon in the Welcome screen, "Import a new game".  This will bring up another window:
 +
 
 +
[[File:boxer_drop_your_game_here.png||center]]
 +
 
 +
Now create a directory with any name, and place the "scor4" directory containing the SCORE v4 program installation (executable, library and help files).  In the following view of finder, the directory is called "dos", and it contains a directory called "scor4" which contains the SCORE v4 program.
 +
 
 +
[[File:score_in_finder.png||center]]
 +
 
 +
Drag the folder which contains the "scor4" folder ("dos" in this case) into the "Drop your game here." window.  After some processing you will get the following window into which you can type the name for the label on the virtual floppy disk:
 +
 
 +
[[File:boxer_congratulations.png||center]]
 +
 
 +
Click on "Launch game" to start the virtual DOS program.  You will see a window such as in the following image which contains the virtual MS-DOS computer.  At the bottom of the window is a list of executables and batch files that boxer automatically found within the SCOR4 directory.  You can either start SCORE from the DOS prompt (by typing "\scor4\scor4.exe") or by clicking on the "scor4.exe" text a the bottom of the window.
 +
 
 +
[[File:boxer_dos_startup.png||center]]
 +
 
 +
After typing "\scor4\scor4.exe" or clicking on "scor4.exe" in the lauchbar at the bottom of the window, you should have SCORE version 4 running in the virtual MS-DOS program:
 +
 
 +
[[File:boxer_score_open.png||center]]
 +
 
 +
You can type {{keypress|{{command}}|F}} to make the MS-DOS window full-screen as in the following example screenshot.  Pressing {{keypress|{{command}}|F}} while in full-screen mode will revert back to window-mode on the Desktop screen.  Click the following image three times to see the full resolution.
 +
 
 +
[[File:boxer_score_fullscreen.png|700px|center]]
 +
 
 +
To run SCORE 4 in the future with Boxer.app, you will find a directory called "Score4.boxer" (or whatever you labeled the virtual floppy disk/CD-ROM case") in the "DOS Games" folder in your home directory.  To run SCORE 4 again, go to that directory, and you will see a list of DOS applications, including "Score4.boxer":
 +
 
 +
[[File:boxer_score_finder.png||center]]
 +
 
 +
To start the virtual MS-DOS computer, double click on the "Score4.boxer" icon, or you can drag it to install it in the Dock for more immediate access.
 +
 
 +
 
 +
 
 +
== Refinements to the SCORE 4 installation in Boxer.app ==
 +
 
 +
=== Function keys ==
 +
 
 +
In the default settings for OS X, you can access function keys by pressing and holding down the {{keypress|Fn}} key and then one of the function keys at the top row of the keyboard ({{keypress|F1}}, {{keypress|F2}}, {{keypress|F3}}, etc.).
 +
 
  
 
== Useful keyboard characters and commands ==
 
== Useful keyboard characters and commands ==

Revision as of 23:14, 1 June 2012

Installing Boxer.app

Download and install Boxer.app from http://boxerapp.com

The version used for this installation manual was Boxer 1.3 (May 2012). Open the Boxer.app program. The first time you run it, a directory called "DOS Games" will be installed in your home directory. This is the default location for the SCORE 4 installation in the next section although the SCORE installation may be moved anywhere else after it has been created.


Setting up SCORE 4 in Boxer.app

To install SCORE 4 in Boxer.app, start Boxer. A welcome screen will appear:

Boxer welcome.png

Click on the middle icon in the Welcome screen, "Import a new game". This will bring up another window:

Boxer drop your game here.png

Now create a directory with any name, and place the "scor4" directory containing the SCORE v4 program installation (executable, library and help files). In the following view of finder, the directory is called "dos", and it contains a directory called "scor4" which contains the SCORE v4 program.

Score in finder.png

Drag the folder which contains the "scor4" folder ("dos" in this case) into the "Drop your game here." window. After some processing you will get the following window into which you can type the name for the label on the virtual floppy disk:

Boxer congratulations.png

Click on "Launch game" to start the virtual DOS program. You will see a window such as in the following image which contains the virtual MS-DOS computer. At the bottom of the window is a list of executables and batch files that boxer automatically found within the SCOR4 directory. You can either start SCORE from the DOS prompt (by typing "\scor4\scor4.exe") or by clicking on the "scor4.exe" text a the bottom of the window.

Boxer dos startup.png

After typing "\scor4\scor4.exe" or clicking on "scor4.exe" in the lauchbar at the bottom of the window, you should have SCORE version 4 running in the virtual MS-DOS program:

Boxer score open.png

You can type +F to make the MS-DOS window full-screen as in the following example screenshot. Pressing +F while in full-screen mode will revert back to window-mode on the Desktop screen. Click the following image three times to see the full resolution.

Boxer score fullscreen.png

To run SCORE 4 in the future with Boxer.app, you will find a directory called "Score4.boxer" (or whatever you labeled the virtual floppy disk/CD-ROM case") in the "DOS Games" folder in your home directory. To run SCORE 4 again, go to that directory, and you will see a list of DOS applications, including "Score4.boxer":

Boxer score finder.png

To start the virtual MS-DOS computer, double click on the "Score4.boxer" icon, or you can drag it to install it in the Dock for more immediate access.


Refinements to the SCORE 4 installation in Boxer.app

= Function keys

In the default settings for OS X, you can access function keys by pressing and holding down the Fn key and then one of the function keys at the top row of the keyboard (F1, F2, F3, etc.).


Useful keyboard characters and commands

Key sequence Synopsis Description
+F Full screen Toggle between full-screen and window display modes.
Fn+M Insert Equivalent to Insert key in MS-DOS / Windows.
Fn+ Home Equivalent to Home key in MS-DOS / Windows.
+V Paste Paste text copied from OS X environment with +C.
+ Shift+S Screenshot Screen capture. PNG file written to desktop.
Click Capture mouse Clicking in the MS-DOS window passes control of the mouse cursor to the MS-DOS window.
+Click Mouse out Release the mouse from the DOS environment back to the OS X system.