GC-Forever Wiki - User contributions [en]

Game Boy Interface/Standard Edition

2018-12-11T21:08:33Z

Eatnumber1: /* Options */ Expand docs on paths. You can specify 'carda:' / 'cardb:'

{{:Game Boy Interface}}
The author's original vision, '''Game Boy Interface Standard Edition''' ('''GBI''') features an advanced video renderer exercising the GameCube hardware to its fullest.

<div class="toclimit-4">
__TOC__
</div>

== Controls ==

=== On-screen display ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons
| Hide on-screen display
|-
|
| X Button
| X Button
| Toggle on-screen display
|-
|
| Y Button
| Y Button
| Revert offset/zoom
|-
|
| Z Button
| Z Button
| Take screenshot
|-
|
| Start/Pause (Hold for 1 second)
| Start/Pause (Hold for 1 second)
| Exit
|-
|
| +Control Pad
| +Control Pad
| Offset
|-
|
| L/R Buttons
| L/R Buttons
| Zoom
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
| Reset Button
|
|
| Save movie
|}

=== In-game ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| X Button
| X Button
| Toggle on-screen display
|-
|
| Y Button
| Y Button
| Turbo
|-
|
| Z Button
| Z Button
| Select
|-
|
| Start/Pause
| Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R Buttons
| L/R Buttons
| L/R Buttons (Only for Game Boy Advance)
|-
| Reset Button
|
|
| Power Switch
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
| Top Right
| Blue or Orange Square
| +Control Pad Right
|-
| Top Left
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|}

== Options ==

; <code>--aspect=<w:h></code>
: Specify screen aspect ratio. The default is the Progressive Scan Mode system setting (4:3 or 16:9).
; <code>--offset=<x:y></code>
: Set offset. The default is the Screen Position system setting (-32 to +32).
; <code>--zoom=<x:y></code>
: Set zoom. The default is the Game Boy Player Start-up Disc's Screen Size setting (2.0 or 2.375).
; <code>--rotate=<0-359></code>
: Set rotation (default: 0).
; <code>--poll=<0-11></code>
: Set controller polling rate.
: {| 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
|}
; <code>--turbo=<on:off></code>
: Set autofire interval (default: 3).
; <code>--movie=<path></code>, <code>--no-movie</code>
: Play input log (default: no).
; <code>--movie-record</code>, <code>--no-movie-record</code>
: Record input log (default: no).
; <code>--overlay=<path></code>, <code>--no-overlay</code>
: Load texture palette (default: frame.tpl.gz).
; <code>--overlay-id=<ID></code>
: Set texture palette index. The default is the Game Boy Player Start-up Disc's Frame setting (0 to 19).
; <code>--overlay-scale=<x:y></code>
: Set texture scale (default: auto).
; <code>--filter=<none|scale2x[ex|plus]|eagle2x|scan2x|normal2x|normalnx></code>
: Set image doubling filter (default: normalnx).
; <code>--dither=<none|threshold|bayer8x8|bayer4x4|bayer2x2|cluster8x8|cluster4x4></code>
: Set dithering algorithm (default: threshold).
; <code>--scaler=<nearest|bilinear|oversample|box></code>
: Set image scaling filter (default: bilinear).
; <code>--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba></code>
: Set color matrix (default: gbi).
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gba:'''
| [[#Game Boy Advance|Game Boy Advance]] (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
|-
| '''nds:'''
| [[#Nintendo DS|Nintendo DS]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| [[#Palm Treo 700p|Palm Treo 700p]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| [[#PlayStation Portable|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])
|}
; <code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
; <code>--output-gamma=<1.0|1.7|2.2></code>
: Specify screen gamma (default: 2.2).
; <code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
; <code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; <code>--volume=<left[:right]></code>
: Set audio gain (default: 0.75).
; <code>--sound=<[mono|stereo][,digital|analog]></code>
: Set sound mode. The default is the Sound Mode system setting (mono or stereo).
:; <code>digital</code>
:: Use PWM decoder.
:; <code>analog[=<a0:a1:a2:b1:b2>]</code>
:: Use 2MHz biquad filter (default). Defaults to a second-order low-pass filter with a cut-off of 10kHz and a quality factor of √2 if not specified.
; <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 and 60Hz Mode system setting (ntsc, pal or pal-60, pal-m).
; <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 interlace
|-
| '''quasi-interlace:'''
| 15 or 18-22kHz segmented frame
|-
| '''non-interlace:'''
| 15 or 18-22kHz progressive
|-
| '''non-progressive:'''
| 31 or 27-33kHz interlace
|-
| '''progressive:'''
| 31 or 36-45kHz progressive
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> modes. Disabling halves the refresh rate for <code>progressive</code> modes.
:: This only works with the Component Video Cable.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2x video oversampling (default: auto). Enabling halves the refresh rate.
:: This only works with the Component Video Cable.
; <code>--osd</code>, <code>--no-osd</code>
: Show on-screen display (default: yes).
; <code>--ipv4-address=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 address.
; <code>--ipv4-gateway=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 gateway.
; <code>--ipv4-netmask=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 netmask.
; <code>--network</code>, <code>--no-network</code>
: Enable [[Broadband Adapter]] features (default: yes).
; <code>--stream[=<aaa.bbb.ccc.ddd>]</code>, <code>--no-stream</code>
: Stream video to IP address on UDP port 1234 (default: no). Defaults to 255.255.255.255 if not specified.
; <code>--enhance</code>, <code>--no-enhance</code>
: Enable Game Boy Player enhancements (default: yes).
: {| class="wikitable sortable"
! Title
! Feature(s)
|-
| ''[[wikipedia:Drill Dozer|Drill Dozer]]''
| Rumble
|-
| ''[[wikipedia:Game Boy Advance Video|Game Boy Advance Video]] Series''
| [[#Can I play Game Boy Advance Video?|Not compatible]]
|-
| ''[[wikipedia:Mario & Luigi: Superstar Saga|Mario & Luigi: Superstar Saga]]''
| Rumble, [[#Mario & Luigi: Superstar Saga|reduced contrast]]
|-
| ''[[wikipedia:Pokémon Pinball: Ruby & Sapphire|Pokémon Pinball: Ruby & Sapphire]]''
| Rumble
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kanji Keisanhen''
| Rumble, restored contrast
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kokugo Sansuu Shakai Rikahen''
| Rumble, restored contrast
|-
| ''[[wikipedia:Super Mario Advance 4: Super Mario Bros. 3|Super Mario Advance 4: Super Mario Bros. 3]]''
| Rumble, [[#Super Mario Bros. 3: Super Mario Advance 4|restored gamma]]
|}
: Note: Remove any accessory from the External Extension Connector, or the Rumble Feature will not work.
: Note: If you are using an EverDrive, make sure to turn off "Quick Boot" in the options, or the enhancements may not work.
; <code><path></code>
: Load Game Boy Advance multiboot ROM (default: default.mb.gz).
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.

Any file path can be relative or absolute. If relative, it is relative to <code>/GBI</code>. They can also explicitly specify the SD card to read from by prefixing an absolute path with <code>carda:</code> or <code>cardb:</code>

== Comparisons ==

=== Video quality ===

==== Blackmagic Intensity Shuttle ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7180.pdf ADV7180] and [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7604.pdf ADV7604].

<gallery widths="240px" heights="160px">
File:GBI ADV7180 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI ADV7180 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI ADV7180 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI ADV7180 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
File:GBI ADV7604 HDRV.png|HD Retrovision Component Video Cable
File:GBI ADV7604 Component.png|Nintendo Component Video Cable
File:GBI ADV7604 GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI ADV7604 GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Datapath VisionRGB ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/AD9887A.pdf AD9887A].

<gallery widths="240px" heights="160px">
File:GBI AD9887A HDRV.png|HD Retrovision Component Video Cable
File:GBI AD9887A Component.png|Nintendo Component Video Cable
File:GBI AD9887A GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI AD9887A GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Hauppauge WinTV-HVR-1850 ====

Using [https://web.archive.org/web/20120509222042/http://conexant.com/servlets/DownloadServlet/PBR-200974-004.pdf?docid=975&revid=4 CX23888].

<gallery widths="240px" heights="160px">
File:GBI CX23888 NTSC.png|Nintendo RF Modulator (NTSC-J)
File:GBI CX23888 PAL-M.png|Nintendo RF Modulator (PAL-M)
File:GBI CX23888 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI CX23888 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI CX23888 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI CX23888 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
</gallery>

=== Sound emulation ===

==== ''Mega Man Zero 2'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gbp.flac Game Boy Player Start-up Disc]

==== ''Pokémon Sapphire'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gbp.flac Game Boy Player Start-up Disc]

=== Image doubling ===

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE None.png|None
File:GBI AXPE Scale2xEx.png|Scale2×Ex
File:GBI AXPE Scale2xPlus.png|Scale2×Plus
File:GBI AXPE Scale2x.png|Scale2×
File:GBI AXPE Eagle2x.png|Eagle2×
File:GBI AXPE Scan2x.png|Scan2×
File:GBI AXPE Normal2x.png|Normal2×
</gallery>

=== Color matrix ===

==== ''Golden Sun'' ====

<gallery widths="240px" heights="160px">
File:GBI AGSE Identity.png|Identity matrix
File:GBI AGSE GBA.png|Game Boy Advance
File:GBI AGSE GBC.png|Game Boy Color
File:GBI AGSE GBI.png|Game Boy Interface
File:GBI AGSE NDS.png|Nintendo DS
File:GBI AGSE Palm.png|Palm Treo 700p
File:GBI AGSE PSP.png|PlayStation Portable
File:GBI AGSE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Mario Kart: Super Circuit'' ====

<gallery widths="240px" heights="160px">
File:GBI AMKE Identity.png|Identity matrix
File:GBI AMKE GBA.png|Game Boy Advance
File:GBI AMKE GBC.png|Game Boy Color
File:GBI AMKE GBI.png|Game Boy Interface
File:GBI AMKE NDS.png|Nintendo DS
File:GBI AMKE Palm.png|Palm Treo 700p
File:GBI AMKE PSP.png|PlayStation Portable
File:GBI AMKE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity.png|Identity matrix
File:GBI AXPE GBA.png|Game Boy Advance
File:GBI AXPE GBC.png|Game Boy Color
File:GBI AXPE GBI.png|Game Boy Interface
File:GBI AXPE NDS.png|Nintendo DS
File:GBI AXPE Palm.png|Palm Treo 700p
File:GBI AXPE PSP.png|PlayStation Portable
File:GBI AXPE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''The Legend of Zelda: The Minish Cap'' ====

<gallery widths="240px" heights="160px">
File:GBI BZME Identity.png|Identity matrix
File:GBI BZME GBA.png|Game Boy Advance
File:GBI BZME GBC.png|Game Boy Color
File:GBI BZME GBI.png|Game Boy Interface
File:GBI BZME NDS.png|Nintendo DS
File:GBI BZME Palm.png|Palm Treo 700p
File:GBI BZME PSP.png|PlayStation Portable
File:GBI BZME VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Wario Land 4'' ====

<gallery widths="240px" heights="160px">
File:GBI AWAE Identity.png|Identity matrix
File:GBI AWAE GBA.png|Game Boy Advance
File:GBI AWAE GBC.png|Game Boy Color
File:GBI AWAE GBI.png|Game Boy Interface
File:GBI AWAE NDS.png|Nintendo DS
File:GBI AWAE Palm.png|Palm Treo 700p
File:GBI AWAE PSP.png|PlayStation Portable
File:GBI AWAE VBA.png|VisualBoyAdvance-M
</gallery>

== Examples ==

=== Color emulation ===

==== Game Boy Advance ====

[[File:GBI_Game_Boy_Advance.png|border|right]]
Using a contrast ratio of 250:1.

<pre>
--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177
</pre>

==== Nintendo DS ====

[[File:GBI_Nintendo_DS.png|border|right]]
Using a contrast ratio of 600:1.

<pre>
--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934
</pre>

==== Palm Treo 700p ====

[[File:GBI_Palm_Treo_700p.png|border|right]]
Using a contrast ratio of 75:1.

<pre>
--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364
</pre>

==== PlayStation Portable ====

[[File:GBI_PlayStation_Portable.png|border|right]]
Using a contrast ratio of 750:1.

<pre>
--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556
</pre>

=== Color restoration ===

==== ''Mario & Luigi: Superstar Saga'' ====

This game reduces contrast when played ''with'' Game Boy Player enhancements.

<pre>
--contrast=1.1
</pre>

==== ''Super Mario Bros. 3: Super Mario Advance 4'' ====

This game reduces gamma when played ''without'' Game Boy Player enhancements.

<pre>
--input-gamma=2.8
</pre>

==== ''The Legend of Zelda: Oracle of Ages/Seasons'' ====

This game reduces gamma when played on a Game Boy Advance.
Due to Game Boy Color limitations, only shadows can be restored perfectly.

<pre>
--input-gamma=4.
</pre>

=== Mimicking ===

==== Game Boy Player Start-up Disc ====

Included as <code>gbi.cli.example</code>.

<pre>
--aspect=4:3
--overlay=frame-srgb.tpl.gz
--dither=none
--matrix=identity
--input-gamma=1.
--output-gamma=1.
--contrast=.78125
--sound=analog=.000148021979839541018009185791015625:.00029604395967908203601837158203125:.000148021979839541018009185791015625:-1.965293407440185546875:.965885460376739501953125
--no-osd
</pre>

==== Wii U Virtual Console ====

<pre>
--aspect=16:9
--zoom=3
--no-overlay
--dither=none
--matrix=identity
--input-gamma=1.
--output-gamma=1.
--contrast=.75
--sound=digital
--no-osd
--no-enhance
</pre>

=== Video optimization ===

==== Datapath VisionRGB ====

The author's personal setup.

<pre>
--aspect=4:3
--offset=0
--zoom=4
--dither=bayer2x2
--scaler=nearest
--format=hd60
--scan-mode=non-interlace,clock2x,size2x
</pre>

* Resolution and Refresh
** Width: 960
** Height: 360
** Vertical Refresh: 60.00
* Video Adjustments
** Horizontal Position: 205
** Horizontal Size: 1200
** Phase: 31
** Vertical Position: 13
** Black Level: 8
* Cropping
** Top: 20
** Left: 0
** Width: 960
** Height: 320
* Color Adjustments
** Brightness: 32
** Contrast: 128
** Colour Domain: YUV (601)
** Colour Balance
*** All Colors
**** Brightness: 32
**** Contrast: 128
*** Red
**** Brightness: 158
**** Contrast: 158
*** Green
**** Brightness: 178
**** Contrast: 178
*** Blue
**** Brightness: 152
**** Contrast: 152

==== Open Source Scan Converter ====

<pre>
--aspect=4:3
--offset=0
--zoom=4
--filter=none
--scaler=nearest
--format=hd60
--scan-mode=non-interlace
</pre>

==== High-definition televisions ====

Change the Aspect Ratio on the television to Just Scan.

<pre>
--aspect=1.8
--zoom=3.375
--format=hd60
--scan-mode=non-progressive
</pre>

==== Video capture devices (Game Boy Advance) ====

<pre>
--aspect=3:2
--offset=0
--zoom=3
--dither=bayer2x2
--scaler=nearest
--format=ntsc
</pre>

==== Video capture devices (Game Boy Color) ====

<pre>
--aspect=5:4
--offset=0
--zoom=4
--dither=bayer2x2
--scaler=nearest
--format=pal
</pre>

== FAQs ==

=== How do I change Game Paks? ===

# Hold the Reset Button.
# Slide the Game Pak Ejector.
# Insert a Game Pak into the Game Pak Slot.
# Release the Reset Button.

=== Can I play [[wikipedia:Game Boy Advance Video|Game Boy Advance Video]]? ===

Yes. You can do so by disabling Game Boy Player enhancements (<code>--no-enhance</code>), or holding a direction while the Game Boy Player logo is visible.

=== Is this an emulator? Can I play ROMs? ===

No, but there's [[Enhanced mGBA]] if you're looking for one.

=== Why is there motion blur? Can I turn it off? ===

It removes stuttering caused by mismatches between the Game Boy Advance and the display refresh rate. It cannot be turned off. It can be reduced by using a 120Hz mode, but it's most effective on a sample-and-hold display.

=== What happens when I exit Game Boy Interface? ===

The Game Boy Player keeps running and you're returned to <code>autoexec.dol</code>, or the Nintendo GameCube Main Menu.

== Changelog ==

=== December, 2018 ===

* Fixed 360p RGBcvS sync issue.

=== October, 2018 ===

* Added HD Custom video format.

=== August, 2018 ===

* Updated color matrices by Pokefan531.

=== July, 2018 ===

* Updated GBA-as-GC controller.

=== June, 2018 ===

* Added analog sound emulation.
* Added Custom-M video format.
* Added Custom interlaced video modes.
* Changed default sound mode to analog.
* Changed brightness/contrast controls to match BT.1886.
* Fixed some audio bugs.
* Enabled progressive scan in more cases to prevent display issues.

=== May, 2018 ===

* Added 360p, 720i, 720p and 1080i video modes.
* Changed scan mode semantics.
* Changed default aspect ratio for progressive scan to 16:9.
* Fixed Game Boy Player advertisement.
* Fixed rumble protocol handshake.

=== April, 2018 ===

* Added movie recording/playback.
* Updated GBA-as-GC controller.

=== March, 2018 ===

* Improved multiboot implementation.
* Improved Game Boy sound quality.
* Improved audio rendering.
* Reduced audio latency.
* Changed default color matrix to GBI's original.
* Fixed SD card compatibility.
* Fixed multiboot to rumble protocol transition.

=== February, 2018 ===

* Added color matrix from Gambatte.
* Added mono sound mode.
* Fixed wiiload autoboot with tiny GBA multiboot ROMs.
* Disabled machine checks.

=== January, 2018 ===

* Updated color matrices by Pokefan531.
* Improved Game Boy Player driver.

=== September, 2017 ===

* Added overlay scale setting.
* Added Logitech Speed Force support.
* Added Active Life Mat support.
* Improved Game Boy Player driver.
* Changed wiiload server to accept oversized DOLs.
* Fixed one random kernel crash.

=== August, 2017 ===

* Added DK Bongos support.
* Updated color matrices by Pokefan531.
* Improved Game Boy Player driver.

=== July, 2017 ===

* Added CLI append support.
* Updated color matrices by Pokefan531.
* Updated GBA-as-GC controller.

=== April, 2017 ===

* Added component video DAC oversampling.
* Added experimental 960i and 1152i video modes.

=== March, 2017 ===

* Added temporal/spatial dithering.
* Added color matrices by Pokefan531.
* Added TPL overlay support to wiiload server.
* Changed default color matrix to Pokefan531's.
* Changed default gamma to 2.2.
* Optimized NormalNx filter.

=== February, 2017 ===

* Added volume control.
* Added per-channel settings where possible.
* Changed volume to 75% to mitigate clipping.
* Fixed framebuffer clearing for 576i.

=== November, 2016 ===

* Updated GBA-as-GC controller.
* Optimized Scale2xEx filter.

=== October, 2016 ===

* Added Scale2xEx and Scale2xPlus filters.
* Added oversample and box scalers.
* Added basic video streaming.
* Added Remote RetroPad support.
* Optimized video rendering.

=== September, 2016 ===

* Added polling rate setting.

=== May, 2016 ===

* Updated GBA-as-GC controller.
* Improved Game Boy Player driver.
* Fixed WaveBird Controllers.

=== April, 2016 ===

* Added GBA multiboot support to wiiload server.
* Added Xboo Communicator.
* Added BIOS/ROM dumper.
* Replaced GBA-as-controller with GBA-as-GC controller.

=== March, 2016 ===

* Added GBA-as-controller support.
* Recognized a half press of the analog triggers.

=== December, 2015 ===

* Expanded video options. Now includes 25, 30, 100 and 120 Hz modes.
* Added gamma-encoded borders for special use.

=== November, 2015 ===

* Added (GZipped) TPL overlay support.
* Added all 20 borders from the Game Boy Player Start-up Disc.

=== October, 2015 ===

* Added Scale2x, Eagle2x, Scan2x and Normal2x filters.

=== August, 2015 ===

* Added executable compression.
* Added return to <code>autoexec.dol</code>.
* Added memory card distribution files.
* Added auto-cropping for Game Boy screenshots.
* Optimized video rendering.
* Reduced coil whine.

=== July, 2015 ===

* Added rumble.
* Added hold to quit.
* Added screenshot saving.
* Added SNTP broadcast listener.
* Changed default video mode to interlaced.
* Fixed Game Boy Player detection.

=== May, 2015 ===

* Changed all 60 Hz modes to have 486 active lines.

=== March, 2015 ===

* Added digital PWM sound.
* Added turbo button.
* Fixed 288p.

[[Category:Homebrew_Software]]

Game Boy Interface/High-Fidelity Edition

2018-12-11T21:08:30Z

Eatnumber1: /* Options */ Accidentally left in obsolete documentation. Remove it.

{{:Game Boy Interface}}
A spiritual successor of the ultra-low latency version, '''Game Boy Interface High-Fidelity Edition''' ('''GBIHF''') aims to provide the best source quality for further processing or archival.

<div class="toclimit-4">
__TOC__
</div>

== Controls ==

=== Type A (two-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Y/Z Buttons
| Y/Z Buttons
| Select
|-
|
| X Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
| Top Right
| Blue or Orange Square
| +Control Pad Right
|-
| Top Left
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|}

=== Type B (one-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| L/Z Buttons
| Y/Z Buttons
| Select
|-
|
| R Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| Y/X Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
|
| Blue or Orange Square
| +Control Pad Right
|-
|
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|-
| Top Left/Right
|
| L/R Buttons
|}

=== Type C (''Super Mario World: Super Mario Advance 2'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| B/Y or X Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Z Button
| Y/Z Buttons
| Select
|-
|
| Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R or A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

=== Type D (''The Legend of Zelda: A Link to the Past'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| Y/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| R Button or Start/Pause
| Y/Z Buttons
| Select
|-
|
| L/Z Buttons
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| X/A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

== Options ==

; <code>--poll=<0-11></code>
: Set controller polling rate.
: {| 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
|}
; <code>--control=<P1[:P2[:P3[:P4]]]></code>
: Set control scheme. The default is the Game Boy Player Start-up Disc's Controller setting (0 or 1).
: {| class="wikitable"
| '''0:'''
| [[#Type A (two-handed)|Type A (two-handed)]]
|-
| '''1:'''
| [[#Type B (one-handed)|Type B (one-handed)]]
|-
| '''2:'''
| [[#Type C (Super Mario World: Super Mario Advance 2)|Type C (''Super Mario World: Super Mario Advance 2'')]]
|-
| '''3:'''
| [[#Type D (The Legend of Zelda: A Link to the Past)|Type D (''The Legend of Zelda: A Link to the Past'')]]
|}
: Note: A Game Boy Advance used as a controller is a Nintendo GameCube Controller.
; <code>--delay-reset=<N></code>
: Set reset delay (default: 0).
; <code>--delay-video=<N></code>
: Set video buffering (default: 1).
; <code>--movie=<path></code>, <code>--no-movie</code>
: Play input log (default: no).
; <code>--movie-record</code>, <code>--no-movie-record</code>
: Record input log (default: no).
; <code>--palette=<xxxx-xxxx-xxxx></code>, <code>--no-palette</code>
: Apply [https://gamefaqs.gamespot.com/snes/588731-super-game-boy/faqs/58647 Super Game Boy] color palette (default: no).
: Note: Press Left + B while the Game Boy logo is visible for proper application on original Game Boy Game Paks.
; <code>--lut3d=<path></code>, <code>--no-lut3d</code>
: Load 32x32x32 lookup table (default: no).
; <code>--lut3d-order=<rgb|gbr|bgr></code>
: Specify lookup table order (default: rgb).
; <code>--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba></code>
: Set color matrix (default: identity).
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gba:'''
| [[#Game Boy Advance|Game Boy Advance]] (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
|-
| '''nds:'''
| [[#Nintendo DS|Nintendo DS]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| [[#Palm Treo 700p|Palm Treo 700p]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| [[#PlayStation Portable|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])
|}
; <code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
; <code>--output-gamma=<value></code>
: Specify screen gamma (default: 2.2).
; <code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
; <code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; <code>--volume=<left[:right]></code>
: Set audio gain (default: 0.75).
; <code>--sound=<[mono|stereo][,digital|analog]></code>
: Set sound mode. The default is the Sound Mode system setting (mono or stereo).
:; <code>digital</code>
:: Use PWM decoder (default).
:; <code>analog[=<a0:a1:a2:b1:b2>]</code>
:: Use 2MHz biquad filter. Defaults to a second-order low-pass filter with a cut-off of 10kHz and a quality factor of √2 if not specified.
; <code>--colorspace=<ycc601|ycc709|ycc2020|rgb709|rgb2020></code>
: Set video color space (default: ycc601).
: This only works with the Component Video Cable.
: {| class="wikitable"
| '''ycc601:'''
| [[wikipedia:xvYCC|IEC 61966-2-4 xvYCC601]]
|-
| '''ycc709:'''
| [[wikipedia:xvYCC|IEC 61966-2-4 xvYCC709]]
|-
| '''ycc2020:'''
| [[wikipedia:Rec. 2020|ITU-R BT.2020 Y’C’BC’R]]
|-
| '''rgb709:'''
| [[wikipedia:sRGB|IEC 61966-2-1 sRGB]]
|-
| '''rgb2020:'''
| [[wikipedia:Rec. 2020|ITU-R BT.2020 R’G’B’]]
|}
; <code>--format=<ntsc|pal|pal-m|ntsc-50|pal-60|custom|custom-m|hd60|hd50|hd48|hdcustom></code>
: Set video format (default: custom).
; <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 (non-interlace or progressive).
: {| class="wikitable"
| '''interlace:'''
| 15 or 18-22kHz interlace
|-
| '''quasi-interlace:'''
| 15 or 18-22kHz segmented frame
|-
| '''non-interlace:'''
| 15 or 18-22kHz progressive
|-
| '''non-progressive:'''
| 31 or 27-33kHz interlace
|-
| '''progressive:'''
| 31 or 36-45kHz progressive
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> modes. Disabling halves the refresh rate for <code>progressive</code> modes.
:: This only works with the Component Video Cable.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2x video oversampling (default: auto). Enabling halves the refresh rate.
:: This only works with the Component Video Cable.
; <code>--usb</code>, <code>--no-usb</code>
: Enable [[USBGecko|USB Gecko]] features (default: yes).
; <code>--enhance</code>, <code>--no-enhance</code>
: Enable Game Boy Player enhancements (default: yes).
: {| class="wikitable sortable"
! Title
! Feature(s)
|-
| ''[[wikipedia:Drill Dozer|Drill Dozer]]''
| Rumble
|-
| ''[[wikipedia:Game Boy Advance Video|Game Boy Advance Video]] Series''
| [[#Can I play Game Boy Advance Video?|Not compatible]]
|-
| ''[[wikipedia:Mario & Luigi: Superstar Saga|Mario & Luigi: Superstar Saga]]''
| Rumble, [[#Mario & Luigi: Superstar Saga|reduced contrast]]
|-
| ''[[wikipedia:Pokémon Pinball: Ruby & Sapphire|Pokémon Pinball: Ruby & Sapphire]]''
| Rumble
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kanji Keisanhen''
| Rumble, restored contrast
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kokugo Sansuu Shakai Rikahen''
| Rumble, restored contrast
|-
| ''[[wikipedia:Super Mario Advance 4: Super Mario Bros. 3|Super Mario Advance 4: Super Mario Bros. 3]]''
| Rumble, [[#Super Mario Bros. 3: Super Mario Advance 4|restored gamma]]
|}
: Note: Remove any accessory from the External Extension Connector, or the Rumble Feature will not work.
: Note: If you are using an EverDrive, make sure to turn off "Quick Boot" in the options, or the enhancements may not work.
; <code><path></code>
: Load Game Boy Advance multiboot ROM (default: default.mb.gz).
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.

Any file path can be relative or absolute. If relative, it is relative to <code>/GBI</code>. They can also explicitly specify the SD card to read from by prefixing an absolute path with <code>carda:</code> or <code>cardb:</code>

== Comparisons ==

=== Video quality ===

==== Blackmagic Intensity Shuttle ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7180.pdf ADV7180] and [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7604.pdf ADV7604].

<gallery widths="240px" heights="160px">
File:GBIHF ADV7180 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBIHF ADV7180 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBIHF ADV7180 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBIHF ADV7180 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
File:GBIHF ADV7604 HDRV.png|HD Retrovision Component Video Cable
File:GBIHF ADV7604 Component.png|Nintendo Component Video Cable
File:GBIHF ADV7604 GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBIHF ADV7604 GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Datapath VisionRGB ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/AD9887A.pdf AD9887A].

<gallery widths="240px" heights="160px">
File:GBIHF AD9887A HDRV.png|HD Retrovision Component Video Cable
File:GBIHF AD9887A Component.png|Nintendo Component Video Cable
File:GBIHF AD9887A GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBIHF AD9887A GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Hauppauge WinTV-HVR-1850 ====

Using [https://web.archive.org/web/20120509222042/http://conexant.com/servlets/DownloadServlet/PBR-200974-004.pdf?docid=975&revid=4 CX23888].

<gallery widths="240px" heights="160px">
File:GBIHF CX23888 NTSC.png|Nintendo RF Modulator (NTSC-J)
File:GBIHF CX23888 PAL-M.png|Nintendo RF Modulator (PAL-M)
File:GBIHF CX23888 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBIHF CX23888 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBIHF CX23888 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBIHF CX23888 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
</gallery>

=== Sound emulation ===

==== ''Mega Man Zero 2'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gbp.flac Game Boy Player Start-up Disc]

==== ''Pokémon Sapphire'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gbp.flac Game Boy Player Start-up Disc]

=== 3D lookup table ===

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity LUT.png|Identity LUT <code>lutrgb.png</code>
File:GBI AXPE GBA Light LUT.png|Game Boy Advance <code>lutrgb-gba-light.png</code>
File:GBI AXPE GBA LUT.png|Game Boy Advance <code>lutrgb-gba.png</code>
File:GBI AXPE GBC LUT.png|Gambatte/higan <code>lutrgb-gbc.png</code>
File:GBI AXPE GBP LUT.png|Game Boy Player Start-up Disc <code>lutrgb-gbp.png</code>
File:GBI AXPE NDS LUT.png|Nintendo DS <code>lutrgb-nds.png</code>
File:GBI AXPE VBA LUT.png|VisualBoyAdvance-M <code>lutrgb-vba.png</code>
File:GBI AXPE WiiU LUT.png|Wii U Virtual Console <code>lutrgb-wiiu.png</code>
</gallery>

=== Color matrix ===

==== ''Golden Sun'' ====

<gallery widths="240px" heights="160px">
File:GBI AGSE Identity.png|Identity matrix
File:GBI AGSE GBA.png|Game Boy Advance
File:GBI AGSE GBC.png|Game Boy Color
File:GBI AGSE GBI.png|Game Boy Interface
File:GBI AGSE NDS.png|Nintendo DS
File:GBI AGSE Palm.png|Palm Treo 700p
File:GBI AGSE PSP.png|PlayStation Portable
File:GBI AGSE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Mario Kart: Super Circuit'' ====

<gallery widths="240px" heights="160px">
File:GBI AMKE Identity.png|Identity matrix
File:GBI AMKE GBA.png|Game Boy Advance
File:GBI AMKE GBC.png|Game Boy Color
File:GBI AMKE GBI.png|Game Boy Interface
File:GBI AMKE NDS.png|Nintendo DS
File:GBI AMKE Palm.png|Palm Treo 700p
File:GBI AMKE PSP.png|PlayStation Portable
File:GBI AMKE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity.png|Identity matrix
File:GBI AXPE GBA.png|Game Boy Advance
File:GBI AXPE GBC.png|Game Boy Color
File:GBI AXPE GBI.png|Game Boy Interface
File:GBI AXPE NDS.png|Nintendo DS
File:GBI AXPE Palm.png|Palm Treo 700p
File:GBI AXPE PSP.png|PlayStation Portable
File:GBI AXPE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''The Legend of Zelda: The Minish Cap'' ====

<gallery widths="240px" heights="160px">
File:GBI BZME Identity.png|Identity matrix
File:GBI BZME GBA.png|Game Boy Advance
File:GBI BZME GBC.png|Game Boy Color
File:GBI BZME GBI.png|Game Boy Interface
File:GBI BZME NDS.png|Nintendo DS
File:GBI BZME Palm.png|Palm Treo 700p
File:GBI BZME PSP.png|PlayStation Portable
File:GBI BZME VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Wario Land 4'' ====

<gallery widths="240px" heights="160px">
File:GBI AWAE Identity.png|Identity matrix
File:GBI AWAE GBA.png|Game Boy Advance
File:GBI AWAE GBC.png|Game Boy Color
File:GBI AWAE GBI.png|Game Boy Interface
File:GBI AWAE NDS.png|Nintendo DS
File:GBI AWAE Palm.png|Palm Treo 700p
File:GBI AWAE PSP.png|PlayStation Portable
File:GBI AWAE VBA.png|VisualBoyAdvance-M
</gallery>

== Examples ==

=== Color emulation ===

==== Game Boy Advance ====

[[File:GBI_Game_Boy_Advance.png|border|right]]
Using a contrast ratio of 250:1.

<pre>
--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177
</pre>

==== Nintendo DS ====

[[File:GBI_Nintendo_DS.png|border|right]]
Using a contrast ratio of 600:1.

<pre>
--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934
</pre>

==== Palm Treo 700p ====

[[File:GBI_Palm_Treo_700p.png|border|right]]
Using a contrast ratio of 75:1.

<pre>
--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364
</pre>

==== PlayStation Portable ====

[[File:GBI_PlayStation_Portable.png|border|right]]
Using a contrast ratio of 750:1.

<pre>
--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556
</pre>

=== Color restoration ===

==== ''Mario & Luigi: Superstar Saga'' ====

This game reduces contrast when played ''with'' Game Boy Player enhancements.

<pre>
--contrast=1.1
</pre>

==== ''Super Mario Bros. 3: Super Mario Advance 4'' ====

This game reduces gamma when played ''without'' Game Boy Player enhancements.

<pre>
--input-gamma=2.8
</pre>

==== ''The Legend of Zelda: Oracle of Ages/Seasons'' ====

This game reduces gamma when played on a Game Boy Advance.
Due to Game Boy Color limitations, only shadows can be restored perfectly.

<pre>
--input-gamma=4.
</pre>

=== Video optimization ===

==== Datapath VisionRGB (Component Video Cable) ====

<pre>
--colorspace=rgb709
--scan-mode=non-interlace,clock2x,size2x
</pre>

* Resolution and Refresh
** Width: 360
** Height: 240
** Vertical Refresh: 59.72
* Video Adjustments
** Horizontal Position: 65
** Horizontal Size: 433
** Phase: 27
** Vertical Position: 18
** Black Level: 8
* Cropping
** Top: 40
** Left: 60
** Width: 240
** Height: 160
* Color Adjustments
** Brightness: 32
** Contrast: 128
** Colour Domain: RGB (601)
** Colour Balance
*** All Colors
**** Brightness: 32
**** Contrast: 128
*** Red
**** Brightness: 156
**** Contrast: 156
*** Green
**** Brightness: 166
**** Contrast: 166
*** Blue
**** Brightness: 148
**** Contrast: 148

==== Open Source Scan Converter ====

Included as <code>gbihf-ossc.cli</code>, <code>gbihf-ossc.dol+cli</code> and <code>gbihf-ossc.gci</code>.

<pre>
--format=hd60
--scan-mode=non-interlace
</pre>

==== XRGB-mini Framemeister ====

Included as <code>gbihf-xrgb.cli</code>, <code>gbihf-xrgb.dol+cli</code> and <code>gbihf-xrgb.gci</code>.
Refer to [http://www.firebrandx.com/framemeisterprofiles.html FirebrandX] for configuration.

<pre>
--format=custom-m
--scan-mode=non-interlace
</pre>

==== High-definition televisions ====

Change the Aspect Ratio on the television to Zoom 1.

<pre>
--colorspace=ycc709
--format=hd60
--scan-mode=non-progressive
</pre>

== FAQs ==

=== How do I change Game Paks? ===

# Hold the Reset Button.
# Slide the Game Pak Ejector.
# Insert a Game Pak into the Game Pak Slot.
# Release the Reset Button.

=== Can I play [[wikipedia:Game Boy Advance Video|Game Boy Advance Video]]? ===

Yes. You can do so by disabling Game Boy Player enhancements (<code>--no-enhance</code>), or holding a direction while the Game Boy Player logo is visible.

=== Is this an emulator? Can I play ROMs? ===

No, but there's [[Enhanced mGBA]] if you're looking for one.

== Changelog ==

=== December, 2018 ===

* Fixed 360p RGBcvS sync issue.

=== October, 2018 ===

* Added HD Custom video format.

=== August, 2018 ===

* Updated color matrices by Pokefan531.

=== July, 2018 ===

* Updated GBA-as-GC controller.

=== June, 2018 ===

* Added analog sound emulation.
* Added video options.
* Added component video DAC oversampling.
* Changed brightness/contrast controls to match BT.1886.
* Fixed some audio bugs.
* Removed left/right chroma location support.

=== May, 2018 ===

* Added Super Game Boy color palette setting.
* Changed default chroma location to center.
* Fixed Game Boy Player advertisement.
* Fixed rumble protocol handshake.

=== April, 2018 ===

* Added movie recording/playback.
* Updated GBA-as-GC controller.

=== March, 2018 ===

* Added RGB Sync-on-Green support.
* Added xvYCC/BT.2020 support for auto-generated 3D LUT.
* Added control swapping for SNES Controllers.
* Added center/right chroma location support.
* Improved multiboot implementation.
* Fixed SD card compatibility.
* Fixed multiboot to rumble protocol transition.

== Media ==

* [https://www.youtube.com/watch?v=SN-r2bl7bV8 Console Verified: GBC Pokémon: Blue Version "warp glitch" by gifvex in 10:11.25]
* [https://www.youtube.com/watch?v=i8ROeArTVyQ Console Verified: GBC Pokémon: Blue Version "Gotta Catch 'Em All!" by luckytyphlosion in 37:54.11]
* [https://www.youtube.com/watch?v=40z__x55Ix0 Console Verified: GBA Sonic Advance by Mukki & ruadath in 10:49.75]
* [https://www.youtube.com/watch?v=VqPV513Fd9w Console Verified: GBA Sonic Advance by Mukki in 11:02.64]
* [https://www.youtube.com/watch?v=kZSfK7u3P2Y Console Verified: GBA Sonic Advance 2 by Mukki in 18:09.45]
* [https://www.youtube.com/watch?v=F6t0fdHay_o Console Verified: GBC Pokémon: Yellow Version by TiKevin83 in 1:36:34.55]

[[Category:Homebrew_Software]]

Game Boy Interface/Speedrunning Edition

2018-12-11T21:07:56Z

Eatnumber1: /* Options */ Expand docs on paths. You can specify 'carda:' / 'cardb:'

{{:Game Boy Interface}}
Formerly the (ultra-)low latency version, '''Game Boy Interface Speedrunning Edition''' ('''GBISR''') features a simplified video renderer, and aims to meet the needs of most [[wikipedia:Speedrun|speedrunning]] communities.

<div class="toclimit-4">
__TOC__
</div>

== Controls ==

=== Type A (two-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Y/Z Buttons
| Y/Z Buttons
| Select
|-
|
| X Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|-
|
| C Stick Down
|
| Toggle input viewer
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
| Top Right
| Blue or Orange Square
| +Control Pad Right
|-
| Top Left
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|}

=== Type B (one-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| L/Z Buttons
| Y/Z Buttons
| Select
|-
|
| R Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| Y/X Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
|
| Blue or Orange Square
| +Control Pad Right
|-
|
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|-
| Top Left/Right
|
| L/R Buttons
|}

=== Type C (''Super Mario World: Super Mario Advance 2'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| B/Y or X Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Z Button
| Y/Z Buttons
| Select
|-
|
| Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R or A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|-
|
| C Stick Down
|
| Toggle input viewer
|}

=== Type D (''The Legend of Zelda: A Link to the Past'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| Y/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| R Button or Start/Pause
| Y/Z Buttons
| Select
|-
|
| L/Z Buttons
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| X/A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

== Options ==

; <code>--offset=<x:y></code>
: Set offset (default: 0).
; <code>--zoom=<x:y></code>
: Set zoom (default: 2.0).
; <code>--rotate=<0-359></code>
: Set rotation (default: 0).
; <code>--poll=<0-11></code>
: Set controller polling rate.
: {| 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
|}
; <code>--control=<P1[:P2[:P3[:P4]]]></code>
: Set control scheme. The default is the Game Boy Player Start-up Disc's Controller setting (0 or 1).
: {| class="wikitable"
| '''0:'''
| [[#Type A (two-handed)|Type A (two-handed)]]
|-
| '''1:'''
| [[#Type B (one-handed)|Type B (one-handed)]]
|-
| '''2:'''
| [[#Type C (Super Mario World: Super Mario Advance 2)|Type C (''Super Mario World: Super Mario Advance 2'')]]
|-
| '''3:'''
| [[#Type D (The Legend of Zelda: A Link to the Past)|Type D (''The Legend of Zelda: A Link to the Past'')]]
|}
: Note: A Game Boy Advance used as a controller is a Nintendo GameCube Controller.
; <code>--delay-reset=<N></code>
: Set reset delay (default: 75).
; <code>--delay-video=<N></code>
: Set video buffering (default: 1).
; <code>--movie=<path></code>, <code>--no-movie</code>
: Play input log (default: no).
; <code>--movie-record</code>, <code>--no-movie-record</code>
: Record input log (default: no).
; <code>--overlay=<path></code>, <code>--no-overlay</code>
: Load texture palette (default: frame-srgb.tpl.gz).
; <code>--overlay-id=<ID></code>
: Set texture palette index. The default is the Game Boy Player Start-up Disc's Frame setting (0 to 19).
; <code>--overlay-scale=<x:y></code>
: Set texture scale (default: auto).
; <code>--palette=<xxxx-xxxx-xxxx></code>, <code>--no-palette</code>
: Apply [https://gamefaqs.gamespot.com/snes/588731-super-game-boy/faqs/58647 Super Game Boy] color palette (default: no).
: Note: Press Left + B while the Game Boy logo is visible for proper application on original Game Boy Game Paks.
; <code>--lut3d=<path></code>, <code>--no-lut3d</code>
: Load 32x32x32 lookup table (default: no).
; <code>--lut3d-order=<rgb|gbr|bgr></code>
: Specify lookup table order (default: rgb).
; <code>--scaler=<nearest|bilinear|oversample|box></code>
: Set image scaling filter (default: nearest).
; <code>--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba></code>
: Set color matrix (default: identity).
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gba:'''
| [[#Game Boy Advance|Game Boy Advance]] (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
|-
| '''nds:'''
| [[#Nintendo DS|Nintendo DS]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| [[#Palm Treo 700p|Palm Treo 700p]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| [[#PlayStation Portable|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])
|}
; <code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
; <code>--output-gamma=<value></code>
: Specify screen gamma (default: 2.2).
; <code>--gamma=<even[:odd]></code>
: Set gamma correction (default: 1.0).
; <code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
; <code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; <code>--blend=<value></code>
: Set alpha blending (default: 1.0).
; <code>--background=<#rrggbb></code>
: Set background color (default: #000000).
; <code>--vfilter=<middle[:lower[:upper]]></code>
: Set vertical filter coefficients (default: 1.0).
; <code>--volume=<left[:right]></code>
: Set audio gain (default: 0.75).
; <code>--sound=<[mono|stereo][,digital|analog]></code>
: Set sound mode. The default is the Sound Mode system setting (mono or stereo).
:; <code>digital</code>
:: Use PWM decoder (default).
:; <code>analog[=<a0:a1:a2:b1:b2>]</code>
:: Use 2MHz biquad filter. Defaults to a second-order low-pass filter with a cut-off of 10kHz and a quality factor of √2 if not specified.
; <code>--format=<[ntsc|pal|pal-m|ntsc-50|pal-60|custom|custom-m][,offset=<x:y>][,scaled-size=<w:h>][,size=<w:h>]></code>
: Set video format. The default is the Video Mode or Progressive Scan Mode system setting (ntsc, pal-60, pal-m, or custom).
:; <code>offset=<x:y></code>
:: Set screen position. The default is the Screen Position system setting (-32 to +32).
:; <code>scaled-size=<w:h></code>
:: Set screen size (default: auto).
:; <code>size=<w:h></code>
:: Set internal resolution (default: 640:480).
; <code>--scan-mode=<[interlace|quasi-interlace|non-interlace|progressive][,clock2x|no-clock2x][,size2x|no-size2x]></code>
: Set scan mode. The default is the Progressive Scan Mode system setting (non-interlace or progressive).
: {| class="wikitable"
| '''interlace:'''
| 15kHz interlace
|-
| '''quasi-interlace:'''
| 15kHz segmented frame
|-
| '''non-interlace:'''
| 15kHz progressive
|-
| '''progressive:'''
| 31kHz progressive
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> modes. Disabling halves the refresh rate for <code>progressive</code> modes.
:: This only works with the Component Video Cable.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2x video oversampling (default: no). Enabling halves the refresh rate.
:: This only works with the Component Video Cable.
; <code>--osd-input[=<x:y>]</code>, <code>--no-osd-input</code>
: Show input viewer (default: no). Defaults to 0:-64 if not specified.
; <code>--usb</code>, <code>--no-usb</code>
: Enable [[USBGecko|USB Gecko]] features (default: yes).
; <code>--enhance</code>, <code>--no-enhance</code>
: Enable Game Boy Player enhancements (default: no). Enabling this option is not recommended.
: {| class="wikitable sortable"
! Title
! Feature(s)
|-
| ''[[wikipedia:Drill Dozer|Drill Dozer]]''
| Rumble
|-
| ''[[wikipedia:Game Boy Advance Video|Game Boy Advance Video]] Series''
| [[#Can I play Game Boy Advance Video?|Not compatible]]
|-
| ''[[wikipedia:Mario & Luigi: Superstar Saga|Mario & Luigi: Superstar Saga]]''
| Rumble, [[#Mario & Luigi: Superstar Saga|reduced contrast]]
|-
| ''[[wikipedia:Pokémon Pinball: Ruby & Sapphire|Pokémon Pinball: Ruby & Sapphire]]''
| Rumble
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kanji Keisanhen''
| Rumble, restored contrast
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kokugo Sansuu Shakai Rikahen''
| Rumble, restored contrast
|-
| ''[[wikipedia:Super Mario Advance 4: Super Mario Bros. 3|Super Mario Advance 4: Super Mario Bros. 3]]''
| Rumble, [[#Super Mario Bros. 3: Super Mario Advance 4|restored gamma]]
|}
: Note: Remove any accessory from the External Extension Connector, or the Rumble Feature will not work.
: Note: If you are using an EverDrive, make sure to turn off "Quick Boot" in the options, or the enhancements may not work.
; <code><path></code>
: Load Game Boy Advance multiboot ROM. Using this option is not recommended.
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.

Any file path can be relative or absolute. If relative, it is relative to <code>/GBI</code>. They can also explicitly specify the SD card to read from by prefixing an absolute path with <code>carda:</code> or <code>cardb:</code>

== Comparisons ==

=== Video quality ===

==== Blackmagic Intensity Shuttle ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7180.pdf ADV7180] and [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7604.pdf ADV7604].

<gallery widths="240px" heights="160px">
File:GBI ADV7180 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI ADV7180 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI ADV7180 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI ADV7180 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
File:GBI ADV7604 HDRV.png|HD Retrovision Component Video Cable
File:GBI ADV7604 Component.png|Nintendo Component Video Cable
File:GBI ADV7604 GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI ADV7604 GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Datapath VisionRGB ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/AD9887A.pdf AD9887A].

<gallery widths="240px" heights="160px">
File:GBI AD9887A HDRV.png|HD Retrovision Component Video Cable
File:GBI AD9887A Component.png|Nintendo Component Video Cable
File:GBI AD9887A GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI AD9887A GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Hauppauge WinTV-HVR-1850 ====

Using [https://web.archive.org/web/20120509222042/http://conexant.com/servlets/DownloadServlet/PBR-200974-004.pdf?docid=975&revid=4 CX23888].

<gallery widths="240px" heights="160px">
File:GBI CX23888 NTSC.png|Nintendo RF Modulator (NTSC-J)
File:GBI CX23888 PAL-M.png|Nintendo RF Modulator (PAL-M)
File:GBI CX23888 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI CX23888 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI CX23888 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI CX23888 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
</gallery>

=== Sound emulation ===

==== ''Mega Man Zero 2'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gbp.flac Game Boy Player Start-up Disc]

==== ''Pokémon Sapphire'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gbp.flac Game Boy Player Start-up Disc]

=== 3D lookup table ===

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity LUT.png|Identity LUT <code>lutrgb.png</code>
File:GBI AXPE GBA Light LUT.png|Game Boy Advance <code>lutrgb-gba-light.png</code>
File:GBI AXPE GBA LUT.png|Game Boy Advance <code>lutrgb-gba.png</code>
File:GBI AXPE GBC LUT.png|Gambatte/higan <code>lutrgb-gbc.png</code>
File:GBI AXPE GBP LUT.png|Game Boy Player Start-up Disc <code>lutrgb-gbp.png</code>
File:GBI AXPE NDS LUT.png|Nintendo DS <code>lutrgb-nds.png</code>
File:GBI AXPE VBA LUT.png|VisualBoyAdvance-M <code>lutrgb-vba.png</code>
File:GBI AXPE WiiU LUT.png|Wii U Virtual Console <code>lutrgb-wiiu.png</code>
</gallery>

=== Color matrix ===

==== ''Golden Sun'' ====

<gallery widths="240px" heights="160px">
File:GBI AGSE Identity.png|Identity matrix
File:GBI AGSE GBA.png|Game Boy Advance
File:GBI AGSE GBC.png|Game Boy Color
File:GBI AGSE GBI.png|Game Boy Interface
File:GBI AGSE NDS.png|Nintendo DS
File:GBI AGSE Palm.png|Palm Treo 700p
File:GBI AGSE PSP.png|PlayStation Portable
File:GBI AGSE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Mario Kart: Super Circuit'' ====

<gallery widths="240px" heights="160px">
File:GBI AMKE Identity.png|Identity matrix
File:GBI AMKE GBA.png|Game Boy Advance
File:GBI AMKE GBC.png|Game Boy Color
File:GBI AMKE GBI.png|Game Boy Interface
File:GBI AMKE NDS.png|Nintendo DS
File:GBI AMKE Palm.png|Palm Treo 700p
File:GBI AMKE PSP.png|PlayStation Portable
File:GBI AMKE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity.png|Identity matrix
File:GBI AXPE GBA.png|Game Boy Advance
File:GBI AXPE GBC.png|Game Boy Color
File:GBI AXPE GBI.png|Game Boy Interface
File:GBI AXPE NDS.png|Nintendo DS
File:GBI AXPE Palm.png|Palm Treo 700p
File:GBI AXPE PSP.png|PlayStation Portable
File:GBI AXPE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''The Legend of Zelda: The Minish Cap'' ====

<gallery widths="240px" heights="160px">
File:GBI BZME Identity.png|Identity matrix
File:GBI BZME GBA.png|Game Boy Advance
File:GBI BZME GBC.png|Game Boy Color
File:GBI BZME GBI.png|Game Boy Interface
File:GBI BZME NDS.png|Nintendo DS
File:GBI BZME Palm.png|Palm Treo 700p
File:GBI BZME PSP.png|PlayStation Portable
File:GBI BZME VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Wario Land 4'' ====

<gallery widths="240px" heights="160px">
File:GBI AWAE Identity.png|Identity matrix
File:GBI AWAE GBA.png|Game Boy Advance
File:GBI AWAE GBC.png|Game Boy Color
File:GBI AWAE GBI.png|Game Boy Interface
File:GBI AWAE NDS.png|Nintendo DS
File:GBI AWAE Palm.png|Palm Treo 700p
File:GBI AWAE PSP.png|PlayStation Portable
File:GBI AWAE VBA.png|VisualBoyAdvance-M
</gallery>

== Examples ==

=== Color emulation ===

==== Game Boy Advance ====

[[File:GBI_Game_Boy_Advance.png|border|right]]
Using a contrast ratio of 250:1.

<pre>
--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177
</pre>

==== Nintendo DS ====

[[File:GBI_Nintendo_DS.png|border|right]]
Using a contrast ratio of 600:1.

<pre>
--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934
</pre>

==== Palm Treo 700p ====

[[File:GBI_Palm_Treo_700p.png|border|right]]
Using a contrast ratio of 75:1.

<pre>
--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364
</pre>

==== PlayStation Portable ====

[[File:GBI_PlayStation_Portable.png|border|right]]
Using a contrast ratio of 750:1.

<pre>
--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556
</pre>

=== Color restoration ===

==== ''Mario & Luigi: Superstar Saga'' ====

This game reduces contrast when played ''with'' Game Boy Player enhancements.

<pre>
--contrast=1.1
</pre>

==== ''Super Mario Bros. 3: Super Mario Advance 4'' ====

This game reduces gamma when played ''without'' Game Boy Player enhancements.

<pre>
--input-gamma=2.8
</pre>

==== ''The Legend of Zelda: Oracle of Ages/Seasons'' ====

This game reduces gamma when played on a Game Boy Advance.
Due to Game Boy Color limitations, only shadows can be restored perfectly.

<pre>
--input-gamma=4.
</pre>

=== Mimicking ===

==== Game Boy Interface (ultra-low latency) ====

<pre>
--delay-reset=0
--delay-video=0
--no-overlay
--format=custom,scaled-size=528:320,size=480:320
</pre>

==== Game Boy Player Start-up Disc (60Hz) ====

Included as <code>gbisr.cli.example</code>.

<pre>
--delay-video=2
--contrast=.78125
--vfilter=.5:.25:.25
--sound=analog=.000148021979839541018009185791015625:.00029604395967908203601837158203125:.000148021979839541018009185791015625:-1.965293407440185546875:.965885460376739501953125
--format=ntsc,scaled-size=666:448,size=608:448
--scan-mode=interlace
--enhance
</pre>

==== Game Boy Player Start-up Disc (50Hz) ====

<pre>
--delay-reset=65
--delay-video=2
--contrast=.78125
--vfilter=.5:.25:.25
--sound=analog=.000148021979839541018009185791015625:.00029604395967908203601837158203125:.000148021979839541018009185791015625:-1.965293407440185546875:.965885460376739501953125
--format=pal,scaled-size=670:530,size=608:448
--scan-mode=interlace
--enhance
</pre>

==== Nintendo 3DS Virtual Console ====

===== ''F-Zero Maximum Velocity'', ''Fire Emblem: The Sacred Stones'', ''Mario vs. Donkey Kong'' and ''The Legend of Zelda: The Minish Cap'' =====

<pre>
--contrast=.7
--blend=.75
</pre>

===== ''Kirby & The Amazing Mirror'' =====

<pre>
--contrast=.6
--blend=.5625
</pre>

===== ''Mario Kart: Super Circuit'' =====

<pre>
--contrast=.65
--blend=.75
</pre>

===== ''Metroid Fusion'' =====

<pre>
--contrast=.7
--blend=.5625
</pre>

===== ''Wario Land 4'' and ''WarioWare, Inc.: Mega Microgame$'' =====

<pre>
--contrast=.65
--blend=.5625
</pre>

===== ''Yoshi's Island: Super Mario Advance 3'' =====

<pre>
--contrast=.6
--blend=.5
</pre>

=== Video optimization ===

==== Datapath VisionRGB (Component Video Cable) ====

<pre>
--vfilter=.5:.5:.0:.5:.0:.5
--format=custom,offset=0,scaled-size=0
--scan-mode=non-interlace,clock2x
</pre>

* Resolution and Refresh
** Width: 320
** Height: 240
** Vertical Refresh: 119.45
* Video Adjustments
** Horizontal Position: 85
** Horizontal Size: 433
** Phase: 27
** Vertical Position: 18
** Black Level: 8
* Cropping
** Top: 40
** Left: 40
** Width: 240
** Height: 160
* Color Adjustments
** Brightness: 32
** Contrast: 128
** Colour Domain: YUV (601)
** Colour Balance
*** All Colors
**** Brightness: 32
**** Contrast: 128
*** Red
**** Brightness: 158
**** Contrast: 158
*** Green
**** Brightness: 170
**** Contrast: 170
*** Blue
**** Brightness: 152
**** Contrast: 152

==== Open Source Scan Converter ====

Included as <code>gbisr-ossc.cli</code>, <code>gbisr-ossc.dol+cli</code> and <code>gbisr-ossc.gci</code>.
Refer to [http://www.firebrandx.com/gbiosscoptimal.html FirebrandX] for configuration.

<pre>
--vfilter=.5:.5:.0:.5:.0:.5
--format=custom,offset=0,scaled-size=0
--scan-mode=non-interlace
</pre>

==== XRGB-mini Framemeister ====

Included as <code>gbisr-xrgb.cli</code>, <code>gbisr-xrgb.dol+cli</code> and <code>gbisr-xrgb.gci</code>.
Refer to [http://www.firebrandx.com/framemeisterprofiles.html FirebrandX] for configuration.

<pre>
--vfilter=.5:.5:.0:.5:.0:.5
--format=custom-m,offset=0,scaled-size=0
--scan-mode=non-interlace
</pre>

=== Video output ===

==== 120Hz black frame insertion ====

<pre>
--vfilter=.5:.5:.0:.0
--scan-mode=non-interlace,clock2x
</pre>

==== 480p hybrid scanlines ====

<pre>
--overlay=frame.tpl.gz
--gamma=2.2:1.
--scan-mode=progressive
</pre>

==== 480p simple scanlines ====

<pre>
--vfilter=.5:.5:.0:.0
--scan-mode=progressive
</pre>

=== Video scaling ===

==== 4:3 fullscreen (Game Boy Advance) ====

<pre>
--zoom=2.375
--scaler=oversample
--vfilter=.625:.1875:.1875
--scan-mode=interlace
</pre>

==== 4:3 fullscreen (Game Boy Color) ====

<pre>
--zoom=3
--vfilter=.5:.25:.25
--scan-mode=interlace
</pre>

<pre>
--zoom=3
--vfilter=.5:.5:.0:.5:.0:.5
--scan-mode=non-interlace
</pre>

==== 16:9 fullscreen ====

<pre>
--zoom=2:3
--format=size=568
--scan-mode=progressive
</pre>

== FAQs ==

=== How do I change Game Paks? ===

# Hold the Reset Button.
# Slide the Game Pak Ejector.
# Insert a Game Pak into the Game Pak Slot.
# Release the Reset Button.

=== Can I play [[wikipedia:Game Boy Advance Video|Game Boy Advance Video]]? ===

Yes. You can do so by disabling Game Boy Player enhancements (<code>--no-enhance</code>), or holding a direction while the Game Boy Player logo is visible.

=== Is this an emulator? Can I play ROMs? ===

No, but there's [[Enhanced mGBA]] if you're looking for one.

== Changelog ==

=== August, 2018 ===

* Updated color matrices by Pokefan531.

=== July, 2018 ===

* Updated GBA-as-GC controller.
* Disabled component video DAC oversampling.

=== June, 2018 ===

* Added analog sound emulation.
* Added Custom-M video format.
* Added Custom interlaced video modes.
* Merged vertical filter controls.
* Changed brightness/contrast controls to match BT.1886.
* Fixed some audio bugs.
* Enabled progressive scan in more cases to prevent display issues.

=== May, 2018 ===

* Added Super Game Boy color palette setting.
* Changed scan mode semantics.
* Fixed Game Boy Player advertisement.
* Fixed rumble protocol handshake.

=== April, 2018 ===

* Added movie recording/playback.
* Updated GBA-as-GC controller.

=== March, 2018 ===

* Added control swapping for SNES Controllers.
* Added framebuffer size/offset setting.
* Replaced sample aspect ratio with scaled size.
* Improved per-field filtering in single-buffered mode.
* Improved multiboot implementation.
* Improved Game Boy sound quality.
* Improved audio rendering.
* Reduced audio latency.
* Fixed SD card compatibility.
* Fixed multiboot to rumble protocol transition.
* Disabled default multiboot.

=== February, 2018 ===

* Added background color setting.
* Added video buffering setting.
* Added input viewer.
* Added color matrix from Gambatte.
* Added mono sound mode.
* Added 3D LUT auto-generation.
* Added GBR/BGR LUT order support.
* Added per-field gamma correction control.
* Changed some argument semantics.
* Fixed per-field settings with default video mode.
* Fixed wiiload autoboot with tiny GBA multiboot ROMs.
* Disabled machine checks.

=== January, 2018 ===

* Updated LUTs by Pokefan531.
* Improved Game Boy Player driver.
* Changed default component video modes.
* Tweaked control type C.

=== September, 2017 ===

* Added overlay scale setting.
* Added Logitech Speed Force support.
* Added Active Life Mat support.
* Improved Game Boy Player driver.
* Changed zoom scale.
* Changed wiiload server to accept oversized DOLs.
* Fixed one random kernel crash.
* Fixed scaling without a 3D LUT.

=== August, 2017 ===

* Added DK Bongos support.
* Adapted control type C for Super Mario World: Super Mario Advance 2.
* Added control type D for The Legend of Zelda: A Link to the Past.
* Added per-field vertical filter control.
* Added PNG 3D LUT support.
* Added LUTs by Pokefan531.
* Added LUTs from the 3DS Virtual Console.
* Improved Game Boy Player driver.

=== July, 2017 ===

* Added CLI append support.
* Updated GBA-as-GC controller.
* Changed reset combo behavior.

=== June, 2017 ===

* Added zoom & rotate.
* Added reset delay.
* Added reset combo.

=== April, 2017 ===

* Added component video DAC oversampling.
* Added reset fade effect.
* Added TPL overlay support.

=== March, 2017 ===

* Added rumble, disabled by default.
* Added USB Gecko wiiload server.
* Added Xboo Communicator.

=== February, 2017 ===

* Added volume control.
* Added per-channel settings where possible.
* Changed volume to 75% to mitigate clipping.

=== November, 2016 ===

* Updated GBA-as-GC controller.

=== September, 2016 ===

* Added video options.
* Added control schemes.
* Added polling rate setting.

=== May, 2016 ===

* Updated GBA-as-GC controller.
* Improved Game Boy Player driver.
* Fixed WaveBird Controllers.

=== April, 2016 ===

* Replaced GBA-as-controller with GBA-as-GC controller.

=== March, 2016 ===

* Added U+D/L+R cancelling.
* Added GBA-as-controller support.
* Recognized a half press of the analog triggers.

=== August, 2015 ===

* Added executable compression.
* Added memory card distribution files.
* Reduced coil whine.

=== July, 2015 ===

* Fixed Game Boy Player detection.

[[Category:Homebrew_Software]]

Game Boy Interface/High-Fidelity Edition

2018-12-11T21:07:26Z

Eatnumber1: /* Options */ Expand docs on paths. You can specify 'carda:' / 'cardb:'

{{:Game Boy Interface}}
A spiritual successor of the ultra-low latency version, '''Game Boy Interface High-Fidelity Edition''' ('''GBIHF''') aims to provide the best source quality for further processing or archival.

<div class="toclimit-4">
__TOC__
</div>

== Controls ==

=== Type A (two-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Y/Z Buttons
| Y/Z Buttons
| Select
|-
|
| X Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
| Top Right
| Blue or Orange Square
| +Control Pad Right
|-
| Top Left
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|}

=== Type B (one-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| L/Z Buttons
| Y/Z Buttons
| Select
|-
|
| R Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| Y/X Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
|
| Blue or Orange Square
| +Control Pad Right
|-
|
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|-
| Top Left/Right
|
| L/R Buttons
|}

=== Type C (''Super Mario World: Super Mario Advance 2'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| B/Y or X Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Z Button
| Y/Z Buttons
| Select
|-
|
| Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R or A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

=== Type D (''The Legend of Zelda: A Link to the Past'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| Y/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| R Button or Start/Pause
| Y/Z Buttons
| Select
|-
|
| L/Z Buttons
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| X/A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

== Options ==

; <code>--poll=<0-11></code>
: Set controller polling rate.
: {| 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
|}
; <code>--control=<P1[:P2[:P3[:P4]]]></code>
: Set control scheme. The default is the Game Boy Player Start-up Disc's Controller setting (0 or 1).
: {| class="wikitable"
| '''0:'''
| [[#Type A (two-handed)|Type A (two-handed)]]
|-
| '''1:'''
| [[#Type B (one-handed)|Type B (one-handed)]]
|-
| '''2:'''
| [[#Type C (Super Mario World: Super Mario Advance 2)|Type C (''Super Mario World: Super Mario Advance 2'')]]
|-
| '''3:'''
| [[#Type D (The Legend of Zelda: A Link to the Past)|Type D (''The Legend of Zelda: A Link to the Past'')]]
|}
: Note: A Game Boy Advance used as a controller is a Nintendo GameCube Controller.
; <code>--delay-reset=<N></code>
: Set reset delay (default: 0).
; <code>--delay-video=<N></code>
: Set video buffering (default: 1).
; <code>--movie=<path></code>, <code>--no-movie</code>
: Play input log (default: no).
; <code>--movie-record</code>, <code>--no-movie-record</code>
: Record input log (default: no).
; <code>--palette=<xxxx-xxxx-xxxx></code>, <code>--no-palette</code>
: Apply [https://gamefaqs.gamespot.com/snes/588731-super-game-boy/faqs/58647 Super Game Boy] color palette (default: no).
: Note: Press Left + B while the Game Boy logo is visible for proper application on original Game Boy Game Paks.
; <code>--lut3d=<path></code>, <code>--no-lut3d</code>
: Load 32x32x32 lookup table (default: no).
; <code>--lut3d-order=<rgb|gbr|bgr></code>
: Specify lookup table order (default: rgb).
; <code>--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba></code>
: Set color matrix (default: identity).
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gba:'''
| [[#Game Boy Advance|Game Boy Advance]] (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
|-
| '''nds:'''
| [[#Nintendo DS|Nintendo DS]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| [[#Palm Treo 700p|Palm Treo 700p]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| [[#PlayStation Portable|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])
|}
; <code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
; <code>--output-gamma=<value></code>
: Specify screen gamma (default: 2.2).
; <code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
; <code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; <code>--volume=<left[:right]></code>
: Set audio gain (default: 0.75).
; <code>--sound=<[mono|stereo][,digital|analog]></code>
: Set sound mode. The default is the Sound Mode system setting (mono or stereo).
:; <code>digital</code>
:: Use PWM decoder (default).
:; <code>analog[=<a0:a1:a2:b1:b2>]</code>
:: Use 2MHz biquad filter. Defaults to a second-order low-pass filter with a cut-off of 10kHz and a quality factor of √2 if not specified.
; <code>--colorspace=<ycc601|ycc709|ycc2020|rgb709|rgb2020></code>
: Set video color space (default: ycc601).
: This only works with the Component Video Cable.
: {| class="wikitable"
| '''ycc601:'''
| [[wikipedia:xvYCC|IEC 61966-2-4 xvYCC601]]
|-
| '''ycc709:'''
| [[wikipedia:xvYCC|IEC 61966-2-4 xvYCC709]]
|-
| '''ycc2020:'''
| [[wikipedia:Rec. 2020|ITU-R BT.2020 Y’C’BC’R]]
|-
| '''rgb709:'''
| [[wikipedia:sRGB|IEC 61966-2-1 sRGB]]
|-
| '''rgb2020:'''
| [[wikipedia:Rec. 2020|ITU-R BT.2020 R’G’B’]]
|}
; <code>--format=<ntsc|pal|pal-m|ntsc-50|pal-60|custom|custom-m|hd60|hd50|hd48|hdcustom></code>
: Set video format (default: custom).
; <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 (non-interlace or progressive).
: {| class="wikitable"
| '''interlace:'''
| 15 or 18-22kHz interlace
|-
| '''quasi-interlace:'''
| 15 or 18-22kHz segmented frame
|-
| '''non-interlace:'''
| 15 or 18-22kHz progressive
|-
| '''non-progressive:'''
| 31 or 27-33kHz interlace
|-
| '''progressive:'''
| 31 or 36-45kHz progressive
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> modes. Disabling halves the refresh rate for <code>progressive</code> modes.
:: This only works with the Component Video Cable.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2x video oversampling (default: auto). Enabling halves the refresh rate.
:: This only works with the Component Video Cable.
; <code>--usb</code>, <code>--no-usb</code>
: Enable [[USBGecko|USB Gecko]] features (default: yes).
; <code>--enhance</code>, <code>--no-enhance</code>
: Enable Game Boy Player enhancements (default: yes).
: {| class="wikitable sortable"
! Title
! Feature(s)
|-
| ''[[wikipedia:Drill Dozer|Drill Dozer]]''
| Rumble
|-
| ''[[wikipedia:Game Boy Advance Video|Game Boy Advance Video]] Series''
| [[#Can I play Game Boy Advance Video?|Not compatible]]
|-
| ''[[wikipedia:Mario & Luigi: Superstar Saga|Mario & Luigi: Superstar Saga]]''
| Rumble, [[#Mario & Luigi: Superstar Saga|reduced contrast]]
|-
| ''[[wikipedia:Pokémon Pinball: Ruby & Sapphire|Pokémon Pinball: Ruby & Sapphire]]''
| Rumble
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kanji Keisanhen''
| Rumble, restored contrast
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kokugo Sansuu Shakai Rikahen''
| Rumble, restored contrast
|-
| ''[[wikipedia:Super Mario Advance 4: Super Mario Bros. 3|Super Mario Advance 4: Super Mario Bros. 3]]''
| Rumble, [[#Super Mario Bros. 3: Super Mario Advance 4|restored gamma]]
|}
: Note: Remove any accessory from the External Extension Connector, or the Rumble Feature will not work.
: Note: If you are using an EverDrive, make sure to turn off "Quick Boot" in the options, or the enhancements may not work.
; <code><path></code>
: Load Game Boy Advance multiboot ROM (default: default.mb.gz).
: Note: Paths are relative to /GBI
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.

Any file path can be relative or absolute. If relative, it is relative to <code>/GBI</code>. They can also explicitly specify the SD card to read from by prefixing an absolute path with <code>carda:</code> or <code>cardb:</code>

== Comparisons ==

=== Video quality ===

==== Blackmagic Intensity Shuttle ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7180.pdf ADV7180] and [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7604.pdf ADV7604].

<gallery widths="240px" heights="160px">
File:GBIHF ADV7180 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBIHF ADV7180 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBIHF ADV7180 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBIHF ADV7180 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
File:GBIHF ADV7604 HDRV.png|HD Retrovision Component Video Cable
File:GBIHF ADV7604 Component.png|Nintendo Component Video Cable
File:GBIHF ADV7604 GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBIHF ADV7604 GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Datapath VisionRGB ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/AD9887A.pdf AD9887A].

<gallery widths="240px" heights="160px">
File:GBIHF AD9887A HDRV.png|HD Retrovision Component Video Cable
File:GBIHF AD9887A Component.png|Nintendo Component Video Cable
File:GBIHF AD9887A GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBIHF AD9887A GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Hauppauge WinTV-HVR-1850 ====

Using [https://web.archive.org/web/20120509222042/http://conexant.com/servlets/DownloadServlet/PBR-200974-004.pdf?docid=975&revid=4 CX23888].

<gallery widths="240px" heights="160px">
File:GBIHF CX23888 NTSC.png|Nintendo RF Modulator (NTSC-J)
File:GBIHF CX23888 PAL-M.png|Nintendo RF Modulator (PAL-M)
File:GBIHF CX23888 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBIHF CX23888 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBIHF CX23888 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBIHF CX23888 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
</gallery>

=== Sound emulation ===

==== ''Mega Man Zero 2'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gbp.flac Game Boy Player Start-up Disc]

==== ''Pokémon Sapphire'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gbp.flac Game Boy Player Start-up Disc]

=== 3D lookup table ===

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity LUT.png|Identity LUT <code>lutrgb.png</code>
File:GBI AXPE GBA Light LUT.png|Game Boy Advance <code>lutrgb-gba-light.png</code>
File:GBI AXPE GBA LUT.png|Game Boy Advance <code>lutrgb-gba.png</code>
File:GBI AXPE GBC LUT.png|Gambatte/higan <code>lutrgb-gbc.png</code>
File:GBI AXPE GBP LUT.png|Game Boy Player Start-up Disc <code>lutrgb-gbp.png</code>
File:GBI AXPE NDS LUT.png|Nintendo DS <code>lutrgb-nds.png</code>
File:GBI AXPE VBA LUT.png|VisualBoyAdvance-M <code>lutrgb-vba.png</code>
File:GBI AXPE WiiU LUT.png|Wii U Virtual Console <code>lutrgb-wiiu.png</code>
</gallery>

=== Color matrix ===

==== ''Golden Sun'' ====

<gallery widths="240px" heights="160px">
File:GBI AGSE Identity.png|Identity matrix
File:GBI AGSE GBA.png|Game Boy Advance
File:GBI AGSE GBC.png|Game Boy Color
File:GBI AGSE GBI.png|Game Boy Interface
File:GBI AGSE NDS.png|Nintendo DS
File:GBI AGSE Palm.png|Palm Treo 700p
File:GBI AGSE PSP.png|PlayStation Portable
File:GBI AGSE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Mario Kart: Super Circuit'' ====

<gallery widths="240px" heights="160px">
File:GBI AMKE Identity.png|Identity matrix
File:GBI AMKE GBA.png|Game Boy Advance
File:GBI AMKE GBC.png|Game Boy Color
File:GBI AMKE GBI.png|Game Boy Interface
File:GBI AMKE NDS.png|Nintendo DS
File:GBI AMKE Palm.png|Palm Treo 700p
File:GBI AMKE PSP.png|PlayStation Portable
File:GBI AMKE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity.png|Identity matrix
File:GBI AXPE GBA.png|Game Boy Advance
File:GBI AXPE GBC.png|Game Boy Color
File:GBI AXPE GBI.png|Game Boy Interface
File:GBI AXPE NDS.png|Nintendo DS
File:GBI AXPE Palm.png|Palm Treo 700p
File:GBI AXPE PSP.png|PlayStation Portable
File:GBI AXPE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''The Legend of Zelda: The Minish Cap'' ====

<gallery widths="240px" heights="160px">
File:GBI BZME Identity.png|Identity matrix
File:GBI BZME GBA.png|Game Boy Advance
File:GBI BZME GBC.png|Game Boy Color
File:GBI BZME GBI.png|Game Boy Interface
File:GBI BZME NDS.png|Nintendo DS
File:GBI BZME Palm.png|Palm Treo 700p
File:GBI BZME PSP.png|PlayStation Portable
File:GBI BZME VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Wario Land 4'' ====

<gallery widths="240px" heights="160px">
File:GBI AWAE Identity.png|Identity matrix
File:GBI AWAE GBA.png|Game Boy Advance
File:GBI AWAE GBC.png|Game Boy Color
File:GBI AWAE GBI.png|Game Boy Interface
File:GBI AWAE NDS.png|Nintendo DS
File:GBI AWAE Palm.png|Palm Treo 700p
File:GBI AWAE PSP.png|PlayStation Portable
File:GBI AWAE VBA.png|VisualBoyAdvance-M
</gallery>

== Examples ==

=== Color emulation ===

==== Game Boy Advance ====

[[File:GBI_Game_Boy_Advance.png|border|right]]
Using a contrast ratio of 250:1.

<pre>
--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177
</pre>

==== Nintendo DS ====

[[File:GBI_Nintendo_DS.png|border|right]]
Using a contrast ratio of 600:1.

<pre>
--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934
</pre>

==== Palm Treo 700p ====

[[File:GBI_Palm_Treo_700p.png|border|right]]
Using a contrast ratio of 75:1.

<pre>
--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364
</pre>

==== PlayStation Portable ====

[[File:GBI_PlayStation_Portable.png|border|right]]
Using a contrast ratio of 750:1.

<pre>
--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556
</pre>

=== Color restoration ===

==== ''Mario & Luigi: Superstar Saga'' ====

This game reduces contrast when played ''with'' Game Boy Player enhancements.

<pre>
--contrast=1.1
</pre>

==== ''Super Mario Bros. 3: Super Mario Advance 4'' ====

This game reduces gamma when played ''without'' Game Boy Player enhancements.

<pre>
--input-gamma=2.8
</pre>

==== ''The Legend of Zelda: Oracle of Ages/Seasons'' ====

This game reduces gamma when played on a Game Boy Advance.
Due to Game Boy Color limitations, only shadows can be restored perfectly.

<pre>
--input-gamma=4.
</pre>

=== Video optimization ===

==== Datapath VisionRGB (Component Video Cable) ====

<pre>
--colorspace=rgb709
--scan-mode=non-interlace,clock2x,size2x
</pre>

* Resolution and Refresh
** Width: 360
** Height: 240
** Vertical Refresh: 59.72
* Video Adjustments
** Horizontal Position: 65
** Horizontal Size: 433
** Phase: 27
** Vertical Position: 18
** Black Level: 8
* Cropping
** Top: 40
** Left: 60
** Width: 240
** Height: 160
* Color Adjustments
** Brightness: 32
** Contrast: 128
** Colour Domain: RGB (601)
** Colour Balance
*** All Colors
**** Brightness: 32
**** Contrast: 128
*** Red
**** Brightness: 156
**** Contrast: 156
*** Green
**** Brightness: 166
**** Contrast: 166
*** Blue
**** Brightness: 148
**** Contrast: 148

==== Open Source Scan Converter ====

Included as <code>gbihf-ossc.cli</code>, <code>gbihf-ossc.dol+cli</code> and <code>gbihf-ossc.gci</code>.

<pre>
--format=hd60
--scan-mode=non-interlace
</pre>

==== XRGB-mini Framemeister ====

Included as <code>gbihf-xrgb.cli</code>, <code>gbihf-xrgb.dol+cli</code> and <code>gbihf-xrgb.gci</code>.
Refer to [http://www.firebrandx.com/framemeisterprofiles.html FirebrandX] for configuration.

<pre>
--format=custom-m
--scan-mode=non-interlace
</pre>

==== High-definition televisions ====

Change the Aspect Ratio on the television to Zoom 1.

<pre>
--colorspace=ycc709
--format=hd60
--scan-mode=non-progressive
</pre>

== FAQs ==

=== How do I change Game Paks? ===

# Hold the Reset Button.
# Slide the Game Pak Ejector.
# Insert a Game Pak into the Game Pak Slot.
# Release the Reset Button.

=== Can I play [[wikipedia:Game Boy Advance Video|Game Boy Advance Video]]? ===

Yes. You can do so by disabling Game Boy Player enhancements (<code>--no-enhance</code>), or holding a direction while the Game Boy Player logo is visible.

=== Is this an emulator? Can I play ROMs? ===

No, but there's [[Enhanced mGBA]] if you're looking for one.

== Changelog ==

=== December, 2018 ===

* Fixed 360p RGBcvS sync issue.

=== October, 2018 ===

* Added HD Custom video format.

=== August, 2018 ===

* Updated color matrices by Pokefan531.

=== July, 2018 ===

* Updated GBA-as-GC controller.

=== June, 2018 ===

* Added analog sound emulation.
* Added video options.
* Added component video DAC oversampling.
* Changed brightness/contrast controls to match BT.1886.
* Fixed some audio bugs.
* Removed left/right chroma location support.

=== May, 2018 ===

* Added Super Game Boy color palette setting.
* Changed default chroma location to center.
* Fixed Game Boy Player advertisement.
* Fixed rumble protocol handshake.

=== April, 2018 ===

* Added movie recording/playback.
* Updated GBA-as-GC controller.

=== March, 2018 ===

* Added RGB Sync-on-Green support.
* Added xvYCC/BT.2020 support for auto-generated 3D LUT.
* Added control swapping for SNES Controllers.
* Added center/right chroma location support.
* Improved multiboot implementation.
* Fixed SD card compatibility.
* Fixed multiboot to rumble protocol transition.

== Media ==

* [https://www.youtube.com/watch?v=SN-r2bl7bV8 Console Verified: GBC Pokémon: Blue Version "warp glitch" by gifvex in 10:11.25]
* [https://www.youtube.com/watch?v=i8ROeArTVyQ Console Verified: GBC Pokémon: Blue Version "Gotta Catch 'Em All!" by luckytyphlosion in 37:54.11]
* [https://www.youtube.com/watch?v=40z__x55Ix0 Console Verified: GBA Sonic Advance by Mukki & ruadath in 10:49.75]
* [https://www.youtube.com/watch?v=VqPV513Fd9w Console Verified: GBA Sonic Advance by Mukki in 11:02.64]
* [https://www.youtube.com/watch?v=kZSfK7u3P2Y Console Verified: GBA Sonic Advance 2 by Mukki in 18:09.45]
* [https://www.youtube.com/watch?v=F6t0fdHay_o Console Verified: GBC Pokémon: Yellow Version by TiKevin83 in 1:36:34.55]

[[Category:Homebrew_Software]]

Game Boy Interface/High-Fidelity Edition

2018-12-11T20:52:17Z

Eatnumber1: /* Options */ Add note about paths being relative to /GBI

{{:Game Boy Interface}}
A spiritual successor of the ultra-low latency version, '''Game Boy Interface High-Fidelity Edition''' ('''GBIHF''') aims to provide the best source quality for further processing or archival.

<div class="toclimit-4">
__TOC__
</div>

== Controls ==

=== Type A (two-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Y/Z Buttons
| Y/Z Buttons
| Select
|-
|
| X Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
| Top Right
| Blue or Orange Square
| +Control Pad Right
|-
| Top Left
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|}

=== Type B (one-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| L/Z Buttons
| Y/Z Buttons
| Select
|-
|
| R Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| Y/X Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
|
| Blue or Orange Square
| +Control Pad Right
|-
|
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|-
| Top Left/Right
|
| L/R Buttons
|}

=== Type C (''Super Mario World: Super Mario Advance 2'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| B/Y or X Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Z Button
| Y/Z Buttons
| Select
|-
|
| Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R or A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

=== Type D (''The Legend of Zelda: A Link to the Past'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| Y/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| R Button or Start/Pause
| Y/Z Buttons
| Select
|-
|
| L/Z Buttons
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| X/A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

== Options ==

; <code>--poll=<0-11></code>
: Set controller polling rate.
: {| 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
|}
; <code>--control=<P1[:P2[:P3[:P4]]]></code>
: Set control scheme. The default is the Game Boy Player Start-up Disc's Controller setting (0 or 1).
: {| class="wikitable"
| '''0:'''
| [[#Type A (two-handed)|Type A (two-handed)]]
|-
| '''1:'''
| [[#Type B (one-handed)|Type B (one-handed)]]
|-
| '''2:'''
| [[#Type C (Super Mario World: Super Mario Advance 2)|Type C (''Super Mario World: Super Mario Advance 2'')]]
|-
| '''3:'''
| [[#Type D (The Legend of Zelda: A Link to the Past)|Type D (''The Legend of Zelda: A Link to the Past'')]]
|}
: Note: A Game Boy Advance used as a controller is a Nintendo GameCube Controller.
; <code>--delay-reset=<N></code>
: Set reset delay (default: 0).
; <code>--delay-video=<N></code>
: Set video buffering (default: 1).
; <code>--movie=<path></code>, <code>--no-movie</code>
: Play input log (default: no).
; <code>--movie-record</code>, <code>--no-movie-record</code>
: Record input log (default: no).
; <code>--palette=<xxxx-xxxx-xxxx></code>, <code>--no-palette</code>
: Apply [https://gamefaqs.gamespot.com/snes/588731-super-game-boy/faqs/58647 Super Game Boy] color palette (default: no).
: Note: Press Left + B while the Game Boy logo is visible for proper application on original Game Boy Game Paks.
; <code>--lut3d=<path></code>, <code>--no-lut3d</code>
: Load 32x32x32 lookup table (default: no).
; <code>--lut3d-order=<rgb|gbr|bgr></code>
: Specify lookup table order (default: rgb).
; <code>--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba></code>
: Set color matrix (default: identity).
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gba:'''
| [[#Game Boy Advance|Game Boy Advance]] (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
|-
| '''nds:'''
| [[#Nintendo DS|Nintendo DS]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| [[#Palm Treo 700p|Palm Treo 700p]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| [[#PlayStation Portable|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])
|}
; <code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
; <code>--output-gamma=<value></code>
: Specify screen gamma (default: 2.2).
; <code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
; <code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; <code>--volume=<left[:right]></code>
: Set audio gain (default: 0.75).
; <code>--sound=<[mono|stereo][,digital|analog]></code>
: Set sound mode. The default is the Sound Mode system setting (mono or stereo).
:; <code>digital</code>
:: Use PWM decoder (default).
:; <code>analog[=<a0:a1:a2:b1:b2>]</code>
:: Use 2MHz biquad filter. Defaults to a second-order low-pass filter with a cut-off of 10kHz and a quality factor of √2 if not specified.
; <code>--colorspace=<ycc601|ycc709|ycc2020|rgb709|rgb2020></code>
: Set video color space (default: ycc601).
: This only works with the Component Video Cable.
: {| class="wikitable"
| '''ycc601:'''
| [[wikipedia:xvYCC|IEC 61966-2-4 xvYCC601]]
|-
| '''ycc709:'''
| [[wikipedia:xvYCC|IEC 61966-2-4 xvYCC709]]
|-
| '''ycc2020:'''
| [[wikipedia:Rec. 2020|ITU-R BT.2020 Y’C’BC’R]]
|-
| '''rgb709:'''
| [[wikipedia:sRGB|IEC 61966-2-1 sRGB]]
|-
| '''rgb2020:'''
| [[wikipedia:Rec. 2020|ITU-R BT.2020 R’G’B’]]
|}
; <code>--format=<ntsc|pal|pal-m|ntsc-50|pal-60|custom|custom-m|hd60|hd50|hd48|hdcustom></code>
: Set video format (default: custom).
; <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 (non-interlace or progressive).
: {| class="wikitable"
| '''interlace:'''
| 15 or 18-22kHz interlace
|-
| '''quasi-interlace:'''
| 15 or 18-22kHz segmented frame
|-
| '''non-interlace:'''
| 15 or 18-22kHz progressive
|-
| '''non-progressive:'''
| 31 or 27-33kHz interlace
|-
| '''progressive:'''
| 31 or 36-45kHz progressive
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> modes. Disabling halves the refresh rate for <code>progressive</code> modes.
:: This only works with the Component Video Cable.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2x video oversampling (default: auto). Enabling halves the refresh rate.
:: This only works with the Component Video Cable.
; <code>--usb</code>, <code>--no-usb</code>
: Enable [[USBGecko|USB Gecko]] features (default: yes).
; <code>--enhance</code>, <code>--no-enhance</code>
: Enable Game Boy Player enhancements (default: yes).
: {| class="wikitable sortable"
! Title
! Feature(s)
|-
| ''[[wikipedia:Drill Dozer|Drill Dozer]]''
| Rumble
|-
| ''[[wikipedia:Game Boy Advance Video|Game Boy Advance Video]] Series''
| [[#Can I play Game Boy Advance Video?|Not compatible]]
|-
| ''[[wikipedia:Mario & Luigi: Superstar Saga|Mario & Luigi: Superstar Saga]]''
| Rumble, [[#Mario & Luigi: Superstar Saga|reduced contrast]]
|-
| ''[[wikipedia:Pokémon Pinball: Ruby & Sapphire|Pokémon Pinball: Ruby & Sapphire]]''
| Rumble
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kanji Keisanhen''
| Rumble, restored contrast
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kokugo Sansuu Shakai Rikahen''
| Rumble, restored contrast
|-
| ''[[wikipedia:Super Mario Advance 4: Super Mario Bros. 3|Super Mario Advance 4: Super Mario Bros. 3]]''
| Rumble, [[#Super Mario Bros. 3: Super Mario Advance 4|restored gamma]]
|}
: Note: Remove any accessory from the External Extension Connector, or the Rumble Feature will not work.
: Note: If you are using an EverDrive, make sure to turn off "Quick Boot" in the options, or the enhancements may not work.
; <code><path></code>
: Load Game Boy Advance multiboot ROM (default: default.mb.gz).
: Note: Paths are relative to /GBI
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.

== Comparisons ==

=== Video quality ===

==== Blackmagic Intensity Shuttle ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7180.pdf ADV7180] and [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7604.pdf ADV7604].

<gallery widths="240px" heights="160px">
File:GBIHF ADV7180 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBIHF ADV7180 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBIHF ADV7180 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBIHF ADV7180 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
File:GBIHF ADV7604 HDRV.png|HD Retrovision Component Video Cable
File:GBIHF ADV7604 Component.png|Nintendo Component Video Cable
File:GBIHF ADV7604 GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBIHF ADV7604 GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Datapath VisionRGB ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/AD9887A.pdf AD9887A].

<gallery widths="240px" heights="160px">
File:GBIHF AD9887A HDRV.png|HD Retrovision Component Video Cable
File:GBIHF AD9887A Component.png|Nintendo Component Video Cable
File:GBIHF AD9887A GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBIHF AD9887A GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Hauppauge WinTV-HVR-1850 ====

Using [https://web.archive.org/web/20120509222042/http://conexant.com/servlets/DownloadServlet/PBR-200974-004.pdf?docid=975&revid=4 CX23888].

<gallery widths="240px" heights="160px">
File:GBIHF CX23888 NTSC.png|Nintendo RF Modulator (NTSC-J)
File:GBIHF CX23888 PAL-M.png|Nintendo RF Modulator (PAL-M)
File:GBIHF CX23888 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBIHF CX23888 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBIHF CX23888 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBIHF CX23888 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
</gallery>

=== Sound emulation ===

==== ''Mega Man Zero 2'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gbp.flac Game Boy Player Start-up Disc]

==== ''Pokémon Sapphire'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gbp.flac Game Boy Player Start-up Disc]

=== 3D lookup table ===

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity LUT.png|Identity LUT <code>lutrgb.png</code>
File:GBI AXPE GBA Light LUT.png|Game Boy Advance <code>lutrgb-gba-light.png</code>
File:GBI AXPE GBA LUT.png|Game Boy Advance <code>lutrgb-gba.png</code>
File:GBI AXPE GBC LUT.png|Gambatte/higan <code>lutrgb-gbc.png</code>
File:GBI AXPE GBP LUT.png|Game Boy Player Start-up Disc <code>lutrgb-gbp.png</code>
File:GBI AXPE NDS LUT.png|Nintendo DS <code>lutrgb-nds.png</code>
File:GBI AXPE VBA LUT.png|VisualBoyAdvance-M <code>lutrgb-vba.png</code>
File:GBI AXPE WiiU LUT.png|Wii U Virtual Console <code>lutrgb-wiiu.png</code>
</gallery>

=== Color matrix ===

==== ''Golden Sun'' ====

<gallery widths="240px" heights="160px">
File:GBI AGSE Identity.png|Identity matrix
File:GBI AGSE GBA.png|Game Boy Advance
File:GBI AGSE GBC.png|Game Boy Color
File:GBI AGSE GBI.png|Game Boy Interface
File:GBI AGSE NDS.png|Nintendo DS
File:GBI AGSE Palm.png|Palm Treo 700p
File:GBI AGSE PSP.png|PlayStation Portable
File:GBI AGSE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Mario Kart: Super Circuit'' ====

<gallery widths="240px" heights="160px">
File:GBI AMKE Identity.png|Identity matrix
File:GBI AMKE GBA.png|Game Boy Advance
File:GBI AMKE GBC.png|Game Boy Color
File:GBI AMKE GBI.png|Game Boy Interface
File:GBI AMKE NDS.png|Nintendo DS
File:GBI AMKE Palm.png|Palm Treo 700p
File:GBI AMKE PSP.png|PlayStation Portable
File:GBI AMKE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity.png|Identity matrix
File:GBI AXPE GBA.png|Game Boy Advance
File:GBI AXPE GBC.png|Game Boy Color
File:GBI AXPE GBI.png|Game Boy Interface
File:GBI AXPE NDS.png|Nintendo DS
File:GBI AXPE Palm.png|Palm Treo 700p
File:GBI AXPE PSP.png|PlayStation Portable
File:GBI AXPE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''The Legend of Zelda: The Minish Cap'' ====

<gallery widths="240px" heights="160px">
File:GBI BZME Identity.png|Identity matrix
File:GBI BZME GBA.png|Game Boy Advance
File:GBI BZME GBC.png|Game Boy Color
File:GBI BZME GBI.png|Game Boy Interface
File:GBI BZME NDS.png|Nintendo DS
File:GBI BZME Palm.png|Palm Treo 700p
File:GBI BZME PSP.png|PlayStation Portable
File:GBI BZME VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Wario Land 4'' ====

<gallery widths="240px" heights="160px">
File:GBI AWAE Identity.png|Identity matrix
File:GBI AWAE GBA.png|Game Boy Advance
File:GBI AWAE GBC.png|Game Boy Color
File:GBI AWAE GBI.png|Game Boy Interface
File:GBI AWAE NDS.png|Nintendo DS
File:GBI AWAE Palm.png|Palm Treo 700p
File:GBI AWAE PSP.png|PlayStation Portable
File:GBI AWAE VBA.png|VisualBoyAdvance-M
</gallery>

== Examples ==

=== Color emulation ===

==== Game Boy Advance ====

[[File:GBI_Game_Boy_Advance.png|border|right]]
Using a contrast ratio of 250:1.

<pre>
--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177
</pre>

==== Nintendo DS ====

[[File:GBI_Nintendo_DS.png|border|right]]
Using a contrast ratio of 600:1.

<pre>
--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934
</pre>

==== Palm Treo 700p ====

[[File:GBI_Palm_Treo_700p.png|border|right]]
Using a contrast ratio of 75:1.

<pre>
--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364
</pre>

==== PlayStation Portable ====

[[File:GBI_PlayStation_Portable.png|border|right]]
Using a contrast ratio of 750:1.

<pre>
--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556
</pre>

=== Color restoration ===

==== ''Mario & Luigi: Superstar Saga'' ====

This game reduces contrast when played ''with'' Game Boy Player enhancements.

<pre>
--contrast=1.1
</pre>

==== ''Super Mario Bros. 3: Super Mario Advance 4'' ====

This game reduces gamma when played ''without'' Game Boy Player enhancements.

<pre>
--input-gamma=2.8
</pre>

==== ''The Legend of Zelda: Oracle of Ages/Seasons'' ====

This game reduces gamma when played on a Game Boy Advance.
Due to Game Boy Color limitations, only shadows can be restored perfectly.

<pre>
--input-gamma=4.
</pre>

=== Video optimization ===

==== Datapath VisionRGB (Component Video Cable) ====

<pre>
--colorspace=rgb709
--scan-mode=non-interlace,clock2x,size2x
</pre>

* Resolution and Refresh
** Width: 360
** Height: 240
** Vertical Refresh: 59.72
* Video Adjustments
** Horizontal Position: 65
** Horizontal Size: 433
** Phase: 27
** Vertical Position: 18
** Black Level: 8
* Cropping
** Top: 40
** Left: 60
** Width: 240
** Height: 160
* Color Adjustments
** Brightness: 32
** Contrast: 128
** Colour Domain: RGB (601)
** Colour Balance
*** All Colors
**** Brightness: 32
**** Contrast: 128
*** Red
**** Brightness: 156
**** Contrast: 156
*** Green
**** Brightness: 166
**** Contrast: 166
*** Blue
**** Brightness: 148
**** Contrast: 148

==== Open Source Scan Converter ====

Included as <code>gbihf-ossc.cli</code>, <code>gbihf-ossc.dol+cli</code> and <code>gbihf-ossc.gci</code>.

<pre>
--format=hd60
--scan-mode=non-interlace
</pre>

==== XRGB-mini Framemeister ====

Included as <code>gbihf-xrgb.cli</code>, <code>gbihf-xrgb.dol+cli</code> and <code>gbihf-xrgb.gci</code>.
Refer to [http://www.firebrandx.com/framemeisterprofiles.html FirebrandX] for configuration.

<pre>
--format=custom-m
--scan-mode=non-interlace
</pre>

==== High-definition televisions ====

Change the Aspect Ratio on the television to Zoom 1.

<pre>
--colorspace=ycc709
--format=hd60
--scan-mode=non-progressive
</pre>

== FAQs ==

=== How do I change Game Paks? ===

# Hold the Reset Button.
# Slide the Game Pak Ejector.
# Insert a Game Pak into the Game Pak Slot.
# Release the Reset Button.

=== Can I play [[wikipedia:Game Boy Advance Video|Game Boy Advance Video]]? ===

Yes. You can do so by disabling Game Boy Player enhancements (<code>--no-enhance</code>), or holding a direction while the Game Boy Player logo is visible.

=== Is this an emulator? Can I play ROMs? ===

No, but there's [[Enhanced mGBA]] if you're looking for one.

== Changelog ==

=== December, 2018 ===

* Fixed 360p RGBcvS sync issue.

=== October, 2018 ===

* Added HD Custom video format.

=== August, 2018 ===

* Updated color matrices by Pokefan531.

=== July, 2018 ===

* Updated GBA-as-GC controller.

=== June, 2018 ===

* Added analog sound emulation.
* Added video options.
* Added component video DAC oversampling.
* Changed brightness/contrast controls to match BT.1886.
* Fixed some audio bugs.
* Removed left/right chroma location support.

=== May, 2018 ===

* Added Super Game Boy color palette setting.
* Changed default chroma location to center.
* Fixed Game Boy Player advertisement.
* Fixed rumble protocol handshake.

=== April, 2018 ===

* Added movie recording/playback.
* Updated GBA-as-GC controller.

=== March, 2018 ===

* Added RGB Sync-on-Green support.
* Added xvYCC/BT.2020 support for auto-generated 3D LUT.
* Added control swapping for SNES Controllers.
* Added center/right chroma location support.
* Improved multiboot implementation.
* Fixed SD card compatibility.
* Fixed multiboot to rumble protocol transition.

== Media ==

* [https://www.youtube.com/watch?v=SN-r2bl7bV8 Console Verified: GBC Pokémon: Blue Version "warp glitch" by gifvex in 10:11.25]
* [https://www.youtube.com/watch?v=i8ROeArTVyQ Console Verified: GBC Pokémon: Blue Version "Gotta Catch 'Em All!" by luckytyphlosion in 37:54.11]
* [https://www.youtube.com/watch?v=40z__x55Ix0 Console Verified: GBA Sonic Advance by Mukki & ruadath in 10:49.75]
* [https://www.youtube.com/watch?v=VqPV513Fd9w Console Verified: GBA Sonic Advance by Mukki in 11:02.64]
* [https://www.youtube.com/watch?v=kZSfK7u3P2Y Console Verified: GBA Sonic Advance 2 by Mukki in 18:09.45]
* [https://www.youtube.com/watch?v=F6t0fdHay_o Console Verified: GBC Pokémon: Yellow Version by TiKevin83 in 1:36:34.55]

[[Category:Homebrew_Software]]

Game Boy Interface/Speedrunning Edition

2018-12-11T20:52:14Z

Eatnumber1: /* Options */ Add note about paths being relative to /GBI

{{:Game Boy Interface}}
Formerly the (ultra-)low latency version, '''Game Boy Interface Speedrunning Edition''' ('''GBISR''') features a simplified video renderer, and aims to meet the needs of most [[wikipedia:Speedrun|speedrunning]] communities.

<div class="toclimit-4">
__TOC__
</div>

== Controls ==

=== Type A (two-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Y/Z Buttons
| Y/Z Buttons
| Select
|-
|
| X Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|-
|
| C Stick Down
|
| Toggle input viewer
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
| Top Right
| Blue or Orange Square
| +Control Pad Right
|-
| Top Left
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|}

=== Type B (one-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| L/Z Buttons
| Y/Z Buttons
| Select
|-
|
| R Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| Y/X Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
|
| Blue or Orange Square
| +Control Pad Right
|-
|
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|-
| Top Left/Right
|
| L/R Buttons
|}

=== Type C (''Super Mario World: Super Mario Advance 2'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| B/Y or X Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Z Button
| Y/Z Buttons
| Select
|-
|
| Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R or A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|-
|
| C Stick Down
|
| Toggle input viewer
|}

=== Type D (''The Legend of Zelda: A Link to the Past'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| Y/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| R Button or Start/Pause
| Y/Z Buttons
| Select
|-
|
| L/Z Buttons
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| X/A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

== Options ==

; <code>--offset=<x:y></code>
: Set offset (default: 0).
; <code>--zoom=<x:y></code>
: Set zoom (default: 2.0).
; <code>--rotate=<0-359></code>
: Set rotation (default: 0).
; <code>--poll=<0-11></code>
: Set controller polling rate.
: {| 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
|}
; <code>--control=<P1[:P2[:P3[:P4]]]></code>
: Set control scheme. The default is the Game Boy Player Start-up Disc's Controller setting (0 or 1).
: {| class="wikitable"
| '''0:'''
| [[#Type A (two-handed)|Type A (two-handed)]]
|-
| '''1:'''
| [[#Type B (one-handed)|Type B (one-handed)]]
|-
| '''2:'''
| [[#Type C (Super Mario World: Super Mario Advance 2)|Type C (''Super Mario World: Super Mario Advance 2'')]]
|-
| '''3:'''
| [[#Type D (The Legend of Zelda: A Link to the Past)|Type D (''The Legend of Zelda: A Link to the Past'')]]
|}
: Note: A Game Boy Advance used as a controller is a Nintendo GameCube Controller.
; <code>--delay-reset=<N></code>
: Set reset delay (default: 75).
; <code>--delay-video=<N></code>
: Set video buffering (default: 1).
; <code>--movie=<path></code>, <code>--no-movie</code>
: Play input log (default: no).
; <code>--movie-record</code>, <code>--no-movie-record</code>
: Record input log (default: no).
; <code>--overlay=<path></code>, <code>--no-overlay</code>
: Load texture palette (default: frame-srgb.tpl.gz).
; <code>--overlay-id=<ID></code>
: Set texture palette index. The default is the Game Boy Player Start-up Disc's Frame setting (0 to 19).
; <code>--overlay-scale=<x:y></code>
: Set texture scale (default: auto).
; <code>--palette=<xxxx-xxxx-xxxx></code>, <code>--no-palette</code>
: Apply [https://gamefaqs.gamespot.com/snes/588731-super-game-boy/faqs/58647 Super Game Boy] color palette (default: no).
: Note: Press Left + B while the Game Boy logo is visible for proper application on original Game Boy Game Paks.
; <code>--lut3d=<path></code>, <code>--no-lut3d</code>
: Load 32x32x32 lookup table (default: no).
; <code>--lut3d-order=<rgb|gbr|bgr></code>
: Specify lookup table order (default: rgb).
; <code>--scaler=<nearest|bilinear|oversample|box></code>
: Set image scaling filter (default: nearest).
; <code>--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba></code>
: Set color matrix (default: identity).
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gba:'''
| [[#Game Boy Advance|Game Boy Advance]] (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
|-
| '''nds:'''
| [[#Nintendo DS|Nintendo DS]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| [[#Palm Treo 700p|Palm Treo 700p]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| [[#PlayStation Portable|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])
|}
; <code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
; <code>--output-gamma=<value></code>
: Specify screen gamma (default: 2.2).
; <code>--gamma=<even[:odd]></code>
: Set gamma correction (default: 1.0).
; <code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
; <code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; <code>--blend=<value></code>
: Set alpha blending (default: 1.0).
; <code>--background=<#rrggbb></code>
: Set background color (default: #000000).
; <code>--vfilter=<middle[:lower[:upper]]></code>
: Set vertical filter coefficients (default: 1.0).
; <code>--volume=<left[:right]></code>
: Set audio gain (default: 0.75).
; <code>--sound=<[mono|stereo][,digital|analog]></code>
: Set sound mode. The default is the Sound Mode system setting (mono or stereo).
:; <code>digital</code>
:: Use PWM decoder (default).
:; <code>analog[=<a0:a1:a2:b1:b2>]</code>
:: Use 2MHz biquad filter. Defaults to a second-order low-pass filter with a cut-off of 10kHz and a quality factor of √2 if not specified.
; <code>--format=<[ntsc|pal|pal-m|ntsc-50|pal-60|custom|custom-m][,offset=<x:y>][,scaled-size=<w:h>][,size=<w:h>]></code>
: Set video format. The default is the Video Mode or Progressive Scan Mode system setting (ntsc, pal-60, pal-m, or custom).
:; <code>offset=<x:y></code>
:: Set screen position. The default is the Screen Position system setting (-32 to +32).
:; <code>scaled-size=<w:h></code>
:: Set screen size (default: auto).
:; <code>size=<w:h></code>
:: Set internal resolution (default: 640:480).
; <code>--scan-mode=<[interlace|quasi-interlace|non-interlace|progressive][,clock2x|no-clock2x][,size2x|no-size2x]></code>
: Set scan mode. The default is the Progressive Scan Mode system setting (non-interlace or progressive).
: {| class="wikitable"
| '''interlace:'''
| 15kHz interlace
|-
| '''quasi-interlace:'''
| 15kHz segmented frame
|-
| '''non-interlace:'''
| 15kHz progressive
|-
| '''progressive:'''
| 31kHz progressive
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> modes. Disabling halves the refresh rate for <code>progressive</code> modes.
:: This only works with the Component Video Cable.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2x video oversampling (default: no). Enabling halves the refresh rate.
:: This only works with the Component Video Cable.
; <code>--osd-input[=<x:y>]</code>, <code>--no-osd-input</code>
: Show input viewer (default: no). Defaults to 0:-64 if not specified.
; <code>--usb</code>, <code>--no-usb</code>
: Enable [[USBGecko|USB Gecko]] features (default: yes).
; <code>--enhance</code>, <code>--no-enhance</code>
: Enable Game Boy Player enhancements (default: no). Enabling this option is not recommended.
: {| class="wikitable sortable"
! Title
! Feature(s)
|-
| ''[[wikipedia:Drill Dozer|Drill Dozer]]''
| Rumble
|-
| ''[[wikipedia:Game Boy Advance Video|Game Boy Advance Video]] Series''
| [[#Can I play Game Boy Advance Video?|Not compatible]]
|-
| ''[[wikipedia:Mario & Luigi: Superstar Saga|Mario & Luigi: Superstar Saga]]''
| Rumble, [[#Mario & Luigi: Superstar Saga|reduced contrast]]
|-
| ''[[wikipedia:Pokémon Pinball: Ruby & Sapphire|Pokémon Pinball: Ruby & Sapphire]]''
| Rumble
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kanji Keisanhen''
| Rumble, restored contrast
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kokugo Sansuu Shakai Rikahen''
| Rumble, restored contrast
|-
| ''[[wikipedia:Super Mario Advance 4: Super Mario Bros. 3|Super Mario Advance 4: Super Mario Bros. 3]]''
| Rumble, [[#Super Mario Bros. 3: Super Mario Advance 4|restored gamma]]
|}
: Note: Remove any accessory from the External Extension Connector, or the Rumble Feature will not work.
: Note: If you are using an EverDrive, make sure to turn off "Quick Boot" in the options, or the enhancements may not work.
; <code><path></code>
: Load Game Boy Advance multiboot ROM. Using this option is not recommended.
: Note: Paths are relative to /GBI
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.

== Comparisons ==

=== Video quality ===

==== Blackmagic Intensity Shuttle ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7180.pdf ADV7180] and [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7604.pdf ADV7604].

<gallery widths="240px" heights="160px">
File:GBI ADV7180 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI ADV7180 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI ADV7180 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI ADV7180 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
File:GBI ADV7604 HDRV.png|HD Retrovision Component Video Cable
File:GBI ADV7604 Component.png|Nintendo Component Video Cable
File:GBI ADV7604 GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI ADV7604 GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Datapath VisionRGB ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/AD9887A.pdf AD9887A].

<gallery widths="240px" heights="160px">
File:GBI AD9887A HDRV.png|HD Retrovision Component Video Cable
File:GBI AD9887A Component.png|Nintendo Component Video Cable
File:GBI AD9887A GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI AD9887A GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Hauppauge WinTV-HVR-1850 ====

Using [https://web.archive.org/web/20120509222042/http://conexant.com/servlets/DownloadServlet/PBR-200974-004.pdf?docid=975&revid=4 CX23888].

<gallery widths="240px" heights="160px">
File:GBI CX23888 NTSC.png|Nintendo RF Modulator (NTSC-J)
File:GBI CX23888 PAL-M.png|Nintendo RF Modulator (PAL-M)
File:GBI CX23888 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI CX23888 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI CX23888 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI CX23888 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
</gallery>

=== Sound emulation ===

==== ''Mega Man Zero 2'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gbp.flac Game Boy Player Start-up Disc]

==== ''Pokémon Sapphire'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gbp.flac Game Boy Player Start-up Disc]

=== 3D lookup table ===

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity LUT.png|Identity LUT <code>lutrgb.png</code>
File:GBI AXPE GBA Light LUT.png|Game Boy Advance <code>lutrgb-gba-light.png</code>
File:GBI AXPE GBA LUT.png|Game Boy Advance <code>lutrgb-gba.png</code>
File:GBI AXPE GBC LUT.png|Gambatte/higan <code>lutrgb-gbc.png</code>
File:GBI AXPE GBP LUT.png|Game Boy Player Start-up Disc <code>lutrgb-gbp.png</code>
File:GBI AXPE NDS LUT.png|Nintendo DS <code>lutrgb-nds.png</code>
File:GBI AXPE VBA LUT.png|VisualBoyAdvance-M <code>lutrgb-vba.png</code>
File:GBI AXPE WiiU LUT.png|Wii U Virtual Console <code>lutrgb-wiiu.png</code>
</gallery>

=== Color matrix ===

==== ''Golden Sun'' ====

<gallery widths="240px" heights="160px">
File:GBI AGSE Identity.png|Identity matrix
File:GBI AGSE GBA.png|Game Boy Advance
File:GBI AGSE GBC.png|Game Boy Color
File:GBI AGSE GBI.png|Game Boy Interface
File:GBI AGSE NDS.png|Nintendo DS
File:GBI AGSE Palm.png|Palm Treo 700p
File:GBI AGSE PSP.png|PlayStation Portable
File:GBI AGSE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Mario Kart: Super Circuit'' ====

<gallery widths="240px" heights="160px">
File:GBI AMKE Identity.png|Identity matrix
File:GBI AMKE GBA.png|Game Boy Advance
File:GBI AMKE GBC.png|Game Boy Color
File:GBI AMKE GBI.png|Game Boy Interface
File:GBI AMKE NDS.png|Nintendo DS
File:GBI AMKE Palm.png|Palm Treo 700p
File:GBI AMKE PSP.png|PlayStation Portable
File:GBI AMKE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity.png|Identity matrix
File:GBI AXPE GBA.png|Game Boy Advance
File:GBI AXPE GBC.png|Game Boy Color
File:GBI AXPE GBI.png|Game Boy Interface
File:GBI AXPE NDS.png|Nintendo DS
File:GBI AXPE Palm.png|Palm Treo 700p
File:GBI AXPE PSP.png|PlayStation Portable
File:GBI AXPE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''The Legend of Zelda: The Minish Cap'' ====

<gallery widths="240px" heights="160px">
File:GBI BZME Identity.png|Identity matrix
File:GBI BZME GBA.png|Game Boy Advance
File:GBI BZME GBC.png|Game Boy Color
File:GBI BZME GBI.png|Game Boy Interface
File:GBI BZME NDS.png|Nintendo DS
File:GBI BZME Palm.png|Palm Treo 700p
File:GBI BZME PSP.png|PlayStation Portable
File:GBI BZME VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Wario Land 4'' ====

<gallery widths="240px" heights="160px">
File:GBI AWAE Identity.png|Identity matrix
File:GBI AWAE GBA.png|Game Boy Advance
File:GBI AWAE GBC.png|Game Boy Color
File:GBI AWAE GBI.png|Game Boy Interface
File:GBI AWAE NDS.png|Nintendo DS
File:GBI AWAE Palm.png|Palm Treo 700p
File:GBI AWAE PSP.png|PlayStation Portable
File:GBI AWAE VBA.png|VisualBoyAdvance-M
</gallery>

== Examples ==

=== Color emulation ===

==== Game Boy Advance ====

[[File:GBI_Game_Boy_Advance.png|border|right]]
Using a contrast ratio of 250:1.

<pre>
--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177
</pre>

==== Nintendo DS ====

[[File:GBI_Nintendo_DS.png|border|right]]
Using a contrast ratio of 600:1.

<pre>
--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934
</pre>

==== Palm Treo 700p ====

[[File:GBI_Palm_Treo_700p.png|border|right]]
Using a contrast ratio of 75:1.

<pre>
--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364
</pre>

==== PlayStation Portable ====

[[File:GBI_PlayStation_Portable.png|border|right]]
Using a contrast ratio of 750:1.

<pre>
--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556
</pre>

=== Color restoration ===

==== ''Mario & Luigi: Superstar Saga'' ====

This game reduces contrast when played ''with'' Game Boy Player enhancements.

<pre>
--contrast=1.1
</pre>

==== ''Super Mario Bros. 3: Super Mario Advance 4'' ====

This game reduces gamma when played ''without'' Game Boy Player enhancements.

<pre>
--input-gamma=2.8
</pre>

==== ''The Legend of Zelda: Oracle of Ages/Seasons'' ====

This game reduces gamma when played on a Game Boy Advance.
Due to Game Boy Color limitations, only shadows can be restored perfectly.

<pre>
--input-gamma=4.
</pre>

=== Mimicking ===

==== Game Boy Interface (ultra-low latency) ====

<pre>
--delay-reset=0
--delay-video=0
--no-overlay
--format=custom,scaled-size=528:320,size=480:320
</pre>

==== Game Boy Player Start-up Disc (60Hz) ====

Included as <code>gbisr.cli.example</code>.

<pre>
--delay-video=2
--contrast=.78125
--vfilter=.5:.25:.25
--sound=analog=.000148021979839541018009185791015625:.00029604395967908203601837158203125:.000148021979839541018009185791015625:-1.965293407440185546875:.965885460376739501953125
--format=ntsc,scaled-size=666:448,size=608:448
--scan-mode=interlace
--enhance
</pre>

==== Game Boy Player Start-up Disc (50Hz) ====

<pre>
--delay-reset=65
--delay-video=2
--contrast=.78125
--vfilter=.5:.25:.25
--sound=analog=.000148021979839541018009185791015625:.00029604395967908203601837158203125:.000148021979839541018009185791015625:-1.965293407440185546875:.965885460376739501953125
--format=pal,scaled-size=670:530,size=608:448
--scan-mode=interlace
--enhance
</pre>

==== Nintendo 3DS Virtual Console ====

===== ''F-Zero Maximum Velocity'', ''Fire Emblem: The Sacred Stones'', ''Mario vs. Donkey Kong'' and ''The Legend of Zelda: The Minish Cap'' =====

<pre>
--contrast=.7
--blend=.75
</pre>

===== ''Kirby & The Amazing Mirror'' =====

<pre>
--contrast=.6
--blend=.5625
</pre>

===== ''Mario Kart: Super Circuit'' =====

<pre>
--contrast=.65
--blend=.75
</pre>

===== ''Metroid Fusion'' =====

<pre>
--contrast=.7
--blend=.5625
</pre>

===== ''Wario Land 4'' and ''WarioWare, Inc.: Mega Microgame$'' =====

<pre>
--contrast=.65
--blend=.5625
</pre>

===== ''Yoshi's Island: Super Mario Advance 3'' =====

<pre>
--contrast=.6
--blend=.5
</pre>

=== Video optimization ===

==== Datapath VisionRGB (Component Video Cable) ====

<pre>
--vfilter=.5:.5:.0:.5:.0:.5
--format=custom,offset=0,scaled-size=0
--scan-mode=non-interlace,clock2x
</pre>

* Resolution and Refresh
** Width: 320
** Height: 240
** Vertical Refresh: 119.45
* Video Adjustments
** Horizontal Position: 85
** Horizontal Size: 433
** Phase: 27
** Vertical Position: 18
** Black Level: 8
* Cropping
** Top: 40
** Left: 40
** Width: 240
** Height: 160
* Color Adjustments
** Brightness: 32
** Contrast: 128
** Colour Domain: YUV (601)
** Colour Balance
*** All Colors
**** Brightness: 32
**** Contrast: 128
*** Red
**** Brightness: 158
**** Contrast: 158
*** Green
**** Brightness: 170
**** Contrast: 170
*** Blue
**** Brightness: 152
**** Contrast: 152

==== Open Source Scan Converter ====

Included as <code>gbisr-ossc.cli</code>, <code>gbisr-ossc.dol+cli</code> and <code>gbisr-ossc.gci</code>.
Refer to [http://www.firebrandx.com/gbiosscoptimal.html FirebrandX] for configuration.

<pre>
--vfilter=.5:.5:.0:.5:.0:.5
--format=custom,offset=0,scaled-size=0
--scan-mode=non-interlace
</pre>

==== XRGB-mini Framemeister ====

Included as <code>gbisr-xrgb.cli</code>, <code>gbisr-xrgb.dol+cli</code> and <code>gbisr-xrgb.gci</code>.
Refer to [http://www.firebrandx.com/framemeisterprofiles.html FirebrandX] for configuration.

<pre>
--vfilter=.5:.5:.0:.5:.0:.5
--format=custom-m,offset=0,scaled-size=0
--scan-mode=non-interlace
</pre>

=== Video output ===

==== 120Hz black frame insertion ====

<pre>
--vfilter=.5:.5:.0:.0
--scan-mode=non-interlace,clock2x
</pre>

==== 480p hybrid scanlines ====

<pre>
--overlay=frame.tpl.gz
--gamma=2.2:1.
--scan-mode=progressive
</pre>

==== 480p simple scanlines ====

<pre>
--vfilter=.5:.5:.0:.0
--scan-mode=progressive
</pre>

=== Video scaling ===

==== 4:3 fullscreen (Game Boy Advance) ====

<pre>
--zoom=2.375
--scaler=oversample
--vfilter=.625:.1875:.1875
--scan-mode=interlace
</pre>

==== 4:3 fullscreen (Game Boy Color) ====

<pre>
--zoom=3
--vfilter=.5:.25:.25
--scan-mode=interlace
</pre>

<pre>
--zoom=3
--vfilter=.5:.5:.0:.5:.0:.5
--scan-mode=non-interlace
</pre>

==== 16:9 fullscreen ====

<pre>
--zoom=2:3
--format=size=568
--scan-mode=progressive
</pre>

== FAQs ==

=== How do I change Game Paks? ===

# Hold the Reset Button.
# Slide the Game Pak Ejector.
# Insert a Game Pak into the Game Pak Slot.
# Release the Reset Button.

=== Can I play [[wikipedia:Game Boy Advance Video|Game Boy Advance Video]]? ===

Yes. You can do so by disabling Game Boy Player enhancements (<code>--no-enhance</code>), or holding a direction while the Game Boy Player logo is visible.

=== Is this an emulator? Can I play ROMs? ===

No, but there's [[Enhanced mGBA]] if you're looking for one.

== Changelog ==

=== August, 2018 ===

* Updated color matrices by Pokefan531.

=== July, 2018 ===

* Updated GBA-as-GC controller.
* Disabled component video DAC oversampling.

=== June, 2018 ===

* Added analog sound emulation.
* Added Custom-M video format.
* Added Custom interlaced video modes.
* Merged vertical filter controls.
* Changed brightness/contrast controls to match BT.1886.
* Fixed some audio bugs.
* Enabled progressive scan in more cases to prevent display issues.

=== May, 2018 ===

* Added Super Game Boy color palette setting.
* Changed scan mode semantics.
* Fixed Game Boy Player advertisement.
* Fixed rumble protocol handshake.

=== April, 2018 ===

* Added movie recording/playback.
* Updated GBA-as-GC controller.

=== March, 2018 ===

* Added control swapping for SNES Controllers.
* Added framebuffer size/offset setting.
* Replaced sample aspect ratio with scaled size.
* Improved per-field filtering in single-buffered mode.
* Improved multiboot implementation.
* Improved Game Boy sound quality.
* Improved audio rendering.
* Reduced audio latency.
* Fixed SD card compatibility.
* Fixed multiboot to rumble protocol transition.
* Disabled default multiboot.

=== February, 2018 ===

* Added background color setting.
* Added video buffering setting.
* Added input viewer.
* Added color matrix from Gambatte.
* Added mono sound mode.
* Added 3D LUT auto-generation.
* Added GBR/BGR LUT order support.
* Added per-field gamma correction control.
* Changed some argument semantics.
* Fixed per-field settings with default video mode.
* Fixed wiiload autoboot with tiny GBA multiboot ROMs.
* Disabled machine checks.

=== January, 2018 ===

* Updated LUTs by Pokefan531.
* Improved Game Boy Player driver.
* Changed default component video modes.
* Tweaked control type C.

=== September, 2017 ===

* Added overlay scale setting.
* Added Logitech Speed Force support.
* Added Active Life Mat support.
* Improved Game Boy Player driver.
* Changed zoom scale.
* Changed wiiload server to accept oversized DOLs.
* Fixed one random kernel crash.
* Fixed scaling without a 3D LUT.

=== August, 2017 ===

* Added DK Bongos support.
* Adapted control type C for Super Mario World: Super Mario Advance 2.
* Added control type D for The Legend of Zelda: A Link to the Past.
* Added per-field vertical filter control.
* Added PNG 3D LUT support.
* Added LUTs by Pokefan531.
* Added LUTs from the 3DS Virtual Console.
* Improved Game Boy Player driver.

=== July, 2017 ===

* Added CLI append support.
* Updated GBA-as-GC controller.
* Changed reset combo behavior.

=== June, 2017 ===

* Added zoom & rotate.
* Added reset delay.
* Added reset combo.

=== April, 2017 ===

* Added component video DAC oversampling.
* Added reset fade effect.
* Added TPL overlay support.

=== March, 2017 ===

* Added rumble, disabled by default.
* Added USB Gecko wiiload server.
* Added Xboo Communicator.

=== February, 2017 ===

* Added volume control.
* Added per-channel settings where possible.
* Changed volume to 75% to mitigate clipping.

=== November, 2016 ===

* Updated GBA-as-GC controller.

=== September, 2016 ===

* Added video options.
* Added control schemes.
* Added polling rate setting.

=== May, 2016 ===

* Updated GBA-as-GC controller.
* Improved Game Boy Player driver.
* Fixed WaveBird Controllers.

=== April, 2016 ===

* Replaced GBA-as-controller with GBA-as-GC controller.

=== March, 2016 ===

* Added U+D/L+R cancelling.
* Added GBA-as-controller support.
* Recognized a half press of the analog triggers.

=== August, 2015 ===

* Added executable compression.
* Added memory card distribution files.
* Reduced coil whine.

=== July, 2015 ===

* Fixed Game Boy Player detection.

[[Category:Homebrew_Software]]

Game Boy Interface/Standard Edition

2018-12-11T20:51:19Z

Eatnumber1: /* Options */ Add note about paths being relative to /GBI

{{:Game Boy Interface}}
The author's original vision, '''Game Boy Interface Standard Edition''' ('''GBI''') features an advanced video renderer exercising the GameCube hardware to its fullest.

<div class="toclimit-4">
__TOC__
</div>

== Controls ==

=== On-screen display ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons
| Hide on-screen display
|-
|
| X Button
| X Button
| Toggle on-screen display
|-
|
| Y Button
| Y Button
| Revert offset/zoom
|-
|
| Z Button
| Z Button
| Take screenshot
|-
|
| Start/Pause (Hold for 1 second)
| Start/Pause (Hold for 1 second)
| Exit
|-
|
| +Control Pad
| +Control Pad
| Offset
|-
|
| L/R Buttons
| L/R Buttons
| Zoom
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
| Reset Button
|
|
| Save movie
|}

=== In-game ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| X Button
| X Button
| Toggle on-screen display
|-
|
| Y Button
| Y Button
| Turbo
|-
|
| Z Button
| Z Button
| Select
|-
|
| Start/Pause
| Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R Buttons
| L/R Buttons
| L/R Buttons (Only for Game Boy Advance)
|-
| Reset Button
|
|
| Power Switch
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
| Top Right
| Blue or Orange Square
| +Control Pad Right
|-
| Top Left
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|}

== Options ==

; <code>--aspect=<w:h></code>
: Specify screen aspect ratio. The default is the Progressive Scan Mode system setting (4:3 or 16:9).
; <code>--offset=<x:y></code>
: Set offset. The default is the Screen Position system setting (-32 to +32).
; <code>--zoom=<x:y></code>
: Set zoom. The default is the Game Boy Player Start-up Disc's Screen Size setting (2.0 or 2.375).
; <code>--rotate=<0-359></code>
: Set rotation (default: 0).
; <code>--poll=<0-11></code>
: Set controller polling rate.
: {| 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
|}
; <code>--turbo=<on:off></code>
: Set autofire interval (default: 3).
; <code>--movie=<path></code>, <code>--no-movie</code>
: Play input log (default: no).
; <code>--movie-record</code>, <code>--no-movie-record</code>
: Record input log (default: no).
; <code>--overlay=<path></code>, <code>--no-overlay</code>
: Load texture palette (default: frame.tpl.gz).
; <code>--overlay-id=<ID></code>
: Set texture palette index. The default is the Game Boy Player Start-up Disc's Frame setting (0 to 19).
; <code>--overlay-scale=<x:y></code>
: Set texture scale (default: auto).
; <code>--filter=<none|scale2x[ex|plus]|eagle2x|scan2x|normal2x|normalnx></code>
: Set image doubling filter (default: normalnx).
; <code>--dither=<none|threshold|bayer8x8|bayer4x4|bayer2x2|cluster8x8|cluster4x4></code>
: Set dithering algorithm (default: threshold).
; <code>--scaler=<nearest|bilinear|oversample|box></code>
: Set image scaling filter (default: bilinear).
; <code>--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba></code>
: Set color matrix (default: gbi).
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gba:'''
| [[#Game Boy Advance|Game Boy Advance]] (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
|-
| '''nds:'''
| [[#Nintendo DS|Nintendo DS]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| [[#Palm Treo 700p|Palm Treo 700p]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| [[#PlayStation Portable|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])
|}
; <code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
; <code>--output-gamma=<1.0|1.7|2.2></code>
: Specify screen gamma (default: 2.2).
; <code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
; <code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; <code>--volume=<left[:right]></code>
: Set audio gain (default: 0.75).
; <code>--sound=<[mono|stereo][,digital|analog]></code>
: Set sound mode. The default is the Sound Mode system setting (mono or stereo).
:; <code>digital</code>
:: Use PWM decoder.
:; <code>analog[=<a0:a1:a2:b1:b2>]</code>
:: Use 2MHz biquad filter (default). Defaults to a second-order low-pass filter with a cut-off of 10kHz and a quality factor of √2 if not specified.
; <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 and 60Hz Mode system setting (ntsc, pal or pal-60, pal-m).
; <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 interlace
|-
| '''quasi-interlace:'''
| 15 or 18-22kHz segmented frame
|-
| '''non-interlace:'''
| 15 or 18-22kHz progressive
|-
| '''non-progressive:'''
| 31 or 27-33kHz interlace
|-
| '''progressive:'''
| 31 or 36-45kHz progressive
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> modes. Disabling halves the refresh rate for <code>progressive</code> modes.
:: This only works with the Component Video Cable.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2x video oversampling (default: auto). Enabling halves the refresh rate.
:: This only works with the Component Video Cable.
; <code>--osd</code>, <code>--no-osd</code>
: Show on-screen display (default: yes).
; <code>--ipv4-address=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 address.
; <code>--ipv4-gateway=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 gateway.
; <code>--ipv4-netmask=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 netmask.
; <code>--network</code>, <code>--no-network</code>
: Enable [[Broadband Adapter]] features (default: yes).
; <code>--stream[=<aaa.bbb.ccc.ddd>]</code>, <code>--no-stream</code>
: Stream video to IP address on UDP port 1234 (default: no). Defaults to 255.255.255.255 if not specified.
; <code>--enhance</code>, <code>--no-enhance</code>
: Enable Game Boy Player enhancements (default: yes).
: {| class="wikitable sortable"
! Title
! Feature(s)
|-
| ''[[wikipedia:Drill Dozer|Drill Dozer]]''
| Rumble
|-
| ''[[wikipedia:Game Boy Advance Video|Game Boy Advance Video]] Series''
| [[#Can I play Game Boy Advance Video?|Not compatible]]
|-
| ''[[wikipedia:Mario & Luigi: Superstar Saga|Mario & Luigi: Superstar Saga]]''
| Rumble, [[#Mario & Luigi: Superstar Saga|reduced contrast]]
|-
| ''[[wikipedia:Pokémon Pinball: Ruby & Sapphire|Pokémon Pinball: Ruby & Sapphire]]''
| Rumble
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kanji Keisanhen''
| Rumble, restored contrast
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kokugo Sansuu Shakai Rikahen''
| Rumble, restored contrast
|-
| ''[[wikipedia:Super Mario Advance 4: Super Mario Bros. 3|Super Mario Advance 4: Super Mario Bros. 3]]''
| Rumble, [[#Super Mario Bros. 3: Super Mario Advance 4|restored gamma]]
|}
: Note: Remove any accessory from the External Extension Connector, or the Rumble Feature will not work.
: Note: If you are using an EverDrive, make sure to turn off "Quick Boot" in the options, or the enhancements may not work.
; <code><path></code>
: Load Game Boy Advance multiboot ROM (default: default.mb.gz).
: Note: Paths are relative to /GBI
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.

== Comparisons ==

=== Video quality ===

==== Blackmagic Intensity Shuttle ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7180.pdf ADV7180] and [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7604.pdf ADV7604].

<gallery widths="240px" heights="160px">
File:GBI ADV7180 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI ADV7180 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI ADV7180 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI ADV7180 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
File:GBI ADV7604 HDRV.png|HD Retrovision Component Video Cable
File:GBI ADV7604 Component.png|Nintendo Component Video Cable
File:GBI ADV7604 GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI ADV7604 GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Datapath VisionRGB ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/AD9887A.pdf AD9887A].

<gallery widths="240px" heights="160px">
File:GBI AD9887A HDRV.png|HD Retrovision Component Video Cable
File:GBI AD9887A Component.png|Nintendo Component Video Cable
File:GBI AD9887A GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI AD9887A GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Hauppauge WinTV-HVR-1850 ====

Using [https://web.archive.org/web/20120509222042/http://conexant.com/servlets/DownloadServlet/PBR-200974-004.pdf?docid=975&revid=4 CX23888].

<gallery widths="240px" heights="160px">
File:GBI CX23888 NTSC.png|Nintendo RF Modulator (NTSC-J)
File:GBI CX23888 PAL-M.png|Nintendo RF Modulator (PAL-M)
File:GBI CX23888 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI CX23888 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI CX23888 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI CX23888 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
</gallery>

=== Sound emulation ===

==== ''Mega Man Zero 2'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gbp.flac Game Boy Player Start-up Disc]

==== ''Pokémon Sapphire'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gbp.flac Game Boy Player Start-up Disc]

=== Image doubling ===

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE None.png|None
File:GBI AXPE Scale2xEx.png|Scale2×Ex
File:GBI AXPE Scale2xPlus.png|Scale2×Plus
File:GBI AXPE Scale2x.png|Scale2×
File:GBI AXPE Eagle2x.png|Eagle2×
File:GBI AXPE Scan2x.png|Scan2×
File:GBI AXPE Normal2x.png|Normal2×
</gallery>

=== Color matrix ===

==== ''Golden Sun'' ====

<gallery widths="240px" heights="160px">
File:GBI AGSE Identity.png|Identity matrix
File:GBI AGSE GBA.png|Game Boy Advance
File:GBI AGSE GBC.png|Game Boy Color
File:GBI AGSE GBI.png|Game Boy Interface
File:GBI AGSE NDS.png|Nintendo DS
File:GBI AGSE Palm.png|Palm Treo 700p
File:GBI AGSE PSP.png|PlayStation Portable
File:GBI AGSE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Mario Kart: Super Circuit'' ====

<gallery widths="240px" heights="160px">
File:GBI AMKE Identity.png|Identity matrix
File:GBI AMKE GBA.png|Game Boy Advance
File:GBI AMKE GBC.png|Game Boy Color
File:GBI AMKE GBI.png|Game Boy Interface
File:GBI AMKE NDS.png|Nintendo DS
File:GBI AMKE Palm.png|Palm Treo 700p
File:GBI AMKE PSP.png|PlayStation Portable
File:GBI AMKE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity.png|Identity matrix
File:GBI AXPE GBA.png|Game Boy Advance
File:GBI AXPE GBC.png|Game Boy Color
File:GBI AXPE GBI.png|Game Boy Interface
File:GBI AXPE NDS.png|Nintendo DS
File:GBI AXPE Palm.png|Palm Treo 700p
File:GBI AXPE PSP.png|PlayStation Portable
File:GBI AXPE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''The Legend of Zelda: The Minish Cap'' ====

<gallery widths="240px" heights="160px">
File:GBI BZME Identity.png|Identity matrix
File:GBI BZME GBA.png|Game Boy Advance
File:GBI BZME GBC.png|Game Boy Color
File:GBI BZME GBI.png|Game Boy Interface
File:GBI BZME NDS.png|Nintendo DS
File:GBI BZME Palm.png|Palm Treo 700p
File:GBI BZME PSP.png|PlayStation Portable
File:GBI BZME VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Wario Land 4'' ====

<gallery widths="240px" heights="160px">
File:GBI AWAE Identity.png|Identity matrix
File:GBI AWAE GBA.png|Game Boy Advance
File:GBI AWAE GBC.png|Game Boy Color
File:GBI AWAE GBI.png|Game Boy Interface
File:GBI AWAE NDS.png|Nintendo DS
File:GBI AWAE Palm.png|Palm Treo 700p
File:GBI AWAE PSP.png|PlayStation Portable
File:GBI AWAE VBA.png|VisualBoyAdvance-M
</gallery>

== Examples ==

=== Color emulation ===

==== Game Boy Advance ====

[[File:GBI_Game_Boy_Advance.png|border|right]]
Using a contrast ratio of 250:1.

<pre>
--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177
</pre>

==== Nintendo DS ====

[[File:GBI_Nintendo_DS.png|border|right]]
Using a contrast ratio of 600:1.

<pre>
--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934
</pre>

==== Palm Treo 700p ====

[[File:GBI_Palm_Treo_700p.png|border|right]]
Using a contrast ratio of 75:1.

<pre>
--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364
</pre>

==== PlayStation Portable ====

[[File:GBI_PlayStation_Portable.png|border|right]]
Using a contrast ratio of 750:1.

<pre>
--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556
</pre>

=== Color restoration ===

==== ''Mario & Luigi: Superstar Saga'' ====

This game reduces contrast when played ''with'' Game Boy Player enhancements.

<pre>
--contrast=1.1
</pre>

==== ''Super Mario Bros. 3: Super Mario Advance 4'' ====

This game reduces gamma when played ''without'' Game Boy Player enhancements.

<pre>
--input-gamma=2.8
</pre>

==== ''The Legend of Zelda: Oracle of Ages/Seasons'' ====

This game reduces gamma when played on a Game Boy Advance.
Due to Game Boy Color limitations, only shadows can be restored perfectly.

<pre>
--input-gamma=4.
</pre>

=== Mimicking ===

==== Game Boy Player Start-up Disc ====

Included as <code>gbi.cli.example</code>.

<pre>
--aspect=4:3
--overlay=frame-srgb.tpl.gz
--dither=none
--matrix=identity
--input-gamma=1.
--output-gamma=1.
--contrast=.78125
--sound=analog=.000148021979839541018009185791015625:.00029604395967908203601837158203125:.000148021979839541018009185791015625:-1.965293407440185546875:.965885460376739501953125
--no-osd
</pre>

==== Wii U Virtual Console ====

<pre>
--aspect=16:9
--zoom=3
--no-overlay
--dither=none
--matrix=identity
--input-gamma=1.
--output-gamma=1.
--contrast=.75
--sound=digital
--no-osd
--no-enhance
</pre>

=== Video optimization ===

==== Datapath VisionRGB ====

The author's personal setup.

<pre>
--aspect=4:3
--offset=0
--zoom=4
--dither=bayer2x2
--scaler=nearest
--format=hd60
--scan-mode=non-interlace,clock2x,size2x
</pre>

* Resolution and Refresh
** Width: 960
** Height: 360
** Vertical Refresh: 60.00
* Video Adjustments
** Horizontal Position: 205
** Horizontal Size: 1200
** Phase: 31
** Vertical Position: 13
** Black Level: 8
* Cropping
** Top: 20
** Left: 0
** Width: 960
** Height: 320
* Color Adjustments
** Brightness: 32
** Contrast: 128
** Colour Domain: YUV (601)
** Colour Balance
*** All Colors
**** Brightness: 32
**** Contrast: 128
*** Red
**** Brightness: 158
**** Contrast: 158
*** Green
**** Brightness: 178
**** Contrast: 178
*** Blue
**** Brightness: 152
**** Contrast: 152

==== Open Source Scan Converter ====

<pre>
--aspect=4:3
--offset=0
--zoom=4
--filter=none
--scaler=nearest
--format=hd60
--scan-mode=non-interlace
</pre>

==== High-definition televisions ====

Change the Aspect Ratio on the television to Just Scan.

<pre>
--aspect=1.8
--zoom=3.375
--format=hd60
--scan-mode=non-progressive
</pre>

==== Video capture devices (Game Boy Advance) ====

<pre>
--aspect=3:2
--offset=0
--zoom=3
--dither=bayer2x2
--scaler=nearest
--format=ntsc
</pre>

==== Video capture devices (Game Boy Color) ====

<pre>
--aspect=5:4
--offset=0
--zoom=4
--dither=bayer2x2
--scaler=nearest
--format=pal
</pre>

== FAQs ==

=== How do I change Game Paks? ===

# Hold the Reset Button.
# Slide the Game Pak Ejector.
# Insert a Game Pak into the Game Pak Slot.
# Release the Reset Button.

=== Can I play [[wikipedia:Game Boy Advance Video|Game Boy Advance Video]]? ===

Yes. You can do so by disabling Game Boy Player enhancements (<code>--no-enhance</code>), or holding a direction while the Game Boy Player logo is visible.

=== Is this an emulator? Can I play ROMs? ===

No, but there's [[Enhanced mGBA]] if you're looking for one.

=== Why is there motion blur? Can I turn it off? ===

It removes stuttering caused by mismatches between the Game Boy Advance and the display refresh rate. It cannot be turned off. It can be reduced by using a 120Hz mode, but it's most effective on a sample-and-hold display.

=== What happens when I exit Game Boy Interface? ===

The Game Boy Player keeps running and you're returned to <code>autoexec.dol</code>, or the Nintendo GameCube Main Menu.

== Changelog ==

=== December, 2018 ===

* Fixed 360p RGBcvS sync issue.

=== October, 2018 ===

* Added HD Custom video format.

=== August, 2018 ===

* Updated color matrices by Pokefan531.

=== July, 2018 ===

* Updated GBA-as-GC controller.

=== June, 2018 ===

* Added analog sound emulation.
* Added Custom-M video format.
* Added Custom interlaced video modes.
* Changed default sound mode to analog.
* Changed brightness/contrast controls to match BT.1886.
* Fixed some audio bugs.
* Enabled progressive scan in more cases to prevent display issues.

=== May, 2018 ===

* Added 360p, 720i, 720p and 1080i video modes.
* Changed scan mode semantics.
* Changed default aspect ratio for progressive scan to 16:9.
* Fixed Game Boy Player advertisement.
* Fixed rumble protocol handshake.

=== April, 2018 ===

* Added movie recording/playback.
* Updated GBA-as-GC controller.

=== March, 2018 ===

* Improved multiboot implementation.
* Improved Game Boy sound quality.
* Improved audio rendering.
* Reduced audio latency.
* Changed default color matrix to GBI's original.
* Fixed SD card compatibility.
* Fixed multiboot to rumble protocol transition.

=== February, 2018 ===

* Added color matrix from Gambatte.
* Added mono sound mode.
* Fixed wiiload autoboot with tiny GBA multiboot ROMs.
* Disabled machine checks.

=== January, 2018 ===

* Updated color matrices by Pokefan531.
* Improved Game Boy Player driver.

=== September, 2017 ===

* Added overlay scale setting.
* Added Logitech Speed Force support.
* Added Active Life Mat support.
* Improved Game Boy Player driver.
* Changed wiiload server to accept oversized DOLs.
* Fixed one random kernel crash.

=== August, 2017 ===

* Added DK Bongos support.
* Updated color matrices by Pokefan531.
* Improved Game Boy Player driver.

=== July, 2017 ===

* Added CLI append support.
* Updated color matrices by Pokefan531.
* Updated GBA-as-GC controller.

=== April, 2017 ===

* Added component video DAC oversampling.
* Added experimental 960i and 1152i video modes.

=== March, 2017 ===

* Added temporal/spatial dithering.
* Added color matrices by Pokefan531.
* Added TPL overlay support to wiiload server.
* Changed default color matrix to Pokefan531's.
* Changed default gamma to 2.2.
* Optimized NormalNx filter.

=== February, 2017 ===

* Added volume control.
* Added per-channel settings where possible.
* Changed volume to 75% to mitigate clipping.
* Fixed framebuffer clearing for 576i.

=== November, 2016 ===

* Updated GBA-as-GC controller.
* Optimized Scale2xEx filter.

=== October, 2016 ===

* Added Scale2xEx and Scale2xPlus filters.
* Added oversample and box scalers.
* Added basic video streaming.
* Added Remote RetroPad support.
* Optimized video rendering.

=== September, 2016 ===

* Added polling rate setting.

=== May, 2016 ===

* Updated GBA-as-GC controller.
* Improved Game Boy Player driver.
* Fixed WaveBird Controllers.

=== April, 2016 ===

* Added GBA multiboot support to wiiload server.
* Added Xboo Communicator.
* Added BIOS/ROM dumper.
* Replaced GBA-as-controller with GBA-as-GC controller.

=== March, 2016 ===

* Added GBA-as-controller support.
* Recognized a half press of the analog triggers.

=== December, 2015 ===

* Expanded video options. Now includes 25, 30, 100 and 120 Hz modes.
* Added gamma-encoded borders for special use.

=== November, 2015 ===

* Added (GZipped) TPL overlay support.
* Added all 20 borders from the Game Boy Player Start-up Disc.

=== October, 2015 ===

* Added Scale2x, Eagle2x, Scan2x and Normal2x filters.

=== August, 2015 ===

* Added executable compression.
* Added return to <code>autoexec.dol</code>.
* Added memory card distribution files.
* Added auto-cropping for Game Boy screenshots.
* Optimized video rendering.
* Reduced coil whine.

=== July, 2015 ===

* Added rumble.
* Added hold to quit.
* Added screenshot saving.
* Added SNTP broadcast listener.
* Changed default video mode to interlaced.
* Fixed Game Boy Player detection.

=== May, 2015 ===

* Changed all 60 Hz modes to have 486 active lines.

=== March, 2015 ===

* Added digital PWM sound.
* Added turbo button.
* Fixed 288p.

[[Category:Homebrew_Software]]

Game Boy Interface/High-Fidelity Edition

2018-12-11T12:16:31Z

Eatnumber1: /* Options */ Add note about paths being relative to /GBI

{{:Game Boy Interface}}
A spiritual successor of the ultra-low latency version, '''Game Boy Interface High-Fidelity Edition''' ('''GBIHF''') aims to provide the best source quality for further processing or archival.

<div class="toclimit-4">
__TOC__
</div>

== Controls ==

=== Type A (two-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Y/Z Buttons
| Y/Z Buttons
| Select
|-
|
| X Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
| Top Right
| Blue or Orange Square
| +Control Pad Right
|-
| Top Left
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|}

=== Type B (one-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| L/Z Buttons
| Y/Z Buttons
| Select
|-
|
| R Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| Y/X Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
|
| Blue or Orange Square
| +Control Pad Right
|-
|
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|-
| Top Left/Right
|
| L/R Buttons
|}

=== Type C (''Super Mario World: Super Mario Advance 2'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| B/Y or X Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Z Button
| Y/Z Buttons
| Select
|-
|
| Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R or A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

=== Type D (''The Legend of Zelda: A Link to the Past'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| Y/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| R Button or Start/Pause
| Y/Z Buttons
| Select
|-
|
| L/Z Buttons
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| X/A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

== Options ==

; <code>--poll=<0-11></code>
: Set controller polling rate.
: {| 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
|}
; <code>--control=<P1[:P2[:P3[:P4]]]></code>
: Set control scheme. The default is the Game Boy Player Start-up Disc's Controller setting (0 or 1).
: {| class="wikitable"
| '''0:'''
| [[#Type A (two-handed)|Type A (two-handed)]]
|-
| '''1:'''
| [[#Type B (one-handed)|Type B (one-handed)]]
|-
| '''2:'''
| [[#Type C (Super Mario World: Super Mario Advance 2)|Type C (''Super Mario World: Super Mario Advance 2'')]]
|-
| '''3:'''
| [[#Type D (The Legend of Zelda: A Link to the Past)|Type D (''The Legend of Zelda: A Link to the Past'')]]
|}
: Note: A Game Boy Advance used as a controller is a Nintendo GameCube Controller.
; <code>--delay-reset=<N></code>
: Set reset delay (default: 0).
; <code>--delay-video=<N></code>
: Set video buffering (default: 1).
; <code>--movie=<path></code>, <code>--no-movie</code>
: Play input log (default: no).
; <code>--movie-record</code>, <code>--no-movie-record</code>
: Record input log (default: no).
; <code>--palette=<xxxx-xxxx-xxxx></code>, <code>--no-palette</code>
: Apply [https://gamefaqs.gamespot.com/snes/588731-super-game-boy/faqs/58647 Super Game Boy] color palette (default: no).
: Note: Press Left + B while the Game Boy logo is visible for proper application on original Game Boy Game Paks.
; <code>--lut3d=<path></code>, <code>--no-lut3d</code>
: Load 32x32x32 lookup table (default: no).
; <code>--lut3d-order=<rgb|gbr|bgr></code>
: Specify lookup table order (default: rgb).
; <code>--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba></code>
: Set color matrix (default: identity).
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gba:'''
| [[#Game Boy Advance|Game Boy Advance]] (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
|-
| '''nds:'''
| [[#Nintendo DS|Nintendo DS]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| [[#Palm Treo 700p|Palm Treo 700p]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| [[#PlayStation Portable|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])
|}
; <code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
; <code>--output-gamma=<value></code>
: Specify screen gamma (default: 2.2).
; <code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
; <code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; <code>--volume=<left[:right]></code>
: Set audio gain (default: 0.75).
; <code>--sound=<[mono|stereo][,digital|analog]></code>
: Set sound mode. The default is the Sound Mode system setting (mono or stereo).
:; <code>digital</code>
:: Use PWM decoder (default).
:; <code>analog[=<a0:a1:a2:b1:b2>]</code>
:: Use 2MHz biquad filter. Defaults to a second-order low-pass filter with a cut-off of 10kHz and a quality factor of √2 if not specified.
; <code>--colorspace=<ycc601|ycc709|ycc2020|rgb709|rgb2020></code>
: Set video color space (default: ycc601).
: This only works with the Component Video Cable.
: {| class="wikitable"
| '''ycc601:'''
| [[wikipedia:xvYCC|IEC 61966-2-4 xvYCC601]]
|-
| '''ycc709:'''
| [[wikipedia:xvYCC|IEC 61966-2-4 xvYCC709]]
|-
| '''ycc2020:'''
| [[wikipedia:Rec. 2020|ITU-R BT.2020 Y’C’BC’R]]
|-
| '''rgb709:'''
| [[wikipedia:sRGB|IEC 61966-2-1 sRGB]]
|-
| '''rgb2020:'''
| [[wikipedia:Rec. 2020|ITU-R BT.2020 R’G’B’]]
|}
; <code>--format=<ntsc|pal|pal-m|ntsc-50|pal-60|custom|custom-m|hd60|hd50|hd48|hdcustom></code>
: Set video format (default: custom).
; <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 (non-interlace or progressive).
: {| class="wikitable"
| '''interlace:'''
| 15 or 18-22kHz interlace
|-
| '''quasi-interlace:'''
| 15 or 18-22kHz segmented frame
|-
| '''non-interlace:'''
| 15 or 18-22kHz progressive
|-
| '''non-progressive:'''
| 31 or 27-33kHz interlace
|-
| '''progressive:'''
| 31 or 36-45kHz progressive
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> modes. Disabling halves the refresh rate for <code>progressive</code> modes.
:: This only works with the Component Video Cable.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2x video oversampling (default: auto). Enabling halves the refresh rate.
:: This only works with the Component Video Cable.
; <code>--usb</code>, <code>--no-usb</code>
: Enable [[USBGecko|USB Gecko]] features (default: yes).
; <code>--enhance</code>, <code>--no-enhance</code>
: Enable Game Boy Player enhancements (default: yes).
: {| class="wikitable sortable"
! Title
! Feature(s)
|-
| ''[[wikipedia:Drill Dozer|Drill Dozer]]''
| Rumble
|-
| ''[[wikipedia:Game Boy Advance Video|Game Boy Advance Video]] Series''
| [[#Can I play Game Boy Advance Video?|Not compatible]]
|-
| ''[[wikipedia:Mario & Luigi: Superstar Saga|Mario & Luigi: Superstar Saga]]''
| Rumble, [[#Mario & Luigi: Superstar Saga|reduced contrast]]
|-
| ''[[wikipedia:Pokémon Pinball: Ruby & Sapphire|Pokémon Pinball: Ruby & Sapphire]]''
| Rumble
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kanji Keisanhen''
| Rumble, restored contrast
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kokugo Sansuu Shakai Rikahen''
| Rumble, restored contrast
|-
| ''[[wikipedia:Super Mario Advance 4: Super Mario Bros. 3|Super Mario Advance 4: Super Mario Bros. 3]]''
| Rumble, [[#Super Mario Bros. 3: Super Mario Advance 4|restored gamma]]
|}
: Note: Remove any accessory from the External Extension Connector, or the Rumble Feature will not work.
: Note: If you are using an EverDrive, make sure to turn off "Quick Boot" in the options, or the enhancements may not work.
; <code><path></code>
: Load Game Boy Advance multiboot ROM (default: default.mb.gz).
: Paths are relative to working directory + /GBI
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.

== Comparisons ==

=== Video quality ===

==== Blackmagic Intensity Shuttle ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7180.pdf ADV7180] and [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7604.pdf ADV7604].

<gallery widths="240px" heights="160px">
File:GBIHF ADV7180 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBIHF ADV7180 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBIHF ADV7180 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBIHF ADV7180 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
File:GBIHF ADV7604 HDRV.png|HD Retrovision Component Video Cable
File:GBIHF ADV7604 Component.png|Nintendo Component Video Cable
File:GBIHF ADV7604 GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBIHF ADV7604 GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Datapath VisionRGB ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/AD9887A.pdf AD9887A].

<gallery widths="240px" heights="160px">
File:GBIHF AD9887A HDRV.png|HD Retrovision Component Video Cable
File:GBIHF AD9887A Component.png|Nintendo Component Video Cable
File:GBIHF AD9887A GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBIHF AD9887A GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Hauppauge WinTV-HVR-1850 ====

Using [https://web.archive.org/web/20120509222042/http://conexant.com/servlets/DownloadServlet/PBR-200974-004.pdf?docid=975&revid=4 CX23888].

<gallery widths="240px" heights="160px">
File:GBIHF CX23888 NTSC.png|Nintendo RF Modulator (NTSC-J)
File:GBIHF CX23888 PAL-M.png|Nintendo RF Modulator (PAL-M)
File:GBIHF CX23888 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBIHF CX23888 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBIHF CX23888 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBIHF CX23888 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
</gallery>

=== Sound emulation ===

==== ''Mega Man Zero 2'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gbp.flac Game Boy Player Start-up Disc]

==== ''Pokémon Sapphire'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gbp.flac Game Boy Player Start-up Disc]

=== 3D lookup table ===

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity LUT.png|Identity LUT <code>lutrgb.png</code>
File:GBI AXPE GBA Light LUT.png|Game Boy Advance <code>lutrgb-gba-light.png</code>
File:GBI AXPE GBA LUT.png|Game Boy Advance <code>lutrgb-gba.png</code>
File:GBI AXPE GBC LUT.png|Gambatte/higan <code>lutrgb-gbc.png</code>
File:GBI AXPE GBP LUT.png|Game Boy Player Start-up Disc <code>lutrgb-gbp.png</code>
File:GBI AXPE NDS LUT.png|Nintendo DS <code>lutrgb-nds.png</code>
File:GBI AXPE VBA LUT.png|VisualBoyAdvance-M <code>lutrgb-vba.png</code>
File:GBI AXPE WiiU LUT.png|Wii U Virtual Console <code>lutrgb-wiiu.png</code>
</gallery>

=== Color matrix ===

==== ''Golden Sun'' ====

<gallery widths="240px" heights="160px">
File:GBI AGSE Identity.png|Identity matrix
File:GBI AGSE GBA.png|Game Boy Advance
File:GBI AGSE GBC.png|Game Boy Color
File:GBI AGSE GBI.png|Game Boy Interface
File:GBI AGSE NDS.png|Nintendo DS
File:GBI AGSE Palm.png|Palm Treo 700p
File:GBI AGSE PSP.png|PlayStation Portable
File:GBI AGSE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Mario Kart: Super Circuit'' ====

<gallery widths="240px" heights="160px">
File:GBI AMKE Identity.png|Identity matrix
File:GBI AMKE GBA.png|Game Boy Advance
File:GBI AMKE GBC.png|Game Boy Color
File:GBI AMKE GBI.png|Game Boy Interface
File:GBI AMKE NDS.png|Nintendo DS
File:GBI AMKE Palm.png|Palm Treo 700p
File:GBI AMKE PSP.png|PlayStation Portable
File:GBI AMKE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity.png|Identity matrix
File:GBI AXPE GBA.png|Game Boy Advance
File:GBI AXPE GBC.png|Game Boy Color
File:GBI AXPE GBI.png|Game Boy Interface
File:GBI AXPE NDS.png|Nintendo DS
File:GBI AXPE Palm.png|Palm Treo 700p
File:GBI AXPE PSP.png|PlayStation Portable
File:GBI AXPE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''The Legend of Zelda: The Minish Cap'' ====

<gallery widths="240px" heights="160px">
File:GBI BZME Identity.png|Identity matrix
File:GBI BZME GBA.png|Game Boy Advance
File:GBI BZME GBC.png|Game Boy Color
File:GBI BZME GBI.png|Game Boy Interface
File:GBI BZME NDS.png|Nintendo DS
File:GBI BZME Palm.png|Palm Treo 700p
File:GBI BZME PSP.png|PlayStation Portable
File:GBI BZME VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Wario Land 4'' ====

<gallery widths="240px" heights="160px">
File:GBI AWAE Identity.png|Identity matrix
File:GBI AWAE GBA.png|Game Boy Advance
File:GBI AWAE GBC.png|Game Boy Color
File:GBI AWAE GBI.png|Game Boy Interface
File:GBI AWAE NDS.png|Nintendo DS
File:GBI AWAE Palm.png|Palm Treo 700p
File:GBI AWAE PSP.png|PlayStation Portable
File:GBI AWAE VBA.png|VisualBoyAdvance-M
</gallery>

== Examples ==

=== Color emulation ===

==== Game Boy Advance ====

[[File:GBI_Game_Boy_Advance.png|border|right]]
Using a contrast ratio of 250:1.

<pre>
--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177
</pre>

==== Nintendo DS ====

[[File:GBI_Nintendo_DS.png|border|right]]
Using a contrast ratio of 600:1.

<pre>
--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934
</pre>

==== Palm Treo 700p ====

[[File:GBI_Palm_Treo_700p.png|border|right]]
Using a contrast ratio of 75:1.

<pre>
--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364
</pre>

==== PlayStation Portable ====

[[File:GBI_PlayStation_Portable.png|border|right]]
Using a contrast ratio of 750:1.

<pre>
--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556
</pre>

=== Color restoration ===

==== ''Mario & Luigi: Superstar Saga'' ====

This game reduces contrast when played ''with'' Game Boy Player enhancements.

<pre>
--contrast=1.1
</pre>

==== ''Super Mario Bros. 3: Super Mario Advance 4'' ====

This game reduces gamma when played ''without'' Game Boy Player enhancements.

<pre>
--input-gamma=2.8
</pre>

==== ''The Legend of Zelda: Oracle of Ages/Seasons'' ====

This game reduces gamma when played on a Game Boy Advance.
Due to Game Boy Color limitations, only shadows can be restored perfectly.

<pre>
--input-gamma=4.
</pre>

=== Video optimization ===

==== Datapath VisionRGB (Component Video Cable) ====

<pre>
--colorspace=rgb709
--scan-mode=non-interlace,clock2x,size2x
</pre>

* Resolution and Refresh
** Width: 360
** Height: 240
** Vertical Refresh: 59.72
* Video Adjustments
** Horizontal Position: 65
** Horizontal Size: 433
** Phase: 27
** Vertical Position: 18
** Black Level: 8
* Cropping
** Top: 40
** Left: 60
** Width: 240
** Height: 160
* Color Adjustments
** Brightness: 32
** Contrast: 128
** Colour Domain: RGB (601)
** Colour Balance
*** All Colors
**** Brightness: 32
**** Contrast: 128
*** Red
**** Brightness: 156
**** Contrast: 156
*** Green
**** Brightness: 166
**** Contrast: 166
*** Blue
**** Brightness: 148
**** Contrast: 148

==== Open Source Scan Converter ====

Included as <code>gbihf-ossc.cli</code>, <code>gbihf-ossc.dol+cli</code> and <code>gbihf-ossc.gci</code>.

<pre>
--format=hd60
--scan-mode=non-interlace
</pre>

==== XRGB-mini Framemeister ====

Included as <code>gbihf-xrgb.cli</code>, <code>gbihf-xrgb.dol+cli</code> and <code>gbihf-xrgb.gci</code>.
Refer to [http://www.firebrandx.com/framemeisterprofiles.html FirebrandX] for configuration.

<pre>
--format=custom-m
--scan-mode=non-interlace
</pre>

==== High-definition televisions ====

Change the Aspect Ratio on the television to Zoom 1.

<pre>
--colorspace=ycc709
--format=hd60
--scan-mode=non-progressive
</pre>

== FAQs ==

=== How do I change Game Paks? ===

# Hold the Reset Button.
# Slide the Game Pak Ejector.
# Insert a Game Pak into the Game Pak Slot.
# Release the Reset Button.

=== Can I play [[wikipedia:Game Boy Advance Video|Game Boy Advance Video]]? ===

Yes. You can do so by disabling Game Boy Player enhancements (<code>--no-enhance</code>), or holding a direction while the Game Boy Player logo is visible.

=== Is this an emulator? Can I play ROMs? ===

No, but there's [[Enhanced mGBA]] if you're looking for one.

== Changelog ==

=== December, 2018 ===

* Fixed 360p RGBcvS sync issue.

=== October, 2018 ===

* Added HD Custom video format.

=== August, 2018 ===

* Updated color matrices by Pokefan531.

=== July, 2018 ===

* Updated GBA-as-GC controller.

=== June, 2018 ===

* Added analog sound emulation.
* Added video options.
* Added component video DAC oversampling.
* Changed brightness/contrast controls to match BT.1886.
* Fixed some audio bugs.
* Removed left/right chroma location support.

=== May, 2018 ===

* Added Super Game Boy color palette setting.
* Changed default chroma location to center.
* Fixed Game Boy Player advertisement.
* Fixed rumble protocol handshake.

=== April, 2018 ===

* Added movie recording/playback.
* Updated GBA-as-GC controller.

=== March, 2018 ===

* Added RGB Sync-on-Green support.
* Added xvYCC/BT.2020 support for auto-generated 3D LUT.
* Added control swapping for SNES Controllers.
* Added center/right chroma location support.
* Improved multiboot implementation.
* Fixed SD card compatibility.
* Fixed multiboot to rumble protocol transition.

== Media ==

* [https://www.youtube.com/watch?v=SN-r2bl7bV8 Console Verified: GBC Pokémon: Blue Version "warp glitch" by gifvex in 10:11.25]
* [https://www.youtube.com/watch?v=i8ROeArTVyQ Console Verified: GBC Pokémon: Blue Version "Gotta Catch 'Em All!" by luckytyphlosion in 37:54.11]
* [https://www.youtube.com/watch?v=40z__x55Ix0 Console Verified: GBA Sonic Advance by Mukki & ruadath in 10:49.75]
* [https://www.youtube.com/watch?v=VqPV513Fd9w Console Verified: GBA Sonic Advance by Mukki in 11:02.64]
* [https://www.youtube.com/watch?v=kZSfK7u3P2Y Console Verified: GBA Sonic Advance 2 by Mukki in 18:09.45]
* [https://www.youtube.com/watch?v=F6t0fdHay_o Console Verified: GBC Pokémon: Yellow Version by TiKevin83 in 1:36:34.55]

[[Category:Homebrew_Software]]

Game Boy Interface/Speedrunning Edition

2018-12-11T12:16:01Z

Eatnumber1: /* Options */ Add note about paths being relative to /GBI

{{:Game Boy Interface}}
Formerly the (ultra-)low latency version, '''Game Boy Interface Speedrunning Edition''' ('''GBISR''') features a simplified video renderer, and aims to meet the needs of most [[wikipedia:Speedrun|speedrunning]] communities.

<div class="toclimit-4">
__TOC__
</div>

== Controls ==

=== Type A (two-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Y/Z Buttons
| Y/Z Buttons
| Select
|-
|
| X Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|-
|
| C Stick Down
|
| Toggle input viewer
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
| Top Right
| Blue or Orange Square
| +Control Pad Right
|-
| Top Left
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|}

=== Type B (one-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| L/Z Buttons
| Y/Z Buttons
| Select
|-
|
| R Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| Y/X Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
|
| Blue or Orange Square
| +Control Pad Right
|-
|
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|-
| Top Left/Right
|
| L/R Buttons
|}

=== Type C (''Super Mario World: Super Mario Advance 2'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| B/Y or X Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Z Button
| Y/Z Buttons
| Select
|-
|
| Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R or A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|-
|
| C Stick Down
|
| Toggle input viewer
|}

=== Type D (''The Legend of Zelda: A Link to the Past'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| Y/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| R Button or Start/Pause
| Y/Z Buttons
| Select
|-
|
| L/Z Buttons
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| X/A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

== Options ==

; <code>--offset=<x:y></code>
: Set offset (default: 0).
; <code>--zoom=<x:y></code>
: Set zoom (default: 2.0).
; <code>--rotate=<0-359></code>
: Set rotation (default: 0).
; <code>--poll=<0-11></code>
: Set controller polling rate.
: {| 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
|}
; <code>--control=<P1[:P2[:P3[:P4]]]></code>
: Set control scheme. The default is the Game Boy Player Start-up Disc's Controller setting (0 or 1).
: {| class="wikitable"
| '''0:'''
| [[#Type A (two-handed)|Type A (two-handed)]]
|-
| '''1:'''
| [[#Type B (one-handed)|Type B (one-handed)]]
|-
| '''2:'''
| [[#Type C (Super Mario World: Super Mario Advance 2)|Type C (''Super Mario World: Super Mario Advance 2'')]]
|-
| '''3:'''
| [[#Type D (The Legend of Zelda: A Link to the Past)|Type D (''The Legend of Zelda: A Link to the Past'')]]
|}
: Note: A Game Boy Advance used as a controller is a Nintendo GameCube Controller.
; <code>--delay-reset=<N></code>
: Set reset delay (default: 75).
; <code>--delay-video=<N></code>
: Set video buffering (default: 1).
; <code>--movie=<path></code>, <code>--no-movie</code>
: Play input log (default: no).
; <code>--movie-record</code>, <code>--no-movie-record</code>
: Record input log (default: no).
; <code>--overlay=<path></code>, <code>--no-overlay</code>
: Load texture palette (default: frame-srgb.tpl.gz).
; <code>--overlay-id=<ID></code>
: Set texture palette index. The default is the Game Boy Player Start-up Disc's Frame setting (0 to 19).
; <code>--overlay-scale=<x:y></code>
: Set texture scale (default: auto).
; <code>--palette=<xxxx-xxxx-xxxx></code>, <code>--no-palette</code>
: Apply [https://gamefaqs.gamespot.com/snes/588731-super-game-boy/faqs/58647 Super Game Boy] color palette (default: no).
: Note: Press Left + B while the Game Boy logo is visible for proper application on original Game Boy Game Paks.
; <code>--lut3d=<path></code>, <code>--no-lut3d</code>
: Load 32x32x32 lookup table (default: no).
; <code>--lut3d-order=<rgb|gbr|bgr></code>
: Specify lookup table order (default: rgb).
; <code>--scaler=<nearest|bilinear|oversample|box></code>
: Set image scaling filter (default: nearest).
; <code>--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba></code>
: Set color matrix (default: identity).
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gba:'''
| [[#Game Boy Advance|Game Boy Advance]] (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
|-
| '''nds:'''
| [[#Nintendo DS|Nintendo DS]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| [[#Palm Treo 700p|Palm Treo 700p]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| [[#PlayStation Portable|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])
|}
; <code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
; <code>--output-gamma=<value></code>
: Specify screen gamma (default: 2.2).
; <code>--gamma=<even[:odd]></code>
: Set gamma correction (default: 1.0).
; <code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
; <code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; <code>--blend=<value></code>
: Set alpha blending (default: 1.0).
; <code>--background=<#rrggbb></code>
: Set background color (default: #000000).
; <code>--vfilter=<middle[:lower[:upper]]></code>
: Set vertical filter coefficients (default: 1.0).
; <code>--volume=<left[:right]></code>
: Set audio gain (default: 0.75).
; <code>--sound=<[mono|stereo][,digital|analog]></code>
: Set sound mode. The default is the Sound Mode system setting (mono or stereo).
:; <code>digital</code>
:: Use PWM decoder (default).
:; <code>analog[=<a0:a1:a2:b1:b2>]</code>
:: Use 2MHz biquad filter. Defaults to a second-order low-pass filter with a cut-off of 10kHz and a quality factor of √2 if not specified.
; <code>--format=<[ntsc|pal|pal-m|ntsc-50|pal-60|custom|custom-m][,offset=<x:y>][,scaled-size=<w:h>][,size=<w:h>]></code>
: Set video format. The default is the Video Mode or Progressive Scan Mode system setting (ntsc, pal-60, pal-m, or custom).
:; <code>offset=<x:y></code>
:: Set screen position. The default is the Screen Position system setting (-32 to +32).
:; <code>scaled-size=<w:h></code>
:: Set screen size (default: auto).
:; <code>size=<w:h></code>
:: Set internal resolution (default: 640:480).
; <code>--scan-mode=<[interlace|quasi-interlace|non-interlace|progressive][,clock2x|no-clock2x][,size2x|no-size2x]></code>
: Set scan mode. The default is the Progressive Scan Mode system setting (non-interlace or progressive).
: {| class="wikitable"
| '''interlace:'''
| 15kHz interlace
|-
| '''quasi-interlace:'''
| 15kHz segmented frame
|-
| '''non-interlace:'''
| 15kHz progressive
|-
| '''progressive:'''
| 31kHz progressive
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> modes. Disabling halves the refresh rate for <code>progressive</code> modes.
:: This only works with the Component Video Cable.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2x video oversampling (default: no). Enabling halves the refresh rate.
:: This only works with the Component Video Cable.
; <code>--osd-input[=<x:y>]</code>, <code>--no-osd-input</code>
: Show input viewer (default: no). Defaults to 0:-64 if not specified.
; <code>--usb</code>, <code>--no-usb</code>
: Enable [[USBGecko|USB Gecko]] features (default: yes).
; <code>--enhance</code>, <code>--no-enhance</code>
: Enable Game Boy Player enhancements (default: no). Enabling this option is not recommended.
: {| class="wikitable sortable"
! Title
! Feature(s)
|-
| ''[[wikipedia:Drill Dozer|Drill Dozer]]''
| Rumble
|-
| ''[[wikipedia:Game Boy Advance Video|Game Boy Advance Video]] Series''
| [[#Can I play Game Boy Advance Video?|Not compatible]]
|-
| ''[[wikipedia:Mario & Luigi: Superstar Saga|Mario & Luigi: Superstar Saga]]''
| Rumble, [[#Mario & Luigi: Superstar Saga|reduced contrast]]
|-
| ''[[wikipedia:Pokémon Pinball: Ruby & Sapphire|Pokémon Pinball: Ruby & Sapphire]]''
| Rumble
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kanji Keisanhen''
| Rumble, restored contrast
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kokugo Sansuu Shakai Rikahen''
| Rumble, restored contrast
|-
| ''[[wikipedia:Super Mario Advance 4: Super Mario Bros. 3|Super Mario Advance 4: Super Mario Bros. 3]]''
| Rumble, [[#Super Mario Bros. 3: Super Mario Advance 4|restored gamma]]
|}
: Note: Remove any accessory from the External Extension Connector, or the Rumble Feature will not work.
: Note: If you are using an EverDrive, make sure to turn off "Quick Boot" in the options, or the enhancements may not work.
; <code><path></code>
: Load Game Boy Advance multiboot ROM. Using this option is not recommended.
: Paths are relative to working directory + /GBI
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.

== Comparisons ==

=== Video quality ===

==== Blackmagic Intensity Shuttle ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7180.pdf ADV7180] and [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7604.pdf ADV7604].

<gallery widths="240px" heights="160px">
File:GBI ADV7180 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI ADV7180 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI ADV7180 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI ADV7180 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
File:GBI ADV7604 HDRV.png|HD Retrovision Component Video Cable
File:GBI ADV7604 Component.png|Nintendo Component Video Cable
File:GBI ADV7604 GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI ADV7604 GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Datapath VisionRGB ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/AD9887A.pdf AD9887A].

<gallery widths="240px" heights="160px">
File:GBI AD9887A HDRV.png|HD Retrovision Component Video Cable
File:GBI AD9887A Component.png|Nintendo Component Video Cable
File:GBI AD9887A GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI AD9887A GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Hauppauge WinTV-HVR-1850 ====

Using [https://web.archive.org/web/20120509222042/http://conexant.com/servlets/DownloadServlet/PBR-200974-004.pdf?docid=975&revid=4 CX23888].

<gallery widths="240px" heights="160px">
File:GBI CX23888 NTSC.png|Nintendo RF Modulator (NTSC-J)
File:GBI CX23888 PAL-M.png|Nintendo RF Modulator (PAL-M)
File:GBI CX23888 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI CX23888 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI CX23888 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI CX23888 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
</gallery>

=== Sound emulation ===

==== ''Mega Man Zero 2'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gbp.flac Game Boy Player Start-up Disc]

==== ''Pokémon Sapphire'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gbp.flac Game Boy Player Start-up Disc]

=== 3D lookup table ===

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity LUT.png|Identity LUT <code>lutrgb.png</code>
File:GBI AXPE GBA Light LUT.png|Game Boy Advance <code>lutrgb-gba-light.png</code>
File:GBI AXPE GBA LUT.png|Game Boy Advance <code>lutrgb-gba.png</code>
File:GBI AXPE GBC LUT.png|Gambatte/higan <code>lutrgb-gbc.png</code>
File:GBI AXPE GBP LUT.png|Game Boy Player Start-up Disc <code>lutrgb-gbp.png</code>
File:GBI AXPE NDS LUT.png|Nintendo DS <code>lutrgb-nds.png</code>
File:GBI AXPE VBA LUT.png|VisualBoyAdvance-M <code>lutrgb-vba.png</code>
File:GBI AXPE WiiU LUT.png|Wii U Virtual Console <code>lutrgb-wiiu.png</code>
</gallery>

=== Color matrix ===

==== ''Golden Sun'' ====

<gallery widths="240px" heights="160px">
File:GBI AGSE Identity.png|Identity matrix
File:GBI AGSE GBA.png|Game Boy Advance
File:GBI AGSE GBC.png|Game Boy Color
File:GBI AGSE GBI.png|Game Boy Interface
File:GBI AGSE NDS.png|Nintendo DS
File:GBI AGSE Palm.png|Palm Treo 700p
File:GBI AGSE PSP.png|PlayStation Portable
File:GBI AGSE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Mario Kart: Super Circuit'' ====

<gallery widths="240px" heights="160px">
File:GBI AMKE Identity.png|Identity matrix
File:GBI AMKE GBA.png|Game Boy Advance
File:GBI AMKE GBC.png|Game Boy Color
File:GBI AMKE GBI.png|Game Boy Interface
File:GBI AMKE NDS.png|Nintendo DS
File:GBI AMKE Palm.png|Palm Treo 700p
File:GBI AMKE PSP.png|PlayStation Portable
File:GBI AMKE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity.png|Identity matrix
File:GBI AXPE GBA.png|Game Boy Advance
File:GBI AXPE GBC.png|Game Boy Color
File:GBI AXPE GBI.png|Game Boy Interface
File:GBI AXPE NDS.png|Nintendo DS
File:GBI AXPE Palm.png|Palm Treo 700p
File:GBI AXPE PSP.png|PlayStation Portable
File:GBI AXPE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''The Legend of Zelda: The Minish Cap'' ====

<gallery widths="240px" heights="160px">
File:GBI BZME Identity.png|Identity matrix
File:GBI BZME GBA.png|Game Boy Advance
File:GBI BZME GBC.png|Game Boy Color
File:GBI BZME GBI.png|Game Boy Interface
File:GBI BZME NDS.png|Nintendo DS
File:GBI BZME Palm.png|Palm Treo 700p
File:GBI BZME PSP.png|PlayStation Portable
File:GBI BZME VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Wario Land 4'' ====

<gallery widths="240px" heights="160px">
File:GBI AWAE Identity.png|Identity matrix
File:GBI AWAE GBA.png|Game Boy Advance
File:GBI AWAE GBC.png|Game Boy Color
File:GBI AWAE GBI.png|Game Boy Interface
File:GBI AWAE NDS.png|Nintendo DS
File:GBI AWAE Palm.png|Palm Treo 700p
File:GBI AWAE PSP.png|PlayStation Portable
File:GBI AWAE VBA.png|VisualBoyAdvance-M
</gallery>

== Examples ==

=== Color emulation ===

==== Game Boy Advance ====

[[File:GBI_Game_Boy_Advance.png|border|right]]
Using a contrast ratio of 250:1.

<pre>
--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177
</pre>

==== Nintendo DS ====

[[File:GBI_Nintendo_DS.png|border|right]]
Using a contrast ratio of 600:1.

<pre>
--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934
</pre>

==== Palm Treo 700p ====

[[File:GBI_Palm_Treo_700p.png|border|right]]
Using a contrast ratio of 75:1.

<pre>
--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364
</pre>

==== PlayStation Portable ====

[[File:GBI_PlayStation_Portable.png|border|right]]
Using a contrast ratio of 750:1.

<pre>
--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556
</pre>

=== Color restoration ===

==== ''Mario & Luigi: Superstar Saga'' ====

This game reduces contrast when played ''with'' Game Boy Player enhancements.

<pre>
--contrast=1.1
</pre>

==== ''Super Mario Bros. 3: Super Mario Advance 4'' ====

This game reduces gamma when played ''without'' Game Boy Player enhancements.

<pre>
--input-gamma=2.8
</pre>

==== ''The Legend of Zelda: Oracle of Ages/Seasons'' ====

This game reduces gamma when played on a Game Boy Advance.
Due to Game Boy Color limitations, only shadows can be restored perfectly.

<pre>
--input-gamma=4.
</pre>

=== Mimicking ===

==== Game Boy Interface (ultra-low latency) ====

<pre>
--delay-reset=0
--delay-video=0
--no-overlay
--format=custom,scaled-size=528:320,size=480:320
</pre>

==== Game Boy Player Start-up Disc (60Hz) ====

Included as <code>gbisr.cli.example</code>.

<pre>
--delay-video=2
--contrast=.78125
--vfilter=.5:.25:.25
--sound=analog=.000148021979839541018009185791015625:.00029604395967908203601837158203125:.000148021979839541018009185791015625:-1.965293407440185546875:.965885460376739501953125
--format=ntsc,scaled-size=666:448,size=608:448
--scan-mode=interlace
--enhance
</pre>

==== Game Boy Player Start-up Disc (50Hz) ====

<pre>
--delay-reset=65
--delay-video=2
--contrast=.78125
--vfilter=.5:.25:.25
--sound=analog=.000148021979839541018009185791015625:.00029604395967908203601837158203125:.000148021979839541018009185791015625:-1.965293407440185546875:.965885460376739501953125
--format=pal,scaled-size=670:530,size=608:448
--scan-mode=interlace
--enhance
</pre>

==== Nintendo 3DS Virtual Console ====

===== ''F-Zero Maximum Velocity'', ''Fire Emblem: The Sacred Stones'', ''Mario vs. Donkey Kong'' and ''The Legend of Zelda: The Minish Cap'' =====

<pre>
--contrast=.7
--blend=.75
</pre>

===== ''Kirby & The Amazing Mirror'' =====

<pre>
--contrast=.6
--blend=.5625
</pre>

===== ''Mario Kart: Super Circuit'' =====

<pre>
--contrast=.65
--blend=.75
</pre>

===== ''Metroid Fusion'' =====

<pre>
--contrast=.7
--blend=.5625
</pre>

===== ''Wario Land 4'' and ''WarioWare, Inc.: Mega Microgame$'' =====

<pre>
--contrast=.65
--blend=.5625
</pre>

===== ''Yoshi's Island: Super Mario Advance 3'' =====

<pre>
--contrast=.6
--blend=.5
</pre>

=== Video optimization ===

==== Datapath VisionRGB (Component Video Cable) ====

<pre>
--vfilter=.5:.5:.0:.5:.0:.5
--format=custom,offset=0,scaled-size=0
--scan-mode=non-interlace,clock2x
</pre>

* Resolution and Refresh
** Width: 320
** Height: 240
** Vertical Refresh: 119.45
* Video Adjustments
** Horizontal Position: 85
** Horizontal Size: 433
** Phase: 27
** Vertical Position: 18
** Black Level: 8
* Cropping
** Top: 40
** Left: 40
** Width: 240
** Height: 160
* Color Adjustments
** Brightness: 32
** Contrast: 128
** Colour Domain: YUV (601)
** Colour Balance
*** All Colors
**** Brightness: 32
**** Contrast: 128
*** Red
**** Brightness: 158
**** Contrast: 158
*** Green
**** Brightness: 170
**** Contrast: 170
*** Blue
**** Brightness: 152
**** Contrast: 152

==== Open Source Scan Converter ====

Included as <code>gbisr-ossc.cli</code>, <code>gbisr-ossc.dol+cli</code> and <code>gbisr-ossc.gci</code>.
Refer to [http://www.firebrandx.com/gbiosscoptimal.html FirebrandX] for configuration.

<pre>
--vfilter=.5:.5:.0:.5:.0:.5
--format=custom,offset=0,scaled-size=0
--scan-mode=non-interlace
</pre>

==== XRGB-mini Framemeister ====

Included as <code>gbisr-xrgb.cli</code>, <code>gbisr-xrgb.dol+cli</code> and <code>gbisr-xrgb.gci</code>.
Refer to [http://www.firebrandx.com/framemeisterprofiles.html FirebrandX] for configuration.

<pre>
--vfilter=.5:.5:.0:.5:.0:.5
--format=custom-m,offset=0,scaled-size=0
--scan-mode=non-interlace
</pre>

=== Video output ===

==== 120Hz black frame insertion ====

<pre>
--vfilter=.5:.5:.0:.0
--scan-mode=non-interlace,clock2x
</pre>

==== 480p hybrid scanlines ====

<pre>
--overlay=frame.tpl.gz
--gamma=2.2:1.
--scan-mode=progressive
</pre>

==== 480p simple scanlines ====

<pre>
--vfilter=.5:.5:.0:.0
--scan-mode=progressive
</pre>

=== Video scaling ===

==== 4:3 fullscreen (Game Boy Advance) ====

<pre>
--zoom=2.375
--scaler=oversample
--vfilter=.625:.1875:.1875
--scan-mode=interlace
</pre>

==== 4:3 fullscreen (Game Boy Color) ====

<pre>
--zoom=3
--vfilter=.5:.25:.25
--scan-mode=interlace
</pre>

<pre>
--zoom=3
--vfilter=.5:.5:.0:.5:.0:.5
--scan-mode=non-interlace
</pre>

==== 16:9 fullscreen ====

<pre>
--zoom=2:3
--format=size=568
--scan-mode=progressive
</pre>

== FAQs ==

=== How do I change Game Paks? ===

# Hold the Reset Button.
# Slide the Game Pak Ejector.
# Insert a Game Pak into the Game Pak Slot.
# Release the Reset Button.

=== Can I play [[wikipedia:Game Boy Advance Video|Game Boy Advance Video]]? ===

Yes. You can do so by disabling Game Boy Player enhancements (<code>--no-enhance</code>), or holding a direction while the Game Boy Player logo is visible.

=== Is this an emulator? Can I play ROMs? ===

No, but there's [[Enhanced mGBA]] if you're looking for one.

== Changelog ==

=== August, 2018 ===

* Updated color matrices by Pokefan531.

=== July, 2018 ===

* Updated GBA-as-GC controller.
* Disabled component video DAC oversampling.

=== June, 2018 ===

* Added analog sound emulation.
* Added Custom-M video format.
* Added Custom interlaced video modes.
* Merged vertical filter controls.
* Changed brightness/contrast controls to match BT.1886.
* Fixed some audio bugs.
* Enabled progressive scan in more cases to prevent display issues.

=== May, 2018 ===

* Added Super Game Boy color palette setting.
* Changed scan mode semantics.
* Fixed Game Boy Player advertisement.
* Fixed rumble protocol handshake.

=== April, 2018 ===

* Added movie recording/playback.
* Updated GBA-as-GC controller.

=== March, 2018 ===

* Added control swapping for SNES Controllers.
* Added framebuffer size/offset setting.
* Replaced sample aspect ratio with scaled size.
* Improved per-field filtering in single-buffered mode.
* Improved multiboot implementation.
* Improved Game Boy sound quality.
* Improved audio rendering.
* Reduced audio latency.
* Fixed SD card compatibility.
* Fixed multiboot to rumble protocol transition.
* Disabled default multiboot.

=== February, 2018 ===

* Added background color setting.
* Added video buffering setting.
* Added input viewer.
* Added color matrix from Gambatte.
* Added mono sound mode.
* Added 3D LUT auto-generation.
* Added GBR/BGR LUT order support.
* Added per-field gamma correction control.
* Changed some argument semantics.
* Fixed per-field settings with default video mode.
* Fixed wiiload autoboot with tiny GBA multiboot ROMs.
* Disabled machine checks.

=== January, 2018 ===

* Updated LUTs by Pokefan531.
* Improved Game Boy Player driver.
* Changed default component video modes.
* Tweaked control type C.

=== September, 2017 ===

* Added overlay scale setting.
* Added Logitech Speed Force support.
* Added Active Life Mat support.
* Improved Game Boy Player driver.
* Changed zoom scale.
* Changed wiiload server to accept oversized DOLs.
* Fixed one random kernel crash.
* Fixed scaling without a 3D LUT.

=== August, 2017 ===

* Added DK Bongos support.
* Adapted control type C for Super Mario World: Super Mario Advance 2.
* Added control type D for The Legend of Zelda: A Link to the Past.
* Added per-field vertical filter control.
* Added PNG 3D LUT support.
* Added LUTs by Pokefan531.
* Added LUTs from the 3DS Virtual Console.
* Improved Game Boy Player driver.

=== July, 2017 ===

* Added CLI append support.
* Updated GBA-as-GC controller.
* Changed reset combo behavior.

=== June, 2017 ===

* Added zoom & rotate.
* Added reset delay.
* Added reset combo.

=== April, 2017 ===

* Added component video DAC oversampling.
* Added reset fade effect.
* Added TPL overlay support.

=== March, 2017 ===

* Added rumble, disabled by default.
* Added USB Gecko wiiload server.
* Added Xboo Communicator.

=== February, 2017 ===

* Added volume control.
* Added per-channel settings where possible.
* Changed volume to 75% to mitigate clipping.

=== November, 2016 ===

* Updated GBA-as-GC controller.

=== September, 2016 ===

* Added video options.
* Added control schemes.
* Added polling rate setting.

=== May, 2016 ===

* Updated GBA-as-GC controller.
* Improved Game Boy Player driver.
* Fixed WaveBird Controllers.

=== April, 2016 ===

* Replaced GBA-as-controller with GBA-as-GC controller.

=== March, 2016 ===

* Added U+D/L+R cancelling.
* Added GBA-as-controller support.
* Recognized a half press of the analog triggers.

=== August, 2015 ===

* Added executable compression.
* Added memory card distribution files.
* Reduced coil whine.

=== July, 2015 ===

* Fixed Game Boy Player detection.

[[Category:Homebrew_Software]]

Game Boy Interface/Standard Edition

2018-12-11T12:15:15Z

Eatnumber1: /* Options */ Add note about paths being relative to /GBI

{{:Game Boy Interface}}
The author's original vision, '''Game Boy Interface Standard Edition''' ('''GBI''') features an advanced video renderer exercising the GameCube hardware to its fullest.

<div class="toclimit-4">
__TOC__
</div>

== Controls ==

=== On-screen display ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons
| Hide on-screen display
|-
|
| X Button
| X Button
| Toggle on-screen display
|-
|
| Y Button
| Y Button
| Revert offset/zoom
|-
|
| Z Button
| Z Button
| Take screenshot
|-
|
| Start/Pause (Hold for 1 second)
| Start/Pause (Hold for 1 second)
| Exit
|-
|
| +Control Pad
| +Control Pad
| Offset
|-
|
| L/R Buttons
| L/R Buttons
| Zoom
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
| Reset Button
|
|
| Save movie
|}

=== In-game ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| X Button
| X Button
| Toggle on-screen display
|-
|
| Y Button
| Y Button
| Turbo
|-
|
| Z Button
| Z Button
| Select
|-
|
| Start/Pause
| Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R Buttons
| L/R Buttons
| L/R Buttons (Only for Game Boy Advance)
|-
| Reset Button
|
|
| Power Switch
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
| Top Right
| Blue or Orange Square
| +Control Pad Right
|-
| Top Left
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|}

== Options ==

; <code>--aspect=<w:h></code>
: Specify screen aspect ratio. The default is the Progressive Scan Mode system setting (4:3 or 16:9).
; <code>--offset=<x:y></code>
: Set offset. The default is the Screen Position system setting (-32 to +32).
; <code>--zoom=<x:y></code>
: Set zoom. The default is the Game Boy Player Start-up Disc's Screen Size setting (2.0 or 2.375).
; <code>--rotate=<0-359></code>
: Set rotation (default: 0).
; <code>--poll=<0-11></code>
: Set controller polling rate.
: {| 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
|}
; <code>--turbo=<on:off></code>
: Set autofire interval (default: 3).
; <code>--movie=<path></code>, <code>--no-movie</code>
: Play input log (default: no).
; <code>--movie-record</code>, <code>--no-movie-record</code>
: Record input log (default: no).
; <code>--overlay=<path></code>, <code>--no-overlay</code>
: Load texture palette (default: frame.tpl.gz).
; <code>--overlay-id=<ID></code>
: Set texture palette index. The default is the Game Boy Player Start-up Disc's Frame setting (0 to 19).
; <code>--overlay-scale=<x:y></code>
: Set texture scale (default: auto).
; <code>--filter=<none|scale2x[ex|plus]|eagle2x|scan2x|normal2x|normalnx></code>
: Set image doubling filter (default: normalnx).
; <code>--dither=<none|threshold|bayer8x8|bayer4x4|bayer2x2|cluster8x8|cluster4x4></code>
: Set dithering algorithm (default: threshold).
; <code>--scaler=<nearest|bilinear|oversample|box></code>
: Set image scaling filter (default: bilinear).
; <code>--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba></code>
: Set color matrix (default: gbi).
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gba:'''
| [[#Game Boy Advance|Game Boy Advance]] (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
|-
| '''nds:'''
| [[#Nintendo DS|Nintendo DS]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| [[#Palm Treo 700p|Palm Treo 700p]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| [[#PlayStation Portable|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])
|}
; <code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
; <code>--output-gamma=<1.0|1.7|2.2></code>
: Specify screen gamma (default: 2.2).
; <code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
; <code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; <code>--volume=<left[:right]></code>
: Set audio gain (default: 0.75).
; <code>--sound=<[mono|stereo][,digital|analog]></code>
: Set sound mode. The default is the Sound Mode system setting (mono or stereo).
:; <code>digital</code>
:: Use PWM decoder.
:; <code>analog[=<a0:a1:a2:b1:b2>]</code>
:: Use 2MHz biquad filter (default). Defaults to a second-order low-pass filter with a cut-off of 10kHz and a quality factor of √2 if not specified.
; <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 and 60Hz Mode system setting (ntsc, pal or pal-60, pal-m).
; <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 interlace
|-
| '''quasi-interlace:'''
| 15 or 18-22kHz segmented frame
|-
| '''non-interlace:'''
| 15 or 18-22kHz progressive
|-
| '''non-progressive:'''
| 31 or 27-33kHz interlace
|-
| '''progressive:'''
| 31 or 36-45kHz progressive
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> modes. Disabling halves the refresh rate for <code>progressive</code> modes.
:: This only works with the Component Video Cable.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2x video oversampling (default: auto). Enabling halves the refresh rate.
:: This only works with the Component Video Cable.
; <code>--osd</code>, <code>--no-osd</code>
: Show on-screen display (default: yes).
; <code>--ipv4-address=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 address.
; <code>--ipv4-gateway=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 gateway.
; <code>--ipv4-netmask=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 netmask.
; <code>--network</code>, <code>--no-network</code>
: Enable [[Broadband Adapter]] features (default: yes).
; <code>--stream[=<aaa.bbb.ccc.ddd>]</code>, <code>--no-stream</code>
: Stream video to IP address on UDP port 1234 (default: no). Defaults to 255.255.255.255 if not specified.
; <code>--enhance</code>, <code>--no-enhance</code>
: Enable Game Boy Player enhancements (default: yes).
: {| class="wikitable sortable"
! Title
! Feature(s)
|-
| ''[[wikipedia:Drill Dozer|Drill Dozer]]''
| Rumble
|-
| ''[[wikipedia:Game Boy Advance Video|Game Boy Advance Video]] Series''
| [[#Can I play Game Boy Advance Video?|Not compatible]]
|-
| ''[[wikipedia:Mario & Luigi: Superstar Saga|Mario & Luigi: Superstar Saga]]''
| Rumble, [[#Mario & Luigi: Superstar Saga|reduced contrast]]
|-
| ''[[wikipedia:Pokémon Pinball: Ruby & Sapphire|Pokémon Pinball: Ruby & Sapphire]]''
| Rumble
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kanji Keisanhen''
| Rumble, restored contrast
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kokugo Sansuu Shakai Rikahen''
| Rumble, restored contrast
|-
| ''[[wikipedia:Super Mario Advance 4: Super Mario Bros. 3|Super Mario Advance 4: Super Mario Bros. 3]]''
| Rumble, [[#Super Mario Bros. 3: Super Mario Advance 4|restored gamma]]
|}
: Note: Remove any accessory from the External Extension Connector, or the Rumble Feature will not work.
: Note: If you are using an EverDrive, make sure to turn off "Quick Boot" in the options, or the enhancements may not work.
; <code><path></code>
: Load Game Boy Advance multiboot ROM (default: default.mb.gz).
: Paths are relative to working directory + /GBI
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.

== Comparisons ==

=== Video quality ===

==== Blackmagic Intensity Shuttle ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7180.pdf ADV7180] and [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7604.pdf ADV7604].

<gallery widths="240px" heights="160px">
File:GBI ADV7180 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI ADV7180 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI ADV7180 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI ADV7180 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
File:GBI ADV7604 HDRV.png|HD Retrovision Component Video Cable
File:GBI ADV7604 Component.png|Nintendo Component Video Cable
File:GBI ADV7604 GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI ADV7604 GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Datapath VisionRGB ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/AD9887A.pdf AD9887A].

<gallery widths="240px" heights="160px">
File:GBI AD9887A HDRV.png|HD Retrovision Component Video Cable
File:GBI AD9887A Component.png|Nintendo Component Video Cable
File:GBI AD9887A GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI AD9887A GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Hauppauge WinTV-HVR-1850 ====

Using [https://web.archive.org/web/20120509222042/http://conexant.com/servlets/DownloadServlet/PBR-200974-004.pdf?docid=975&revid=4 CX23888].

<gallery widths="240px" heights="160px">
File:GBI CX23888 NTSC.png|Nintendo RF Modulator (NTSC-J)
File:GBI CX23888 PAL-M.png|Nintendo RF Modulator (PAL-M)
File:GBI CX23888 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI CX23888 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI CX23888 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI CX23888 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
</gallery>

=== Sound emulation ===

==== ''Mega Man Zero 2'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gbp.flac Game Boy Player Start-up Disc]

==== ''Pokémon Sapphire'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gbp.flac Game Boy Player Start-up Disc]

=== Image doubling ===

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE None.png|None
File:GBI AXPE Scale2xEx.png|Scale2×Ex
File:GBI AXPE Scale2xPlus.png|Scale2×Plus
File:GBI AXPE Scale2x.png|Scale2×
File:GBI AXPE Eagle2x.png|Eagle2×
File:GBI AXPE Scan2x.png|Scan2×
File:GBI AXPE Normal2x.png|Normal2×
</gallery>

=== Color matrix ===

==== ''Golden Sun'' ====

<gallery widths="240px" heights="160px">
File:GBI AGSE Identity.png|Identity matrix
File:GBI AGSE GBA.png|Game Boy Advance
File:GBI AGSE GBC.png|Game Boy Color
File:GBI AGSE GBI.png|Game Boy Interface
File:GBI AGSE NDS.png|Nintendo DS
File:GBI AGSE Palm.png|Palm Treo 700p
File:GBI AGSE PSP.png|PlayStation Portable
File:GBI AGSE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Mario Kart: Super Circuit'' ====

<gallery widths="240px" heights="160px">
File:GBI AMKE Identity.png|Identity matrix
File:GBI AMKE GBA.png|Game Boy Advance
File:GBI AMKE GBC.png|Game Boy Color
File:GBI AMKE GBI.png|Game Boy Interface
File:GBI AMKE NDS.png|Nintendo DS
File:GBI AMKE Palm.png|Palm Treo 700p
File:GBI AMKE PSP.png|PlayStation Portable
File:GBI AMKE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity.png|Identity matrix
File:GBI AXPE GBA.png|Game Boy Advance
File:GBI AXPE GBC.png|Game Boy Color
File:GBI AXPE GBI.png|Game Boy Interface
File:GBI AXPE NDS.png|Nintendo DS
File:GBI AXPE Palm.png|Palm Treo 700p
File:GBI AXPE PSP.png|PlayStation Portable
File:GBI AXPE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''The Legend of Zelda: The Minish Cap'' ====

<gallery widths="240px" heights="160px">
File:GBI BZME Identity.png|Identity matrix
File:GBI BZME GBA.png|Game Boy Advance
File:GBI BZME GBC.png|Game Boy Color
File:GBI BZME GBI.png|Game Boy Interface
File:GBI BZME NDS.png|Nintendo DS
File:GBI BZME Palm.png|Palm Treo 700p
File:GBI BZME PSP.png|PlayStation Portable
File:GBI BZME VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Wario Land 4'' ====

<gallery widths="240px" heights="160px">
File:GBI AWAE Identity.png|Identity matrix
File:GBI AWAE GBA.png|Game Boy Advance
File:GBI AWAE GBC.png|Game Boy Color
File:GBI AWAE GBI.png|Game Boy Interface
File:GBI AWAE NDS.png|Nintendo DS
File:GBI AWAE Palm.png|Palm Treo 700p
File:GBI AWAE PSP.png|PlayStation Portable
File:GBI AWAE VBA.png|VisualBoyAdvance-M
</gallery>

== Examples ==

=== Color emulation ===

==== Game Boy Advance ====

[[File:GBI_Game_Boy_Advance.png|border|right]]
Using a contrast ratio of 250:1.

<pre>
--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177
</pre>

==== Nintendo DS ====

[[File:GBI_Nintendo_DS.png|border|right]]
Using a contrast ratio of 600:1.

<pre>
--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934
</pre>

==== Palm Treo 700p ====

[[File:GBI_Palm_Treo_700p.png|border|right]]
Using a contrast ratio of 75:1.

<pre>
--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364
</pre>

==== PlayStation Portable ====

[[File:GBI_PlayStation_Portable.png|border|right]]
Using a contrast ratio of 750:1.

<pre>
--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556
</pre>

=== Color restoration ===

==== ''Mario & Luigi: Superstar Saga'' ====

This game reduces contrast when played ''with'' Game Boy Player enhancements.

<pre>
--contrast=1.1
</pre>

==== ''Super Mario Bros. 3: Super Mario Advance 4'' ====

This game reduces gamma when played ''without'' Game Boy Player enhancements.

<pre>
--input-gamma=2.8
</pre>

==== ''The Legend of Zelda: Oracle of Ages/Seasons'' ====

This game reduces gamma when played on a Game Boy Advance.
Due to Game Boy Color limitations, only shadows can be restored perfectly.

<pre>
--input-gamma=4.
</pre>

=== Mimicking ===

==== Game Boy Player Start-up Disc ====

Included as <code>gbi.cli.example</code>.

<pre>
--aspect=4:3
--overlay=frame-srgb.tpl.gz
--dither=none
--matrix=identity
--input-gamma=1.
--output-gamma=1.
--contrast=.78125
--sound=analog=.000148021979839541018009185791015625:.00029604395967908203601837158203125:.000148021979839541018009185791015625:-1.965293407440185546875:.965885460376739501953125
--no-osd
</pre>

==== Wii U Virtual Console ====

<pre>
--aspect=16:9
--zoom=3
--no-overlay
--dither=none
--matrix=identity
--input-gamma=1.
--output-gamma=1.
--contrast=.75
--sound=digital
--no-osd
--no-enhance
</pre>

=== Video optimization ===

==== Datapath VisionRGB ====

The author's personal setup.

<pre>
--aspect=4:3
--offset=0
--zoom=4
--dither=bayer2x2
--scaler=nearest
--format=hd60
--scan-mode=non-interlace,clock2x,size2x
</pre>

* Resolution and Refresh
** Width: 960
** Height: 360
** Vertical Refresh: 60.00
* Video Adjustments
** Horizontal Position: 205
** Horizontal Size: 1200
** Phase: 31
** Vertical Position: 13
** Black Level: 8
* Cropping
** Top: 20
** Left: 0
** Width: 960
** Height: 320
* Color Adjustments
** Brightness: 32
** Contrast: 128
** Colour Domain: YUV (601)
** Colour Balance
*** All Colors
**** Brightness: 32
**** Contrast: 128
*** Red
**** Brightness: 158
**** Contrast: 158
*** Green
**** Brightness: 178
**** Contrast: 178
*** Blue
**** Brightness: 152
**** Contrast: 152

==== Open Source Scan Converter ====

<pre>
--aspect=4:3
--offset=0
--zoom=4
--filter=none
--scaler=nearest
--format=hd60
--scan-mode=non-interlace
</pre>

==== High-definition televisions ====

Change the Aspect Ratio on the television to Just Scan.

<pre>
--aspect=1.8
--zoom=3.375
--format=hd60
--scan-mode=non-progressive
</pre>

==== Video capture devices (Game Boy Advance) ====

<pre>
--aspect=3:2
--offset=0
--zoom=3
--dither=bayer2x2
--scaler=nearest
--format=ntsc
</pre>

==== Video capture devices (Game Boy Color) ====

<pre>
--aspect=5:4
--offset=0
--zoom=4
--dither=bayer2x2
--scaler=nearest
--format=pal
</pre>

== FAQs ==

=== How do I change Game Paks? ===

# Hold the Reset Button.
# Slide the Game Pak Ejector.
# Insert a Game Pak into the Game Pak Slot.
# Release the Reset Button.

=== Can I play [[wikipedia:Game Boy Advance Video|Game Boy Advance Video]]? ===

Yes. You can do so by disabling Game Boy Player enhancements (<code>--no-enhance</code>), or holding a direction while the Game Boy Player logo is visible.

=== Is this an emulator? Can I play ROMs? ===

No, but there's [[Enhanced mGBA]] if you're looking for one.

=== Why is there motion blur? Can I turn it off? ===

It removes stuttering caused by mismatches between the Game Boy Advance and the display refresh rate. It cannot be turned off. It can be reduced by using a 120Hz mode, but it's most effective on a sample-and-hold display.

=== What happens when I exit Game Boy Interface? ===

The Game Boy Player keeps running and you're returned to <code>autoexec.dol</code>, or the Nintendo GameCube Main Menu.

== Changelog ==

=== December, 2018 ===

* Fixed 360p RGBcvS sync issue.

=== October, 2018 ===

* Added HD Custom video format.

=== August, 2018 ===

* Updated color matrices by Pokefan531.

=== July, 2018 ===

* Updated GBA-as-GC controller.

=== June, 2018 ===

* Added analog sound emulation.
* Added Custom-M video format.
* Added Custom interlaced video modes.
* Changed default sound mode to analog.
* Changed brightness/contrast controls to match BT.1886.
* Fixed some audio bugs.
* Enabled progressive scan in more cases to prevent display issues.

=== May, 2018 ===

* Added 360p, 720i, 720p and 1080i video modes.
* Changed scan mode semantics.
* Changed default aspect ratio for progressive scan to 16:9.
* Fixed Game Boy Player advertisement.
* Fixed rumble protocol handshake.

=== April, 2018 ===

* Added movie recording/playback.
* Updated GBA-as-GC controller.

=== March, 2018 ===

* Improved multiboot implementation.
* Improved Game Boy sound quality.
* Improved audio rendering.
* Reduced audio latency.
* Changed default color matrix to GBI's original.
* Fixed SD card compatibility.
* Fixed multiboot to rumble protocol transition.

=== February, 2018 ===

* Added color matrix from Gambatte.
* Added mono sound mode.
* Fixed wiiload autoboot with tiny GBA multiboot ROMs.
* Disabled machine checks.

=== January, 2018 ===

* Updated color matrices by Pokefan531.
* Improved Game Boy Player driver.

=== September, 2017 ===

* Added overlay scale setting.
* Added Logitech Speed Force support.
* Added Active Life Mat support.
* Improved Game Boy Player driver.
* Changed wiiload server to accept oversized DOLs.
* Fixed one random kernel crash.

=== August, 2017 ===

* Added DK Bongos support.
* Updated color matrices by Pokefan531.
* Improved Game Boy Player driver.

=== July, 2017 ===

* Added CLI append support.
* Updated color matrices by Pokefan531.
* Updated GBA-as-GC controller.

=== April, 2017 ===

* Added component video DAC oversampling.
* Added experimental 960i and 1152i video modes.

=== March, 2017 ===

* Added temporal/spatial dithering.
* Added color matrices by Pokefan531.
* Added TPL overlay support to wiiload server.
* Changed default color matrix to Pokefan531's.
* Changed default gamma to 2.2.
* Optimized NormalNx filter.

=== February, 2017 ===

* Added volume control.
* Added per-channel settings where possible.
* Changed volume to 75% to mitigate clipping.
* Fixed framebuffer clearing for 576i.

=== November, 2016 ===

* Updated GBA-as-GC controller.
* Optimized Scale2xEx filter.

=== October, 2016 ===

* Added Scale2xEx and Scale2xPlus filters.
* Added oversample and box scalers.
* Added basic video streaming.
* Added Remote RetroPad support.
* Optimized video rendering.

=== September, 2016 ===

* Added polling rate setting.

=== May, 2016 ===

* Updated GBA-as-GC controller.
* Improved Game Boy Player driver.
* Fixed WaveBird Controllers.

=== April, 2016 ===

* Added GBA multiboot support to wiiload server.
* Added Xboo Communicator.
* Added BIOS/ROM dumper.
* Replaced GBA-as-controller with GBA-as-GC controller.

=== March, 2016 ===

* Added GBA-as-controller support.
* Recognized a half press of the analog triggers.

=== December, 2015 ===

* Expanded video options. Now includes 25, 30, 100 and 120 Hz modes.
* Added gamma-encoded borders for special use.

=== November, 2015 ===

* Added (GZipped) TPL overlay support.
* Added all 20 borders from the Game Boy Player Start-up Disc.

=== October, 2015 ===

* Added Scale2x, Eagle2x, Scan2x and Normal2x filters.

=== August, 2015 ===

* Added executable compression.
* Added return to <code>autoexec.dol</code>.
* Added memory card distribution files.
* Added auto-cropping for Game Boy screenshots.
* Optimized video rendering.
* Reduced coil whine.

=== July, 2015 ===

* Added rumble.
* Added hold to quit.
* Added screenshot saving.
* Added SNTP broadcast listener.
* Changed default video mode to interlaced.
* Fixed Game Boy Player detection.

=== May, 2015 ===

* Changed all 60 Hz modes to have 486 active lines.

=== March, 2015 ===

* Added digital PWM sound.
* Added turbo button.
* Fixed 288p.

[[Category:Homebrew_Software]]

Game Boy Interface/High-Fidelity Edition

2018-12-08T20:26:12Z

Eatnumber1: /* Options */ Add a note about turning off QuickBoot to the GBIHF options section.

{{:Game Boy Interface}}
A spiritual successor of the ultra-low latency version, '''Game Boy Interface High-Fidelity Edition''' ('''GBIHF''') aims to provide the best source quality for further processing or archival.

<div class="toclimit-4">
__TOC__
</div>

== Controls ==

=== Type A (two-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Y/Z Buttons
| Y/Z Buttons
| Select
|-
|
| X Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
| Top Right
| Blue or Orange Square
| +Control Pad Right
|-
| Top Left
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|}

=== Type B (one-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| L/Z Buttons
| Y/Z Buttons
| Select
|-
|
| R Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| Y/X Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
|
| Blue or Orange Square
| +Control Pad Right
|-
|
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|-
| Top Left/Right
|
| L/R Buttons
|}

=== Type C (''Super Mario World: Super Mario Advance 2'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| B/Y or X Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Z Button
| Y/Z Buttons
| Select
|-
|
| Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R or A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

=== Type D (''The Legend of Zelda: A Link to the Past'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| Y/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| R Button or Start/Pause
| Y/Z Buttons
| Select
|-
|
| L/Z Buttons
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| X/A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

== Options ==

; <code>--poll=<0-11></code>
: Set controller polling rate.
: {| 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
|}
; <code>--control=<P1[:P2[:P3[:P4]]]></code>
: Set control scheme. The default is the Game Boy Player Start-up Disc's Controller setting (0 or 1).
: {| class="wikitable"
| '''0:'''
| [[#Type A (two-handed)|Type A (two-handed)]]
|-
| '''1:'''
| [[#Type B (one-handed)|Type B (one-handed)]]
|-
| '''2:'''
| [[#Type C (Super Mario World: Super Mario Advance 2)|Type C (''Super Mario World: Super Mario Advance 2'')]]
|-
| '''3:'''
| [[#Type D (The Legend of Zelda: A Link to the Past)|Type D (''The Legend of Zelda: A Link to the Past'')]]
|}
: Note: A Game Boy Advance used as a controller is a Nintendo GameCube Controller.
; <code>--delay-reset=<N></code>
: Set reset delay (default: 0).
; <code>--delay-video=<N></code>
: Set video buffering (default: 1).
; <code>--movie=<path></code>, <code>--no-movie</code>
: Play input log (default: no).
; <code>--movie-record</code>, <code>--no-movie-record</code>
: Record input log (default: no).
; <code>--palette=<xxxx-xxxx-xxxx></code>, <code>--no-palette</code>
: Apply [https://gamefaqs.gamespot.com/snes/588731-super-game-boy/faqs/58647 Super Game Boy] color palette (default: no).
: Note: Press Left + B while the Game Boy logo is visible for proper application on original Game Boy Game Paks.
; <code>--lut3d=<path></code>, <code>--no-lut3d</code>
: Load 32x32x32 lookup table (default: no).
; <code>--lut3d-order=<rgb|gbr|bgr></code>
: Specify lookup table order (default: rgb).
; <code>--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba></code>
: Set color matrix (default: identity).
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gba:'''
| [[#Game Boy Advance|Game Boy Advance]] (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
|-
| '''nds:'''
| [[#Nintendo DS|Nintendo DS]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| [[#Palm Treo 700p|Palm Treo 700p]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| [[#PlayStation Portable|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])
|}
; <code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
; <code>--output-gamma=<value></code>
: Specify screen gamma (default: 2.2).
; <code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
; <code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; <code>--volume=<left[:right]></code>
: Set audio gain (default: 0.75).
; <code>--sound=<[mono|stereo][,digital|analog]></code>
: Set sound mode. The default is the Sound Mode system setting (mono or stereo).
:; <code>digital</code>
:: Use PWM decoder (default).
:; <code>analog[=<a0:a1:a2:b1:b2>]</code>
:: Use 2MHz biquad filter. Defaults to a second-order low-pass filter with a cut-off of 10kHz and a quality factor of √2 if not specified.
; <code>--colorspace=<ycc601|ycc709|ycc2020|rgb709|rgb2020></code>
: Set video color space (default: ycc601).
: This only works with the Component Video Cable.
: {| class="wikitable"
| '''ycc601:'''
| [[wikipedia:xvYCC|IEC 61966-2-4 xvYCC601]]
|-
| '''ycc709:'''
| [[wikipedia:xvYCC|IEC 61966-2-4 xvYCC709]]
|-
| '''ycc2020:'''
| [[wikipedia:Rec. 2020|ITU-R BT.2020 Y’C’BC’R]]
|-
| '''rgb709:'''
| [[wikipedia:sRGB|IEC 61966-2-1 sRGB]]
|-
| '''rgb2020:'''
| [[wikipedia:Rec. 2020|ITU-R BT.2020 R’G’B’]]
|}
; <code>--format=<ntsc|pal|pal-m|ntsc-50|pal-60|custom|custom-m|hd60|hd50|hd48|hdcustom></code>
: Set video format (default: custom).
; <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 (non-interlace or progressive).
: {| class="wikitable"
| '''interlace:'''
| 15 or 18-22kHz interlace
|-
| '''quasi-interlace:'''
| 15 or 18-22kHz segmented frame
|-
| '''non-interlace:'''
| 15 or 18-22kHz progressive
|-
| '''non-progressive:'''
| 31 or 27-33kHz interlace
|-
| '''progressive:'''
| 31 or 36-45kHz progressive
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> modes. Disabling halves the refresh rate for <code>progressive</code> modes.
:: This only works with the Component Video Cable.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2x video oversampling (default: auto). Enabling halves the refresh rate.
:: This only works with the Component Video Cable.
; <code>--usb</code>, <code>--no-usb</code>
: Enable [[USBGecko|USB Gecko]] features (default: yes).
; <code>--enhance</code>, <code>--no-enhance</code>
: Enable Game Boy Player enhancements (default: yes).
: {| class="wikitable sortable"
! Title
! Feature(s)
|-
| ''[[wikipedia:Drill Dozer|Drill Dozer]]''
| Rumble
|-
| ''[[wikipedia:Game Boy Advance Video|Game Boy Advance Video]] Series''
| [[#Can I play Game Boy Advance Video?|Not compatible]]
|-
| ''[[wikipedia:Mario & Luigi: Superstar Saga|Mario & Luigi: Superstar Saga]]''
| Rumble, [[#Mario & Luigi: Superstar Saga|reduced contrast]]
|-
| ''[[wikipedia:Pokémon Pinball: Ruby & Sapphire|Pokémon Pinball: Ruby & Sapphire]]''
| Rumble
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kanji Keisanhen''
| Rumble, restored contrast
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kokugo Sansuu Shakai Rikahen''
| Rumble, restored contrast
|-
| ''[[wikipedia:Super Mario Advance 4: Super Mario Bros. 3|Super Mario Advance 4: Super Mario Bros. 3]]''
| Rumble, [[#Super Mario Bros. 3: Super Mario Advance 4|restored gamma]]
|}
: Note: Remove any accessory from the External Extension Connector, or the Rumble Feature will not work.
: Note: If you are using an EverDrive, make sure to turn off "Quick Boot" in the options, or the enhancements may not work.
; <code><path></code>
: Load Game Boy Advance multiboot ROM (default: default.mb.gz).
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.

== Comparisons ==

=== Video quality ===

==== Blackmagic Intensity Shuttle ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7180.pdf ADV7180] and [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7604.pdf ADV7604].

<gallery widths="240px" heights="160px">
File:GBIHF ADV7180 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBIHF ADV7180 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBIHF ADV7180 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBIHF ADV7180 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
File:GBIHF ADV7604 HDRV.png|HD Retrovision Component Video Cable
File:GBIHF ADV7604 Component.png|Nintendo Component Video Cable
File:GBIHF ADV7604 GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBIHF ADV7604 GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Datapath VisionRGB ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/AD9887A.pdf AD9887A].

<gallery widths="240px" heights="160px">
File:GBIHF AD9887A HDRV.png|HD Retrovision Component Video Cable
File:GBIHF AD9887A Component.png|Nintendo Component Video Cable
File:GBIHF AD9887A GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBIHF AD9887A GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Hauppauge WinTV-HVR-1850 ====

Using [https://web.archive.org/web/20120509222042/http://conexant.com/servlets/DownloadServlet/PBR-200974-004.pdf?docid=975&revid=4 CX23888].

<gallery widths="240px" heights="160px">
File:GBIHF CX23888 NTSC.png|Nintendo RF Modulator (NTSC-J)
File:GBIHF CX23888 PAL-M.png|Nintendo RF Modulator (PAL-M)
File:GBIHF CX23888 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBIHF CX23888 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBIHF CX23888 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBIHF CX23888 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
</gallery>

=== Sound emulation ===

==== ''Mega Man Zero 2'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gbp.flac Game Boy Player Start-up Disc]

==== ''Pokémon Sapphire'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gbp.flac Game Boy Player Start-up Disc]

=== 3D lookup table ===

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity LUT.png|Identity LUT <code>lutrgb.png</code>
File:GBI AXPE GBA Light LUT.png|Game Boy Advance <code>lutrgb-gba-light.png</code>
File:GBI AXPE GBA LUT.png|Game Boy Advance <code>lutrgb-gba.png</code>
File:GBI AXPE GBC LUT.png|Gambatte/higan <code>lutrgb-gbc.png</code>
File:GBI AXPE GBP LUT.png|Game Boy Player Start-up Disc <code>lutrgb-gbp.png</code>
File:GBI AXPE NDS LUT.png|Nintendo DS <code>lutrgb-nds.png</code>
File:GBI AXPE VBA LUT.png|VisualBoyAdvance-M <code>lutrgb-vba.png</code>
File:GBI AXPE WiiU LUT.png|Wii U Virtual Console <code>lutrgb-wiiu.png</code>
</gallery>

=== Color matrix ===

==== ''Golden Sun'' ====

<gallery widths="240px" heights="160px">
File:GBI AGSE Identity.png|Identity matrix
File:GBI AGSE GBA.png|Game Boy Advance
File:GBI AGSE GBC.png|Game Boy Color
File:GBI AGSE GBI.png|Game Boy Interface
File:GBI AGSE NDS.png|Nintendo DS
File:GBI AGSE Palm.png|Palm Treo 700p
File:GBI AGSE PSP.png|PlayStation Portable
File:GBI AGSE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Mario Kart: Super Circuit'' ====

<gallery widths="240px" heights="160px">
File:GBI AMKE Identity.png|Identity matrix
File:GBI AMKE GBA.png|Game Boy Advance
File:GBI AMKE GBC.png|Game Boy Color
File:GBI AMKE GBI.png|Game Boy Interface
File:GBI AMKE NDS.png|Nintendo DS
File:GBI AMKE Palm.png|Palm Treo 700p
File:GBI AMKE PSP.png|PlayStation Portable
File:GBI AMKE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity.png|Identity matrix
File:GBI AXPE GBA.png|Game Boy Advance
File:GBI AXPE GBC.png|Game Boy Color
File:GBI AXPE GBI.png|Game Boy Interface
File:GBI AXPE NDS.png|Nintendo DS
File:GBI AXPE Palm.png|Palm Treo 700p
File:GBI AXPE PSP.png|PlayStation Portable
File:GBI AXPE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''The Legend of Zelda: The Minish Cap'' ====

<gallery widths="240px" heights="160px">
File:GBI BZME Identity.png|Identity matrix
File:GBI BZME GBA.png|Game Boy Advance
File:GBI BZME GBC.png|Game Boy Color
File:GBI BZME GBI.png|Game Boy Interface
File:GBI BZME NDS.png|Nintendo DS
File:GBI BZME Palm.png|Palm Treo 700p
File:GBI BZME PSP.png|PlayStation Portable
File:GBI BZME VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Wario Land 4'' ====

<gallery widths="240px" heights="160px">
File:GBI AWAE Identity.png|Identity matrix
File:GBI AWAE GBA.png|Game Boy Advance
File:GBI AWAE GBC.png|Game Boy Color
File:GBI AWAE GBI.png|Game Boy Interface
File:GBI AWAE NDS.png|Nintendo DS
File:GBI AWAE Palm.png|Palm Treo 700p
File:GBI AWAE PSP.png|PlayStation Portable
File:GBI AWAE VBA.png|VisualBoyAdvance-M
</gallery>

== Examples ==

=== Color emulation ===

==== Game Boy Advance ====

[[File:GBI_Game_Boy_Advance.png|border|right]]
Using a contrast ratio of 250:1.

<pre>
--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177
</pre>

==== Nintendo DS ====

[[File:GBI_Nintendo_DS.png|border|right]]
Using a contrast ratio of 600:1.

<pre>
--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934
</pre>

==== Palm Treo 700p ====

[[File:GBI_Palm_Treo_700p.png|border|right]]
Using a contrast ratio of 75:1.

<pre>
--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364
</pre>

==== PlayStation Portable ====

[[File:GBI_PlayStation_Portable.png|border|right]]
Using a contrast ratio of 750:1.

<pre>
--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556
</pre>

=== Color restoration ===

==== ''Mario & Luigi: Superstar Saga'' ====

This game reduces contrast when played ''with'' Game Boy Player enhancements.

<pre>
--contrast=1.1
</pre>

==== ''Super Mario Bros. 3: Super Mario Advance 4'' ====

This game reduces gamma when played ''without'' Game Boy Player enhancements.

<pre>
--input-gamma=2.8
</pre>

==== ''The Legend of Zelda: Oracle of Ages/Seasons'' ====

This game reduces gamma when played on a Game Boy Advance.
Due to Game Boy Color limitations, only shadows can be restored perfectly.

<pre>
--input-gamma=4.
</pre>

=== Video optimization ===

==== Datapath VisionRGB (Component Video Cable) ====

<pre>
--colorspace=rgb709
--scan-mode=non-interlace,clock2x,size2x
</pre>

* Resolution and Refresh
** Width: 360
** Height: 240
** Vertical Refresh: 59.72
* Video Adjustments
** Horizontal Position: 65
** Horizontal Size: 433
** Phase: 27
** Vertical Position: 18
** Black Level: 8
* Cropping
** Top: 40
** Left: 60
** Width: 240
** Height: 160
* Color Adjustments
** Brightness: 32
** Contrast: 128
** Colour Domain: RGB (601)
** Colour Balance
*** All Colors
**** Brightness: 32
**** Contrast: 128
*** Red
**** Brightness: 156
**** Contrast: 156
*** Green
**** Brightness: 166
**** Contrast: 166
*** Blue
**** Brightness: 148
**** Contrast: 148

==== Open Source Scan Converter ====

Included as <code>gbihf-ossc.cli</code>, <code>gbihf-ossc.dol+cli</code> and <code>gbihf-ossc.gci</code>.

<pre>
--format=hd60
--scan-mode=non-interlace
</pre>

==== XRGB-mini Framemeister ====

Included as <code>gbihf-xrgb.cli</code>, <code>gbihf-xrgb.dol+cli</code> and <code>gbihf-xrgb.gci</code>.
Refer to [http://www.firebrandx.com/framemeisterprofiles.html FirebrandX] for configuration.

<pre>
--format=custom-m
--scan-mode=non-interlace
</pre>

==== High-definition televisions ====

Change the Aspect Ratio on the television to Zoom 1.

<pre>
--colorspace=ycc709
--format=hd60
--scan-mode=non-progressive
</pre>

== FAQs ==

=== How do I change Game Paks? ===

# Hold the Reset Button.
# Slide the Game Pak Ejector.
# Insert a Game Pak into the Game Pak Slot.
# Release the Reset Button.

=== Can I play [[wikipedia:Game Boy Advance Video|Game Boy Advance Video]]? ===

Yes. You can do so by disabling Game Boy Player enhancements (<code>--no-enhance</code>), or holding a direction while the Game Boy Player logo is visible.

=== Is this an emulator? Can I play ROMs? ===

No, but there's [[Enhanced mGBA]] if you're looking for one.

== Changelog ==

=== October, 2018 ===

* Added HDCustom video format.

=== August, 2018 ===

* Updated color matrices by Pokefan531.

=== July, 2018 ===

* Updated GBA-as-GC controller.

=== June, 2018 ===

* Added analog sound emulation.
* Added video options.
* Added component video DAC oversampling.
* Changed brightness/contrast controls to match BT.1886.
* Fixed some audio bugs.
* Removed left/right chroma location support.

=== May, 2018 ===

* Added Super Game Boy color palette setting.
* Changed default chroma location to center.
* Fixed Game Boy Player advertisement.
* Fixed rumble protocol handshake.

=== April, 2018 ===

* Added movie recording/playback.
* Updated GBA-as-GC controller.

=== March, 2018 ===

* Added RGB Sync-on-Green support.
* Added xvYCC/BT.2020 support for auto-generated 3D LUT.
* Added control swapping for SNES Controllers.
* Added center/right chroma location support.
* Improved multiboot implementation.
* Fixed SD card compatibility.
* Fixed multiboot to rumble protocol transition.

== Media ==

* [https://www.youtube.com/watch?v=SN-r2bl7bV8 Console Verified: GBC Pokémon: Blue Version "warp glitch" by gifvex in 10:11.25]
* [https://www.youtube.com/watch?v=i8ROeArTVyQ Console Verified: GBC Pokémon: Blue Version "Gotta Catch 'Em All!" by luckytyphlosion in 37:54.11]
* [https://www.youtube.com/watch?v=40z__x55Ix0 Console Verified: GBA Sonic Advance by Mukki & ruadath in 10:49.75]
* [https://www.youtube.com/watch?v=VqPV513Fd9w Console Verified: GBA Sonic Advance by Mukki in 11:02.64]
* [https://www.youtube.com/watch?v=kZSfK7u3P2Y Console Verified: GBA Sonic Advance 2 by Mukki in 18:09.45]
* [https://www.youtube.com/watch?v=F6t0fdHay_o Console Verified: GBC Pokémon: Yellow Version by TiKevin83 in 1:36:34.55]

[[Category:Homebrew_Software]]

Game Boy Interface/Speedrunning Edition

2018-12-08T20:25:34Z

Eatnumber1: /* Options */ Add a note about turning off QuickBoot to the GBISR options section.

{{:Game Boy Interface}}
Formerly the (ultra-)low latency version, '''Game Boy Interface Speedrunning Edition''' ('''GBISR''') features a simplified video renderer, and aims to meet the needs of most [[wikipedia:Speedrun|speedrunning]] communities.

<div class="toclimit-4">
__TOC__
</div>

== Controls ==

=== Type A (two-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Y/Z Buttons
| Y/Z Buttons
| Select
|-
|
| X Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|-
|
| C Stick Down
|
| Toggle input viewer
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
| Top Right
| Blue or Orange Square
| +Control Pad Right
|-
| Top Left
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|}

=== Type B (one-handed) ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| L/Z Buttons
| Y/Z Buttons
| Select
|-
|
| R Button or Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| Y/X Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
|
| Blue or Orange Square
| +Control Pad Right
|-
|
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|-
| Top Left/Right
|
| L/R Buttons
|}

=== Type C (''Super Mario World: Super Mario Advance 2'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| B/Y or X Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| Z Button
| Y/Z Buttons
| Select
|-
|
| Start/Pause
| X Button or Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R or A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|-
|
| C Stick Down
|
| Toggle input viewer
|}

=== Type D (''The Legend of Zelda: A Link to the Past'') ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| Y/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| R Button or Start/Pause
| Y/Z Buttons
| Select
|-
|
| L/Z Buttons
| X Button or Start/Pause
| Start
|-
|
| +Control Pad, Control Stick or C Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| X/A Buttons
| L/R Buttons
| L/R Buttons
|-
| Reset Button
| B, X and Start/Pause Buttons
| B, X and Start/Pause Buttons
| Power Switch
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
|
| X, Y and Start/Pause Buttons (Hold for 3 seconds)
|
| Swap controls (Only with SNES Controller)
|}

== Options ==

; <code>--offset=<x:y></code>
: Set offset (default: 0).
; <code>--zoom=<x:y></code>
: Set zoom (default: 2.0).
; <code>--rotate=<0-359></code>
: Set rotation (default: 0).
; <code>--poll=<0-11></code>
: Set controller polling rate.
: {| 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
|}
; <code>--control=<P1[:P2[:P3[:P4]]]></code>
: Set control scheme. The default is the Game Boy Player Start-up Disc's Controller setting (0 or 1).
: {| class="wikitable"
| '''0:'''
| [[#Type A (two-handed)|Type A (two-handed)]]
|-
| '''1:'''
| [[#Type B (one-handed)|Type B (one-handed)]]
|-
| '''2:'''
| [[#Type C (Super Mario World: Super Mario Advance 2)|Type C (''Super Mario World: Super Mario Advance 2'')]]
|-
| '''3:'''
| [[#Type D (The Legend of Zelda: A Link to the Past)|Type D (''The Legend of Zelda: A Link to the Past'')]]
|}
: Note: A Game Boy Advance used as a controller is a Nintendo GameCube Controller.
; <code>--delay-reset=<N></code>
: Set reset delay (default: 75).
; <code>--delay-video=<N></code>
: Set video buffering (default: 1).
; <code>--movie=<path></code>, <code>--no-movie</code>
: Play input log (default: no).
; <code>--movie-record</code>, <code>--no-movie-record</code>
: Record input log (default: no).
; <code>--overlay=<path></code>, <code>--no-overlay</code>
: Load texture palette (default: frame-srgb.tpl.gz).
; <code>--overlay-id=<ID></code>
: Set texture palette index. The default is the Game Boy Player Start-up Disc's Frame setting (0 to 19).
; <code>--overlay-scale=<x:y></code>
: Set texture scale (default: auto).
; <code>--palette=<xxxx-xxxx-xxxx></code>, <code>--no-palette</code>
: Apply [https://gamefaqs.gamespot.com/snes/588731-super-game-boy/faqs/58647 Super Game Boy] color palette (default: no).
: Note: Press Left + B while the Game Boy logo is visible for proper application on original Game Boy Game Paks.
; <code>--lut3d=<path></code>, <code>--no-lut3d</code>
: Load 32x32x32 lookup table (default: no).
; <code>--lut3d-order=<rgb|gbr|bgr></code>
: Specify lookup table order (default: rgb).
; <code>--scaler=<nearest|bilinear|oversample|box></code>
: Set image scaling filter (default: nearest).
; <code>--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba></code>
: Set color matrix (default: identity).
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gba:'''
| [[#Game Boy Advance|Game Boy Advance]] (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
|-
| '''nds:'''
| [[#Nintendo DS|Nintendo DS]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| [[#Palm Treo 700p|Palm Treo 700p]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| [[#PlayStation Portable|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])
|}
; <code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
; <code>--output-gamma=<value></code>
: Specify screen gamma (default: 2.2).
; <code>--gamma=<even[:odd]></code>
: Set gamma correction (default: 1.0).
; <code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
; <code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; <code>--blend=<value></code>
: Set alpha blending (default: 1.0).
; <code>--background=<#rrggbb></code>
: Set background color (default: #000000).
; <code>--vfilter=<middle[:lower[:upper]]></code>
: Set vertical filter coefficients (default: 1.0).
; <code>--volume=<left[:right]></code>
: Set audio gain (default: 0.75).
; <code>--sound=<[mono|stereo][,digital|analog]></code>
: Set sound mode. The default is the Sound Mode system setting (mono or stereo).
:; <code>digital</code>
:: Use PWM decoder (default).
:; <code>analog[=<a0:a1:a2:b1:b2>]</code>
:: Use 2MHz biquad filter. Defaults to a second-order low-pass filter with a cut-off of 10kHz and a quality factor of √2 if not specified.
; <code>--format=<[ntsc|pal|pal-m|ntsc-50|pal-60|custom|custom-m][,offset=<x:y>][,scaled-size=<w:h>][,size=<w:h>]></code>
: Set video format. The default is the Video Mode or Progressive Scan Mode system setting (ntsc, pal-60, pal-m, or custom).
:; <code>offset=<x:y></code>
:: Set screen position. The default is the Screen Position system setting (-32 to +32).
:; <code>scaled-size=<w:h></code>
:: Set screen size (default: auto).
:; <code>size=<w:h></code>
:: Set internal resolution (default: 640:480).
; <code>--scan-mode=<[interlace|quasi-interlace|non-interlace|progressive][,clock2x|no-clock2x][,size2x|no-size2x]></code>
: Set scan mode. The default is the Progressive Scan Mode system setting (non-interlace or progressive).
: {| class="wikitable"
| '''interlace:'''
| 15kHz interlace
|-
| '''quasi-interlace:'''
| 15kHz segmented frame
|-
| '''non-interlace:'''
| 15kHz progressive
|-
| '''progressive:'''
| 31kHz progressive
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> modes. Disabling halves the refresh rate for <code>progressive</code> modes.
:: This only works with the Component Video Cable.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2x video oversampling (default: no). Enabling halves the refresh rate.
:: This only works with the Component Video Cable.
; <code>--osd-input[=<x:y>]</code>, <code>--no-osd-input</code>
: Show input viewer (default: no). Defaults to 0:-64 if not specified.
; <code>--usb</code>, <code>--no-usb</code>
: Enable [[USBGecko|USB Gecko]] features (default: yes).
; <code>--enhance</code>, <code>--no-enhance</code>
: Enable Game Boy Player enhancements (default: no). Enabling this option is not recommended.
: {| class="wikitable sortable"
! Title
! Feature(s)
|-
| ''[[wikipedia:Drill Dozer|Drill Dozer]]''
| Rumble
|-
| ''[[wikipedia:Game Boy Advance Video|Game Boy Advance Video]] Series''
| [[#Can I play Game Boy Advance Video?|Not compatible]]
|-
| ''[[wikipedia:Mario & Luigi: Superstar Saga|Mario & Luigi: Superstar Saga]]''
| Rumble, [[#Mario & Luigi: Superstar Saga|reduced contrast]]
|-
| ''[[wikipedia:Pokémon Pinball: Ruby & Sapphire|Pokémon Pinball: Ruby & Sapphire]]''
| Rumble
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kanji Keisanhen''
| Rumble, restored contrast
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kokugo Sansuu Shakai Rikahen''
| Rumble, restored contrast
|-
| ''[[wikipedia:Super Mario Advance 4: Super Mario Bros. 3|Super Mario Advance 4: Super Mario Bros. 3]]''
| Rumble, [[#Super Mario Bros. 3: Super Mario Advance 4|restored gamma]]
|}
: Note: Remove any accessory from the External Extension Connector, or the Rumble Feature will not work.
: Note: If you are using an EverDrive, make sure to turn off "Quick Boot" in the options, or the enhancements may not work.
; <code><path></code>
: Load Game Boy Advance multiboot ROM. Using this option is not recommended.
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.

== Comparisons ==

=== Video quality ===

==== Blackmagic Intensity Shuttle ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7180.pdf ADV7180] and [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7604.pdf ADV7604].

<gallery widths="240px" heights="160px">
File:GBI ADV7180 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI ADV7180 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI ADV7180 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI ADV7180 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
File:GBI ADV7604 HDRV.png|HD Retrovision Component Video Cable
File:GBI ADV7604 Component.png|Nintendo Component Video Cable
File:GBI ADV7604 GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI ADV7604 GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Datapath VisionRGB ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/AD9887A.pdf AD9887A].

<gallery widths="240px" heights="160px">
File:GBI AD9887A HDRV.png|HD Retrovision Component Video Cable
File:GBI AD9887A Component.png|Nintendo Component Video Cable
File:GBI AD9887A GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI AD9887A GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Hauppauge WinTV-HVR-1850 ====

Using [https://web.archive.org/web/20120509222042/http://conexant.com/servlets/DownloadServlet/PBR-200974-004.pdf?docid=975&revid=4 CX23888].

<gallery widths="240px" heights="160px">
File:GBI CX23888 NTSC.png|Nintendo RF Modulator (NTSC-J)
File:GBI CX23888 PAL-M.png|Nintendo RF Modulator (PAL-M)
File:GBI CX23888 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI CX23888 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI CX23888 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI CX23888 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
</gallery>

=== Sound emulation ===

==== ''Mega Man Zero 2'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gbp.flac Game Boy Player Start-up Disc]

==== ''Pokémon Sapphire'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gbp.flac Game Boy Player Start-up Disc]

=== 3D lookup table ===

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity LUT.png|Identity LUT <code>lutrgb.png</code>
File:GBI AXPE GBA Light LUT.png|Game Boy Advance <code>lutrgb-gba-light.png</code>
File:GBI AXPE GBA LUT.png|Game Boy Advance <code>lutrgb-gba.png</code>
File:GBI AXPE GBC LUT.png|Gambatte/higan <code>lutrgb-gbc.png</code>
File:GBI AXPE GBP LUT.png|Game Boy Player Start-up Disc <code>lutrgb-gbp.png</code>
File:GBI AXPE NDS LUT.png|Nintendo DS <code>lutrgb-nds.png</code>
File:GBI AXPE VBA LUT.png|VisualBoyAdvance-M <code>lutrgb-vba.png</code>
File:GBI AXPE WiiU LUT.png|Wii U Virtual Console <code>lutrgb-wiiu.png</code>
</gallery>

=== Color matrix ===

==== ''Golden Sun'' ====

<gallery widths="240px" heights="160px">
File:GBI AGSE Identity.png|Identity matrix
File:GBI AGSE GBA.png|Game Boy Advance
File:GBI AGSE GBC.png|Game Boy Color
File:GBI AGSE GBI.png|Game Boy Interface
File:GBI AGSE NDS.png|Nintendo DS
File:GBI AGSE Palm.png|Palm Treo 700p
File:GBI AGSE PSP.png|PlayStation Portable
File:GBI AGSE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Mario Kart: Super Circuit'' ====

<gallery widths="240px" heights="160px">
File:GBI AMKE Identity.png|Identity matrix
File:GBI AMKE GBA.png|Game Boy Advance
File:GBI AMKE GBC.png|Game Boy Color
File:GBI AMKE GBI.png|Game Boy Interface
File:GBI AMKE NDS.png|Nintendo DS
File:GBI AMKE Palm.png|Palm Treo 700p
File:GBI AMKE PSP.png|PlayStation Portable
File:GBI AMKE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity.png|Identity matrix
File:GBI AXPE GBA.png|Game Boy Advance
File:GBI AXPE GBC.png|Game Boy Color
File:GBI AXPE GBI.png|Game Boy Interface
File:GBI AXPE NDS.png|Nintendo DS
File:GBI AXPE Palm.png|Palm Treo 700p
File:GBI AXPE PSP.png|PlayStation Portable
File:GBI AXPE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''The Legend of Zelda: The Minish Cap'' ====

<gallery widths="240px" heights="160px">
File:GBI BZME Identity.png|Identity matrix
File:GBI BZME GBA.png|Game Boy Advance
File:GBI BZME GBC.png|Game Boy Color
File:GBI BZME GBI.png|Game Boy Interface
File:GBI BZME NDS.png|Nintendo DS
File:GBI BZME Palm.png|Palm Treo 700p
File:GBI BZME PSP.png|PlayStation Portable
File:GBI BZME VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Wario Land 4'' ====

<gallery widths="240px" heights="160px">
File:GBI AWAE Identity.png|Identity matrix
File:GBI AWAE GBA.png|Game Boy Advance
File:GBI AWAE GBC.png|Game Boy Color
File:GBI AWAE GBI.png|Game Boy Interface
File:GBI AWAE NDS.png|Nintendo DS
File:GBI AWAE Palm.png|Palm Treo 700p
File:GBI AWAE PSP.png|PlayStation Portable
File:GBI AWAE VBA.png|VisualBoyAdvance-M
</gallery>

== Examples ==

=== Color emulation ===

==== Game Boy Advance ====

[[File:GBI_Game_Boy_Advance.png|border|right]]
Using a contrast ratio of 250:1.

<pre>
--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177
</pre>

==== Nintendo DS ====

[[File:GBI_Nintendo_DS.png|border|right]]
Using a contrast ratio of 600:1.

<pre>
--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934
</pre>

==== Palm Treo 700p ====

[[File:GBI_Palm_Treo_700p.png|border|right]]
Using a contrast ratio of 75:1.

<pre>
--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364
</pre>

==== PlayStation Portable ====

[[File:GBI_PlayStation_Portable.png|border|right]]
Using a contrast ratio of 750:1.

<pre>
--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556
</pre>

=== Color restoration ===

==== ''Mario & Luigi: Superstar Saga'' ====

This game reduces contrast when played ''with'' Game Boy Player enhancements.

<pre>
--contrast=1.1
</pre>

==== ''Super Mario Bros. 3: Super Mario Advance 4'' ====

This game reduces gamma when played ''without'' Game Boy Player enhancements.

<pre>
--input-gamma=2.8
</pre>

==== ''The Legend of Zelda: Oracle of Ages/Seasons'' ====

This game reduces gamma when played on a Game Boy Advance.
Due to Game Boy Color limitations, only shadows can be restored perfectly.

<pre>
--input-gamma=4.
</pre>

=== Mimicking ===

==== Game Boy Interface (ultra-low latency) ====

<pre>
--delay-reset=0
--delay-video=0
--no-overlay
--format=custom,scaled-size=528:320,size=480:320
</pre>

==== Game Boy Player Start-up Disc (60Hz) ====

Included as <code>gbisr.cli.example</code>.

<pre>
--delay-video=2
--contrast=.78125
--vfilter=.5:.25:.25
--sound=analog=.000148021979839541018009185791015625:.00029604395967908203601837158203125:.000148021979839541018009185791015625:-1.965293407440185546875:.965885460376739501953125
--format=ntsc,scaled-size=666:448,size=608:448
--scan-mode=interlace
--enhance
</pre>

==== Game Boy Player Start-up Disc (50Hz) ====

<pre>
--delay-reset=65
--delay-video=2
--contrast=.78125
--vfilter=.5:.25:.25
--sound=analog=.000148021979839541018009185791015625:.00029604395967908203601837158203125:.000148021979839541018009185791015625:-1.965293407440185546875:.965885460376739501953125
--format=pal,scaled-size=670:530,size=608:448
--scan-mode=interlace
--enhance
</pre>

==== Nintendo 3DS Virtual Console ====

===== ''F-Zero Maximum Velocity'', ''Fire Emblem: The Sacred Stones'', ''Mario vs. Donkey Kong'' and ''The Legend of Zelda: The Minish Cap'' =====

<pre>
--contrast=.7
--blend=.75
</pre>

===== ''Kirby & The Amazing Mirror'' =====

<pre>
--contrast=.6
--blend=.5625
</pre>

===== ''Mario Kart: Super Circuit'' =====

<pre>
--contrast=.65
--blend=.75
</pre>

===== ''Metroid Fusion'' =====

<pre>
--contrast=.7
--blend=.5625
</pre>

===== ''Wario Land 4'' and ''WarioWare, Inc.: Mega Microgame$'' =====

<pre>
--contrast=.65
--blend=.5625
</pre>

===== ''Yoshi's Island: Super Mario Advance 3'' =====

<pre>
--contrast=.6
--blend=.5
</pre>

=== Video optimization ===

==== Datapath VisionRGB (Component Video Cable) ====

<pre>
--vfilter=.5:.5:.0:.5:.0:.5
--format=custom,offset=0,scaled-size=0
--scan-mode=non-interlace,clock2x
</pre>

* Resolution and Refresh
** Width: 320
** Height: 240
** Vertical Refresh: 119.45
* Video Adjustments
** Horizontal Position: 85
** Horizontal Size: 433
** Phase: 27
** Vertical Position: 18
** Black Level: 8
* Cropping
** Top: 40
** Left: 40
** Width: 240
** Height: 160
* Color Adjustments
** Brightness: 32
** Contrast: 128
** Colour Domain: YUV (601)
** Colour Balance
*** All Colors
**** Brightness: 32
**** Contrast: 128
*** Red
**** Brightness: 158
**** Contrast: 158
*** Green
**** Brightness: 170
**** Contrast: 170
*** Blue
**** Brightness: 152
**** Contrast: 152

==== Open Source Scan Converter ====

Included as <code>gbisr-ossc.cli</code>, <code>gbisr-ossc.dol+cli</code> and <code>gbisr-ossc.gci</code>.
Refer to [http://www.firebrandx.com/gbiosscoptimal.html FirebrandX] for configuration.

<pre>
--vfilter=.5:.5:.0:.5:.0:.5
--format=custom,offset=0,scaled-size=0
--scan-mode=non-interlace
</pre>

==== XRGB-mini Framemeister ====

Included as <code>gbisr-xrgb.cli</code>, <code>gbisr-xrgb.dol+cli</code> and <code>gbisr-xrgb.gci</code>.
Refer to [http://www.firebrandx.com/framemeisterprofiles.html FirebrandX] for configuration.

<pre>
--vfilter=.5:.5:.0:.5:.0:.5
--format=custom-m,offset=0,scaled-size=0
--scan-mode=non-interlace
</pre>

=== Video output ===

==== 120Hz black frame insertion ====

<pre>
--vfilter=.5:.5:.0:.0
--scan-mode=non-interlace,clock2x
</pre>

==== 480p hybrid scanlines ====

<pre>
--overlay=frame.tpl.gz
--gamma=2.2:1.
--scan-mode=progressive
</pre>

==== 480p simple scanlines ====

<pre>
--vfilter=.5:.5:.0:.0
--scan-mode=progressive
</pre>

=== Video scaling ===

==== 4:3 fullscreen (Game Boy Advance) ====

<pre>
--zoom=2.375
--scaler=oversample
--vfilter=.625:.1875:.1875
--scan-mode=interlace
</pre>

==== 4:3 fullscreen (Game Boy Color) ====

<pre>
--zoom=3
--vfilter=.5:.25:.25
--scan-mode=interlace
</pre>

<pre>
--zoom=3
--vfilter=.5:.5:.0:.5:.0:.5
--scan-mode=non-interlace
</pre>

==== 16:9 fullscreen ====

<pre>
--zoom=2:3
--format=size=568
--scan-mode=progressive
</pre>

== FAQs ==

=== How do I change Game Paks? ===

# Hold the Reset Button.
# Slide the Game Pak Ejector.
# Insert a Game Pak into the Game Pak Slot.
# Release the Reset Button.

=== Can I play [[wikipedia:Game Boy Advance Video|Game Boy Advance Video]]? ===

Yes. You can do so by disabling Game Boy Player enhancements (<code>--no-enhance</code>), or holding a direction while the Game Boy Player logo is visible.

=== Is this an emulator? Can I play ROMs? ===

No, but there's [[Enhanced mGBA]] if you're looking for one.

== Changelog ==

=== August, 2018 ===

* Updated color matrices by Pokefan531.

=== July, 2018 ===

* Updated GBA-as-GC controller.
* Disabled component video DAC oversampling.

=== June, 2018 ===

* Added analog sound emulation.
* Added Custom-M video format.
* Added Custom interlaced video modes.
* Merged vertical filter controls.
* Changed brightness/contrast controls to match BT.1886.
* Fixed some audio bugs.
* Enabled progressive scan in more cases to prevent display issues.

=== May, 2018 ===

* Added Super Game Boy color palette setting.
* Changed scan mode semantics.
* Fixed Game Boy Player advertisement.
* Fixed rumble protocol handshake.

=== April, 2018 ===

* Added movie recording/playback.
* Updated GBA-as-GC controller.

=== March, 2018 ===

* Added control swapping for SNES Controllers.
* Added framebuffer size/offset setting.
* Replaced sample aspect ratio with scaled size.
* Improved per-field filtering in single-buffered mode.
* Improved multiboot implementation.
* Improved Game Boy sound quality.
* Improved audio rendering.
* Reduced audio latency.
* Fixed SD card compatibility.
* Fixed multiboot to rumble protocol transition.
* Disabled default multiboot.

=== February, 2018 ===

* Added background color setting.
* Added video buffering setting.
* Added input viewer.
* Added color matrix from Gambatte.
* Added mono sound mode.
* Added 3D LUT auto-generation.
* Added GBR/BGR LUT order support.
* Added per-field gamma correction control.
* Changed some argument semantics.
* Fixed per-field settings with default video mode.
* Fixed wiiload autoboot with tiny GBA multiboot ROMs.
* Disabled machine checks.

=== January, 2018 ===

* Updated LUTs by Pokefan531.
* Improved Game Boy Player driver.
* Changed default component video modes.
* Tweaked control type C.

=== September, 2017 ===

* Added overlay scale setting.
* Added Logitech Speed Force support.
* Added Active Life Mat support.
* Improved Game Boy Player driver.
* Changed zoom scale.
* Changed wiiload server to accept oversized DOLs.
* Fixed one random kernel crash.
* Fixed scaling without a 3D LUT.

=== August, 2017 ===

* Added DK Bongos support.
* Adapted control type C for Super Mario World: Super Mario Advance 2.
* Added control type D for The Legend of Zelda: A Link to the Past.
* Added per-field vertical filter control.
* Added PNG 3D LUT support.
* Added LUTs by Pokefan531.
* Added LUTs from the 3DS Virtual Console.
* Improved Game Boy Player driver.

=== July, 2017 ===

* Added CLI append support.
* Updated GBA-as-GC controller.
* Changed reset combo behavior.

=== June, 2017 ===

* Added zoom & rotate.
* Added reset delay.
* Added reset combo.

=== April, 2017 ===

* Added component video DAC oversampling.
* Added reset fade effect.
* Added TPL overlay support.

=== March, 2017 ===

* Added rumble, disabled by default.
* Added USB Gecko wiiload server.
* Added Xboo Communicator.

=== February, 2017 ===

* Added volume control.
* Added per-channel settings where possible.
* Changed volume to 75% to mitigate clipping.

=== November, 2016 ===

* Updated GBA-as-GC controller.

=== September, 2016 ===

* Added video options.
* Added control schemes.
* Added polling rate setting.

=== May, 2016 ===

* Updated GBA-as-GC controller.
* Improved Game Boy Player driver.
* Fixed WaveBird Controllers.

=== April, 2016 ===

* Replaced GBA-as-controller with GBA-as-GC controller.

=== March, 2016 ===

* Added U+D/L+R cancelling.
* Added GBA-as-controller support.
* Recognized a half press of the analog triggers.

=== August, 2015 ===

* Added executable compression.
* Added memory card distribution files.
* Reduced coil whine.

=== July, 2015 ===

* Fixed Game Boy Player detection.

[[Category:Homebrew_Software]]

Game Boy Interface/Standard Edition

2018-12-08T20:24:39Z

Eatnumber1: /* Options */ Add a note about turning off QuickBoot to the GBI options section.

{{:Game Boy Interface}}
The author's original vision, '''Game Boy Interface Standard Edition''' ('''GBI''') features an advanced video renderer exercising the GameCube hardware to its fullest.

<div class="toclimit-4">
__TOC__
</div>

== Controls ==

=== On-screen display ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons
| Hide on-screen display
|-
|
| X Button
| X Button
| Toggle on-screen display
|-
|
| Y Button
| Y Button
| Revert offset/zoom
|-
|
| Z Button
| Z Button
| Take screenshot
|-
|
| Start/Pause (Hold for 1 second)
| Start/Pause (Hold for 1 second)
| Exit
|-
|
| +Control Pad
| +Control Pad
| Offset
|-
|
| L/R Buttons
| L/R Buttons
| Zoom
|-
| Reset Button
| X, Y and Start/Pause Buttons (Hold for 1.5 seconds)
|
| Recalibrate
|-
| Reset Button
|
|
| Save movie
|}

=== In-game ===

{| class="wikitable" style="display: inline-table;"
|-
! Nintendo GameCube
! Nintendo GameCube Controller
! Logitech Speed Force
! Action
|-
|
| A/B Buttons
| A/B Buttons or Accelerator/Brake Pedals
| A/B Buttons
|-
|
| X Button
| X Button
| Toggle on-screen display
|-
|
| Y Button
| Y Button
| Turbo
|-
|
| Z Button
| Z Button
| Select
|-
|
| Start/Pause
| Start/Pause
| Start
|-
|
| +Control Pad or Control Stick
| +Control Pad or Steering Wheel
| +Control Pad
|-
|
| L/R Buttons
| L/R Buttons
| L/R Buttons (Only for Game Boy Advance)
|-
| Reset Button
|
|
| Power Switch
|}

{| class="wikitable" style="display: inline-table;"
|-
! DK Bongos Controller
! Active Life Mat Controller
! Action
|-
| Bottom Right/Left
| Orange Up/Right
| A/B Buttons
|-
| Hand Clap
| - Button
| Select
|-
| Start/Pause
| + Button
| Start
|-
| Top Right
| Blue or Orange Square
| +Control Pad Right
|-
| Top Left
| Blue Left
| +Control Pad Left
|-
|
| Blue Up
| +Control Pad Up
|-
|
| Blue or Orange Down
| +Control Pad Down
|}

== Options ==

; <code>--aspect=<w:h></code>
: Specify screen aspect ratio. The default is the Progressive Scan Mode system setting (4:3 or 16:9).
; <code>--offset=<x:y></code>
: Set offset. The default is the Screen Position system setting (-32 to +32).
; <code>--zoom=<x:y></code>
: Set zoom. The default is the Game Boy Player Start-up Disc's Screen Size setting (2.0 or 2.375).
; <code>--rotate=<0-359></code>
: Set rotation (default: 0).
; <code>--poll=<0-11></code>
: Set controller polling rate.
: {| 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
|}
; <code>--turbo=<on:off></code>
: Set autofire interval (default: 3).
; <code>--movie=<path></code>, <code>--no-movie</code>
: Play input log (default: no).
; <code>--movie-record</code>, <code>--no-movie-record</code>
: Record input log (default: no).
; <code>--overlay=<path></code>, <code>--no-overlay</code>
: Load texture palette (default: frame.tpl.gz).
; <code>--overlay-id=<ID></code>
: Set texture palette index. The default is the Game Boy Player Start-up Disc's Frame setting (0 to 19).
; <code>--overlay-scale=<x:y></code>
: Set texture scale (default: auto).
; <code>--filter=<none|scale2x[ex|plus]|eagle2x|scan2x|normal2x|normalnx></code>
: Set image doubling filter (default: normalnx).
; <code>--dither=<none|threshold|bayer8x8|bayer4x4|bayer2x2|cluster8x8|cluster4x4></code>
: Set dithering algorithm (default: threshold).
; <code>--scaler=<nearest|bilinear|oversample|box></code>
: Set image scaling filter (default: bilinear).
; <code>--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba></code>
: Set color matrix (default: gbi).
: {| class="wikitable"
| '''identity:'''
| [[wikipedia:Identity matrix|Identity matrix]]
|-
| '''gba:'''
| [[#Game Boy Advance|Game Boy Advance]] (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
|-
| '''nds:'''
| [[#Nintendo DS|Nintendo DS]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''palm:'''
| [[#Palm Treo 700p|Palm Treo 700p]] (by [https://forums.libretro.com/t/real-gba-and-ds-phat-colors/1540 Pokefan531])
|-
| '''psp:'''
| [[#PlayStation Portable|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])
|}
; <code>--input-gamma=<red[:green[:blue]]></code>
: Set gamma (default: 2.2).
; <code>--output-gamma=<1.0|1.7|2.2></code>
: Specify screen gamma (default: 2.2).
; <code>--contrast=<red[:green[:blue]]></code>
: Set gain (default: 1.0).
; <code>--brightness=<red[:green[:blue]]></code>
: Set lift (default: 0.0).
; <code>--volume=<left[:right]></code>
: Set audio gain (default: 0.75).
; <code>--sound=<[mono|stereo][,digital|analog]></code>
: Set sound mode. The default is the Sound Mode system setting (mono or stereo).
:; <code>digital</code>
:: Use PWM decoder.
:; <code>analog[=<a0:a1:a2:b1:b2>]</code>
:: Use 2MHz biquad filter (default). Defaults to a second-order low-pass filter with a cut-off of 10kHz and a quality factor of √2 if not specified.
; <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 and 60Hz Mode system setting (ntsc, pal or pal-60, pal-m).
; <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 interlace
|-
| '''quasi-interlace:'''
| 15 or 18-22kHz segmented frame
|-
| '''non-interlace:'''
| 15 or 18-22kHz progressive
|-
| '''non-progressive:'''
| 31 or 27-33kHz interlace
|-
| '''progressive:'''
| 31 or 36-45kHz progressive
|}
:; <code>clock2x</code>, <code>no-clock2x</code>
:: Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for <code>interlace</code> modes. Disabling halves the refresh rate for <code>progressive</code> modes.
:: This only works with the Component Video Cable.
:; <code>size2x</code>, <code>no-size2x</code>
:: Enable 2x video oversampling (default: auto). Enabling halves the refresh rate.
:: This only works with the Component Video Cable.
; <code>--osd</code>, <code>--no-osd</code>
: Show on-screen display (default: yes).
; <code>--ipv4-address=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 address.
; <code>--ipv4-gateway=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 gateway.
; <code>--ipv4-netmask=<aaa.bbb.ccc.ddd></code>
: Set static IPv4 netmask.
; <code>--network</code>, <code>--no-network</code>
: Enable [[Broadband Adapter]] features (default: yes).
; <code>--stream[=<aaa.bbb.ccc.ddd>]</code>, <code>--no-stream</code>
: Stream video to IP address on UDP port 1234 (default: no). Defaults to 255.255.255.255 if not specified.
; <code>--enhance</code>, <code>--no-enhance</code>
: Enable Game Boy Player enhancements (default: yes).
: {| class="wikitable sortable"
! Title
! Feature(s)
|-
| ''[[wikipedia:Drill Dozer|Drill Dozer]]''
| Rumble
|-
| ''[[wikipedia:Game Boy Advance Video|Game Boy Advance Video]] Series''
| [[#Can I play Game Boy Advance Video?|Not compatible]]
|-
| ''[[wikipedia:Mario & Luigi: Superstar Saga|Mario & Luigi: Superstar Saga]]''
| Rumble, [[#Mario & Luigi: Superstar Saga|reduced contrast]]
|-
| ''[[wikipedia:Pokémon Pinball: Ruby & Sapphire|Pokémon Pinball: Ruby & Sapphire]]''
| Rumble
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kanji Keisanhen''
| Rumble, restored contrast
|-
| ''Shikakui Atama o Maru Kusuru Advance: Kokugo Sansuu Shakai Rikahen''
| Rumble, restored contrast
|-
| ''[[wikipedia:Super Mario Advance 4: Super Mario Bros. 3|Super Mario Advance 4: Super Mario Bros. 3]]''
| Rumble, [[#Super Mario Bros. 3: Super Mario Advance 4|restored gamma]]
|}
: Note: Remove any accessory from the External Extension Connector, or the Rumble Feature will not work.
: Note: If you are using an EverDrive, make sure to turn off "Quick Boot" in the options, or the enhancements may not work.
; <code><path></code>
: Load Game Boy Advance multiboot ROM (default: default.mb.gz).
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.

== Comparisons ==

=== Video quality ===

==== Blackmagic Intensity Shuttle ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7180.pdf ADV7180] and [http://www.analog.com/media/en/technical-documentation/data-sheets/ADV7604.pdf ADV7604].

<gallery widths="240px" heights="160px">
File:GBI ADV7180 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI ADV7180 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI ADV7180 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI ADV7180 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
File:GBI ADV7604 HDRV.png|HD Retrovision Component Video Cable
File:GBI ADV7604 Component.png|Nintendo Component Video Cable
File:GBI ADV7604 GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI ADV7604 GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Datapath VisionRGB ====

Using [http://www.analog.com/media/en/technical-documentation/data-sheets/AD9887A.pdf AD9887A].

<gallery widths="240px" heights="160px">
File:GBI AD9887A HDRV.png|HD Retrovision Component Video Cable
File:GBI AD9887A Component.png|Nintendo Component Video Cable
File:GBI AD9887A GCHD.png|GCVideo-DVI v2.4a and earlier
File:GBI AD9887A GCHD RevB.png|GCVideo-DVI v2.4b
</gallery>

==== Hauppauge WinTV-HVR-1850 ====

Using [https://web.archive.org/web/20120509222042/http://conexant.com/servlets/DownloadServlet/PBR-200974-004.pdf?docid=975&revid=4 CX23888].

<gallery widths="240px" heights="160px">
File:GBI CX23888 NTSC.png|Nintendo RF Modulator (NTSC-J)
File:GBI CX23888 PAL-M.png|Nintendo RF Modulator (PAL-M)
File:GBI CX23888 Composite NTSC.png|Nintendo Stereo AV Cable (NTSC-J)
File:GBI CX23888 Composite PAL-M.png|Nintendo Stereo AV Cable (PAL-M)
File:GBI CX23888 S-Video NTSC.png|Generic S-Video Cable (NTSC-J)
File:GBI CX23888 S-Video PAL-M.png|Generic S-Video Cable (PAL-M)
</gallery>

=== Sound emulation ===

==== ''Mega Man Zero 2'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-a62e-gbp.flac Game Boy Player Start-up Disc]

==== ''Pokémon Sapphire'' ====

* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-none.flac Digital]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gba.flac Game Boy Advance]
* [https://files.extremscorner.org/gamecube/audio/gbi-axpe-gbp.flac Game Boy Player Start-up Disc]

=== Image doubling ===

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE None.png|None
File:GBI AXPE Scale2xEx.png|Scale2×Ex
File:GBI AXPE Scale2xPlus.png|Scale2×Plus
File:GBI AXPE Scale2x.png|Scale2×
File:GBI AXPE Eagle2x.png|Eagle2×
File:GBI AXPE Scan2x.png|Scan2×
File:GBI AXPE Normal2x.png|Normal2×
</gallery>

=== Color matrix ===

==== ''Golden Sun'' ====

<gallery widths="240px" heights="160px">
File:GBI AGSE Identity.png|Identity matrix
File:GBI AGSE GBA.png|Game Boy Advance
File:GBI AGSE GBC.png|Game Boy Color
File:GBI AGSE GBI.png|Game Boy Interface
File:GBI AGSE NDS.png|Nintendo DS
File:GBI AGSE Palm.png|Palm Treo 700p
File:GBI AGSE PSP.png|PlayStation Portable
File:GBI AGSE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Mario Kart: Super Circuit'' ====

<gallery widths="240px" heights="160px">
File:GBI AMKE Identity.png|Identity matrix
File:GBI AMKE GBA.png|Game Boy Advance
File:GBI AMKE GBC.png|Game Boy Color
File:GBI AMKE GBI.png|Game Boy Interface
File:GBI AMKE NDS.png|Nintendo DS
File:GBI AMKE Palm.png|Palm Treo 700p
File:GBI AMKE PSP.png|PlayStation Portable
File:GBI AMKE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Pokémon Sapphire'' ====

<gallery widths="240px" heights="160px">
File:GBI AXPE Identity.png|Identity matrix
File:GBI AXPE GBA.png|Game Boy Advance
File:GBI AXPE GBC.png|Game Boy Color
File:GBI AXPE GBI.png|Game Boy Interface
File:GBI AXPE NDS.png|Nintendo DS
File:GBI AXPE Palm.png|Palm Treo 700p
File:GBI AXPE PSP.png|PlayStation Portable
File:GBI AXPE VBA.png|VisualBoyAdvance-M
</gallery>

==== ''The Legend of Zelda: The Minish Cap'' ====

<gallery widths="240px" heights="160px">
File:GBI BZME Identity.png|Identity matrix
File:GBI BZME GBA.png|Game Boy Advance
File:GBI BZME GBC.png|Game Boy Color
File:GBI BZME GBI.png|Game Boy Interface
File:GBI BZME NDS.png|Nintendo DS
File:GBI BZME Palm.png|Palm Treo 700p
File:GBI BZME PSP.png|PlayStation Portable
File:GBI BZME VBA.png|VisualBoyAdvance-M
</gallery>

==== ''Wario Land 4'' ====

<gallery widths="240px" heights="160px">
File:GBI AWAE Identity.png|Identity matrix
File:GBI AWAE GBA.png|Game Boy Advance
File:GBI AWAE GBC.png|Game Boy Color
File:GBI AWAE GBI.png|Game Boy Interface
File:GBI AWAE NDS.png|Nintendo DS
File:GBI AWAE Palm.png|Palm Treo 700p
File:GBI AWAE PSP.png|PlayStation Portable
File:GBI AWAE VBA.png|VisualBoyAdvance-M
</gallery>

== Examples ==

=== Color emulation ===

==== Game Boy Advance ====

[[File:GBI_Game_Boy_Advance.png|border|right]]
Using a contrast ratio of 250:1.

<pre>
--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177
</pre>

==== Nintendo DS ====

[[File:GBI_Nintendo_DS.png|border|right]]
Using a contrast ratio of 600:1.

<pre>
--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934
</pre>

==== Palm Treo 700p ====

[[File:GBI_Palm_Treo_700p.png|border|right]]
Using a contrast ratio of 75:1.

<pre>
--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364
</pre>

==== PlayStation Portable ====

[[File:GBI_PlayStation_Portable.png|border|right]]
Using a contrast ratio of 750:1.

<pre>
--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556
</pre>

=== Color restoration ===

==== ''Mario & Luigi: Superstar Saga'' ====

This game reduces contrast when played ''with'' Game Boy Player enhancements.

<pre>
--contrast=1.1
</pre>

==== ''Super Mario Bros. 3: Super Mario Advance 4'' ====

This game reduces gamma when played ''without'' Game Boy Player enhancements.

<pre>
--input-gamma=2.8
</pre>

==== ''The Legend of Zelda: Oracle of Ages/Seasons'' ====

This game reduces gamma when played on a Game Boy Advance.
Due to Game Boy Color limitations, only shadows can be restored perfectly.

<pre>
--input-gamma=4.
</pre>

=== Mimicking ===

==== Game Boy Player Start-up Disc ====

Included as <code>gbi.cli.example</code>.

<pre>
--aspect=4:3
--overlay=frame-srgb.tpl.gz
--dither=none
--matrix=identity
--input-gamma=1.
--output-gamma=1.
--contrast=.78125
--sound=analog=.000148021979839541018009185791015625:.00029604395967908203601837158203125:.000148021979839541018009185791015625:-1.965293407440185546875:.965885460376739501953125
--no-osd
</pre>

==== Wii U Virtual Console ====

<pre>
--aspect=16:9
--zoom=3
--no-overlay
--dither=none
--matrix=identity
--input-gamma=1.
--output-gamma=1.
--contrast=.75
--sound=digital
--no-osd
--no-enhance
</pre>

=== Video optimization ===

==== Datapath VisionRGB ====

The author's personal setup.

<pre>
--aspect=4:3
--offset=0
--zoom=4
--dither=bayer2x2
--scaler=nearest
--format=hd60
--scan-mode=non-interlace,clock2x,size2x
</pre>

* Resolution and Refresh
** Width: 960
** Height: 360
** Vertical Refresh: 60.00
* Video Adjustments
** Horizontal Position: 205
** Horizontal Size: 1200
** Phase: 31
** Vertical Position: 13
** Black Level: 8
* Cropping
** Top: 20
** Left: 0
** Width: 960
** Height: 320
* Color Adjustments
** Brightness: 32
** Contrast: 128
** Colour Domain: YUV (601)
** Colour Balance
*** All Colors
**** Brightness: 32
**** Contrast: 128
*** Red
**** Brightness: 158
**** Contrast: 158
*** Green
**** Brightness: 178
**** Contrast: 178
*** Blue
**** Brightness: 152
**** Contrast: 152

==== Open Source Scan Converter ====

<pre>
--aspect=4:3
--offset=0
--zoom=4
--filter=none
--scaler=nearest
--format=hd60
--scan-mode=non-interlace
</pre>

==== High-definition televisions ====

Change the Aspect Ratio on the television to Just Scan.

<pre>
--aspect=1.8
--zoom=3.375
--format=hd60
--scan-mode=non-progressive
</pre>

==== Video capture devices (Game Boy Advance) ====

<pre>
--aspect=3:2
--offset=0
--zoom=3
--dither=bayer2x2
--scaler=nearest
--format=ntsc
</pre>

==== Video capture devices (Game Boy Color) ====

<pre>
--aspect=5:4
--offset=0
--zoom=4
--dither=bayer2x2
--scaler=nearest
--format=pal
</pre>

== FAQs ==

=== How do I change Game Paks? ===

# Hold the Reset Button.
# Slide the Game Pak Ejector.
# Insert a Game Pak into the Game Pak Slot.
# Release the Reset Button.

=== Can I play [[wikipedia:Game Boy Advance Video|Game Boy Advance Video]]? ===

Yes. You can do so by disabling Game Boy Player enhancements (<code>--no-enhance</code>), or holding a direction while the Game Boy Player logo is visible.

=== Is this an emulator? Can I play ROMs? ===

No, but there's [[Enhanced mGBA]] if you're looking for one.

=== Why is there motion blur? Can I turn it off? ===

It removes stuttering caused by mismatches between the Game Boy Advance and the display refresh rate. It cannot be turned off. It can be reduced by using a 120Hz mode, but it's most effective on a sample-and-hold display.

=== What happens when I exit Game Boy Interface? ===

The Game Boy Player keeps running and you're returned to <code>autoexec.dol</code>, or the Nintendo GameCube Main Menu.

== Changelog ==

=== October, 2018 ===

* Added HDCustom video format.

=== August, 2018 ===

* Updated color matrices by Pokefan531.

=== July, 2018 ===

* Updated GBA-as-GC controller.

=== June, 2018 ===

* Added analog sound emulation.
* Added Custom-M video format.
* Added Custom interlaced video modes.
* Changed default sound mode to analog.
* Changed brightness/contrast controls to match BT.1886.
* Fixed some audio bugs.
* Enabled progressive scan in more cases to prevent display issues.

=== May, 2018 ===

* Added 360p, 720i, 720p and 1080i video modes.
* Changed scan mode semantics.
* Changed default aspect ratio for progressive scan to 16:9.
* Fixed Game Boy Player advertisement.
* Fixed rumble protocol handshake.

=== April, 2018 ===

* Added movie recording/playback.
* Updated GBA-as-GC controller.

=== March, 2018 ===

* Improved multiboot implementation.
* Improved Game Boy sound quality.
* Improved audio rendering.
* Reduced audio latency.
* Changed default color matrix to GBI's original.
* Fixed SD card compatibility.
* Fixed multiboot to rumble protocol transition.

=== February, 2018 ===

* Added color matrix from Gambatte.
* Added mono sound mode.
* Fixed wiiload autoboot with tiny GBA multiboot ROMs.
* Disabled machine checks.

=== January, 2018 ===

* Updated color matrices by Pokefan531.
* Improved Game Boy Player driver.

=== September, 2017 ===

* Added overlay scale setting.
* Added Logitech Speed Force support.
* Added Active Life Mat support.
* Improved Game Boy Player driver.
* Changed wiiload server to accept oversized DOLs.
* Fixed one random kernel crash.

=== August, 2017 ===

* Added DK Bongos support.
* Updated color matrices by Pokefan531.
* Improved Game Boy Player driver.

=== July, 2017 ===

* Added CLI append support.
* Updated color matrices by Pokefan531.
* Updated GBA-as-GC controller.

=== April, 2017 ===

* Added component video DAC oversampling.
* Added experimental 960i and 1152i video modes.

=== March, 2017 ===

* Added temporal/spatial dithering.
* Added color matrices by Pokefan531.
* Added TPL overlay support to wiiload server.
* Changed default color matrix to Pokefan531's.
* Changed default gamma to 2.2.
* Optimized NormalNx filter.

=== February, 2017 ===

* Added volume control.
* Added per-channel settings where possible.
* Changed volume to 75% to mitigate clipping.
* Fixed framebuffer clearing for 576i.

=== November, 2016 ===

* Updated GBA-as-GC controller.
* Optimized Scale2xEx filter.

=== October, 2016 ===

* Added Scale2xEx and Scale2xPlus filters.
* Added oversample and box scalers.
* Added basic video streaming.
* Added Remote RetroPad support.
* Optimized video rendering.

=== September, 2016 ===

* Added polling rate setting.

=== May, 2016 ===

* Updated GBA-as-GC controller.
* Improved Game Boy Player driver.
* Fixed WaveBird Controllers.

=== April, 2016 ===

* Added GBA multiboot support to wiiload server.
* Added Xboo Communicator.
* Added BIOS/ROM dumper.
* Replaced GBA-as-controller with GBA-as-GC controller.

=== March, 2016 ===

* Added GBA-as-controller support.
* Recognized a half press of the analog triggers.

=== December, 2015 ===

* Expanded video options. Now includes 25, 30, 100 and 120 Hz modes.
* Added gamma-encoded borders for special use.

=== November, 2015 ===

* Added (GZipped) TPL overlay support.
* Added all 20 borders from the Game Boy Player Start-up Disc.

=== October, 2015 ===

* Added Scale2x, Eagle2x, Scan2x and Normal2x filters.

=== August, 2015 ===

* Added executable compression.
* Added return to <code>autoexec.dol</code>.
* Added memory card distribution files.
* Added auto-cropping for Game Boy screenshots.
* Optimized video rendering.
* Reduced coil whine.

=== July, 2015 ===

* Added rumble.
* Added hold to quit.
* Added screenshot saving.
* Added SNTP broadcast listener.
* Changed default video mode to interlaced.
* Fixed Game Boy Player detection.

=== May, 2015 ===

* Changed all 60 Hz modes to have 486 active lines.

=== March, 2015 ===

* Added digital PWM sound.
* Added turbo button.
* Fixed 288p.

[[Category:Homebrew_Software]]

Game Boy Interface

2018-12-08T12:20:53Z

Eatnumber1: /* GBA-as-controller */ note that you need to turn off the EverDrive's quick boot feature for rumble to work.

{{Infobox/homebrew
| title = <includeonly>[[</includeonly>Game Boy Interface<includeonly>]]</includeonly>
| author = [[User:Extrems|Extrems]]
| type = Utility
| version = Rolling release
| licence = [[Game Boy Interface#Licence|Freeware]]
| downloadraw = [https://files.extremscorner.org/gamecube/apps/gbi/latest Main download] [https://files.extremscorner.org/gamecube/apps/gbi/latest-extra Extra download]
| website = https://www.extremscorner.org/
| discussion = https://www.gc-forever.com/forums/viewtopic.php?f=37&t=2782
| source = https://github.com/ExtremsCorner
}}
<noinclude>
'''Game Boy Interface''' is an alternative to the Game Boy Player Start-up Disc software. It still requires the [[wikipedia:Game Boy Player|Game Boy Player]] hardware.

Game Boy Interface is currently available in three different editions: [[Game Boy Interface/Standard Edition|Standard]], [[Game Boy Interface/Speedrunning Edition|Speedrunning]] and [[Game Boy Interface/High-Fidelity Edition|High-Fidelity]].

<div class="toclimit-2">
__TOC__
</div>

== Overview ==

=== GBA-as-controller ===

Turn your Game Boy Advance into a Nintendo 64 or Nintendo GameCube Controller using the [[wikipedia:GameCube – Game Boy Advance link cable|Game Boy Advance Cable]].

Rumble is supported using the following Game or Option Paks:

* [[wikipedia:Drill Dozer|Drill Dozer]]
* [[wikipedia:Rumble Pak#Nintendo DS|Nintendo DS Rumble Pak]]
* [[wikipedia:Slide Adventure MAGKID#Slide Controller|Nintendo DS Slide Controller]]
* [[wikipedia:WarioWare: Twisted!|WarioWare: Twisted!]]

NOTE: If you are using a EverDrive, turn **off** "Quick Boot" in the options menu.

== Installation ==

{{Further|Booting Homebrew}}

=== SD Card ===

# Format the SD Card as FAT.
# Extract the main package to an SD Card.
# (Optional) Extract the extra package to an SD Card.
# (Optional) Rename the desired <code>.dol</code> or <code>.dol+cli</code> file on the SD Card to <code>autoexec.dol</code>.

Important: Do not move the folders into a folder.

=== Memory Card + SD Card ===

# Format the SD Card as FAT or FAT32.
# Extract the main package to an SD Card.
# (Optional) Extract the extra package to an SD Card.
# Restore [//www.gc-forever.com/forums/viewtopic.php?f=39&t=3023 Home Bros.] to a Memory Card.
# Rename the desired <code>.dol</code> or <code>.dol+cli</code> file on the SD Card to <code>boot.dol</code>.

Important: Do not move <code>boot.dol</code> or the folders into a folder.

=== Memory Card ===

=== IPL + SD Card ===

# Format the SD Card as FAT or FAT32.
# Extract the main package to an SD Card.
# (Optional) Extract the extra package to an SD Card.
# Install [https://github.com/Streetwalrus/iplboot/releases iplboot] to a supported [[IPL Replacement]].
# Rename the desired <code>.dol</code> or <code>.dol+cli</code> file on the SD Card to <code>ipl.dol</code>.

Important: Do not move <code>ipl.dol</code> or the folders into a folder.

=== DVD + SD Card ===

# Format the SD Card as FAT or FAT32.
# Extract the main package to an SD Card.
# (Optional) Extract the extra package to an SD Card.
# Burn <code>boot.gcm</code> from the extra package to a DVD-R.
# Rename the desired <code>.dol</code> or <code>.dol+cli</code> file on the SD Card to <code>boot.dol</code>.

Important: Do not move <code>boot.dol</code> or the folders into a folder.

=== DVD + Memory Card ===

=== DVD ===

This method is unsupported at this time.

== Configuration ==

=== Using Swiss ===

When loading a <code>.dol</code> file, [[Swiss]] first look for a <code>.dcp</code> file. This file contain a limited set of options that can be interactively changed before starting Game Boy Interface. This set of options can be expanded upon, but is limited to 16 options with 8 choices of 31 characters.

For a more permanent or advanced configuration, a <code>.cli</code> file can be used. This file contain command-line arguments on separate lines.

A list of options and example configurations can be found in the subpage for each edition.

=== Using wiiload ===

Game Boy Interface can be reloaded using its internal [//wiibrew.org/wiki/Wiiload wiiload] server with command-line arguments passed to the wiiload client.

New overlays can also be uploaded in this way.

=== Other ===

The contents of a <code>.cli</code> file can be appended to a <code>.dol</code> file to form a <code>.dol+cli</code> file. The file must end with a blank line due to the hacky nature of this method.

== Support ==

* [https://discord.gg/2dhfaHN Extrems' Corner.org Discord]
* [irc://irc.efnet.org/gc-forever GC-Forever IRC]
* [//www.gc-forever.com/forums/viewtopic.php?f=37&t=2782 GC-Forever Forums]

== Licence ==

<pre>
Copyright (c) 2014-2018, Extrems' Corner.org
All rights reserved. You may not sell or redistribute this software.
All trademarks used are properties of their respective owners.
</pre>

[[Category:Homebrew_Software]]
</noinclude>

Swiss

2018-05-02T20:08:18Z

Eatnumber1: /* Broadband Adapter */ apparently I misunderstood and this is unimplemented

{{Infobox/homebrew
| title = Swiss
| image = [[File:Swiss.png|right|thumb|235px]]
| type = Utility / IPL Replacement
| author = emu_kidid
| version = 0.4r431
| licence = [http://www.gnu.org/licenses/gpl-2.0.txt GNU GPL v2]
| website = http://code.google.com/p/swiss-gc/
| download = https://github.com/emukidid/swiss-gc/releases
| source = http://code.google.com/p/swiss-gc/source/list
}}

[http://code.google.com/p/swiss-gc/ '''Swiss'''] aims to be a all-in-one homebrew utility for the Nintendo GameCube. It uses libOGC and is compiled with devkitPPC (part of [http://www.devkitpro.org/ devkitPro]).
Swiss can boot Gamecube software from several devices, like from the [[SDGecko]], [[WODE]], [[Wiikey Fusion]] and more.

==Usage==
* [[Swiss/Usage|Usage Guide]]

==Compatibility==
*[[Swiss/Compatibility List|The Swiss Compatibility Wiki]]
*[[Swiss/Forced Progressive Compatibility List|Forced Progressive Compatibility Wiki]]

==Download==
* Binaries available [http://www.gc-forever.com/forums/viewtopic.php?f=25&t=1375 here] and [https://github.com/emukidid/swiss-gc/releases here]
* Source available here [https://github.com/emukidid/swiss-gc here]

==Features==
===General===
* GX GUI
* File Manager
* Video mode forcing
* Progressive video mode forcing to 480p and 576p (requires component cable)
* 16:9 wide aspect ratio forcing
* Configuration saving/loading
* Region free support
* Detailed console info
* Fragmented file support from all FAT based devices (except Wiikey Fusion)
* Automatically execute boot.dol from SD Gecko in Slot A / B if found

===Disc Based===
* DVD-/+R
* ISO9660 (for DOL loading)
* Multi-Game (Viper, GCOS DVD9)
* Multi-Disc

===[[SDGecko]]===
* ISO/GCM booting
* Multi-Disc
* DOL loading
* Disc dumping

===[[Ide-exi|IDE-EXI]]===
* ISO/GCM booting
* Multi-Disc
* DOL loading
* Disc dumping

===[[Wii Optical Drive Emulator|Wode]]===
* ISO/GCM booting
* It's also possible to make Swiss the [[Swiss on WODE | initial ISO]] for the [[WODE]].

===[[Wiikey Fusion]]===
* DOL loading
* ISO/GCM booting (via FAT32 formatted SD inserted into the Wiikey Fusion)
* It's also possible to make Swiss the [[Swiss/Usage#Installing_Swiss_to_the_Wiikey_Fusion_Flash | initial ISO]] for the [[Wiikey Fusion]]

===[[Qoob|Qoob Pro]]===
* Boot DOL files from the flash file system

===Cheats===
* WiiRD codes supported: [http://www.gc-forever.com/forums/viewtopic.php?f=38&t=3032 HowTo]

===Memory Cards===
* Boot DOL/DOL AS GCI
* General File Managment to/from this device and with other devices.

===[[Broadband Adapter]]===
* Serves a page on the DHCP obtained IP
* Disc dumping over HTTP
* IPL dumping over HTTP

===[[USBGecko]]===
* ISO/GCM booting
* DOL Loading
* WiiRD Debugging in games from all devices ("kenobi" from GeckoOS 1.9.3.1)

==Future Features==

===General===
* Cover Support

==Known Issues==
* Official bug tracker [http://code.google.com/p/swiss-gc/issues/list here]

==Tips and Tricks==
[[TipsTricksSwiss|Tips and Tricks about Swiss]]

[[Category:Homebrew_Software]]

Swiss

2018-05-02T19:24:10Z

Eatnumber1: /* Broadband Adapter */ Add untested information on how to load ISOs over a network.

{{Infobox/homebrew
| title = Swiss
| image = [[File:Swiss.png|right|thumb|235px]]
| type = Utility / IPL Replacement
| author = emu_kidid
| version = 0.4r431
| licence = [http://www.gnu.org/licenses/gpl-2.0.txt GNU GPL v2]
| website = http://code.google.com/p/swiss-gc/
| download = https://github.com/emukidid/swiss-gc/releases
| source = http://code.google.com/p/swiss-gc/source/list
}}

[http://code.google.com/p/swiss-gc/ '''Swiss'''] aims to be a all-in-one homebrew utility for the Nintendo GameCube. It uses libOGC and is compiled with devkitPPC (part of [http://www.devkitpro.org/ devkitPro]).
Swiss can boot Gamecube software from several devices, like from the [[SDGecko]], [[WODE]], [[Wiikey Fusion]] and more.

==Usage==
* [[Swiss/Usage|Usage Guide]]

==Compatibility==
*[[Swiss/Compatibility List|The Swiss Compatibility Wiki]]
*[[Swiss/Forced Progressive Compatibility List|Forced Progressive Compatibility Wiki]]

==Download==
* Binaries available [http://www.gc-forever.com/forums/viewtopic.php?f=25&t=1375 here] and [https://github.com/emukidid/swiss-gc/releases here]
* Source available here [https://github.com/emukidid/swiss-gc here]

==Features==
===General===
* GX GUI
* File Manager
* Video mode forcing
* Progressive video mode forcing to 480p and 576p (requires component cable)
* 16:9 wide aspect ratio forcing
* Configuration saving/loading
* Region free support
* Detailed console info
* Fragmented file support from all FAT based devices (except Wiikey Fusion)
* Automatically execute boot.dol from SD Gecko in Slot A / B if found

===Disc Based===
* DVD-/+R
* ISO9660 (for DOL loading)
* Multi-Game (Viper, GCOS DVD9)
* Multi-Disc

===[[SDGecko]]===
* ISO/GCM booting
* Multi-Disc
* DOL loading
* Disc dumping

===[[Ide-exi|IDE-EXI]]===
* ISO/GCM booting
* Multi-Disc
* DOL loading
* Disc dumping

===[[Wii Optical Drive Emulator|Wode]]===
* ISO/GCM booting
* It's also possible to make Swiss the [[Swiss on WODE | initial ISO]] for the [[WODE]].

===[[Wiikey Fusion]]===
* DOL loading
* ISO/GCM booting (via FAT32 formatted SD inserted into the Wiikey Fusion)
* It's also possible to make Swiss the [[Swiss/Usage#Installing_Swiss_to_the_Wiikey_Fusion_Flash | initial ISO]] for the [[Wiikey Fusion]]

===[[Qoob|Qoob Pro]]===
* Boot DOL files from the flash file system

===Cheats===
* WiiRD codes supported: [http://www.gc-forever.com/forums/viewtopic.php?f=38&t=3032 HowTo]

===Memory Cards===
* Boot DOL/DOL AS GCI
* General File Managment to/from this device and with other devices.

===[[Broadband Adapter]]===
* Serves a page on the DHCP obtained IP
* Disc dumping over HTTP
* IPL dumping over HTTP

====[[Loading ISOs over BBA]]====
'''Untested''' It should be possible to load ISOs over the BBA. You must serve the ISOs using [http://fsp.sourceforge.net/ FSP], and set the ethernet port to 10mbps full duplex. '''Untested'''

===[[USBGecko]]===
* ISO/GCM booting
* DOL Loading
* WiiRD Debugging in games from all devices ("kenobi" from GeckoOS 1.9.3.1)

==Future Features==

===General===
* Cover Support

==Known Issues==
* Official bug tracker [http://code.google.com/p/swiss-gc/issues/list here]

==Tips and Tricks==
[[TipsTricksSwiss|Tips and Tricks about Swiss]]

[[Category:Homebrew_Software]]