Game Boy Interface/Standard Edition

From GC-Forever Wiki
Jump to navigation Jump to search
Game Boy Interface
Information
Author(s) Extrems
Type Utility
Version Rolling release
Licence All rights reserved
Links
Download main package
Download extra package
Website
Discussion
Source


Controls

On-screen display

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)
Quit
+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

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

Options

--aspect=<w:h>
Set screen aspect ratio. (default: sram)
--offset=<x:y>
Set default offset. (default: sram)
--zoom=<x:y>
Set default zoom. (default: sram)
--rotate=<0-359>
Set default rotation. (default: 0)
--poll=<0-11>
Set polling rate. (default: 1)
--turbo=<on:off>
Set autofire interval. (default: 3)
--movie=<path>, --no-movie
Play input log. (default: no)
--movie-record, --no-movie-record
Record input log. (default: no)
--overlay=<path>, --no-overlay
Set texture palette. (default: frame.tpl.gz)
--overlay-id=<id>
Set texture palette index. (default: sram)
--overlay-scale=<x:y>
Set texture scale. (default: auto)
--filter=<none|scale2x[ex|plus]|eagle2x|scan2x|normal2x|normalnx>
Set image doubling filter. (default: normalnx)
--dither=<none|threshold|bayer8x8|bayer4x4|bayer2x2|cluster8x8|cluster4x4>
Set dithering algorithm. (default: threshold)
--scaler=<nearest|bilinear|oversample|box>
Set image scaling filter. (default: bilinear)
--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba>
Set color matrix. (default: gbi)
--input-gamma=<r:g:b>
Set gamma. (default: 2.2)
--output-gamma=<1.0|1.7|2.2>
Set screen gamma. (default: 2.2)
--contrast=<r:g:b>
Set gain. (default: 1.0)
--brightness=<r:g:b>
Set bias. (default: 0.0)
--volume=<l:r>
Set audio gain. (default: 0.75)
--sound=<mono|stereo>
Set sound mode. (default: sram)
--format=<ntsc|pal|pal-m|ntsc-50|pal-60|custom>
Set video format. (default: sram)
--scan-mode=<interlace|quasi-interlace|non-interlace|non-progressive|progressive>[,double-clock[,oversample]]
Set scan mode. (default: sram)
--osd, --no-osd
Toggle on-screen display. (default: yes)
--ipv4-address=<aaa.bbb.ccc.ddd>
Set static IPv4 address. (default: dhcp)
--ipv4-gateway=<aaa.bbb.ccc.ddd>
Set static IPv4 gateway. (default: dhcp)
--ipv4-netmask=<aaa.bbb.ccc.ddd>
Set static IPv4 netmask. (default: dhcp)
--network, --no-network
Toggle networking. (default: yes)
--stream[=<aaa.bbb.ccc.ddd>], --no-stream
Stream video to IP address on UDP port 1234. (default: no)
--enhance, --no-enhance
Toggle Game Boy Player enhancements. (default: yes)
<path>
Set Game Boy Advance multiboot. (default: default.mb.gz)

Examples

Color restoration

Mario & Luigi: Superstar Saga

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

--overlay=frame-srgb.tpl.gz
--matrix=identity
--input-gamma=1.
--output-gamma=1.
--contrast=1.1

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.

--input-gamma=4.

This can be combined with Gambatte/higan's color correction as a special case.

--overlay=frame-srgb.tpl.gz
--matrix=gbc
--input-gamma=1.8
--output-gamma=1.

Mimicking

Game Boy Player Start-up Disc

Included as gbi.cli.example.

--overlay=frame-srgb.tpl.gz
--dither=none
--matrix=identity
--input-gamma=1.
--output-gamma=1.
--contrast=.78125
--no-osd

Changelog

May 18, 2018

  • Changed default aspect ratio for progressive scan to 16:9.
  • Fixed rumble protocol handshake.

April 15, 2018

  • Updated GBA-as-GC controller.

April 5, 2018

  • Added movie recording.
  • Added movie playback.

March 30, 2018

  • Improved multiboot implementation.
  • Attempted fix for SD card compatibility.

March 25, 2018

  • Changed default color matrix to GBI's original.
  • Fixed multiboot to rumble protocol transition.

March 6, 2018

  • Improved Game Boy sound quality.
  • Improved audio rendering.
  • Reduced audio latency.

February 10, 2018

  • Added color matrix from Gambatte. (requires 1.0 gamma settings)
  • Added mono sound mode.
  • Fixed wiiload autoboot with tiny GBA multiboot ROMs.

February 4, 2018

  • Disabled machine checks.

January 28, 2018

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

September 10, 2017

  • Added overlay scale setting.

September 9, 2017

  • Fixed one random kernel crash.

September 5, 2017

  • Added GameCube Steering Wheel support.
  • Added Active Life Mat support.
  • Readded DK Bongos support.

September 2, 2017

  • Improved Game Boy Player driver.
  • Changed wiiload server to accept oversized DOLs.
  • Removed DK Bongos support due to raphnet adapter bug.

August 27, 2017

  • Added DK Bongos support.
  • Improved Game Boy Player driver.

August 13, 2017

  • Updated color matrices by Pokefan531.

July 30, 2017

  • Updated color matrices by Pokefan531.
  • Updated GBA-as-GC controller.

July 23, 2017

  • Updated GBA-as-GC controller.

July 3, 2017

  • Added CLI append support.

April 10, 2017

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

March 19, 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 11, 2017

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

November 26, 2016

  • Updated GBA-as-GC controller.
  • Optimized/Fixed Scale2xEx filter.

October 26, 2016

  • Added Scale2xEx and Scale2xPlus filters.
  • Added oversample and box scalers.
  • Optimized video rendering.
  • Fixed IP fragment identifier.

October 4, 2016

  • Added basic video streaming.
  • Added Remote RetroPad support.

September 7, 2016

  • Added polling rate setting.

May 17, 2016

  • Added rumble to GBA-as-GC controller, requires Drill Dozer or WarioWare: Twisted! cartridge.
  • Improved Game Boy Player driver.
  • Fixed WaveBird Controllers?

April 29, 2016

  • Added GBA multiboot support to wiiload server.
  • Replaced GBA-as-controller with GBA-as-GC controller.

April 4, 2016

  • Added Xboo Communicator.
  • Added BIOS/ROM dumper.

March 28, 2016

  • Fixed GameCube Controller hotplugging.
  • Fixed no GameCube Controller issue.

March 26, 2016

  • Added GBA-as-controller support. (thanks FIX94!)
  • Recognized a half-press of the analog triggers.
  • Disabled GameCube Controller hotplugging for now.

December 10, 2015

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

November 24, 2015

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

October 14, 2015

  • Added Scan2x and Normal2x GPU filters.

October 2, 2015

  • Added Scale2x and Eagle GPU filters.

August 16, 2015

  • Added return to autoexec.dol
  • Added memory card distribution files.
  • Added auto-cropping for Game Boy screenshots.
  • Optimized video rendering.
  • Compressed with LZMA2.
  • Reduced coil whine.

July 31, 2015

  • Added rumble.
  • Added hold to quit.

July 15, 2015

  • Added screenshot saving to SD.
  • Added SNTP broadcast listener.
  • Changed default video mode to interlaced.
  • Fixed Game Boy Player detection issue.

May 8, 2015

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

March 31, 2015

  • Added digital PWM sound, with some glitches.
  • Added turbo button.
  • Fixed 288p, probably?

March 13, 2015

  • Initial release.