Pecus/libretro-atari800
1
0
Fork 0
mirror of https://github.com/Pecusx/libretro-atari800.git synced 2026-05-20 22:33:22 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
5a96c0ca66dbf0828b787a4cf3cbb208fc1b4fcd
libretro-atari800/atari800/DOC/directx.txt
T
R-type 5a96c0ca66 initial commit
2015-12-14 14:00:35 +01:00

230 lines
8.9 KiB
Plaintext
Raw Blame History

This file documents new options that I have personally
added to the Windows DX port of the emulator since 2.1.
The major goal of these enhancements is to allow the
emulator to perform better on modern display and game
controller technology, including widescreen monitors,
TVs, gamepads, and HTPC/kiosk setups. A secondary
goal is to make usability improvements to the emulator
shell including main menu and internal mouse support.
Windows DX: Windows Display Options
===================================
Note: Defaults are shown in [brackets].
Note: All settings (except -console) can be saved in the UI.
Display Rendering
-----------------
[GDI] Software pixel scaling. Fast.
GDI+ Software pixel scaling. Moderate.
GDI+/Bilinear Software bilinear scaling. Slow.
GDI+/Bilinear (HQ) Software HQ bilinear scaling. Very slow.
GDI+/Bicubic (HQ) Software HQ bicubic scaling. Slow
Direct3D Hardware pixel scaling. Fast.
Direct3D/Bilinear Hardware bilinear scaling. Fast.
Note: Emulator must be restarted to activate a rendering
mode change.
Hint: For softer pixels and resolution-independent aliasing
control, choose Direct3D/Bilinear mode.
Fullscreen Resolution
---------------------
[Desktop] Use the current desktop resolution.
VGA 640x480. 2x native pixel resolution.
SXGA 1280x960. 4x native pixel resolution.
UXGA 1600x1200. 5x native pixel resolution.
Hint: Use -fsres command line to use a custom resolution that
does not appear in this list.
Scaling Method
--------------
Off Stretch unconstrained to window boundary
[Normal] Scale dynamically while enforcing aspect.
Simple Scale to exact multiple of native screen.
Adaptive Compensate for widescreen stretching.
Note: Adaptive mode is "experimental" and not fully compatible
with all combinations of settings.
Aspect Mode
-----------
[Auto] 7:5 or 4:3 crop depending on screen metrics.
Wide Display 336x240 pixel matrix in 7:5 aspect.
Cropped Display 320x240 pixel matrix in 4:3 aspect.
Compressed Display 336x240 pixel matrix in 4:3 aspect.
Note: Scaling method must be set to "Normal" or "Simple" for these
settings to be effective.
Custom Crop Options
-------------------
Horizontal crop Symmetrically crop width by # of pixels. [0]
Vertical crop Symmetrically crop height by # of pixels. [0]
Lock aspect mode Force current aspect mode ratio on crop.[No]
Hint: Cropping can be used to effectively zoom or stretch. To zoom
without distortion while using a 4:3 resolution in fullscreen,
set horizontal and vertical crop to equal values. To zoom
when using a widescreen display and resolution in fullscreen,
you typically only need to set a vertical crop value.
Note: Be aware that using vertical crop will clip the notification
area of the screen sometimes used to display frame rates or
disk activity.
Other Settings
--------------
Screen mode Switch between Fullscreen and [Windowed] modes.
Window scale Set size of window as percent of native. [200]
Scanline mode Three resolutions of simulated scanlines. [Off]
Horizontal offset Shift screen horizontally <-24..24>. [0]
Vertical offset Shift screen vertically <-50..50>. [0]
Always hide cursor Hide mouse cursor in fullscreen UI. [No]
Show menu Show or hide the Windows main menu. [Yes]
Windows DX: Display Settings
============================
Color preset
-------------------------
[Standard] Standard color adjustments as seen on a real TV or
monitor. Accurately represents full spectrum of colors.
Deep black Adjusted to allow producing pure black color (unlike the
Standard preset). May look more pleasant, although is
less accurate when representing the darkest colors.
Vibrant Arcade-like vibrant colors. Enhanced color saturation
and black-level.
Hint: Changing video settings (i.e. brightness, contrast, etc.) from
one of the base profile settings will cause the profile name
to read "Custom".
Windows DX: Controller Configuration
====================================
Keyboard Joystick Modes
-----------------------
Keypad Keypad is joystick. 0 key is trigger.
Keypad+ Keypad is joystick. 5=down. 0, left ctrl=trigger.
[Arrows] Use cursor block as joystick. Left ctrl=trigger.
Alternate Joystick Modes
------------------------
[Normal] Normal joystick functions.
Dual Double-map player 2 stick to Z/Z-Rotation axis.
Shared Double-map player 2 stick to player 1 stick.
Hint: Use "Dual" on two-stick gamepads for two joystick games like
Robotron and Space Dungeon. Use "Shared" to share a single
joystick between two players on games that normally require
two joysticks.
Custom Button Options
---------------------
Use "Enable custom buttons" to turn on custom joystickbutton feature.
Use "Assign custom buttons" to assign keystrokes to joystick buttons.
The following buttons may be mapped.
* All numbers.
* All alphabet keys in upper & lower case.
* Atari Option, Select, and Start (press F2, F3, or F4).
* Space
* Return
Windows DX Menu Operation
=========================
Configuration options may be accessed through either the
main menu or by pressing F1. The main menu is only available
when the emulator is run in a window.
Mouse Operations
----------------
Inside the configuration menus, mouse ops are as follows.
Click: Selects item
Double click: Activates item (Enter)
Right click: Back (Esc)
Wheel up: Up
Wheel down: Down
Wheel left: Left
Wheel right: Right
Windows DX keyboard hot-keys
============================
Alt+Enter Toggles between windowed and fullscreen modes
Alt+PageUp Increases the size of the window
Alt+PageDown Decreases the size of the window
Alt+I Advances to the next scanline (interleave) mode
Alt+M Toggles Windows main menu on or off.
Alt+Shift+Z 3D "tilt screen". (Direct3D modes only)
Alt+Z 3D "screensaver". (Direct3D modes only)
Hint: Use of Alt-T & Alt-Z may require running the "DirectX 9 Updater"
from microsoft.com. Google or Bing the quoted text to find it.
Windows DX: Command Line Options
================================
-help Show all help options (including these)
-console Send debug output to a console instead of
atari800.txt. Required for debug monitor.
-keyjoy <mode> Keyboard joystick mode.
<keypad>, <keypadplus>, <arrow>
-altjoy <mode> Alternate joystick mode.
<normal>, <dual>, <shared>
-mapjoy1buttons Use custom button mappings for joystick 1.
-mapjoy2buttons Use custom button mappings for joystick 2.
-render <mode> Rendering engine to use.
<ddraw>, <gdi>, <gdiplus>, <direct3d>
-filter <mode> Scaling filter.
<bilinear>, <bicubic>, <hqbilinear>, <hqbicubic>
-scaling <mode> Scaling method.
<off>, <normal>, <simple>, <adaptive>
-aspect <mode> Aspect mode.
<auto>, <wide>, <cropped>, <compressed>
-winscale <scale> Window size as a percent of native Atari screen.
<100>, <200>, <250>, etc.
-fullscreen Force fullscreen mode at startup.
-windowed Force windowed mode at startup.
-fsres <dim> Custom fullscreen resolution. <widthxheight>
i.e. <640x480>, <800x600>, <1024x768>, etc.
-scanlines <mode> Scanline mode.
<low>, <medium>, <high>
-hcrop <amt> Crop the screen horizontally.
<number of atari pixels>
-vcrop <amt> Crop the screen vertically.
<number of atari pixels>
-crop <amt> Crop the screen horizonally & vertically.
<number of atari pixels>
-lockaspect Lock current aspect mode when trimming.
-hoffset <amt> Shift screen horizontally.
<number of atari pixels>
-voffset <amt> Shift screen vertically.
<number of atari pixels>
-hidecursor Hide mouse cursor in fullscreen UI mode.
-hidemenu Hide the Windows main menu.
-colors-preset Use one of predefined color adjustments.
<standard>, <deep-black>, <vibrant>
-width Set display mode width (ddraw only).
-blt Use blitting to draw graphics (ddraw only).
David Dahlstrom
2010-04-29
Reference in New Issue View Git Blame Copy Permalink