BeebEm - BBC Micro and Master 128 Emulator

Menu Options

File Menu

Run Disc	Loads a disc image into drive 0 and boots (runs) it.
Load Disc 0 / 1	Load a disc image into drive 0 or 1. Discs are write protected when loaded to prevent any accidental data loss. Boot a disc by pressing Shift & F12.
Load Tape	Load a tape image. See the tapes section for info on running a tape.
New Disc 0 / 1	Creates a new disc image in drive 0 or 1. Use the file type field to select the type of disc image to create. New disc images are write enabled when created. The images have a standard 31 file catalogue by default.
Eject Disc 0 / 1	Ejects the disc image currently loaded. The name of the file currently loaded is shown next to the menu option.
Write Protect 0 / 1	Toggles write protection for drive 0 or 1. Keep discs write protected unless you intend to write to them. Also see the WARNING in the 'Disc Images' section.
Protect on Load	Indicates if a disc should be write protected when it is loaded.
Reset	"Power-On" reset for when a game crashes.
Load State / Save State	Load or save the state of BeebEm. This is useful for saving your position in a game for example. State files are put in the 'BeebState' directory by default.
Quick Load / Quick Save	Quickly load or save BeebEm state without having to specify the filename. The state is saved and loaded from the 'BeebState/quicksave.uef' file. Quicksave now keeps the last 10 quicksave files so you can go back to an earlier state using the load state menu option. There are keyboard shortcuts for Quicksave (keypad /) and Quickload (keypad *) so you can save and load without having to go through the menus.
Screen Capture Options	Select the resolution and file format for screen capture to file.
Capture Screen	Capture the BeebEm screen to a file. You will be prompted for a file name. Note that you can also use the ALT+keypad 5 shortcut to capture the screen to file.
Video Options	Select the resolution and how many frames get skipped for video capture. If video and audio get out of sync when playing back then try selecting a lower resolution and lower frame rate (more skipped frames).
Capture Video	Start video capture. Video is recorded at a maximum of 25 frames per second at a resolution of 640x512. Sound is captured at the sample rate selected in the sound menu. If sound is disabled when capture is started then sound is not recorded in the AVI file. You can edit the AVIs using Movie Maker and save them as more compact WMV files.
End Video	Stops video capture.
Exit	Exit BeebEm

Edit Menu

Copy	Copy BASIC program to the clipboard. Sets the printer destination to the clipboard, enables the printer output and lists the current program.
Paste	Pastes the clipboard content into BeebEm.
Translate CR-LF	Adds/removes linefeed characters as text is copied and pasted from the clipboard.
Import Files to Disc	Allows files to be added to a DFS disc image. BeebEm will look for a .INF file containing file attributes but files without .INF files can also be imported. If a file name matches one already in the disc image the imported file will overwrite the one in the image.
Export Files from Disc	Allows files to be exported from a DFS disc image. BeebEm will create a .INF file for each file exported to hold the file attributes.

Comms Menu

Tape Speed	Select the speed at which tape software loads and saves.
Rewind Tape	Reset the tape position to the start.
Unlock Tape	Removed the lock flag from files as they are loaded. This enables you to *LOAD a locked file.
Tape Control	Opens the tape control (see the "Tape Images" section).
Printer On/Off	Switches printer capture on or off. To start and stop printing within BeebEm use the VDU2 and VDU3 commands or Ctrl B and Ctrl C.
Printer Destination	Select where to send the printer output. WARNING: if you direct printer output to an LPT port that is not attached to anything BeebEm may hang.
RS423 On/Off	Switches the Beeb's serial communications port on or off.
RS423 Destination	Select where to send the serial port data. Select Microvitec Touch Screen to enable touch screen support. Select an IP option to route data to a TCP/IP port (see the 'Serial Port' section).

View Menu

Display Renderer	Selects how BeebEm draws to the screen. DirectX9 will probably be the fastest.
DirectX Smoothing	When using DirectDraw or DirectX9 enabling smoothing will switch on bilinear interpolation. This will blur the display slightly which will give it a smoother look.
Smooth Teletext Only	Enable DX smoothing for mode 7 only.
Speed and FPS On/Off	Show or hide the relative speed and the number of frames per second.
Full Screen	Switch to full screen mode.
Maintain Aspect Ratio in Full Screen	Enables 5:4 aspect ratio output in full-screen mode.
Window Sizes	Sets the window size.
DirectX Full Screen Mode	Screen resolution to use in full screen mode. The higher resolutions may look better.
Monitor Type	Selects the type of monitor to emulate.
Hide Menu	Hides the menu. Makes full screen mode look just like a real Beeb!
LEDs	The Beeb keyboard and disc (1770 only) LEDs can be shown at the bottom of the BeebEm window.
Motion Blur	Fades out contents of previous frames rather than blanking them out (like phosphor persistence). Can improve flicker in some games. The % intensities of the 8 frames can be edited in the preferences file.
Screen Reader Text View	Switch screen reader compatible text view on or off (see 'Accessibility Features')

Speed Menu

Real Time	Runs BeebEm at the same speed as a real BBC Micro.
Fixed Speed	Runs BeebEm at a fixed speed relative to a real BBC Micro. The frame rate may need to be reduced for the higher speeds. The keypad +/- keys will change between fixed speeds.
50/25/10/5/1 FPS	Runs BeebEm at a constant frame rate. The slower the frame rate the faster BeebEm runs relative to a BBC Micro.

Sound Menu

Sound Streamer	Select the sound streaming interface for BeebEm to use.
Sound On/Off	Switch sound on or off.
Sound Chip	Switches the sound chip on or off. Useful when you want to hear the cassette sounds.
Sound Effects	Options for switching on emulation of cassette motor, tape software loading and disc drive noise.
44.1/22.05/11.025 kHz	Sets the sound sample rate. The higher it is the better the sound quality but the slower BeebEm runs.
Full/High/Medium/Low Volume	Set the sound volume.
Use Primary Buffer	Grabs exclusive use of your sound card so any other applications playing music will stop. May make BeebEm run faster.
Part Samples	Smooths sound sampling. Using part samples usually sounds better.
Exponential Volume	Enables an exponential volume scale. Makes the sound output better.
Text To Speech	Switch text to speech generation on or off (see 'Accessibility Features')

AMX Menu

On/Off	Switch AMX mouse on or off. It may be useful to hide the Windows cursor as well (see the Options menu).
L+R for Middle	Simulates a middle button press when you press the left and right buttons together.
Map to 160x256 / 320x256 / 640x256	Coordinate range to map the Windows mouse position to. Pick the one that gives AMX mouse movements nearest to your Windows mouse movements.
Adjust +50%/+30%/+10%/etc.	Percentage to increase or decrease the AMX map sizes. Pick the one that gives AMX mouse movements that are slightly greater than the corresponding Windows mouse movements. You can then match up the AMX and Windows pointer positions by moving the Windows pointer to the edges of the BeebEm Window. This is easiest to do in full screen mode.

Hardware Menu

BBC Model	Allows you to switch between the BBC Model B types and Master 128 emulation.
Model B Floppy Controller	Allows you to select the Model B disc hardware emulation. To use an alternative floppy disc controller (FDC) board you will need to use an appropriate ROM (e.g. Acorn DFS2.26 for the Acorn 1770 board).
65C02 Second Processor	Enables/disables the 65C02 second processor emulation. Note that in Master 128 mode the second processor may be disabled in the CMOS settings. To enable it type "*CONFIGURE TUBE" and press break (F12).
Torch Z80 Second Processor	Enables/disables the Z80 second processor emulation. See the 'Z80 Co-Pro' section for more details.
Allow SW RAM Write	Enable/disable writes for each sideways RAM slot. See the 'ROM Software' section.
SW RAM Board On/Off	Enables Solidisk SW RAM board emulation. The RAM bank that is enabled for writing is selected via the User VIA port B. Set port B bits 0-3 to output (e.g. ?&FE62=15) and select the bank via port B (e.g. ?&FE60=4).
Edit ROM Configuration	Allow you to edit the ROM configuration. Note that you will usually have to press the Break key (F12) before a new ROM configuration is recognised.
Ignore Illegal Instructions	When disabled a dialog appears detailing the opcode and program counter.
Undocumented Instructions	Some games use undocumented instructions so try enabling the full set if something does not work. Selecting documented instructions only may speed BeebEm up.
Teletext Half Mode	Uses half the number of screen lines for teletext mode 7. May speed BeebEm up.
Basic Hardware Only	Switches off Analogue to Digital (Joystick) and Serial (printing, comms & tape) emulation. May speed BeebEm up.
Econet On/Off	Switch Econet emulation on or off. See the 'Econet' section for more details.
Teletext On/Off	Switch Teletext emulation on or off. See the 'Teletext' section for more details.
Floppy Drive On/Off	Switch floppy drive emulation on or off.
SCSI Hard Drive On/Off	Switch SCSI/SASI hard drive emulation on or off. See the 'Hard Disk' section for more details.
IDE Hard Drive On/Off	Switch IDE hard drive emulation on or off. See the 'Hard Disk' section for more details.
User Port Breakout Box	Opens the user port breakout box dialog. The breakout box allows keys to be assigned for switch box emulation.
User Port RTC Module	Enables the real time clock module. This is used by the Econet file server software.
RTC Y2K Adjust On/Off	When enabled the Master 128 real time clock is adjusted by 20 years to allow for the Y2K issues in the MOS.

Options Menu

Joystick	Switch on or off PC/Beeb analogue joystick support. Calibrate the joystick through the Windows control panel.
Analogue Mousestick	Switch on or off the mapping of Mouse position to analogue Beeb joystick position. Allows you to use the mouse as a joystick.
Digital Mousestick	Switch on or off the mapping of Mouse movements to digital Beeb joystick movements.
Freeze when inactive	When selected BeebEm will freeze when you switch to another Window.
Hide Cursor	Show or hide the mouse cursor while it is over the BeebEm window (useful when using the Mousestick or the AMX mouse).
Define User Key Mapping	Allows you to define your own keyboard mapping. See the 'Keyboard Mappings' section.
Load User Key Mapping	Loads a user defined key mapping from a file.
Save User Key Mapping	Saves a user defined key mapping to a file.
User Defined Mapping	Selects the currently loaded user defined keyboard mapping.
Default Keyboard Mapping	Selects the default keyboard map. See the 'Keyboard Mappings' section.
Logical Keyboard Mapping	Selects the logical keyboard map. See the 'Keyboard Mappings' section.
Map A,S to CAPS,CTRL	Maps the A and S keys to CAPS and CTRL keys on the Beeb keyboard. This is good for some games (e.g. Zalaga).
Map F1-F10 to f0-f9	Selects a slightly different mapping for the function keys.
Disable Keys	Allows you to disable selected keys within BeebEm. The Windows (start) keys can also be disabled but note that this affects all Windows applications, not just BeebEm.
Debugger	Opens the debugger window (see the 'Debugger' section).
Save Preferences	Saves the BeebEm settings to the current preferences file. Settings include the selected menu options, user defined keyboard, Window position and CMOS RAM contents.
Autosave CMOS RAM	Automatically saves the Master 128 CMOS RAM on exit from BeebEm.
Autosave All Prefs	Automatically saves all preferences on exit from BeebEm.
Save Disc/Tape/State Folders	When enabled BeebEm will remember where the folders where you last loaded or saved disc, tape or state files.
Select User Data Folder	Select the location for the BeebEm data files. When creating a new folder BeebEm will copy a default set of data files into the folder. BeebEm will default to using the last folder selected.

Help Menu

View Help	View this file.
About BeebEm	Show version number and date of BeebEm.