From 937c34103931618b8fd63cd132832877ec656ae3 Mon Sep 17 00:00:00 2001 From: RichardG867 Date: Sat, 20 Dec 2025 00:37:20 -0300 Subject: [PATCH] Dynarec disable option --- settings/machine.rst | 2 ++ usage/menubar.rst | 1 + usage/toolbar.rst | 6 ++++++ 3 files changed, 9 insertions(+) diff --git a/settings/machine.rst b/settings/machine.rst index 7bcd01b..2d32294 100644 --- a/settings/machine.rst +++ b/settings/machine.rst @@ -44,6 +44,8 @@ Dynamic Recompiler Enable the dynamic recompiler, which provides faster but less accurate CPU emulation. The recompiler is available as an option for 486-class processors, and is mandatory starting with the Pentium. +.. note:: The recompiler can be disabled temporarily (even on processors where it is mandatory) through an option on the :ref:`toolbar ` and :ref:`Action menu `, in the unlikely event that an application performs worse with the recompiler enabled. Selecting this temporary option again or restarting 86Box will reenable the recompiler. + Softfloat FPU ------------- diff --git a/usage/menubar.rst b/usage/menubar.rst index c2e86b8..8d288c3 100644 --- a/usage/menubar.rst +++ b/usage/menubar.rst @@ -8,6 +8,7 @@ The menu bar located at the top of the 86Box window provides controls for the em Action ------ +* **Force interpretation:** temporarily disable the :ref:`dynamic recompiler `. Uncheck this option to reenable the recompiler. You can alternatively press :kbd:`Ctrl`\ +\ :kbd:`Alt`\ +\ :kbd:`I` (:ref:`customizable `) to control this option. * **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 the 86Box window 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. * **Update mouse every CPU frame:** force the emulated mouse to send movements as fast as possible, ignoring any polling rate set by the emulated operating system. diff --git a/usage/toolbar.rst b/usage/toolbar.rst index d7c0c1c..6cd3d4f 100644 --- a/usage/toolbar.rst +++ b/usage/toolbar.rst @@ -5,6 +5,12 @@ Toolbar The toolbar located at the top of the 86Box window (right below the :doc:`menu bar `) has two purposes: it provides quick actions for the emulated machine on its left hand side, and displays status information on its right hand side. +|interpreter| |recompiler| Toggle recompilation +----------------------------------------------- + +Temporarily disable the :ref:`dynamic recompiler `. Press again to reenable the recompiler. You can alternatively press :kbd:`Ctrl`\ +\ :kbd:`Alt`\ +\ :kbd:`I` (:ref:`customizable `) to control this option. + + |pause| |run| Pause/resume execution ------------------------------------