/release/picobsd/tinyware/view/README

https://bitbucket.org/freebsd/freebsd-head/ · #! · 86 lines · 59 code · 27 blank · 0 comment · 0 complexity · 9ba3e4a073e30e4c649fe8610373593d MD5 · raw file 

    

  1. Warsaw, 1998.08.18
    2. 

  2. 

  3. 			VIEW - small PNG viewer
    4. 

  4. 			-----------------------
    5. 

  5. 

  6. This program is intended to serve as a simple console viewer for PNG
    7. 

  7. graphics. It also features some scripting abilities, which allow you to
    8. 

  8. build simple presentation.
    9. 

  9. 

  10. In fact, using even this initial version I was able to build a nice
    11. 

  11. presentation of PicoBSD abilities which I used in real-life situation (you
    12. 

  12. can see for yourself one of the presentation's screens, fbsd.png).
    13. 

    14. 

  14. The audience was impressed :-), especially when I asked them politely what
    15. 

  15. are requirements and cost to make that kind of presentation using M$
    16. 

  16. products...
    17. 

  17. 

  18. Simple Viewing
    19. 

  19. --------------
    20. 

  20. 

  21. Usage is as follows:
    22. 

  22. 

  23. 	view [-g nnn.nnn] [-r x] filename.png
    24. 

  24. 

  25. where
    26. 

  26. 	-g nnn.nnn	screen gamma (you can adjust how bright is the
    27. 

  27. 			picture)
    28. 

  28. 	-r x		resolution:
    29. 

  29. 			0 - 640x480x16
    30. 

  30. 			1 - 640x200x256
    31. 

  31. 			2 - 320x240x256
    32. 

  32. 

  33. Under right mouse button you can find a simple menu, which tells you also
    34. 

  34. the hotkeys. You can shift, rotate and zoom the picture.
    35. 

  35. 

  36. Presentation
    37. 

  37. ------------
    38. 

  38. 

  39. Usage is as above, but the file you give as argument is a (unix) text file
    40. 

  40. of the following format:
    41. 

  41. 

  42. 	1	VIEW SCRIPT
    43. 

  43. 	2	5
    44. 

  44. 	3	welcome.png
    45. 

  45. 	4	/home/clipart/logo.png
    46. 

  46. 	5	/home/present/title.png
    47. 

  47. 	6	/home/present/outline.png
    48. 

  48. 	7	/home/present/end.png
    49. 

  49. 

  50. (of course without the line numbering or the leading space!). The line number
    51. 

  51. 1 is magic, and must be present in order to recognize the file properly.
    52. 

  52. 

  53. The second line tells how many pictures consist the presentation. The
    54. 

  54. following lines tell the file names containing the images themselves.
    55. 

  55. 

  56. See the example in file picobsd.vu.
    57. 

  57. 

  58. Command line arguments (gamma and resolution) are as above. You can also use
    59. 

  59. the pop-up menu to adjust image parameters, as well as go forward or
    60. 

  60. backward in the presentation.
    61. 

  61. 

  62. Bugs, caveats, missing features
    63. 

  63. -------------------------------
    64. 

  64. 

  65. * there are some bugs in libvgl which require strange workarounds, and even
    66. 

  66.   then it doesn't work quite right. See the source for the 'XXX' comments...
    67. 

    68. 

  68. * I didn't have time to add gamma adjustment to the pop-up menu. It's
    69. 

  69.   simple, though, and I leave it as an exercise for the reader :-))
    70. 

  70. 

  71. * it would be great if someone would add GIF and jpeg support.
    72. 

  72. 

  73. * the error checking is probably weak. A bad PNG file or script file will
    74. 

  74.   probably cause a coredump.
    75. 

  75. 

  76. * pop-up menu facilities need more abstraction to be usable in other cases.
    77. 

  77. 

  78. Anyway, as it is even now it's quite usable.
    79. 

    80. 

  80. Have fun!
    81. 

  81. 

  82. Andrzej Bialecki
    83. 

  83. 

  84. <abial@freebsd.org>
    85. 

  85. 

  86. $FreeBSD$
    87.