Video Viewer (VRAM viewer)

The Video Viewer is used to view VRAM in a number of different formats, including a Tile Map tool suitable for modes 0-2, a Framebuffer tool for 3-5, and a Layers tool for any mode.


Tile Map Viewer

The tile map viewer is used to view VRAM as either a text or rot/scale tile map.


The tile map viewer
Image from fr018 by Farbrausch, which placed #1 in the Woest '02 compo.


Tile Viewers

These viewers can be used to view VRAM as a mosaic of tiles. The Tile viewer has a Tileset location dropdown to specify which 16 KB to display, and the Sprite viewer displays the entire upper 32 KB of VRAM.


The background tile viewer


The sprite tile viewer

Both images are from Simonchu by Jagos, Jua, FlanGordo, and doh, which placed #5 in the 2002 gbadev.org compo.

Common to both tools is a Color Mode selector. In 16 color mode, the Palette Base scrollbar is available to choose the high 4 bits of the palette index for each pixel.


The Framebuffer Viewer

This can be used to view VRAM as a framebuffer, and is useful in modes 3-5. In mode 3, there is only one framebuffer, but in 4 and 5, there are two.


The framebuffer viewer
Image from mode4.bin by Dead-Body.

Warning: The framebuffer viewer will render as if A=D=1, and B=C=0. Thus, rot/scale and tweaked layers will not display correctly.


The Layers Viewer

The layers page is used to view what a rendered screen would look like if the enable bits in the DISP_CR register were different. A layer is any of the four backgrounds or sprites, for more information see the Video portion of the SDK.


The layer viewer
Image from Torben's Marvellous Adventure by Jimmy M, Thanius, Erik G, and Dan H, which placed #19 in the 2002 gbadev.org compo.

This tool can be used to:

The Load button makes the enabled layers match the bits in DISP_CR, and the Save button reverses the process, altering the DISP_CR register permenantly.

Warning: The layer viewer is not a perfect match for the main rendering process. Any Raster effects will not display correctly, and rot/scale backgrounds will not rotate; they will display as if A=D=1, and B=C=0.


Common Tools


Common to all viewers


Copyright © 2001 to 2003, Bottled Light, Inc.