home *** CD-ROM | disk | FTP | other *** search
/ Der Mediaplex Sampler - Die 6 von Plex / 6_v_plex.zip / 6_v_plex / DISK2 / MULTI_04 / NOVA.ZIP / NOVA.TXT < prev    next >
Text File  |  1993-03-11  |  9KB  |  215 lines
  1.                                         NOVA v1.0 Instructions  3/9/93                Evaluation Copy                    
  2.                                               (c) RKSoft 1993
  3.  
  4.  
  5. RKSoft
  6. Randy Scarborough
  7. 519 Lively
  8. San Antonio, Texas    78213
  9. (210) 344-3460
  10.  
  11. Permission to evaluate, and distribute this demonstration software and its
  12. documentation for any purpose and without fee is hereby granted, provided
  13. that the above copyright notice appear in all copies and that both that
  14. copyright notice and this permission notice appear in supporting
  15. documentation.  This software is provided "as is" without express or
  16. implied warranty.
  17.  
  18.  
  19. Note to DEMO users:  The NOVA demo is a full featured demo with the exception
  20.                                          that the final output will have several vertical bands
  21.                      of empty space.
  22.  
  23.   NOVA is a TARGA to NOVAJET color bit map file converter.  NOVA can read all
  24. of the various flavors of TARGA.  Future formats to be supported include, TIFF
  25. GIF, BMP and PCX.  ADI drivers are also in the works. Shown below is
  26. a screen dump of the NOVA help feature.  This screen is shown by typing NOVA
  27. followed by ENTER.    This screen is also shown if a syntax error on the
  28. command line is found.
  29.  
  30. NOVA v1.0  3-04-93
  31.  (c)1993 RKSoft SA TX
  32.  Targa to Novajet color bitmap
  33.  
  34. Full Feature Demo
  35.     RKSoft
  36.   519 Lively
  37.   San Antonio, Texas 78213
  38.   (210) 344-3460
  39.  
  40. Usage: NOVA -[switches] INFILE[.tga] [OUTFILE[.nov]]
  41.     [switchs]
  42.  L    - large file, use disk
  43.  B    - cmy -> black off
  44.  D    - extra output
  45.  C    - color dither off
  46.  M    - create color map
  47.  X    - create color block map
  48.  R    - rotate (disabled with L switch)
  49.  A# - aspect
  50.  H# - height (image pixels)
  51.  W# - width (image pixels)
  52.  O# - offset (output pixels)
  53.  
  54.     For most options NOVA requires at least an input file name (INFILE).    If the 
  55. extension of the TARGA filename is not included on the command line, the file 
  56. must exist with an extension of ".TGA".    If the extension of the infile is
  57. included, NOVA will look for that file.    If the output file name (OUTFILE) is
  58. not included, NOVA will use the base name of the input file and add the
  59. extension ".NOV".  If the output file name is included, NOVA will use this
  60. name and append the ".NOV" extension if necessary.    If the output file has an 
  61. extension, NOVA will use the entire file name.
  62.  
  63. example:
  64.  
  65. C:> NOVA lighthou
  66.  
  67.                 NOVA will look for the file LIGHTHOU.TGA and output to file
  68.                 LIGHTHOU.NOV.
  69.  
  70. C:> NOVA lighthou.trg
  71.  
  72.                 NOVA will look for the file LIGHTHOU.TRG and output to file
  73.                 LIGHTHOU.NOV.
  74.  
  75. C:> NOVA lighthou test
  76.  
  77.                 NOVA will look for the file LIGHTHOU.TGA and output to file
  78.                 TEST.NOV.
  79.  
  80. C:> NOVA lighthou.tga test.rtl
  81.  
  82.                 NOVA will look for the file LIGHTHOU.TGA and output to file
  83.                 TEST.RTL.
  84.  
  85. C:> NOVA lighthou.trg test.rtl
  86.  
  87.                 NOVA will look for the file LIGHTHOU.TRG and output to file
  88.                 TEST.RTL.
  89.  
  90.     The SWITCH parameters tell NOVA to perform specific functions.    Each switch 
  91. must be preceded by a hyphen '-'.  The switches can appear in any order on the
  92. DOS command line
  93.  
  94. -L    Use this switch with VERY large input files.  A very large file is one
  95. that has a file size larger than 80% of your installed RAM.  If you have 16MB 
  96. of RAM installed then a very large file would have a file size >= 12.8MB.  If
  97. you are not sure, run NOVA without this switch.  If the program fails or
  98. gives an out of memory error, use this switch.  This switch will cause NOVA
  99. to execute much slower.  However NOVA will be able to deal with extremely
  100. large input files.  By default the -L switch is off.
  101.  
  102.     **IMPORTANT:
  103.       If this switch is used, there must be sufficient free disk space available.
  104.       The amount of free disk space required can be calculated by multiplying
  105.       the input file by 2.  If the input file is 24MB, NOVA will need approx.
  106.       48MB of disk space.
  107.  
  108.         Using this switch will automatically disable the -R rotate switch. 
  109.     Rotations are not allowed on a very large input file.
  110.  
  111.         Initially, try NOVA without this switch. If the file is too large, NOVA
  112.     will fail almost immediately.  If this occurs, use the switch.
  113.         
  114.     
  115. -B    If a pixel requires a mix of Cyan, Magenta and Yellow to create Black,
  116. NOVA will tell the plotter to use the Black ink pen for this pixel.  This
  117. reduces the amount of ink.    The default is to perform this conversion.
  118.  
  119. -D    Displays extra information about the TARGA as NOVA is working.    The
  120. default is no extra information is displayed.
  121.  
  122. -C    Turn off color dithering and use the sample colors built into NOVA.
  123. Dithering is required because the NOVAJET cannot mix variable amounts of 
  124. ink at a given pixel on the plot.    Dithering also helps smooth the image
  125. somewhat.  This dithering actually causes the output image to double in size.
  126. Each pixel in the TARGA image is mapped to a 2x2 grid of output pixels.  
  127. Each of these 4 pixels can contain various combinations of inks. This allows
  128. many more (apparent) colors to be generated.    Color dithering is on by
  129. default.
  130.  
  131. -M    This option generates a sample gradient color map.    This switch should
  132. not be combined with any other switch.  A plot of the gradient map will give
  133. you an idea of the color combinations available on the NOVAJET. The resultant
  134. plot file is 1024x1024.
  135.  
  136. -X    This option generates a sample color block map.  This switch should not be
  137. combined with any other switch.  The resultant plot file is a 18x19 grid of
  138. the colors built into NOVA.
  139.  
  140. -R    Rotate the image 90* clock-wise. The horizontal dimension of the screen
  141. image translates to the direction the paper travels on the plotter.  The 
  142. vertical dimension translates to the direction the pens travel on the plotter.
  143. The default is no rotation.    The horizontal dimension of the screen image
  144. translates to the direction the pens travel on the plotter.  The vertical
  145. dimension translates to the direction the paper travels on the plotter.
  146.  
  147.     **IMPORTANT:
  148.     Rotations are not allowed when the -L switch is used for very large files.
  149.   If the -L switch is used the -R switch will automatically be disabled.
  150.   
  151. -A# This option adjusts the aspect ratio of each pixel in the
  152. resultant image.    The image can be stretched int the x or y dimension.
  153. The default aspect ratio is (width/height)*100.  For an image with dimensions
  154. 640x480 the aspect ratio is 133.  In this case, an aspect ratio greater than
  155. 133 will stretch the width.  While a value less than 133 will stretch the
  156. height.  -A150 would stretch the image in the x making the dimensions 721x480
  157. While -A110 would stretch the image in the y making the dimensions 640x580.    
  158.  
  159.     example
  160.  
  161.     721x480 : 721/480*100 = 150 (rounding is always down)
  162.     640x580 : 640/580*100 = 110     "        "      "
  163.  
  164. The default aspect ratio is (width/height)*100.
  165.  
  166. -H# This option adjusts the height of the image.    The value must be greater
  167. than the existing height of the TARGA image.  Scaling down the image is not 
  168. allowed.  The value used is relative to the TARGA image.    If the -W# or -A#
  169. switches are not used, the aspect ratio remains (width/height) and the width will
  170. be adjust to match the aspect ratio.  This option allows you to scale the
  171. output plot to an absolute dimension.  If the TARGA image is 640x480 and
  172. -H1000 is used, the resultant image on the plot will be 1333x1000.    Dithering
  173. will cause the image to be scaled by a factor of 2.  The resultant image will
  174. be 2666x2000.
  175.  
  176. -W# This option adjusts the width of the image.  The value must be greater 
  177. than the existing width of the TARGA image.    Scaling down the image is not
  178. allowed.    The value used is relative to the TARGA image.    If the -H# or -A#
  179. switches are not used, the aspect ratio remains (width/height) and the height
  180. will be adjust to match the aspect ratio.  This option allows you to scale
  181. the output plot to an absolute dimension.  If the TARGA image is 640x480 and
  182. -W1000 is used, the resultant image on the plot will be 1000x750.  Dithering
  183. will cause the image to be scaled by a factor of 2.  The resultant image will
  184. be 2000x1500.
  185.  
  186. -O# This option allows the image to be shifted away from the edge of the paper
  187. in the direction the pens move on the plotter.  The value is in plotter 
  188. pixels.    If -O300 is used and the plotter is set to 300dpi then the image will
  189. be shifted 1 inch away from the plotters minimum x plot position.
  190.  
  191. EXAMPLES:
  192.  
  193. C:> NOVA -d -b -r lighthou
  194.  
  195.                 NOVA will look for the file LIGHTHOU.TGA and output to file
  196.                 LIGHTHOU.NOV.  Additional imformation about the TARGA
  197.                 will be displayed.    The CMY to Black option will be disabled.
  198.                 The image will be rotated 90* clock-wise.
  199.  
  200. C:> NOVA -m lighthou
  201.  
  202.                 NOVA will  output a gradient color map to file LIGHTHOU.NOV.
  203.                 Additional information about the TARGA will be displayed.
  204.                 The CMY to Black option will be disabled.  The image will be
  205.                 rotated 90* clock-wise.
  206.  
  207. C:> NOVA -d -l lighthou
  208.  
  209.                 NOVA will look for the file LIGHTHOU.TGA and output to file
  210.                 LIGHTHOU.NOV.  Additional imformation about the TARGA
  211.                 will be displayed.    NOVA will use disk space instead of memory
  212.         when processing the image.
  213.  
  214.  
  215.