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