diff --git a/index.rst b/index.rst index 777418a..ac95fcb 100644 --- a/index.rst +++ b/index.rst @@ -29,6 +29,7 @@ to retro computing and, of course, 86Box. We look forward to hearing from you! :caption: Using 86Box usage/gettingstarted + usage/menu settings/index usage/machinespecific usage/diskimages diff --git a/usage/gettingstarted.rst b/usage/gettingstarted.rst index e3f1a2c..de22c93 100644 --- a/usage/gettingstarted.rst +++ b/usage/gettingstarted.rst @@ -11,15 +11,9 @@ Here are the basic steps to help you get started with 86Box. The user interface Once you got the romset in the right place, you can start ``86Box.exe``. The main window has three important areas: -* **The menu bar at the top**, where most commands and options are located -* **The display area in the middle**, which is where the output from the emulated machine will be rendered -* **The status bar at the bottom**, containing icons for quickly accessing the configured peripheral devices - -The *Action* menu has basic commands for controlling the emulated machine. You can cycle the power (also known as a *hard reset*), send the *Ctrl+Alt+Del* and *Ctrl+Alt+Esc* keystrokes, pause the virtual machine or close it. - -The *View* menu is mostly filled with various options for advanced users, so we'll skip it for now. The *Tools* menu, on the other hand, is pretty important, as it allows you to access the settings for the virtual machine and take screenshots. - -In the *About* menu, you can access the *About 86Box* window and see who helped make this emulator. +* **The menu bar at the top**, where most controls and options are located. See :doc:`menu` for more information. +* **The display area in the middle**, which is where the display output from the emulated machine will be rendered. +* **The status bar at the bottom**, containing icons for quickly accessing the configured peripheral devices. .. rubric:: Step 3: Configure the hardware diff --git a/usage/machinespecific.rst b/usage/machinespecific.rst index 356c3c5..60329d5 100644 --- a/usage/machinespecific.rst +++ b/usage/machinespecific.rst @@ -53,7 +53,7 @@ Slot 2 .. rubric:: Gigabyte GA-6GXU -* The BIOS display will corrupt itself after the memory test if the maximum 2048 MB RAM is selected. This is a visual glitch which does not otherwise negatively impact the machine. +* The BIOS display will corrupt itself during the memory test if the maximum of 2048 MB RAM is selected. This is a visual glitch which does not otherwise negatively impact the machine. Socket 370 ---------- @@ -68,4 +68,4 @@ See: :ref:`atc6310bxii` * The I/O ports and IRQs used by all these ports can be configured in the BIOS setup. -* ACPI is disabled by default, unlike other machines with Award v6.00PG BIOS. Enable it through the *ACPI function* option of the *Power Management Setup* menu on the BIOS setup. +* ACPI is disabled by default, unlike other machines with Award v6.00PG BIOS. It can be enabled through the *ACPI function* option of the *Power Management Setup* menu on the BIOS setup. diff --git a/usage/menu.rst b/usage/menu.rst new file mode 100644 index 0000000..0f379fe --- /dev/null +++ b/usage/menu.rst @@ -0,0 +1,60 @@ +Menu bar +======== + +The menu bar located at the top of the 86Box window provides controls for the emulated machine as a whole, its display, and the 86Box user interface. + +Action +------ + +* **Right CTRL is left ALT:** let the right Ctrl key act as a left Alt key, to match some special keyboards where the Alt key is located on the right side of the space bar. +* **Hard reset:** force a reset of the emulated machine. Requires confirmation. +* **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. Uncheck this option to resume emulation. +* **Exit:** quit 86Box. Requires confirmation. + +View +---- + +* **Resizeable window:** allow the 86Box window to be freely resized. Unchecking this option will return the window to its normal size. +* **Remember size & position:** automatically save the size and position of the 86Box window to the configuration file. +* **Renderer:** select a graphical renderer for the emulated display. *SDL (Hardware)* is recommended, but it may not work on some host systems, where *SDL (Software)* is the best option. +* **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. +* **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 fit 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. + * **Integer scale:** scale the emulated display to the largest integer scale amount to fit the host display. This provides the highest possible picture quality, at the cost of black bars. + +* **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 phosphor, green phosphor and white phosphor monitors can be selected. + * **Grayscale conversion type:** select the color-to-grayscale conversion profile to use when a grayscale monitor is selected. + +* **CGA/PCjr/Tandy/EGA/(S)VGA overscan:** enable an overscan border around the display for the specified video hardware types. +* **Change contrast for monochrome display:** optimize the contrast of monochrome CGA monitors for 4-color operation. + +Media +----- + +This menu lists all removable media drives attached to the emulated machine, and provides the same controls that are accessible by clicking the respective drive icon on the :doc:`status bar `. + +Tools +----- + +* **Settings:** open the :doc:`Settings <../settings/index>` window. +* **Update status bar icons:** enable the blinking lights on :doc:`status bar ` icons. Unchecking this may improve emulation performance on low-end host systems. +* **Enable Discord integration:** enable Discord Rich Presence. Other Discord users will know that you're running 86Box, as well as the names of the virtual machine directory, emulated machine and emulated CPU you're using. +* **Take screenshot:** take a screenshot of the emulated display. Screenshots are saved as PNG images in the ``screenshots`` directory. + +.. note:: Discord integration will not be available if the Discord desktop app is not running, or if the ``discord_game_sdk.dll`` library is not present in the 86Box directory. + +Help +---- + +* **Documentation:** open the very documentation you're reading. +* **About 86Box:** show credits and license information about 86Box.