home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / ppm2fli / Docs / unflick < prev   
Text File  |  1996-08-16  |  4KB  |  109 lines
  1. unflick - extract images from a FLI/FLC file
  2.  
  3. Synopsis
  4. --------
  5. unflick -a -m -b<begin> -n<max> -v -z -zz <animation> <base> <extension>
  6.  
  7.  The program unflick extracts single images or a series of images from a
  8. given FLI-animation. The extracted images are stored in separated files. The
  9. formats PPM (raw and ascii) and FBM (mapped 8bpp) are available. Additionally
  10. unflick can perform an automatic compression of the output files using the
  11. compress or the gzip utility. The file <animation> contains the input
  12. FLI-animation. The output file names are controlled by the parameters <base>
  13. and <extension>.
  14.  
  15.  If the parameter <extension> is omitted, the names of the generated files
  16. are composed of the given <base> followed by a dot and a number field:
  17.  
  18.  base .001,
  19.  base .002,
  20.  base .003,
  21. etc.
  22.  
  23. The number indicates the position at which the image appears in the
  24. FLI-animation. Note that when the input animation has more than 999 frames
  25. automatically more digits are used in the number field of the file names. 
  26.  
  27.  In the case of a given <extension>, the file names consist of the <base>,
  28. directly followed by the number field, plus a dot and the given extension:
  29.  
  30.  base 001. extension ,
  31.  base 002. extension ,
  32.  base 003. extension ,
  33. etc.
  34.  
  35. Before an image is written to disk, the program tests if a file with the
  36. designated name already exists. In this case the old file is not overwritten
  37. and the program terminates with an error.
  38.  
  39. Options
  40. -------
  41. -a
  42.   Write the images in PPM ascii format instead of PPM raw. Note that this
  43. needs much more disk space.
  44.  
  45. -b<begin>
  46.   Only the images with the number <begin> or higher are extracted. By default
  47. the extraction starts with the first image.
  48.  
  49. -m
  50.   Write the images in mapped FBM format. Then they can be converted to other
  51. formats with the utilities of the FBM package.
  52.  
  53. -n<max>
  54.   Extract not more than <max> images. By default all images from the given
  55. beginning up to the end are extracted. With this option it is possible to
  56. extract only a part of the images. 
  57.  
  58. -v
  59.   Write some information about the processed FLI-file to stdout.
  60.  
  61. -z
  62.   Postprocess the output files with the compress utility.
  63.  
  64. -zz
  65.   Postprocess the output files with the gzip utility.
  66.  
  67. Examples
  68. --------
  69. For example we want to extract all images from the FLI-animation
  70. `nicefilm.fli'. We choose the names
  71.  
  72.     picture.001, picture.002, picture.003, ...
  73.  
  74. for the output files. And we want that the images are written in PPM-ascii
  75. format. In this case we give the command:
  76.  
  77.     % unflick -a nicefilm.fli picture
  78.  
  79. In the next example we are interested only in the 10th image of the
  80. FLI-animation. We want the output image in compressed PPM-raw format. As
  81. output name we wish `picture010.ppm.Z'. To do this we type the command:
  82.  
  83.     % unflick -b 10 -n 1 -z nicefilm.fli picture ppm
  84.  
  85. This only works when no old file with the name `picture010.ppm' exists,
  86. because at first the image is written to this file and then compressed. At
  87. the end this temporary file is removed by the  compress command. Note that
  88. unflick does not test the existence of the compressed file
  89. `picture010.ppm.Z'. This is done by compress. If such a file already exists
  90. compress usually asks to overwrite it. When the answer is negative the
  91. compression is not performed and the temporary file `picture010.ppm' is not
  92. removed.
  93.  
  94. See also
  95. --------
  96. ppm2fli (1), fbm (1) and ppm (5)
  97.  
  98. Authors
  99. -------
  100. Klaus Ehrenfried (klaus@es.go.dlr.de).
  101. Copyright (C) 1996 by Klaus Ehrenfried.
  102. Release of January 1996.
  103.  
  104. Permission to use, copy, modify, and distribute this software is hereby
  105. granted, provided that the above copyright notice appears in all copies and
  106. that the software is available to all free of charge. The author disclaims
  107. all warranties with regard to this software, including all implied warranties
  108. of merchant-ability and fitness. The code is simply distributed as it is.
  109.