Enhanced mGBA: Difference between revisions
Jump to navigation
Jump to search
Line 66: | Line 66: | ||
| 100Hz | | 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> | ; {{anchor|--cursor|--no-cursor}}<code>--cursor=<path></code>, <code>--no-cursor</code> | ||
: Load texture palette for cursors (default: point.tpl.gz). | : Load texture palette for cursors (default: point.tpl.gz). | ||
Line 117: | Line 118: | ||
| Inverse sharp bilinear interpolation | | Inverse sharp bilinear interpolation | ||
|} | |} | ||
; {{anchor|-- | ; {{anchor|--profile-intent}}<code>--profile-intent=<perceptual|relative|saturation|absolute></code> | ||
: Set color | : 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" | : {| class="wikitable" | ||
| ''' | | '''srgb:''' | ||
| | | Emulator | ||
|- | |||
| '''gambatte:''' | |||
| Gambatte / higan / ares | |||
|- | |- | ||
| '''gba:''' | | '''gba:''' | ||
| Game Boy Advance | | [[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:''' | | '''gbc:''' | ||
| Game Boy Color ( | | [[Game Boy Interface/Standard Edition#Game Boy Color|Game Boy Color]] | ||
|- | |||
| '''gbi:''' | |||
| Game Boy Interface (2015–2017) | |||
|- | |- | ||
| ''' | | '''hicolour:''' | ||
| Gameboy Hi-Colour Convertor | | Gameboy Hi-Colour Convertor | ||
|- | |- | ||
| ''' | | '''higan:''' | ||
| | | higan / ares | ||
|- | |- | ||
| '''nds:''' | | '''nds:''' | ||
| Nintendo DS | | [[Game Boy Interface/Standard Edition#Nintendo DS|Nintendo DS]] | ||
|- | |- | ||
| '''palm:''' | | '''palm:''' | ||
| Palm Treo 700p | | [[Game Boy Interface/Standard Edition#Palm Treo 700p|Palm Treo 700p]] | ||
|- | |- | ||
| '''psp:''' | | '''psp:''' | ||
| PlayStation Portable | | [[Game Boy Interface/Standard Edition#PlayStation Portable|PlayStation Portable]] | ||
|} | |} | ||
; {{anchor|-- | ; {{anchor|--matrix}}<code>--matrix=<identity|gambatte|gba|gbasp|gbc|gbi|hicolour|higan|nds|palm|psp|vba></code> | ||
: Set | : Set color matrix (default: gbi). | ||
: | : This translates the RGB color primaries to the [[wikipedia:sRGB|standard RGB color space]]. | ||
: {| class="wikitable" | : {| class="wikitable" | ||
| ''' | | '''identity:''' | ||
| | | [[wikipedia:Identity matrix|Identity matrix]] | ||
|- | |||
| '''gambatte:''' | |||
| Gambatte / higan / ares | |||
|- | |- | ||
| '''gba:''' | | '''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:''' | | '''gbc:''' | ||
| Game Boy Color | | Game Boy Color (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531]) | ||
|- | |- | ||
| ''' | | '''gbi:''' | ||
| Gameboy Hi-Colour Convertor | | 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:''' | | '''nds:''' | ||
| [ | | Nintendo DS (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531]) | ||
|- | |- | ||
| '''palm:''' | | '''palm:''' | ||
| | | Palm Treo 700p (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531]) | ||
|- | |- | ||
| '''psp:''' | | '''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> | ; {{anchor|--input-gamma}}<code>--input-gamma=<red[:green[:blue]]></code> | ||
: Set gamma (default: 2.2). | : 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> | ; {{anchor|--output-gamma}}<code>--output-gamma=<1.0|1.7|2.2></code> | ||
: Specify screen gamma (default: 2.2). | : Specify screen gamma (default: 2.2). | ||
Line 184: | Line 208: | ||
; {{anchor|--contrast}}<code>--contrast=<red[:green[:blue]]></code> | ; {{anchor|--contrast}}<code>--contrast=<red[:green[:blue]]></code> | ||
: Set gain (default: 1.0). | : 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> | ; {{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). | : Set video format. The default is the Video Mode system setting (ntsc, pal-60, pal-m). |
Latest revision as of 22:43, 18 June 2024
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 forprogressive
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.