The menu bar located at the top of the PCBox window provides controls for the emulated machine as a whole, its display, and the PCBox user interface.
On macOS, the Exit (Quit), Preferences and About PCBox options are found in the PCBox application menu instead of the locations outlined here.
Keyboard requires capture: require the mouse to be captured for keypresses to be forwarded to the emulated machine. Enabling this option allows the use of keyboard combinations (such as Alt+Tab) on the host system while PCBox is focused.
Right CTRL is left ALT: let the right Ctrl key act as a left Alt key, to simulate some special keyboards where the Alt key is located on the right side of the space bar.
Tablet tool: select the pointing tool to use on the drawing tablet. This option will only be available when emulating a tablet.
Hard Reset: force a reset of the emulated machine. Requires confirmation, which can be disabled by checking the Don’t show this message again box.
Ctrl+Alt+Del: send a Ctrl+Alt+Del key combination to the emulated machine. You can alternatively press Ctrl+F12 to send that combination.
Ctrl+Alt+Esc: send a Ctrl+Alt+Esc key combination to the emulated machine.
Pause: pause emulation of the machine. Uncheck this option to resume emulation.
Exit: quit PCBox. Requires confirmation, which can be disabled by checking the Don’t show this message again box.
Hide toolbar: hides the toolbar below the menu bar.
Hide status bar: hides the status bar at the bottom of the window.
Show non-primary monitors: shows or hides the secondary display window if a secondary video card is configured.
Resizeable window: allow the PCBox window to be freely resized. Unchecking this option will also return the window to its normal size.
Remember size & position: automatically save the size and position of the PCBox window to the emulated machine’s configuration file.
Renderer: select a graphical renderer for the emulated display.
Qt (Software) is recommended in most cases.
Qt (OpenGL), Vulkan and Direct3D 9 are known to perform better on some host systems. Try these if your system is struggling to maintain 100% emulation speed. Vulkan may not be available if the host GPU is not Vulkan-capable, and Direct3D 9 is only available on Windows hosts.
OpenGL (3.0 Core) allows for shader effects to be applied to the emulated display, however, it is not compatible with older integrated GPUs.
Renderer options: open a window to configure the OpenGL (3.0 Core) renderer. This option will be available if that renderer is selected.
Target framerate: select the framerate at which the emulated display is updated. Synchronize with video automatically uses the emulated display’s current refresh rate.
VSync: enable vertical sync. Recommended if tearing artifacts are observed.
Browse: load a
.glslshader file to apply to the emulated display.
Remove: disable the currently-loaded shader.
Many shaders are available for simulating CRT displays, VHS tapes and other aesthetics; the RetroArch glsl-shaders repository is a good place to start.
Shaders that take advantage of multipass and previous frames are not supported.
.cgpshaders are not supported either, as these formats are long deprecated.
Specify dimensions: open a window where an exact size (in pixels) for the emulated display can be set. If checked, the Lock to this size box prevents changes in the emulated display’s resolution from overriding the specified size.
Force 4:3 display ratio: stretch the emulated display to a 4:3 aspect ratio, independently of the emulated machine’s screen resolution.
Window scale factor: scale the emulated display to half (0.5x), normal (1x), 50% larger (1.5x) or double (2x) sizes.
Filter method: select the filtering method (Nearest or Linear) to be used when scaling the emulated display.
HiDPI scaling: automatically scale the emulated display to real size if your host system has a HiDPI display. This option can be used alongside Window scale factor above.
If HiDPI scaling is disabled on a host with a HiDPI display, the emulated display’s size may be off by one pixel due to an integer scaling limitation.
Fullscreen: enter full screen mode. Press Ctrl+Alt+Page Down to go back to windowed mode. You can also enter full screen mode by pressing Ctrl+Alt+Page Up.
Fullscreen stretch mode: select the picture mode to use when in full screen mode.
Full screen stretch: stretch the emulated display to completely fill the host display.
4:3: stretch the emulated display to a 4:3 aspect ratio, then scale it to fit the host display.
Square pixels (keep ratio): scale the emulated display to fit the host display, without changing the aspect ratio.
Integer scale: scale the emulated display to the largest integer scale factor to fit the host display. This provides the highest possible picture quality, at the cost of black bars if the host display’s resolution is not divisible by the emulated display’s resolution.
EGA/(S)VGA settings: contains display settings specific to EGA, VGA and Super VGA video hardware.
Inverted VGA monitor: emulate a VGA monitor with inverted colors.
VGA screen type: select the VGA monitor type to emulate. Color, Grayscale, Amber, Green and White phosphor monitors can be selected.
Grayscale conversion type: select the color-to-grayscale conversion profile (BT.601, BT.709 or Average) to use when a grayscale monitor is selected.
CGA/PCjr/Tandy/EGA/(S)VGA overscan: add an overscan border around the display. This border is only added when emulating the specified video hardware types.
Change contrast for monochrome display: optimize the contrast of monochrome CGA monitors for 4-color operation.
This menu lists all storage drives and network cards attached to the emulated machine, and provides the same controls that are accessible by clicking the respective device’s icon on the status bar.
The Clear image history option empties the list of recently-loaded image files or folders on all storage drives.
Settings: open the Settings window to configure the emulated machine.
Update status bar icons: enable the activity lights on status bar icons. Unchecking this option may improve emulation performance on low-end host systems.
Enable Discord integration: enable Discord Rich Presence. PCBox shares the emulated machine’s name, model and CPU with other Discord users.
Integration requires the Discord desktop app, running on x86 or x64 Windows,
x86_64 Linux or Intel macOS. Discord does not provide integration support for other operating systems / architectures or the browser app. Additionally, integration will not be available on Windows if the included
discord_game_sdk.dll file is missing from the PCBox directory.
Take screenshot: take a screenshot of the emulated display. Screenshots are saved as .png images in the
screenshotssubdirectory found in the emulated machine’s directory, which can be opened with the Open screenshots folder option below.
Sound gain: open the sound gain control, which is also accessible through the status bar.
Preferences: open the Preferences window, which provides the following options:
Language: select a language for the PCBox user interface.
Mouse sensitivity: adjust the emulated mouse’s tracking sensitivity.
Select media images from program working directory: if checked, starts any file open/save prompts on the emulated machine’s directory. This option is particularly useful for macOS users.
MCA devices: open the MCA devices window, which lists the IDs and required Adapter Definition Files of all Micro Channel devices installed on the emulated machine. This option will only be available when emulating a Micro Channel Architecture-based machine.
Open screenshots folder: open the host system’s file browser on the directory where screenshots of this emulated machine are saved.
Documentation: open the very documentation you’re reading.
About PCBox: show credits and license information about PCBox.