Enhanced mGBA: Difference between revisions

From GC-Forever Wiki
Jump to navigation Jump to search
Created page with "{{Infobox/homebrew | title = <includeonly>[[</includeonly>Enhanced mGBA<includeonly>]]</includeonly> | author = Extrems | type = Handheld em..."
 
 
(39 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox/homebrew
{{Infobox/homebrew
| title      = <includeonly>[[</includeonly>Enhanced mGBA<includeonly>]]</includeonly>
| title      = <includeonly>[[</includeonly>Enhanced mGBA<includeonly>]]</includeonly>
| author      = [[User:Extrems|Extrems]]
| author      = <span class="plainlinks">[https://www.patreon.com/Extrems Extrems]</span>
| type        = Handheld emulator
| type        = Handheld emulator
| version    = Rolling release
| version    = Rolling release
| licence    = Freeware
| licence    = MPL v2.0
| downloadraw = [https://files.extremscorner.org/gamecube/apps/mgba/latest Download] <br /> [https://files.extremscorner.org/gamecube/apps/mgba/latest-extra Download extras]
| downloadraw = [https://files.extremscorner.org/gamecube/apps/mgba/latest Download main package] <br /> [https://files.extremscorner.org/gamecube/apps/mgba/latest-extra Download extra package]
| website    = https://www.extremscorner.org/
| website    = https://mgba.io/
| discussion  = https://www.gc-forever.com/forums/viewtopic.php?f=13&t=3129
| discussion  = https://www.gc-forever.com/forums/viewtopic.php?f=13&t=3129
| source      = https://github.com/Extrems/mGBA
| source      = https://github.com/extremscorner/emgba
}}
}}
<noinclude>
<noinclude>
'''Enhanced mGBA''' is an enhanced port of the [https://mgba.io/ Game Boy Advance emulator], based on [[Game Boy Interface/Standard Edition|Game Boy Interface]].
'''Enhanced mGBA''' ('''emGBA''') is an enhanced port of the [https://mgba.io/ Game Boy Advance emulator], based on [[Game Boy Interface/Standard Edition|Game Boy Interface Standard Edition]].
 
== Options ==
 
; {{anchor|--aspect}}<code>--aspect=<w:h></code>
: 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.
; {{anchor|--offset}}<code>--offset=<x:y></code>
: Set offset. The default is the Screen Position system setting (-32 to +32).
; {{anchor|--zoom}}<code>--zoom=<x:y></code>
: Set zoom (default: auto).
; {{anchor|--zoom-auto}}<code>--zoom-auto[=<ratio>]</code>
: Enable best fit for a given screen size ratio, or [[wikipedia:Safe area (television)|safe area]]. The default is the Game Boy Player Start-up Disc's Screen Size setting (0.75 or 0.875).
; {{anchor|--rotate}}<code>--rotate=<0-359></code>
: Set rotation (default: 0).
; {{anchor|--poll}}<code>--poll=<0-11></code>
: 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.
: {| class="wikitable"
| '''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.
; {{anchor|--cursor|--no-cursor}}<code>--cursor=<path></code>, <code>--no-cursor</code>
: Load texture palette for cursors (default: point.tpl.gz).
; {{anchor|--overlay|--no-overlay}}<code>--overlay=<path></code>, <code>--no-overlay</code>
: Load texture palette for graphic overlays (default: frame.tpl.gz).
; {{anchor|--overlay-id}}<code>--overlay-id=<ID></code>
: Set texture palette index for graphic overlay. The default is the Game Boy Player Start-up Disc's Frame setting (0 to 19).
; {{anchor|--overlay-scale}}<code>--overlay-scale=<x:y></code>
: Set texture scale for graphic overlay (default: auto).
; {{anchor|--filter}}<code>--filter=<[none|blend|deflicker|accumulate|scale2x[ex|plus]|eagle2x|scan2x|normal2x][,prescale|no-prescale]></code>
: Set image doubling or screen filter. The default is the Game Boy Player Start-up Disc's Screen Filter setting (none, blend, deflicker).
:; <code>none</code>
:: Also known as the Sharp screen filter.
:; <code>blend[=<red[:green[:blue]]>]</code>
:: Blend frames ''n'' and ''n-1'' (default: 0.55).
:: Also known as the Soft screen filter.
:; <code>deflicker[=<red[:green[:blue]]>]</code>
:: Blend frames ''n'' and ''n-1'' where ''n'' and ''n-2'' are equal (default: 0.55).
:: Also known as the Normal screen filter.
:; <code>accumulate[=<red[:green[:blue]]>]</code>
:: Blend frames with accumulation buffer (default: 0.55).
:: As used by the Nintendo 3DS Ambassador games.
:; <code>scale2xex</code>
:: Apply enhanced [[wikipedia:Pixel-art scaling algorithms#EPX/Scale2×/AdvMAME2×|EPX/Scale2×/AdvMAME2×]] algorithm with Y’C’<sub>B</sub>C’<sub>R</sub> difference.
:; <code>scale2xplus</code>
:; <code>scale2x</code>
:: Apply [[wikipedia:Pixel-art scaling algorithms#EPX/Scale2×/AdvMAME2×|EPX/Scale2×/AdvMAME2×]] algorithm.
:; <code>eagle2x</code>
:: Apply [[wikipedia:Pixel-art scaling algorithms#Eagle|Eagle]] algorithm.
:; <code>scan2x</code>
:: Apply simple scanlines.
:; <code>normal2x</code>
:; <code>prescale</code>, <code>no-prescale</code>
:: Enable prescaling filter (default: no).
; {{anchor|--dither}}<code>--dither=<none|threshold|bayer8x8|bayer4x4|bayer2x2|cluster8x8|cluster4x4></code>
: Set dithering algorithm (default: threshold). Setting this option to none is not recommended when using linear RGB rendering.
: Applied during prescaling.
; {{anchor|--scaler}}<code>--scaler=<nearest|bilinear|area|box></code>
: Set image scaling filter. Setting this option to nearest is not recommended when using fractional scaling or a non-square [[wikipedia:Pixel aspect ratio|pixel aspect ratio]].
: {| class="wikitable"
| '''nearest:'''
| [[wikipedia:Nearest-neighbor interpolation|Nearest-neighbor interpolation]] (fastest)
|-
| '''bilinear:'''
| [[wikipedia:Bilinear interpolation|Bilinear interpolation]]
|-
| '''area:'''
| Sharp bilinear interpolation (default)
|-
| '''box:'''
| Inverse sharp bilinear interpolation
|}
; {{anchor|--profile-intent}}<code>--profile-intent=<perceptual|relative|saturation|absolute></code>
: Set [[wikipedia:Color management#Rendering intent|color rendering intent]] (default: perceptual).
; {{anchor|--profile}}<code>--profile=<srgb|gambatte|gba|gbasp|gbc|gbi|hicolour|higan|nds|palm|psp></code>
: Set quick color profile.
: Overrides <code>--matrix</code>, <code>--input-gamma</code>, <code>--output-gamma</code>, <code>--brightness</code> and <code>--contrast</code>.
: {| class="wikitable"
| '''srgb:'''
| Emulator
|-
| '''gambatte:'''
| Gambatte / higan / ares
|-
| '''gba:'''
| [[Game Boy Interface/Standard Edition#Game Boy Advance|Game Boy Advance]]
|-
| '''gbasp:'''
| [[Game Boy Interface/Standard Edition#Game Boy Advance SP (AGS-101)|Game Boy Advance SP (AGS-101)]]
|-
| '''gbc:'''
| [[Game Boy Interface/Standard Edition#Game Boy Color|Game Boy Color]]
|-
| '''gbi:'''
| Game Boy Interface (2015–2017)
|-
| '''hicolour:'''
| Gameboy Hi-Colour Convertor
|-
| '''higan:'''
| higan / ares
|-
| '''nds:'''
| [[Game Boy Interface/Standard Edition#Nintendo DS|Nintendo DS]]
|-
| '''palm:'''
| [[Game Boy Interface/Standard Edition#Palm Treo 700p|Palm Treo 700p]]
|-
| '''psp:'''
| [[Game Boy Interface/Standard Edition#PlayStation Portable|PlayStation Portable]]
|}
; {{anchor|--matrix}}<code>--matrix=<identity|gambatte|gba|gbasp|gbc|gbi|hicolour|higan|nds|palm|psp|vba></code>
: Set color matrix (default: gbi).
: This translates the RGB color primaries to the [[wikipedia:sRGB|standard RGB color space]].
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gambatte:'''
| Gambatte / higan / ares
|-
| '''gba:'''
| Game Boy Advance (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''gbasp:'''
| Game Boy Advance SP (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''gbc:'''
| Game Boy Color (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''gbi:'''
| Game Boy Interface
|-
| '''hicolour:'''
| Gameboy Hi-Colour Convertor (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''higan:'''
| higan / ares
|-
| '''nds:'''
| Nintendo DS (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| Palm Treo 700p (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| PlayStation Portable (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''vba:'''
| VisualBoyAdvance-M (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|}
; {{anchor|--input-gamma}}<code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
: Overrides <code>--input-alpha</code>.
; {{anchor|--input-alpha}}<code>--input-alpha=<red[:green[:blue]]></code>
: Set alpha for piecewise parametric curve (default: 0.0).
; {{anchor|--output-gamma}}<code>--output-gamma=<1.0|1.7|2.2></code>
: Specify screen gamma (default: 2.2).
; {{anchor|--brightness}}<code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; {{anchor|--contrast}}<code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
:* <code>--contrast=.811065673828125:.8790390491485595703125:1.</code> D93 to D65, gamma 2.2.
:* <code>--contrast=1.:.92267322540283203125:.811065673828125</code> D65 to D93, gamma 2.2.
; {{anchor|--format}}<code>--format=<ntsc|pal|pal-m|ntsc-50|pal-60|custom|custom-m|hd60|hd50|hd48|hdcustom></code>
: Set video format. The default is the Video Mode system setting (ntsc, pal-60, pal-m).
: {| class="wikitable"
| '''ntsc:'''
| [[wikipedia:NTSC#NTSC-J|NTSC-J]]
|-
| '''pal:'''
| [[wikipedia:PAL|PAL-B/G/D/K/I]]
|-
| '''pal-m:'''
| [[wikipedia:PAL-M|PAL-M]]
|-
| '''ntsc-50:'''
| [[wikipedia:NTSC#NTSC-N/NTSC50|NTSC-50]]
|-
| '''pal-60:'''
| [[wikipedia:PAL#Multisystem PAL support and "PAL 60"|PAL-60]]
|-
| '''hd60:'''
| [[wikipedia:High-definition television|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. <br /> AVE N-DOL can only output [[wikipedia:Composite video|CVBS]] or [[wikipedia:S-Video|Y/C]] as NTSC-J, PAL-M or NTSC-50. <br /> AVE P-DOL can only output [[wikipedia:Composite video|CVBS]] as PAL-B/G/D/K/I or PAL-60. <br /> AVE-RVL is only designed to support NTSC-J, PAL-B/G/D/K/I, PAL-M and PAL-60.
; {{anchor|--scan-mode}}<code>--scan-mode=<[interlace|quasi-interlace|non-interlace|non-progressive|progressive][,clock2x|no-clock2x][,size2x|no-size2x]></code>
: Set scan mode. The default is the Progressive Scan Mode system setting (interlace or progressive).
: {| class="wikitable"
| '''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)
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> scan modes. Disabling halves the refresh rate for <code>progressive</code> scan modes.
:: This depend on a compatible [[wikipedia:Video encoder|video encoder]] or transmitter not mangling its input.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2× video oversampling (default: auto). Enabling halves the refresh rate. <br /> If the video format's horizontal resolution is less or equal to 682, the internal resolution is doubled instead.
:: This depend on a compatible [[wikipedia:Video encoder|video encoder]] or transmitter not mangling its input.
; {{anchor|--ipv4-address}}<code>--ipv4-address=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 address.
; {{anchor|--ipv4-gateway}}<code>--ipv4-gateway=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 gateway.
; {{anchor|--ipv4-netmask}}<code>--ipv4-netmask=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 netmask.
; {{anchor|--network|--no-network}}<code>--network</code>, <code>--no-network</code>
: Enable [[Broadband Adapter]] features (default: yes).
; <code><path></code>
: Load ROM.


[[Category:Homebrew_Software]]
[[Category:Homebrew_Software]]
</noinclude>
</noinclude>

Latest revision as of 22:43, 18 June 2024

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.
Retrieved from "http://www.gc-forever.com/wiki/index.php?title=Enhanced_mGBA&oldid=7940"