Difference between revisions of "Game Boy Interface/Standard Edition"

From GC-Forever Wiki
Jump to navigation Jump to search
(→‎Options: Add note about paths being relative to /GBI)
(Undo revision 4271 by Eatnumber1 (talk))
Line 327: Line 327:
 
; <code><path></code>
 
; <code><path></code>
 
: Load Game Boy Advance multiboot ROM (default: default.mb.gz).
 
: 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.
 
: Note: Remove any accessory from the External Extension Connector. Hold Start + Select while the Game Boy logo is visible.
  

Revision as of 09:59, 11 December 2018

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
This software must not be sold, neither alone nor as part of a bundle.
If you paid for this software or received it as part of a bundle following payment, you have been scammed and should demand your money back immediately.
Firmware update notice for GCVideo products.
It is strongly recommended to update to GCVideo-DVI v3.0 or later before using this software. GCVideo Lite products are not recommended under any circumstances.

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

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

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

--aspect=<w:h>
Specify screen aspect ratio. The default is the Progressive Scan Mode system setting (4:3 or 16:9).
--offset=<x:y>
Set offset. The default is the Screen Position system setting (-32 to +32).
--zoom=<x:y>
Set zoom. The default is the Game Boy Player Start-up Disc's Screen Size setting (2.0 or 2.375).
--rotate=<0-359>
Set rotation (default: 0).
--poll=<0-11>
Set controller polling rate.
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
--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
Load texture palette (default: frame.tpl.gz).
--overlay-id=<ID>
Set texture palette index. The default is the Game Boy Player Start-up Disc's Frame setting (0 to 19).
--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).
identity: Identity matrix
gba: Game Boy Advance (by Pokefan531)
gbc: Game Boy Color (by Pokefan531)
gbi: Game Boy Interface
nds: Nintendo DS (by Pokefan531)
palm: Palm Treo 700p (by Pokefan531)
psp: PlayStation Portable (by Pokefan531)
vba: VisualBoyAdvance-M (by Pokefan531)
--input-gamma=<red[:green[:blue]]>
Set gamma (default: 2.2).
--output-gamma=<1.0|1.7|2.2>
Specify screen gamma (default: 2.2).
--contrast=<red[:green[:blue]]>
Set gain (default: 1.0).
--brightness=<red[:green[:blue]]>
Set lift (default: 0.0).
--volume=<left[:right]>
Set audio gain (default: 0.75).
--sound=<[mono|stereo][,digital|analog]>
Set sound mode. The default is the Sound Mode system setting (mono or stereo).
digital
Use PWM decoder.
analog[=<a0:a1:a2:b1:b2>]
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.
--format=<ntsc|pal|pal-m|ntsc-50|pal-60|custom|custom-m|hd60|hd50|hd48|hdcustom>
Set video format. The default is the Video Mode and 60Hz Mode system setting (ntsc, pal or pal-60, pal-m).
--scan-mode=<[interlace|quasi-interlace|non-interlace|non-progressive|progressive][,clock2x|no-clock2x][,size2x|no-size2x]>
Set scan mode. The default is the Progressive Scan Mode system setting (interlace or progressive).
interlace: 15 or 18-22kHz 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
clock2x, no-clock2x
Enable 27MHz pixel clock (default: auto). Enabling doubles the refresh rate for interlace modes. Disabling halves the refresh rate for progressive modes.
This only works with the Component Video Cable.
size2x, no-size2x
Enable 2x video oversampling (default: auto). Enabling halves the refresh rate.
This only works with the Component Video Cable.
--osd, --no-osd
Show on-screen display (default: yes).
--ipv4-address=<aaa.bbb.ccc.ddd>
Set static IPv4 address.
--ipv4-gateway=<aaa.bbb.ccc.ddd>
Set static IPv4 gateway.
--ipv4-netmask=<aaa.bbb.ccc.ddd>
Set static IPv4 netmask.
--network, --no-network
Enable Broadband Adapter features (default: yes).
--stream[=<aaa.bbb.ccc.ddd>], --no-stream
Stream video to IP address on UDP port 1234 (default: no). Defaults to 255.255.255.255 if not specified.
--enhance, --no-enhance
Enable Game Boy Player enhancements (default: yes).
Title Feature(s)
Drill Dozer Rumble
Game Boy Advance Video Series Not compatible
Mario & Luigi: Superstar Saga Rumble, reduced contrast
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
Super Mario Advance 4: Super Mario Bros. 3 Rumble, 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.
<path>
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 ADV7180 and ADV7604.

  • Nintendo Stereo AV Cable (NTSC-J)

  • Nintendo Stereo AV Cable (PAL-M)

  • Generic S-Video Cable (NTSC-J)

  • Generic S-Video Cable (PAL-M)

  • HD Retrovision Component Video Cable

  • Nintendo Component Video Cable

  • GCVideo-DVI v2.4a and earlier

  • GCVideo-DVI v2.4b

Datapath VisionRGB

Using AD9887A.

  • HD Retrovision Component Video Cable

  • Nintendo Component Video Cable

  • GCVideo-DVI v2.4a and earlier

  • GCVideo-DVI v2.4b

Hauppauge WinTV-HVR-1850

Using CX23888.

  • Nintendo RF Modulator (NTSC-J)

  • Nintendo RF Modulator (PAL-M)

  • Nintendo Stereo AV Cable (NTSC-J)

  • Nintendo Stereo AV Cable (PAL-M)

  • Generic S-Video Cable (NTSC-J)

  • Generic S-Video Cable (PAL-M)

Sound emulation

Mega Man Zero 2

Pokémon Sapphire

Image doubling

Pokémon Sapphire

  • None

  • Scale2×Ex

  • Scale2×Plus

  • Scale2×

  • Eagle2×

  • Scan2×

  • Normal2×

Color matrix

Golden Sun

  • Identity matrix

  • Game Boy Advance

  • GBI AGSE GBC.png

    Game Boy Color

  • Game Boy Interface

  • Nintendo DS

  • Palm Treo 700p

  • PlayStation Portable

  • VisualBoyAdvance-M

Mario Kart: Super Circuit

  • Identity matrix

  • Game Boy Advance

  • GBI AMKE GBC.png

    Game Boy Color

  • Game Boy Interface

  • Nintendo DS

  • Palm Treo 700p

  • PlayStation Portable

  • VisualBoyAdvance-M

Pokémon Sapphire

  • Identity matrix

  • Game Boy Advance

  • GBI AXPE GBC.png

    Game Boy Color

  • Game Boy Interface

  • Nintendo DS

  • Palm Treo 700p

  • PlayStation Portable

  • VisualBoyAdvance-M

The Legend of Zelda: The Minish Cap

  • Identity matrix

  • Game Boy Advance

  • GBI BZME GBC.png

    Game Boy Color

  • Game Boy Interface

  • Nintendo DS

  • Palm Treo 700p

  • PlayStation Portable

  • VisualBoyAdvance-M

Wario Land 4

  • Identity matrix

  • Game Boy Advance

  • GBI AWAE GBC.png

    Game Boy Color

  • Game Boy Interface

  • Nintendo DS

  • Palm Treo 700p

  • PlayStation Portable

  • VisualBoyAdvance-M

Examples

Color emulation

Game Boy Advance

GBI Game Boy Advance.png

Using a contrast ratio of 250:1. 

--matrix=gba
--input-gamma=4.
--contrast=.74851331406341291833644689906823
--brightness=.25148668593658708166355310093177

Nintendo DS

GBI Nintendo DS.png

Using a contrast ratio of 600:1. 

--matrix=nds
--input-gamma=2.2
--contrast=.94539857500845076575010909270066
--brightness=.05460142499154923424989090729934

Palm Treo 700p

GBI Palm Treo 700p.png

Using a contrast ratio of 75:1. 

--matrix=palm
--input-gamma=2.2
--contrast=.85949252616415732890698972119636
--brightness=.14050747383584267109301027880364

PlayStation Portable

GBI PlayStation Portable.png

Using a contrast ratio of 750:1. 

--matrix=psp
--input-gamma=2.2
--contrast=.95066513192721403818280764386444
--brightness=.04933486807278596181719235613556

Color restoration

Mario & Luigi: Superstar Saga

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

--contrast=1.1

Super Mario Bros. 3: Super Mario Advance 4

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

--input-gamma=2.8

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.

Mimicking

Game Boy Player Start-up Disc

Included as gbi.cli.example. 

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

Wii U Virtual Console

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

Video optimization

Datapath VisionRGB

The author's personal setup. 

--aspect=4:3
--offset=0
--zoom=4
--dither=bayer2x2
--scaler=nearest
--format=hd60
--scan-mode=non-interlace,clock2x,size2x
  • 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

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

High-definition televisions

Change the Aspect Ratio on the television to Just Scan. 

--aspect=1.8
--zoom=3.375
--format=hd60
--scan-mode=non-progressive

Video capture devices (Game Boy Advance)

--aspect=3:2
--offset=0
--zoom=3
--dither=bayer2x2
--scaler=nearest
--format=ntsc

Video capture devices (Game Boy Color)

--aspect=5:4
--offset=0
--zoom=4
--dither=bayer2x2
--scaler=nearest
--format=pal

FAQs

How do I change Game Paks?

  1. Hold the Reset Button.
  2. Slide the Game Pak Ejector.
  3. Insert a Game Pak into the Game Pak Slot.
  4. Release the Reset Button.

Can I play Game Boy Advance Video?

Yes. You can do so by disabling Game Boy Player enhancements (--no-enhance), 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 autoexec.dol, 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 autoexec.dol.
  • 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.
Retrieved from "http://www.gc-forever.com/wiki/index.php?title=Game_Boy_Interface/Standard_Edition&oldid=4274"