diff --git a/docs/graphics/options_gameinfo.png b/docs/graphics/options_gameinfo.png deleted file mode 100644 index fdc4f9dc9..000000000 Binary files a/docs/graphics/options_gameinfo.png and /dev/null differ diff --git a/docs/graphics/options_gameinfo_cartridge.png b/docs/graphics/options_gameinfo_cartridge.png new file mode 100644 index 000000000..ea09b9842 Binary files /dev/null and b/docs/graphics/options_gameinfo_cartridge.png differ diff --git a/docs/graphics/options_gameinfo_console.png b/docs/graphics/options_gameinfo_console.png index 592865acb..49577140c 100644 Binary files a/docs/graphics/options_gameinfo_console.png and b/docs/graphics/options_gameinfo_console.png differ diff --git a/docs/graphics/options_gameinfo_display.png b/docs/graphics/options_gameinfo_display.png deleted file mode 100644 index d3ece3519..000000000 Binary files a/docs/graphics/options_gameinfo_display.png and /dev/null differ diff --git a/docs/graphics/options_gameinfo_emulation.png b/docs/graphics/options_gameinfo_emulation.png new file mode 100644 index 000000000..21d44c22c Binary files /dev/null and b/docs/graphics/options_gameinfo_emulation.png differ diff --git a/docs/index.html b/docs/index.html index 247942eae..bd86b9fc7 100644 --- a/docs/index.html +++ b/docs/index.html @@ -276,7 +276,7 @@ including mapping of CompuMate 'Backspace', 'Space' and 'Enter' functionality to to the actual keys on your keyboard
  • Emulates the Mindlink Controller using your computer's mouse
    • -
  • Supports autodetection for most common controller types
    • +
  • Supports autodetection for most common controller types
  • Support for real Atari 2600 controllers using the Stelladaptor and 2600-daptor/2600-daptor II
    • @@ -718,7 +718,7 @@ F9 - + Save all states Alt + F9 Cmd + F9 @@ -1812,34 +1812,34 @@

    The dialog items are explained in the following two tables.

    Top row (left to right)

    - - - -
    ItemDescription
    Current stateShows the currently loaded state's number
    'Timeline' sliderShows the position of the current state in the + + + + - -
    ItemDescription
    Current stateShows the currently loaded state's number
    'Timeline' sliderShows the position of the current state in the recorded timeline. A state can be selected by dragging the slider with the mouse. To visualize state compression, small marks split the timeline into five, equally sized state number intervals.
    Total statesShows the total number of save states in the +
    Total statesShows the total number of save states in the Time Machine
    +

    Bottom row (left to right)

    - - -
    ItemDescription
    Current timeShows the time of the currently selected status, + + + - - - - - - - - - + + + + + + + + - -
    ItemDescription
    Current timeShows the time of the currently selected status, relative to the first one
    'Start/Stop' buttonStarts or stops the Time Machine
    'Continue' buttonExits the dialog and continues emulation
    'Rewind All' buttonNavigates back to the begin of the timeline
    'Rewind One' buttonNavigates back by one state
    'Unwind One' buttonNavigates forward by one state
    'Unwind All' buttonNavigates forward to the end of the timeline
    'Save All' buttonSaves all states to disk
    'Load All' buttonLoades all states from disk
    Navigation infoInforms about the interval of the user's last +
    'Start/Stop' buttonStarts or stops the Time Machine
    'Continue' buttonExits the dialog and continues emulation
    'Rewind All' buttonNavigates back to the begin of the timeline
    'Rewind One' buttonNavigates back by one state
    'Unwind One' buttonNavigates forward by one state
    'Unwind All' buttonNavigates forward to the end of the timeline
    'Save All' buttonSaves all states to disk
    'Load All' buttonLoades all states from disk
    Navigation infoInforms about the interval of the user's last Time Machine navigation. The interval can vary if the timeline is compressed.
    Total timeShows the total time covered by the save states +
    Total timeShows the total time covered by the save states (aka 'Horizon')
    +

    The 'Time Machine' mode can be configured by the user. For details see @@ -1917,57 +1917,57 @@ shown. - - 

    -audio.enabled <1|0>
    - Enable or disable sound generation. - + + 
    -audio.enabled <1|0>
    + Enable or disable sound generation. + - - 
    -audio.volume <0 - 100>
    - Set the volume. - + + 
    -audio.volume <0 - 100>
    + Set the volume. + - - 
    -audio.preset <1 - 5>
    - Set an audio preset. Numbers in sequence represent presets for - 'custom', 'low quality, 'medium lag', 'high quality, medium lag', - 'high quality, low lag' and 'ultra quality, minimal lag'. - + + 
    -audio.preset <1 - 5>
    + Set an audio preset. Numbers in sequence represent presets for + 'custom', 'low quality, 'medium lag', 'high quality, medium lag', + 'high quality, low lag' and 'ultra quality, minimal lag'. + - - 
    -audio.fragment_size <128|256|512|1024|2048|4096>
    - Set the number of samples in a single fragment processed by the audio driver. - + + 
    -audio.fragment_size <128|256|512|1024|2048|4096>
    + Set the number of samples in a single fragment processed by the audio driver. + - - 
    -audio.sample_rate <44100|48000|96000>
    - Set sound sample output frequency. - + + 
    -audio.sample_rate <44100|48000|96000>
    + Set sound sample output frequency. + - - 
    -audio.resampling_quality <1|2|3>
    - Set resampling quality to low (1), high (2) or ultra (3). - + + 
    -audio.resampling_quality <1|2|3>
    + Set resampling quality to low (1), high (2) or ultra (3). + - - 
    -audio.headroom <0 - 20>
    - Set number of additional half-frames to prebuffer. - + + 
    -audio.headroom <0 - 20>
    + Set number of additional half-frames to prebuffer. + - - 
    -audio.buffer_size <0 - 20>
    - Set maximum number of additional half-frames to buffer. - + + 
    -audio.buffer_size <0 - 20>
    + Set maximum number of additional half-frames to buffer. + - - 
    -audio.stereo <1|0>
    - Enable or disable stereo mode for all ROMs. - + + 
    -audio.stereo <1|0>
    + Enable or disable stereo mode for all ROMs. + - - 
    -audio.dpc_pitch <10000 - 30000>
    - Set the pitch o f Pitfall II music. - + + 
    -audio.dpc_pitch <10000 - 30000>
    + Set the pitch o f Pitfall II music. + 
    -tia.zoom <zoom>
    @@ -1996,9 +1996,9 @@ aspect ratio. - - 
    -tia.fs_overscan <0 - 10>
    - Add overscan to TIA image while in fullscreen mode + + 
    -tia.fs_overscan <0 - 10>
    + Add overscan to TIA image while in fullscreen mode @@ -2608,9 +2608,9 @@ 
    -dev.rwportbreak <1|0>
    Since the 2600 has no dedicated R/W line, different addresses are used - for RAM read or write access. If the code reads from such a write address, this causes - an unwanted, semi-random write to that address. - When this option is enabled, such reads interrupt emulation and the debugger is entered. + for RAM read or write access. If the code reads from such a write address, this causes + an unwanted, semi-random write to that address. + When this option is enabled, such reads interrupt emulation and the debugger is entered. 
    -dev.thumb.trapfatal <1|0>
    When enabled, this allows the Thumb ARM emulation to @@ -2704,14 +2704,14 @@ RendererUse specified rendering mode-video TIA palettePalette for emulation mode-palette TIA interpolationInterpolation for TIA image-tia.inter - TIA zoomZoom level for emulation mode -tia.zoom + TIA zoomZoom level for emulation mode -tia.zoom NTSC aspectWidth of TIA image in NTSC mode-tia.aspectn PAL aspectWidth of TIA image in PAL mode-tia.aspectp Emul. speedEmulation speed-speed - VSyncEnable vertical synced updates-vsync + VSyncEnable vertical synced updates-vsync FullscreenSelf-explanatory-fullscreen StretchIn fullscreen mode, completely fill screen with TIA image-tia.fs_stretch - OverscanIn fullscreen mode, add overscan to the TIA image-tia.fs_overscan + OverscanIn fullscreen mode, add overscan to the TIA image-tia.fs_overscan Fast SuperCharger loadSkip progress loading bars for SuperCharger ROMs-fastscbios Show UI messagesOverlay UI messages onscreen-uimessages Center windowAttempt to center application windows, else position at last position-center @@ -2772,7 +2772,7 @@ -audio.resampling_quality HeadroomNumber of frames to buffer before playback starts. Higher values increase latency, but reduce the potential for dropouts.-audio.headroom Buffer sizeMaximum size of the audio buffer. Higher values increase maximum latency, but reduce the potential for dropouts-audio.buffer_size - Stereo for all ROMsEnables stereo mode for all ROMs.-audio.stereo + Stereo for all ROMsEnables stereo mode for all ROMs.-audio.stereo Pitfall II music pitchDefines the pitch of Pitfall II music (which may vary between carts).-audio.dpc_pitch

    @@ -2813,10 +2813,10 @@ Dialogs positionPosition of dialogs with Stella window-dialogpos HiDPI modeScales the UI by a factor of two when enabled-hidpi List input delayMaximum delay between keypresses in list-widgets before a search string resets. -listdelay - Mouse wheel scrollNumber of lines a mouse scroll will move in list-widgets-mwheel - Double-click speedSpeed of mouse double-clicks-mdouble - Controller repeat delayDelay before controller input repeats-ctrldelay - Controller repeat rateRate of controller input repeats-ctrlrate + Mouse wheel scrollNumber of lines a mouse scroll will move in list-widgets-mwheel + Double-click speedSpeed of mouse double-clicks-mdouble + Controller repeat delayDelay before controller input repeats-ctrldelay + Controller repeat rateRate of controller input repeats-ctrlrate @@ -2846,7 +2846,7 @@ - + @@ -2890,7 +2890,7 @@

    Game Properties dialog:

    ItemBrief descriptionFor more information,
    see CommandLine
    Save pathSpecifies where to save snapshots-snapsavedir
    Continuous snapshot intervalInterval (in seconds) between snapshots-ssinterval
    Use actual ROM nameUse the actual ROM filename instead of the internal database name.-snapname
    Overwrite existing filesWhether to overwrite old snapshots-sssingle
    - + + + + + + + + +
        
    This dialog allows you to change all ROM properties as described in Advanced Configuration - Game Properties. @@ -2936,8 +2936,8 @@ use a controller direction or button. Then that key (combination) or controller action will be bound to the selected event.
    Notes:
      -
    • If nothing seems to happen, either Stella can't see the input device, or the - selected event doesn't support being remapped to the input device.
      • +
    • If nothing seems to happen, either Stella can't see the input device, or the + selected event doesn't support being remapped to the input device.
    • Events which are available in both event modes can be remapped individually.
    • Left and right modifiers are mapped separately. To map them as one, press both modifier keys during mapping.
      • @@ -3268,22 +3268,22 @@
    		     - - - - - - - - -
    ItemBrief descriptionFor more information,
    see CommandLine
    Chip typeType of emulated TIA chip. Allows testing for - TIA versions which exhibit timing problems in certain games. The - 'Custom' option allows testing for glitch combinations.-dev.tia.type
    Inverted HMOVE clock...Emulates the Kool-Aid Man - collision and Cosmic Ark stars glitches for the given objects.-dev.tia.plinvphase
    -dev.tia.msinvphase
    -dev.tia.blinvphase
    Delayed PlayfieldEmulates playfield registers delayed - by one color clock. This e.g. causes glitches in Pesco (stray playfield - pixel) and Quick Step! (colored step borders)-dev.tia.delaypfbits
    -dev.tia.delaypfcolor
    Delayed VDEL... swap forEmulates a VDELP0/P1/BL swap - delayed by one color clock. This e.g cause glitches in the He-Man title - screen.-dev.tia.delayplswap
    -dev.tia.delayblswap
    +
    ItemBrief descriptionFor more information,
    see CommandLine
    Chip typeType of emulated TIA chip. Allows testing for + TIA versions which exhibit timing problems in certain games. The + 'Custom' option allows testing for glitch combinations.-dev.tia.type
    Inverted HMOVE clock...Emulates the Kool-Aid Man + collision and Cosmic Ark stars glitches for the given objects.-dev.tia.plinvphase
    -dev.tia.msinvphase
    -dev.tia.blinvphase
    Delayed PlayfieldEmulates playfield registers delayed + by one color clock. This e.g. causes glitches in Pesco (stray playfield + pixel) and Quick Step! (colored step borders)-dev.tia.delaypfbits
    -dev.tia.delaypfcolor
    Delayed VDEL... swap forEmulates a VDELP0/P1/BL swap + delayed by one color clock. This e.g cause glitches in the He-Man title + screen.-dev.tia.delayplswap
    -dev.tia.delayblswap
    @@ -3676,62 +3676,12 @@ Ms Pac-Man (Stella extended codes):

    Each block in a property file consists of a set of properties for a single game. Stella supports the properties described below:

    - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - +
    Cartridge.MD5:Indicates the MD5 checksum of the ROM image as a - string of hexadecimal digits. Stella uses this property while - attempting to match a game with its block of properties. If the - value of the property matches the MD5 checksum of the ROM image then - Stella uses that block of properties for the game. You can use the - GNU md5sum program, which is included with most Linux distributions, - to calculate the MD5 checksum of a ROM image.
    Cartridge.Manufacturer:Indicates the game's manufacturer.
    Cartridge.ModelNo:Indicates the manufacturer's model number for the game.
    Cartridge.Name:Indicates the actual name of the game. When you save snapshots, - load/save state files, or use the ROM Audit Mode functionality, - this is the name that will be used for the respective file(s).
    Cartridge.Note:Contains any special notes about playing the game.
    Cartridge.Rarity:Indicates how rare a cartridge is, based on the scale described on AtariAge.
    Cartridge.Sound:Indicates if the game should use 1 or 2 channels for sound output. - All original Atari 2600 machines supported 1 channel only, - but some homebrew games have been written to take advantage of stereo - sound mods. The value must be Mono or Stereo.
    Cartridge.StartBank:Indicates which bank to use for reading the reset vector.
    Cartridge.Type:Indicates the bank-switching type for the game. +
    Cartridge.Type:Indicates the bank-switching type for the game. The value of this property must be either Auto or one of the following (for more information about bank-switching see Kevin Horton's 2600 bankswitching document or the documentation in each cartridge's source code file) types. Types marked @@ -3786,13 +3736,50 @@ Ms Pac-Man (Stella extended codes):
    MDM Menu Driven Megacart .MDM
    SB 128-256k SUPERbanking .SB
    UA 8K UA Ltd. .UA
    UASW 8K UA Ltd. (swapped banks).UASW
    UASW 8K UA Ltd. (swapped banks).UASW
    WD Wickstead Design .WD
    X07 ¹64K AtariAge .X07
    - + + Cartridge.StartBank: + Indicates which bank to use for reading the reset vector. + + + + Display.Format: + Indicates the television format the game was designed for. The value + must be Auto, NTSC, PAL, SECAM, NTSC50, + PAL60 or SECAM60. + + + + Display.Phosphor: + Indicates whether the phosphor effect should be emulated or not. + The value must be Yes or No. + + + + Display.PPBlend: + Indicates the amount of blending which will occur while using the + phosphor effect. The value must be n such that 0 <= n + <= 100. The default value is whatever is specified for tv.phosblend. + + + + Cartridge.Sound: + Indicates if the game should use 1 or 2 channels for sound output. + All original Atari 2600 machines supported 1 channel only, + but some homebrew games have been written to take advantage of stereo + sound mods. The value must be Mono or Stereo. + + + + @@ -3835,7 +3822,7 @@ Ms Pac-Man (Stella extended codes): - +
    TrakballStandard Atari 2600 CX22/CX80 'Trak-Ball' controller.
    AtariVox ¹A SpeakJet based unlimited-vocabulary speech/sound synthesizer with 32K EEPROM.
    SaveKeyA 32K EEPROM for saving high scores, etc. (the EEPROM portion of an AtariVox).
    Genesis Sega Genesis controller, which can be used similar to a BoosterGrip, giving an extra button.
    Genesis Sega Genesis controller, which can be used similar to a BoosterGrip, giving an extra button.
    CompuMate ¹Spectravideo CompuMate (if either left or right is set, CompuMate is used for both).
    Mindlink ¹Mindlink controller.
    @@ -3888,40 +3875,48 @@ Ms Pac-Man (Stella extended codes): --> - + - - + + - - + + - - + + - - + + + + + + + + + + + + +
    Display.Format:Indicates the television format the game was designed for. The value - must be Auto, NTSC, PAL, SECAM, NTSC50, - PAL60 or SECAM60.Cartridge.MD5:Indicates the MD5 checksum of the ROM image as a + string of hexadecimal digits. Stella uses this property while + attempting to match a game with its block of properties. If the + value of the property matches the MD5 checksum of the ROM image then + Stella uses that block of properties for the game. You can use the + GNU md5sum program, which is included with most Linux distributions, + to calculate the MD5 checksum of a ROM image.
    Display.YStart:Indicates the scan-line to start displaying at. - The value must be n such that 0 <= n <= 64. - Setting n to zero will enable ystart autodetection, which - should work fine for the vast majority of ROMs.Cartridge.Manufacturer:Indicates the game's manufacturer.
    Display.Phosphor:Indicates whether the phosphor effect should be emulated or not. - The value must be Yes or No.Cartridge.ModelNo:Indicates the manufacturer's model number for the game.
    Display.PPBlend:Indicates the amount of blending which will occur while using the - phosphor effect. The value must be n such that 0 <= n - <= 100. The default value is whatever is specified for tv.phosblend.Cartridge.Name:Indicates the actual name of the game. When you save snapshots, + load/save state files, or use the ROM Audit Mode functionality, + this is the name that will be used for the respective file(s).
    Cartridge.Note:Contains any special notes about playing the game.
    Cartridge.Rarity:Indicates how rare a cartridge is, based on the scale described on AtariAge.
    - +

    The name of the properties file is configurable through the '-propsfile' commandline argument and within the application itself (see Advanced Configuration - Configure Paths). If the