Bernie ][ The Rescue 3.0
Audio/Video
1.1 Power Mode1.2 The Preferences
1.2.1 Screen Refresh1.2.2 Switch Screen Depth at Startup
1.2.3 Bypassing QuickDraw
1.2.4 Smooth Mouse Tracking
1.2.5 Extended Border Area
1.2.6 AppleColor Mode (Smoothed)
1.2.7 Power Mode: Switch at Startup
1.2.8 Power Mode: Preserve Border Color
1.3 Copying Content of Video Window
2.1 Sound At A Glance2.1.1 Turning Sound On/Off2.1.2 SonicSense: Saving CPU resources
2.1.3 The Sound Window
2.2.1 Playback Mode2.2.2 Volume Amplifier
2.2.3 Extra Features
2.2.4 Optimizations
2.3 Sound Capture
2.3.1 Using Sound Capture2.3.2 Performance Considerations
2.3.3 Sound Capture Errors
2.4 Recommendations
Bernie supports the entire range of video modes the Apple IIgs offers, and that's a lot. Video modes range from low resolution graphics and text modes to Apple IIgs' super-hires mode.
Different Video Modes
Bernie is offering three video modes: window mode, zoomed and Power Mode. In window mode, the Apple IIgs video display is contained in a single window and you can work with other windows and applications at the same time. In zoomed mode, the video window is shrinked. Lastly, in Power Mode the Apple IIgs video will occupy the entire screen and your Mac looks like a Apple IIgs.
Different Colors
Your Mac can run at different color "depths": 256 colors, thousands of colors, millions of colors, etc. Bernie has been optimized to run in 256 colors and 16-bit color depth (thousands of colors), and you might want to take advantage of this capability. (It's even a good idea to tell Bernie to switch to 256 or thousands of colors automatically at launch time.) You can still run Bernie at any other color depth, but it will run slower.
Different Refreshes
Bernie is refreshing the video window at 15Hz, 30Hz or 60Hz. There's also an "auto" setting where Bernie will find the best refresh rate for you. An Apple IIgs has a refresh frequency of 50 or 60 Hz, but this is often too often for most work. By reducing refresh frequency, you can free a lot of resources for improved performance.
Bernie features a special video mode called Power Mode. Power Mode makes your Apple IIgs emulator look like an actual Apple IIgs. The Power Mode has the following characteristics:
To activate Power Mode, push Command-Shift-F or the function key F8.
With the introduction of Bernie 3, you may make the regular mouse and menu bar temporarily available by holding down the Shift and Command keys.
In Power Mode, all available colors are reserved for IIgs video. Unfortunately, this prevents Bernie from displaying the border in the proper color. Bernie allows you to put aside one color for the border (see video panel in Preferences). Of course, this one color will not be available in the video window and may result (in extremely rare situations) to cosmetic quirks.
To quit Power Mode push Command-Shift-F or F8 again. You have to remember this keystroke because the menu is not visible. Alternately, you can use the function key F8 to enter or leave Power Mode.
Starting with version 3, it is now possible to have the Disks, Joystick and Sound windows displayed in full-screen mode. The windows will be shown at the bottom of the screen. You can swap the aux windows in and out by selecting the corresponding menu items from the Windows menu.
Tip: holding down shift and command reenables the Mac mouse. You can then click into the aux windows to configure various sound and joystick settings and eject mounted disks.
If you just want to quickly dive into the Mac Finder and return to Power Mode later, use the shortcut Shift-F8. This command puts Bernie into the background and makes the Finder the active application. When you return to Bernie (for example, by choosing it in the applications menu), you'll find yourself back in Power Mode.
Important: remember that Bernie can be taught to emulate in background. If you're hiding Bernie with Shift-F8, it might still be running and other application may perform sluggish. To turn it off, check the flag "pause emulation when in background" in the Preferences.
Many settings can be controlled through the Preferences window. To open it, choose "Preferences" from the Setup menu:
Each option will be discussed hereafter.
The screen refresh rate controls how often Bernie is redrawing the video window. A Apple IIgs is updating the video sixty or fifty times a second (60Hz/50Hz), but usually it is not necessary to redraw the video window that often. By choosing a slower refresh frequency, you can free considerable resources and make Bernie run faster.
The exact overhead of screen refreshes is not fixed but depends on the software you are using. That's why Bernie is offering a "Auto" setting: it then chooses a refresh frequency that your Mac can handle without being slowed too much which is usually 30 Hz.
The recommended setting is "Auto" or "30Hz".
Switches your main monitor to a color depth for which Bernie has a direct video blitter. Drivers exist for 256 colors and thousands of colors.
When launching Bernie and your video is currently set to anything below 256 colors, Bernie will switch to 256 colors. If video is set to millions of colors, Bernie will switch to thousands of colors.
Please note that the 16-bit blitter is not as fast as its 256 colors counterpart. Running Bernie in thousands of colors is very, very approximately 5 to 15% slower.
The recommended setting is to have Bernie switch to an accelerated video mode.
Bypassing QuickDraw means that Bernie is directly writing into the video window on screen.
The conventional approach is to write changes to a separate memory area and then copy the new content to the video window, but this is slow. That's why Bernie is offering you to directly update the video window.
Note: Bernie can only bypass QuickDraw when the video is entirely visible and not overlapped by other windows, partially off-screen or crossing two or more monitors.
The recommended setting is to bypass QuickDraw.
By default, Bernie is updating internal mouse parameters 30 times per second. This is sufficient for most software and reduces mouse emulation overhead. If your software requires a finer resolution, you can tell Bernie to check the mouse position more often (60 times a second) by checking this box.
The recommended setting is to disable smooth mouse tracking.
The Apple IIgs monitor had a pretty large border surrounding the actual content. If you'd like to really feel at home, enable Extended Border to increase border size to about the size of an original Apple IIgs system.
Note: Extended Border should not be enabled on monitors with a resolution of less than 800x600 pixels because it exceeds the size of the monitor and is slowing down emulation. Power Mode will automatically disable Extended Border if your monitor does not support the minimum resolution of 800x600 pixels.
The recommended setting is to turn off extended border.
In AppleColor mode, Bernie smoothes 640x200 superhires video display. This eliminates stripes but some elements (notably text) might look fuzzy. Enabling AppleColor mode does not affect any other video mode besides 640x200 superhires.
The recommended setting is to turn off AppleColor mode.
Automatically switches to (full-screen) Power Mode when Bernie is launched.
Puts aside one color for the border color. This one color will not be available for superhires and theoretically can lead to cosmetic quirks. In practice, though, this should never happen.
Yet another check box in the same video panel, "Fade Screen at Switch", introduces a supercool fade out/in while switching between normal (windowed) view and Power Mode.
When switching to Power Mode, you can tell Bernie to set your monitor to 14" resolution. If your monitor does not support 14" resolution, this option does nothing.
Bernie requires QuickTime to be installed, otherwise switching resolution is not supported. If QuickTime is not installed or deactivated, Power Mode will simply stay at whatever resolution it is.
Another limitations are tabbed windows in MacOS® 8. For a yet to be found reason, MacOS 8 messes up the positions of popup windows when switching to 14" resolution. This problem does also occur when letting Bernie do the switch. There's nothing we can do about tabbed windows - we feel that's Apple's job to fix.
Bernie lets you copy the content of the Video window in two ways, either as a bitmap or as a stream of ASCII characters.
The Copy command in the Edit menu automatically chooses the proper action: if the IIgs is in graphics mode, it copies the window as a bitmap, otherwise as text. If you are not happy with how the Copy command works, you can force Bernie to copy the text screen as a bitmap by choosing "Copy Graphics" from the Edit menu.
With so many options it's easy to make Bernie dog-slow. Here's a short summary of what you should consider if you're looking for top performance:
Bernie features the most advanced sound synthesizer of all Apple II emulators. It's 16-bit , 22/44kHz sound engine produces mono, stereo, stereo enhanced and Dolby Surround Pro Logic® output with a minimum of CPU resources. Internally, a non-linear, autobalancing synthesizer takes care of down-mixing up to 32 voices at highest fidelity across all Ensoniq loads. Several optimizations including SonicSense and real-time smart voice cancelation ensure available CPU time is spent where it's needed, and additional goodies such as recording to file and a high-tech sound window complete Bernie's sound support.
If you have questions regarding Video support, feel free to go to the Feedback page and submit us your question or comment.
Bernie ][ The Rescue supports the full range of "sound reproduction". It supports so-called classic "1-bit" sound found in older Apple II programs as well as the Apple IIgs' Ensoniq® sound chip.
Sound emulation is enabled by checking the menu item "Sound Support" from the Setup menu. When sound emulation is started, you hear a chime.
Sound emulation requires a tremendous amount of CPU resources because the Macintosh does not have a dedicated sound chip but does all sound synthesis in software. 680x0 Macintosh systems had a sound ASIC or a DSP coprocessor, but all PowerPC-based Macs lack such a coprocessor.
Thus, Bernie gives you a helping hand. It features SonicSense, a technique for enabling sound automatically when software starts playing sounds and turning it off when the virtual sound chip is idle. To enable SonicSense...
SonicSense is only active when both sound emulation is turned on and SonicSense is enabled. If you have disabled sound emulation, Bernie will not play anything.
Just for your very own enjoyment, we have given Bernie a multifunctional sound window where you can watch sound emulation at work. The window includes an oscilloscope and a bar of LEDs that represent oscillator activity, among others. It also allows for basic configuration of the sound engine.
Let's go through the window from the left to the right.
The first element is the master level meter - one for the left (L) and one for the right (R) channel.
The LED matrix in the middle of the window displays the activity of each of the 15 voices. (There are 32 voices, you may ask. That is correct, but they are almost always bundled in pairs as independent 16 voices. One voice is typically put aside for timing, hence the 15 voices display in Bernie.) Each column shows the activity of a single voice. The position of the indicator represents the volume of that particular voice.
Next to the LED matrix is a numeric indicator which is typically set to 16. The Ensoniq sound chip can be configured to serve less than its maximum of 16 voices (=32 oscillators). For example, you can choose the number of active voices in Diversi Tune.
To the right you see five loudspeakers centered around a point. Please take no offense, but the blotch is you. Depending on the currently active sound mode (mono, stereo, stereo enhanced, surround), the speaker symbols are on or off.
There are three remaining indicators at the top of the window. Their meaning is:
While this window is sometimes cool to look at, close it if you're done with it. The Sound window consumes an horrible amount of CPU resources. If you have a faster Mac (250Mhz or more, ballpark), this shouldn't be of much concern. On slower Macs, however, it will make a difference.
Clicking Your Way Through The Sound Window
The sound window allows you to configure essential sound settings. These include:
To set the volume, click into the master level display. Your click must go into one of the four lower bars. (This is a feature and not a bug: the idea is to avoid accidential clicks into the higher volumes that may nuke your expensive loudspeakers.) Once you picked up the LED indicator, hold down the mouse button and set the volume to your needs. Emulation will continue in the background so you can adjust the volume with "live" feedback.
Please note that any volume level beyond the lowest possible setting may lead to distorted sound due to clipping. When you hear scratches, you should consider reducing the volume and increase your Mac's global sound volume instead.
Also note that the Sound Window volume "slider" does not offer the same resolution as its counterpart from the Preferences window. You can fine-tune the volume much better from within the Preferences window.
To change sound mode, click into the group of speaker icons to the right. Depending on the icon onto which you click, a different sound mode will be chosen.
Lastly, clicking either the "ON" or "MUTE" indicator toggles sound support.
The LED matrix is a multi-purpose display. You can rotate through 3 different pages by clicking the two digits ("16" in the illustrations above):
Configuring the sound engine by clicking into the sound window is also supported in full-screen mode. Holddown command-shift (to make the mouse pointer appear) and change the settings to your needs.
The playback mode lets you choose among various settings.
The recommended setting is mono for best performance or stereo for games and music applications. Use VectorSound for high-fidelity music applications.
VectorSound Sound Modes
Besides the usual suspects mono, stereo, stereo enhancement and surround playback mode, the new VECTORSOUND engine comes in various flavours.
The Volume slider lets you amplify sound.
If you increase volume beyond the
"Normal" setting, you may experience audible scratches in
some situations. Amplifying the volume basically says that
you are increasing volume beyond what's mathematically
correct, so scratches are necessarily part of the
process.
The recommended setting is to set volume to normal. Some software is playing at a very low level (for example SynthLab) and may need to increase volume.
The Extra Features are a collection of unique functions that improve sound quality:
The Extra Features are a collection of unique functions that improve sound
Sound Capture is a feature that lets you save audio to a Macintosh sound file. The resulting file is a QuickTime AIFF document that you can open in QuickTime Player or virtually any sound editor for further processing.
To start sound capture, open the Edit menu and select "Capture Sound...". Bernie asks you for a file name and where to save the file.
To stop sound capture, select the same menu item again.
Recording sound to a file involves quite some action, and slower Macintosh systems may not keep up with the data stream. To give you better control over sound recording, here are some technical details that will allow you to better configure Bernie's sound capture feature.
Sound recording is always done in the current sound mode. The sound mode is a combination of mono/stereo and 22/44kHz HiFi sound. (Stereo includes stereo enhanced and surround sound. Bernie does never record in VectorSound mode but switches back to regular stereo for performance reasons.) Depending on the combination of the two factors, the data volume can quadruple in worst case. To give you a better understanding of the amount of data, here're some figures for a 1-minute recording:
22kHz, mono: 2.5 Mb (43 kB/second)
22kHz, stereo: 5 Mb (86 kB/second)
44 kHz, mono: 5 Mb (86 kB/second)
44 kHz, stereo: 10 Mb (172 kB/second)
The higher throughput is the more likely is the chance of dropped frames. A dropped frame is a chunk of audio data that was generated but couldn't be written to disk because the previous frame was still waiting in the queue. If you are experiencing a lot of dropped frames, you should consider switching from 44kHz to 22kHz or from a stereo mode to mono.
Another, very important influence on your system's ability to keep up with the data stream is the High-Precision Timing option. As mentioned earlier, this feature sacrifices valuable CPU resources for increased accuracy. Even on faster Macs the data flow generated by high-bandwidth sound modes (44kHz stereo) and the immense overhead of High-Precision Timing can lead to dropped frames. Therefore, we recommend to turn off High-Precision Timing while a sound capture is in progress. Your Mac is given more time to process the sound data without giving up sound quality.
Because Sound Capture really dislikes shortages in CPU cycles, you are given a detailed summary upon stopping a recording. When all went smoothly, Bernie displays the following message in the status bar:
All data has been recorded successfully.
That's the message we're all looking for. In some situations, however, dropped frames occured and Bernie posts a message to the Error window:
Some data was lost (99% written).
This message means that a very small fraction of the sound data could not be recorded to disk. Actually, you shouldn't worry about a result of 99% as a dropped frame or two can easily occur during the very beginning of the sound recording process. (The MacOS gets a hiccup when creating the file and updating the Finder window or desktop. Chances are almost 50-50 it drops a frame at that time.)
A more worrying error message would be:
Some data was lost (50% written).
This typically happens when your Mac is technically not able to record at the pace you chose. In this situation you need to...
We recommend that you proceed in this order.
Things are different when dropped frames were caused by a disk-related error. There are a number of potential problems that can happen when a software is writing to disk, and Sound Capture is no exception. Typical errors are disks with not enough free space or when Bernie was not given write access. If a disk error occured, Bernie will post an additional error message to the Error window indicating why the file could not be written properly
Due to the way how Sound Capture is wired internally, Bernie can't stop Sound Capture by itself. So when a disk error or dropped frame occurs, Sound Capture will continue even when no sound data can be written because of a filled hard disk or the like. It's therefore a good idea to double-check storage space and make sure everything's settled for Sound Capture.
Sound emulation may slow down Bernie on low-end Power Macs significantly. For best performance, be sure to: