Game Boy Interface/Speedrunning Edition

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

Type A (two-handed)

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 ↓		Toggle input viewer

Type B (one-handed)

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)

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

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 ↓		Toggle input viewer

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

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

--offset=<x:y>

Set offset. (default: 0:0)

--zoom=<x:y>

Set zoom. (default: 2.0)

--rotate=<0-359>

Set rotation. (default: 0)

--poll=<0-11>

Set polling rate. (default: 1)

--control=<0-3>

Set controller scheme. (default: sram)

--delay-reset=<n>

Set reset delaying. (default: 75)

--delay-video=<n>

Set video buffering. (default: 1)

--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-srgb.tpl.gz)

--overlay-id=<id>

Set texture palette index. (default: sram)

--overlay-scale=<x:y>

Set texture scale. (default: auto)

--palette=<xxxx-xxxx-xxxx>, --no-palette

Set Super Game Boy color palette. (default: no)

--lut3d=<path>, --no-lut3d

Set 32x32x32 lookup table. (default: auto)

--lut3d-order=<rgb|gbr|bgr>

Set lookup table order. (default: rgb)

--scaler=<nearest|bilinear|oversample|box>

Set image scaling filter. (default: nearest)

--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba>

Set color matrix. (default: identity)

--input-gamma=<r:g:b>

Set gamma. (default: 2.2)

--output-gamma=<1.0|1.7|2.2>

Set screen gamma. (default: 2.2)

--gamma=<even:odd>

Set gamma correction. (default: 1.0)

--contrast=<r:g:b>

Set gain. (default: 1.0)

--brightness=<r:g:b>

Set bias. (default: 0.0)

--blend=<a>

Set alpha blending. (default: 1.0)

--background=<#rrggbb>

Set background color. (default: #000000)

--vfilter=<m:l:u>, --vfilter-even=<m:l:u>, --vfilter-odd=<m:l:u>

Set vertical filter coefficients. (default: 1.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>[,offset=<x:y>][,scaled-size=<w:h>][,size=<w:h>]

Set video format. (default: sram)

--scan-mode=<interlace|quasi-interlace|non-interlace|progressive>[,double-clock[,oversample]]

Set scan mode. (default: sram)

--osd-input[=<x:y>], --no-osd-input

Toggle input viewer. (default: no)

--usb, --no-usb

Toggle USB Gecko. (default: yes)

--enhance, --no-enhance

Toggle Game Boy Player enhancements. (default: no)

<path>

Set Game Boy Advance multiboot. (default: none)

Examples

Color restoration

Mario & Luigi: Superstar Saga

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

--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.

--matrix=gbc
--input-gamma=1.8
--output-gamma=1.

Mimicking

Game Boy Player Start-up Disc (60Hz)

Included as gbisr.cli.example.

--delay-video=2
--input-gamma=1.
--output-gamma=1.
--contrast=.78125
--vfilter=.5:.25:.25
--format=ntsc,scaled-size=666:448,size=608:448
--scan-mode=interlace
--enhance

Game Boy Player Start-up Disc (50Hz)

--delay-reset=65
--delay-video=2
--input-gamma=1.
--output-gamma=1.
--contrast=.78125
--vfilter=.5:.25:.25
--format=pal,scaled-size=670:530,size=608:448
--scan-mode=interlace
--enhance

Video optimization

Open Source Scan Converter

Included as gbisr-ossc.cli, gbisr-ossc.dol+cli and gbisr-ossc.gci.

--vfilter-even=.5:.5
--vfilter-odd=.5:.0:.5
--format=custom,offset=0,scaled-size=0
--scan-mode=non-interlace

XRGB-mini Framemeister

Included as gbisr-xrgb.cli, gbisr-xrgb.dol+cli and gbisr-xrgb.gci.

--vfilter-even=.5:.5
--vfilter-odd=.5:.0:.5
--format=ntsc,offset=0,scaled-size=0
--scan-mode=non-interlace

Video output

120Hz black frame insertion

--vfilter-even=.5:.5
--vfilter-odd=0.
--scan-mode=non-interlace,double-clock

480p hybrid scanlines

--overlay=frame.tpl.gz
--gamma=2.2:1.
--scan-mode=progressive

480p simple scanlines

--vfilter-even=.5:.5
--vfilter-odd=0.
--scan-mode=progressive

Video scaling

4:3 fullscreen (Game Boy Advance)

--zoom=2.375
--scaler=oversample
--vfilter=.5:.25:.25
--format=ntsc
--scan-mode=interlace

4:3 fullscreen (Game Boy Color)

--zoom=3
--vfilter=.5:.25:.25
--format=ntsc
--scan-mode=interlace

16:9 fullscreen

--zoom=2:3
--format=custom,size=568
--scan-mode=progressive

Changelog

May 18, 2018

• Fixed rumble protocol handshake.

May 8, 2015

• Initial release.