Mednafen

Game Boy (Color) Documentation

Last updated December 31, 2010
Valid as of 0.9.16-WIP

Table of Contents:


Mednafen's GameBoy (Color) emulation is based off of VisualBoy Advance.

Default Key Assignments

Key(s):Action:Configuration String:
ALT + SHIFT + 1Activate in-game input configuration process for GameBoy pad.input_config1

Key:Action/Button:
Keypad 2B
Keypad 3A
Enter/ReturnStart
TabSelect
WUp
SDown
ALeft
DRight


Settings Reference

Caution: Any settings that change emulation behavior as seen from the emulated game are shown with the setting name bolded in the table. One should be conscious of these settings if one has changed them from the default values when using network play or movies, as they can cause desychronizations if not set the same among hosts(or between the recording emulator and the playing emulator).

Setting:Value Type:Possible Values:Default Value:Description:

Setting:Value Type:Possible Values:Default Value:Description:
gb.enableboolean0
1
1Enable (automatic) usage of this module.

 
gb.forcemonoboolean0
1
0Force monophonic sound output.

 
gb.pixshaderenumnone
ipxnoty
ipynotx
ipsharper
ipxnotysharper
ipynotxsharper
scale2x
noneEnable specified OpenGL pixel shader.

Obviously, this will only work with the OpenGL "video.driver" setting, and only on cards and OpenGL implementations that support pixel shaders, otherwise you will get a black screen, or Mednafen may display an error message when starting up. Bilinear interpolation is disabled with pixel shaders, and any interpolation, if present, will be noted in the description of each pixel shader.

  • none - None/Disabled

  • ipxnoty - Linear interpolation on X axis only.

  • ipynotx - Linear interpolation on Y axis only.

  • ipsharper - Sharper bilinear interpolation.

  • ipxnotysharper - Sharper version of "ipxnoty".

  • ipynotxsharper - Sharper version of "ipynotx".

  • scale2x - Scale2x
 
gb.scanlinesinteger0 through 1000Enable scanlines with specified opacity.

Opacity is specified in %; IE a value of "100" will give entirely black scanlines.

 
gb.specialenumnone
hq2x
hq3x
hq4x
scale2x
scale3x
scale4x
2xsai
super2xsai
supereagle
nn2x
nn3x
nn4x
nny2x
nny3x
nny4x
noneEnable specified special video scaler.

The destination rectangle is NOT altered by this setting, so if you have xscale and yscale set to "2", and try to use a 3x scaling filter like hq3x, the image is not going to look that great. The nearest-neighbor scalers are intended for use with bilinear interpolation enabled, at high resolutions(such as 1280x1024; nn2x(or nny2x) + bilinear interpolation + fullscreen stretching at this resolution looks quite nice).

  • none - None/Disabled

  • hq2x - hq2x

  • hq3x - hq3x

  • hq4x - hq4x

  • scale2x - scale2x

  • scale3x - scale3x

  • scale4x - scale4x

  • 2xsai - 2xSaI

  • super2xsai - Super 2xSaI

  • supereagle - Super Eagle

  • nn2x - Nearest-neighbor 2x

  • nn3x - Nearest-neighbor 3x

  • nn4x - Nearest-neighbor 4x

  • nny2x - Nearest-neighbor 2x, y axis only

  • nny3x - Nearest-neighbor 3x, y axis only

  • nny4x - Nearest-neighbor 4x, y axis only
 
gb.stretchenum0
full
aspect
0Stretch to fill screen.

  • 0 - Disabled

  • full - Full
    Full-screen stretch, disregarding aspect ratio.

  • aspect - Aspect Preserve
    Full-screen stretch as far as the aspect ratio(in this sense, the equivalent xscalefs == yscalefs) can be maintained.
 
gb.tblurboolean0
1
0Enable video temporal blur(50/50 previous/current frame by default).

 
gb.tblur.accumboolean0
1
0Accumulate color data rather than discarding it.

 
gb.tblur.accum.amountreal0 through 10050Blur amount in accumulation mode, specified in percentage of accumulation buffer to mix with the current frame.

 
gb.videoipboolean0
1
0Enable bilinear interpolation.

 
gb.xresinteger64 through 65536800Full-screen horizontal resolution.

 
gb.xscalereal0.01 through 2564.000000Scaling factor for the X axis.

 
gb.xscalefsreal0.01 through 2564.000000Scaling factor for the X axis in fullscreen mode.

 
gb.yresinteger64 through 65536600Full-screen vertical resolution.

 
gb.yscalereal0.01 through 2564.000000Scaling factor for the Y axis.

 
gb.yscalefsreal0.01 through 2564.000000Scaling factor for the Y axis in fullscreen mode.