mirror/86Box-docs
1
0
Fork 0
mirror of https://github.com/86Box/docs.git synced 2026-02-22 09:35:33 -07:00
Code Issues Packages Projects Releases Wiki Activity

Add usage/menu page for the menu bar

Browse Source
This commit is contained in:
RichardG867
2020-07-19 19:37:26 -03:00
parent f99f0168d6
commit a307fdcd8f
4 changed files with 66 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
index.rst
View File

@@ -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

12
usage/gettingstarted.rst
View File

@@ -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

4
usage/machinespecific.rst
View File

@@ -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.

60
usage/menu.rst Normal file
View File

@@ -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 <statusbar>`.
Tools
-----
* **Settings:** open the :doc:`Settings <../settings/index>` window.
* **Update status bar icons:** enable the blinking lights on :doc:`status bar <statusbar>` 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.