Here’s what they do.
@@ -93,6 +94,10 @@Normally, the emulated Jaguar’s display shows pixels that are razor sharp and is what you would likely see if the Jaguar was hooked up to a high quality monitor. Selecting this item will cause the emulated Jaguar’s display to be averaged, resulting in a screen that looks slightly blurry—more like what you would expect to see if the Jaguar was hooked up to a television. This is an aesthetic option that some people prefer; you may or may not like it.
+Selecting this toolbar button will switch the display into full screen mode; selecting it again will switch it back to windowed mode. This option can also be activated by pressing the F9 key on your keyboard. Note that on monitors with a wide aspect ratio that Virtual Jaguar will still display its virtual screen in a 4:3 aspect ratio—this is normal and expected.
+Pause does the same as the toolbar button; see the “Pause” toolbar button description for details.
+Frame Advance causes Virtual Jaguar to run for one frame (1/60th of a second for NTSC, 1/50th for PAL), and update the screen. This function can also be activated by pressing the F7 key on your keyboard. This option only works when Virtual Jaguar is paused.
+Insert Cartridge... does the same as the toolbar button; see the “Insert Cartridge” toolbar button description for details.
Use CD Unit does the same as the toolbar button; see the “Use CD Unit” toolbar button description for details.
@@ -138,8 +146,7 @@Here’s what they do.
@@ -181,16 +189,34 @@Normally the “Insert Cartridge...” dialog will ignore any files it encounters that it doesn’t know how to deal with. You can override this behavior by checking this option. However, this will not cause Virtual Jaguar to be able to load such files.
+Checking this option will force Virtual Jaguar to use the older, less compatible yet faster blitter. Some games will not work properly with this option checked!
+Under the Controller tab, there are the following options:
Hovering over a letter on the picture of the Jaguar controller will highlight it; clicking on the letter will let you redefine that key. If you prefer, you can define all the keys at once by clicking on the “Define All Keys” button. It will then step through each button on the controller, one at a time, and wait for you to press the key that you wish to set it to. You can exit the key redefinition process at any time by pressing the Esc key on your keyboard.
+Virtual Jaguar utilizes a profile system for controllers. What this means is that you can set up any device that Virtual Jaguar recognizes with any number of different configurations for it. Here’s how it works:
+ +The “Host Device” combobox lets you select whichever gamepad device you have connected to your computer. This, plus the unique “Map Name” will show the keymapping set up for that particular host device/key map combination.
+ +The “Map Name” combobox lets you set up multiple key maps for your detected device. To add a new key map to the current device, press the “+” button next to the combobox. It will then ask your for a human readable name for the new map. If you want to remove any maps that you don't want anymore, you can delete the currently selected map by pressing the “-” button; it will ask for confirmation. Keep in mind that this action cannot be undone!
+ +The “Maps to” combobox tells Virtual Jaguar which virtual controller slot you would like your device to be plugged into. Selecting None disables that key mapping for that device. Selecting Controller #1 will map the device to virtual controller slot #1. Selecting Controller #2 will map the device to virtual controller slot #2. Selecting Either one that’s free will attempt to connect the device to a free virtual controller slot if one is still available after all other connected devices have had a chance to plug into a definite slot. If other devices have filled up the virtual slots, this option will cause the device to not attempt to connect itself.
+ +Hovering over a letter on the picture of the Jaguar controller will highlight it; clicking on the letter will let you redefine that input by pressing a key on the keyboard or button on a connected gamepad. If you prefer, you can define all inputs at once by clicking on the “Define All Inputs” button. It will then step through each input on the controller, one at a time, and wait for you to press the key/button that you wish to set it to. You can exit the key redefinition process at any time by pressing the Esc key on your keyboard.
+ +NOTE: For gamepads to be detected, they must be connected to the computer before starting Virtual Jaguar.
ABS to load is the path to a Jaguar executable file that will be loaded in the Jaguar’s main RAM. This file must have valid headers, otherwise Virtual Jaguar won’t be able to load it. Assuming the file exists and has the correct headers in it, it will be loaded and run when Virtual Jaguar is first run.
+Also, when in Alpine mode, extra toolbar buttons are defined (also found under the extra “Debug” menu):
+ +This window lets you inspect Virtual Jaguar’s emulated memory space. The PgDn key will advance the top of the window’s memory location by 480 bytes, and PgUp will go back by the same amount. The Plus (+) key will advance the top of the window’s memory location by 16 bytes, and Minus (-) will go back by the same amount. Entering a memory location, in hexadecimal, in the edit field and pressing the Go button will display memory from that location. It can be dismissed by clicking on the “X” in the upper corner of the dialog, or by pressing the Esc key on your keyboard.
+ +This window shows the state of the various CPUs in the emulated Jaguar. It can be dismissed by clicking on the “X” in the upper corner of the dialog, or by pressing the Esc key on your keyboard.
+ +This window shows the current state of object list that the Object Processor is pointing to. Note that most of the time, this will likely show an object list that has had its objects processed. It can be dismissed by clicking on the “X” in the upper corner of the dialog, or by pressing the Esc key on your keyboard.
+ +This window provides a disassembly of 68000 opcodes. It can be dismissed by clicking on the “X” in the upper corner of the dialog, or by pressing the Esc key on your keyboard.
+ +This window provides a disassembly of RISC opcodes. It can be dismissed by clicking on the “X” in the upper corner of the dialog, or by pressing the Esc key on your keyboard.
+The aforementioned options will only work when Virtual Jaguar is run in Alpine mode, that is, when the --alpine flag is passed in. If you do not pass in the --alpine flag, Virtual Jaguar will run as it normally does, i.e., as a stock Jaguar, and nothing will be loaded by default.