Enhanced mGBA

From GC-Forever Wiki
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).
Setting this option to 3:2 is not recommended unless interpreting 720×480 as square pixels.
--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
Note: The polling rate will be doubled or halved in tandem with the refresh rate.
--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
--profile-intent=<perceptual|relative|saturation|absolute>
Set color rendering intent (default: perceptual).
--profile=<srgb|gambatte|gba|gbasp|gbc|gbi|hicolour|higan|nds|palm|psp>
Set quick color profile.
Overrides --matrix, --input-gamma, --output-gamma, --brightness and --contrast.
srgb: Emulator
gambatte: Gambatte / higan / ares
gba: Game Boy Advance
gbasp: Game Boy Advance SP (AGS-101)
gbc: Game Boy Color
gbi: Game Boy Interface (2015–2017)
hicolour: Gameboy Hi-Colour Convertor
higan: higan / ares
nds: Nintendo DS
palm: Palm Treo 700p
psp: PlayStation Portable
--matrix=<identity|gambatte|gba|gbasp|gbc|gbi|hicolour|higan|nds|palm|psp|vba>
Set color matrix (default: gbi).
This translates the RGB color primaries to the standard RGB color space.
identity: Identity matrix
gambatte: Gambatte / higan / ares
gba: Game Boy Advance (by Pokefan531)
gbasp: Game Boy Advance SP (by Pokefan531)
gbc: Game Boy Color (by Pokefan531)
gbi: Game Boy Interface
hicolour: Gameboy Hi-Colour Convertor (by Pokefan531)
higan: higan / ares
nds: Nintendo DS (by Pokefan531)
palm: Palm Treo 700p (by Pokefan531)
psp: PlayStation Portable (by Pokefan531)
vba: VisualBoyAdvance-M (by Pokefan531)
--input-gamma=<red[:green[:blue]]>
Set gamma (default: 2.2).
Overrides --input-alpha.
--input-alpha=<red[:green[:blue]]>
Set alpha for piecewise parametric curve (default: 0.0).
--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).
  • --contrast=.811065673828125:.8790390491485595703125:1. D93 to D65, gamma 2.2.
  • --contrast=1.:.92267322540283203125:.811065673828125 D65 to D93, gamma 2.2.
--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.