Vicshow for X




README for X version of Piotr Tracz's Vicshow
X version by Linus Ã…kerlund (linus dot akerlund at gmail dot com).

This is the third release of the X version of Vicshow.  It was ported
from the svgalib version, which was in turn ported from Piotr's MSDOS
version (2.2).  If you feel an urge to look at the code, the stuff in
vicshow.c is of course severely ugly, as it's an quick'n'dirty port
of the svgalib code, which was in turn a quick'n'dirty port of the
MSDOS code.  Fixing it?  Nah...

You need to have GTK installed to compile and run this program.  If
you don't know what GTK is, have a look at  It's
a widget set that's used by a large number of projects, including
GNOME and Gimp, and if you don't already have it installed, you'll do
yourself a great favour by installing it.

I'm not sure exactly what version you need, but I've used 2.4.0.  Any
higher version should be alright, but if you run into problems with some 
version, please contact me.  I can't promise any help, but I'll do my
best, especially if you send me a _detailed_ bug report.

Using the program should be pretty straightforward.  Run the binary
with 0 or more arguments, each of which is a picture file.  The first
one will be displayed immediately, the others will be displayed when
you choose "Next Picture" from the Files menu.  You can also use "Open
Picture" to open a new picture, and of course you can still move back
and forth between all pictures opened so far.  Below the actual
picture the file name and the picture type are displayed.  You can
also save screenshots in ppm format.

Do you want more features?  Have you found a bug?  Do you want to send
me money?  Don't hesitate to contact me!  And if you feel like it,
hack the code and send me patches.


make install

Simple, huh?  If it's too simple for you, see the file INSTALL.


I haven't noticed any, but there might be some missing features...
And maybe a memory leak or two.

Coder format

In version 0.0.3 I added support for the "Coder format", which is 
basically a normal multicolour bitmap, but no "packed" like all the
other formats, like Advanced Art Studio or Koala Paint.  The code
doesn't check the load address, so you're free to use any load 
address you want.  Here's the memory layout:

Offset  Length  Contents
------  ------  --------
$0000   $1f40   Bitmap
$1f40   $0001   Background colour
$2000   $03e8   Screen memory
$2400   $03e8   Colour memory

So it's basically like any other stupid multicolour format, except
that you can load it into memory and set $d011, $d016, $d018, $d020
and $dd00 and see the picture, without having to move stuff around.