Enhanced mGBA

From GC-Forever Wiki
Revision as of 18:44, 5 January 2022 by Extrems (talk | contribs)
Jump to navigation Jump to search
Enhanced mGBA
Information
Author(s) Extrems
Type Handheld emulator
Version Rolling release
Licence MPL v2.0
Links
Download main package
Download extra package
Website
Discussion
Source

Enhanced mGBA (emGBA) is an enhanced port of the Game Boy Advance emulator, based on Game Boy Interface Standard Edition.

Options

--aspect=<w:h>
Specify screen aspect ratio. The default is the Progressive Scan Mode system setting (4:3 or 16:9).
--offset=<x:y>
Set offset. The default is the Screen Position system setting (-32 to +32).
--zoom=<x:y>
Set zoom (default: auto).
--zoom-auto[=<ratio>]
Enable best fit for a given screen size ratio, or safe area. The default is the Game Boy Player Start-up Disc's Screen Size setting (0.75 or 0.875).
--rotate=<0-359>
Set rotation (default: 0).
--poll=<0-11>
Set controller polling rate. Use if your third-party controller or controller adapter is malfunctioning.
Not applicable to Nintendo 64 Controllers using a passive connector adapter.
0: VSync (most compatible)
1: 1000Hz (default)
2: 500Hz
3: 350Hz
4: 300Hz
5: 250Hz
6: 200Hz
7: 150Hz
8: 150Hz
9: 125Hz
10: 125Hz
11: 100Hz
--cursor=<path>, --no-cursor
Load texture palette for cursors (default: point.tpl.gz).
--overlay=<path>, --no-overlay
Load texture palette for graphic overlays (default: frame.tpl.gz).
--overlay-id=<ID>
Set texture palette index for graphic overlay. The default is the Game Boy Player Start-up Disc's Frame setting (0 to 19).
--overlay-scale=<x:y>
Set texture scale for graphic overlay (default: auto).
--filter=<[none|blend|deflicker|accumulate|scale2x[ex|plus]|eagle2x|scan2x|normal2x][,prescale|no-prescale]>
Set image doubling or screen filter. The default is the Game Boy Player Start-up Disc's Screen Filter setting (none, blend, deflicker).
none
Also known as the Sharp screen filter.
blend[=<red[:green[:blue]]>]
Blend frames n and n-1 (default: 0.55).
Also known as the Soft screen filter.
deflicker[=<red[:green[:blue]]>]
Blend frames n and n-1 where n and n-2 are equal (default: 0.55).
Also known as the Normal screen filter.
accumulate[=<red[:green[:blue]]>]
Blend frames with accumulation buffer (default: 0.55).
As used by the Nintendo 3DS Ambassador games.
scale2xex
Apply enhanced EPX/Scale2×/AdvMAME2× algorithm with Y’C’BC’R difference.
scale2xplus
scale2x
Apply EPX/Scale2×/AdvMAME2× algorithm.
eagle2x
Apply Eagle algorithm.
scan2x
Apply simple scanlines.
normal2x
prescale, no-prescale
Enable prescaling filter (default: no).
--dither=<none|threshold|bayer8x8|bayer4x4|bayer2x2|cluster8x8|cluster4x4>
Set dithering algorithm (default: threshold). Setting this option to none is not recommended when using linear RGB rendering.
Applied during prescaling.
--scaler=<nearest|bilinear|area|box>
Set image scaling filter. Setting this option to nearest is not recommended when using fractional scaling or a non-square pixel aspect ratio.
nearest: Nearest-neighbor interpolation (fastest)
bilinear: Bilinear interpolation
area: Sharp bilinear interpolation (default)
box: Inverse sharp bilinear interpolation
--matrix=<identity|gba|gbc|gbc-dev|gbi|nds|palm|psp|vba>
Set color matrix (default: gbi).
This translates the RGB color primaries to the standard RGB color space.
identity: Identity matrix
gba: Game Boy Advance (by Pokefan531)
gbc: Game Boy Color (by Pokefan531)
gbc-dev: Gameboy Hi-Colour Convertor (by Pokefan531)
gbi: Game Boy Interface
nds: Nintendo DS (by Pokefan531)
palm: Palm Treo 700p (by Pokefan531)
psp: PlayStation Portable (by Pokefan531)
vba: VisualBoyAdvance-M (by Pokefan531)
--profile=<srgb|gba|gbc|gbc-dev|gbi|nds|palm|psp>
Set quick color profile.
Overrides --matrix, --input-gamma, --output-gamma, --brightness and --contrast.
srgb: Emulator
gba: Game Boy Advance
gbc: Game Boy Color
gbc-dev: Gameboy Hi-Colour Convertor
gbi: Game Boy Interface (2015–2017)
nds: Nintendo DS
palm: Palm Treo 700p
psp: PlayStation Portable
--input-gamma=<red[:green[:blue]]>
Set gamma (default: 2.2).
--output-gamma=<1.0|1.7|2.2>
Specify screen gamma (default: 2.2).
--brightness=<red[:green[:blue]]>
Set lift (default: 0.0).
--contrast=<red[:green[:blue]]>
Set gain (default: 1.0).
--format=<ntsc|pal|pal-m|ntsc-50|pal-60|custom|custom-m|hd60|hd50|hd48|hdcustom>
Set video format. The default is the Video Mode system setting (ntsc, pal-60, pal-m).
ntsc: NTSC-J
pal: PAL-B/G/D/K/I
pal-m: PAL-M
ntsc-50: NTSC-50
pal-60: PAL-60
hd60: HDTV (60Hz)
hd50: HDTV (50Hz)
hd48: HDTV (48Hz)
Note: GCVideo-DVI is only designed to support NTSC-J, PAL-B/G/D/K/I and PAL-60.
AVE N-DOL can only output CVBS or Y/C as NTSC-J, PAL-M or NTSC-50.
AVE P-DOL can only output CVBS as PAL-B/G/D/K/I or PAL-60.
AVE-RVL is only designed to support NTSC-J, PAL-B/G/D/K/I, PAL-M and PAL-60.
--scan-mode=<[interlace|quasi-interlace|non-interlace|non-progressive|progressive][,clock2x|no-clock2x][,size2x|no-size2x]>
Set scan mode. The default is the Progressive Scan Mode system setting (interlace or progressive).
interlace: 15 or 18-22kHz interlaced (480i@60Hz; 576i@50Hz; 720i@48-60Hz), deflickering
quasi-interlace: 15 or 18-22kHz segmented frame (480sf@30Hz; 576sf@25Hz; 720sf@24-30Hz)
non-interlace: 15 or 18-22kHz progressive (240p@60Hz; 288p@50Hz; 360p@48-60Hz)
non-progressive: 31 or 27-33kHz interlaced (960i@60Hz; 1152i@50Hz; 1080i@48-60Hz), field rendering
progressive: 31 or 27-33kHz progressive (480p@60Hz; 576p@50Hz; 540p@48-60Hz)
clock2x, no-clock2x
Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for interlace scan modes. Disabling halves the refresh rate for progressive scan modes.
This depend on a compatible video encoder or transmitter not mangling its input.
size2x, no-size2x
Enable 2× video oversampling (default: auto). Enabling halves the refresh rate.
If the video format's horizontal resolution is less or equal to 682, the internal resolution is doubled instead.
This depend on a compatible video encoder or transmitter not mangling its input.
--ipv4-address=<aaa.bbb.ccc.ddd>
Set static IPv4 address.
--ipv4-gateway=<aaa.bbb.ccc.ddd>
Set static IPv4 gateway.
--ipv4-netmask=<aaa.bbb.ccc.ddd>
Set static IPv4 netmask.
--network, --no-network
Enable Broadband Adapter features (default: yes).
<path>
Load ROM.