README revision 38589
1139749SimpWarsaw, 1998.08.18
2158124Smarcel
3158124Smarcel			VIEW - small PNG viewer
490731Sjhay			-----------------------
590731Sjhay
690731SjhayThis program is intended to serve as a simple console viewer for PNG
790731Sjhaygraphics. It also features some scripting abilities, which allow you to
8158124Smarcelbuild simple presentation.
990731Sjhay
1090731SjhayIn fact, using even this initial version I was able to build a nice
1190731Sjhaypresentation of PicoBSD abilities which I used in real-life situation (you
1290731Sjhaycan see for yourself one of the presentation's screens, fbsd.png).
1390731Sjhay
1490731SjhayThe audience was impressed :-), especially when I asked them politely what
1590731Sjhayare requirements and cost to make that kind of presentation using M$
1690731Sjhayproducts...
1790731Sjhay
1890731SjhaySimple Viewing
1990731Sjhay--------------
2090731Sjhay
2190731SjhayUsage is as follows:
2290731Sjhay
2390731Sjhay	view [-g nnn.nnn] [-r x] filename.png
2490731Sjhay
2590731Sjhaywhere
2690731Sjhay	-g nnn.nnn	screen gamma (you can adjust how bright is the
2790731Sjhay			picture)
2890731Sjhay	-r x		resolution:
2990731Sjhay			0 - 640x480x16
3090731Sjhay			1 - 640x200x256
3190731Sjhay			2 - 320x240x256
3290731Sjhay
3390731SjhayUnder right mouse button you can find a simple menu, which tells you also
3490731Sjhaythe hotkeys. You can shift, rotate and zoom the picture.
3590731Sjhay
36158124SmarcelPresentation
37158124Smarcel------------
38158124Smarcel
3990731SjhayUsage is as above, but the file you give as argument is a (unix) text file
40158124Smarcelof the following format:
41159545Simp
42158124Smarcel	1	VIEW SCRIPT
43158124Smarcel	2	5
4490731Sjhay	3	welcome.png
4590731Sjhay	4	/home/clipart/logo.png
46158124Smarcel	5	/home/present/title.png
47158124Smarcel	6	/home/present/outline.png
48160030Sobrien	7	/home/present/end.png
4990731Sjhay
50158124Smarcel(of course without the line numbering or the leading space!). The line number
51158124Smarcel1 is magic, and must be present in order to recognize the file properly.
52222660Sjhb
53248340SrstoneThe second line tells how many pictures consist the presentation. The
54158124Smarcelfollowing lines tell the file names containing the images themselves.
55227457Seadler
56251715SmariusSee the example in file picobsd.vu.
57222760Sjhb
58158124SmarcelCommand line arguments (gamma and resolution) are as above. You can also use
59158124Smarcelthe pop-up menu to adjust image parameters, as well as go forward or
60158124Smarcelbackward in the presentation.
61158124Smarcel
62158124SmarcelBugs, caveats, missing features
63119814Smarcel-------------------------------
64158124Smarcel
6598376Sobrien* there are some bugs in libvgl which require strange workarounds, and even
66158124Smarcel  then it doesn't work quite right. See the source for the 'XXX' comments...
67158124Smarcel
68158124Smarcel* I didn't have time to add gamma adjustment to the pop-up menu. It's
69158124Smarcel  simple, though, and I leave it as an exercise for the reader :-))
70128380Sbde
71128380Sbde* it would be great if someone would add GIF and jpeg support.
72158124Smarcel
73158124Smarcel* the error checking is probably weak. A bad PNG file or script file will
74158124Smarcel  probably cause a coredump.
75158124Smarcel
76158124Smarcel* pop-up menu facilities need more abstraction to be usable in other cases.
77119814Smarcel
78119814SmarcelAnyway, as it is even now it's quite usable.
79158124Smarcel
80158124SmarcelHave fun!
81158124Smarcel
82158124SmarcelAndrzej Bialecki
83158124Smarcel
8498376Sobrien<abial@nask.pl>
8598376Sobrien
86158124Smarcel$Id: README,v 1.2 1998/08/19 06:19:44 abial Exp $
87158124Smarcel