home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / procssng / alv.sun / alv.lha / doc / philosophy.ms < prev    next >
Encoding:
Text File  |  1992-11-08  |  2.2 KB  |  66 lines
  1. .SH 1
  2. hilosophy
  3. .SH 2
  4. verview
  5. .PP
  6. he ALV toolkit has been designed with what is hoped is a consistent
  7. hilosophy based on that of
  8. .UX 
  9. o enable users who already know 
  10. .UX
  11. o gain expertise quickly and for more experienced users of the toolkit to
  12. id their comprehension of the interfaces to new tools. 
  13. .PP
  14. he toolkit is made up of many separate programs which can communicate with
  15. ach other via intermediary files or 
  16. .UX
  17. ipes using a common file format. Although each of the individual tools
  18. re quite simple, very powerful combinations of tools (perhaps stored
  19. n shell scripts) can be quickly constructed.
  20. .SH 2
  21. File Format
  22. .PP
  23. he image file format used is the standard Sun rasterfile format. This
  24. as the advantages that images may be easily transfered between
  25. ackages, that images can be edited using graphics editors, such as
  26. ouchup 1,
  27. .FS 1
  28.  fullscreen public domain graphics editor by Ray Kreisel
  29. <rayk@sbcs.sunysb.edu>
  30. .FE
  31. nd that images can be manipulated/created by the standard Sun programs
  32. .I screendump (1), 
  33. .I screenload (1) (now superseeded by 
  34. .I scrload (1)), 
  35. tc.
  36. .PP
  37. olour images have colourmaps associated with them in the normal way
  38. or Sun rasterfiles. If an image has no colourmap, the it is assumed to
  39. e a greyscale image.
  40. .SH 2
  41. ommand Line Argument Conventions
  42. .PP
  43. ll of the programs in the toolkit have a consistent convention for
  44. ommand line arguments, viz:
  45. .IP \(bu
  46. f the program requires an input file (called "infile") it can be read
  47. n the standard input stream.
  48. .IP \(bu
  49. f the program produces an output file (called "outfile") it can be
  50. ritten to the standard output stream.
  51. .IP \(bu
  52. f a filename argument is replaced by a "-" (minus sign) then that file
  53. s replaced by the standard input or standard output stream as appropriate.
  54. .IP \(bu
  55. n programs which do not have required arguments if there are two
  56. rguments in the argument list not preceeded by a "-" (minus sign) then
  57. he first is regarded as being the infile and the second as the
  58. utfile. If there is only one argument not preceeded by a "-" then it
  59. s the infile.
  60. .IP \(bu
  61. he arguments from the users profile ($HOME/.alv_profile or the file
  62. amed in the shell
  63. .I ALV 
  64. nnviroment variable) are placed in front of the arguments entered by the
  65. rogram invoker before any arguments are parsed.
  66.