home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / fax067.zip / t2t.doc < prev    next >
Text File  |  1996-08-28  |  8KB  |  226 lines
  1.  
  2.         T2T.DOC
  3.  
  4.     Documentation for T2T.EXE
  5.  
  6.  
  7. 1) Commandline switches:
  8.  
  9. -NORENAME
  10.     Automatically rename of temporary file (*.TI~) is OFF, target file still
  11.     remains *.TI~.
  12.  
  13. -DELETE
  14.     Sourcefile(s) is deleted by program, target, if named *.TI~ is also
  15.     renamed to (first) source file name.
  16.  
  17. -GRAY[<no_of_bitspersample>]
  18.     Target file will be GrayScale TIFF, if <no_of_bitspersample> is supplied
  19.     (4 or 8) then 4 bit (16) or 8 bit (256) is used. Default (if no
  20.     <no_of_bitspersample> is defined) a value of 8 bit (256) is assumed.
  21.     Any value less than 4 is assumed as 4, and less then 8 is assumed as 8.
  22.  
  23. -COMPRESSION<TIFF_compression>
  24.     Target file will have compression as here defined. Valid values are:
  25.     1 (uncompressed and default),
  26.     2 (Huffman without EOL),
  27.     3 (Huffman with EOL),
  28.     4 (Read whitout EOL),
  29.     5 (LZW) and
  30.     32773 (PackBit).
  31.  
  32. -COLOR[<no_of_bitspersample>]
  33.     Target file will be Color TIFF, if <no_of_bitspersample> is supplied
  34.     (4 or 8) than 4 bit (16) or 8 bit (256) palettecolor will be used.
  35.     Default (if no <no_of_bitspersample> is defined) TrueColor (24 Bits)
  36.     will be assumed. Only values of 4 or 8 is valid, else TrueColor is used.
  37.  
  38. -2D
  39.     Is used as a shurtcut to 2-D Read without EOL compression (4).
  40.  
  41. -1D
  42.     Is used as a shortcut to 1-D Huffman without EOL compression (2).
  43.  
  44. -2F
  45.     Is used as a shortcut to 2-D Read with EOL compression (4) as defined in
  46.     CCITT T.4 for fax. Imagewidth is set to standard 1728 pixels. Images
  47.     which are smaller will be centered, else cut to fit. Resolution is set
  48.     to 204x196 dots per inch.
  49.  
  50. -1F
  51.     Is used as a shortcut to 1-D Huffman with EOL compression (3) as defined
  52.     in CCITT T.4 for fax. Imagewidth is set to standard 1728 pixels. Images
  53.     which are smaller will be centered, else cut to fit. Resolution is set
  54.     to 204x196 dots per inch.
  55.  
  56. -NORMAL
  57.     TIFF resolution is set to XRes = 204 dpi, YRes = 96 dpi.
  58.  
  59. -RESOLUTION<dpi[Xdpi]>
  60.     XRes and YRes is set to <dpi> dots per inch.
  61.  
  62. -I<Infile_name>
  63.     MUST be defined (or in CFG, see 'INFILE') to supply proper name for file(s)
  64.     to use. All wildcards ('*' and '?') can be used, format MUST be TIF (or
  65.     TIF in an EPS-File) or fax rawdata (see there).
  66.  
  67. -O<Path_to_outfile>
  68.     If defined, this is used as a drive and directory specifier for target
  69.     file(s). See also FAXPATH in CFG. If not defined, drive and directory of
  70.     INFILE is used. If converting MORE than one INFILE to ONE OUTFILE
  71.     (multipaged), than drive, directory and name of the FIRST INFILE is used.
  72.  
  73. -O@<CFG-file>
  74.     If this methode is used, more parameters could be supplied (see CFG), they
  75.     are treated as if supplied in commandline. All parameters supplied before
  76.     THIS, will be overwritten if also defined in CFG, all parameters supplied
  77.     AFTER this, will overwrite CFG-parameters! Some parameters ('FAXLOG' and
  78.     'FAXIDX' can ONLY supplied in this way).
  79.  
  80. -K<rawdata_compression>
  81.     This parameter should be supplied, if raw fax data is converted by T2T.
  82.     No check is done, so only values 3 or 4 are sensefull!
  83.  
  84. -FILLORDER<rawdata_fillorder>
  85.     This parameter should be supplied, if raw fax data is converted by T2T.
  86.     No check is done, so only values of 2 (some faxmodems) and 1 (default)
  87.     are senseful!
  88.  
  89. -DIFFUSED
  90.     If T2T must convert from a colorscheme to another (eg color to B&W) this
  91.     parameter selects Floyd-Steinberg error diffusion method for target TIFF.
  92.     Not recommanded, if source is palettecolor, because a limited and not
  93.     fixed pallete will also be used for target.
  94.  
  95. -DITHERED
  96.     If T2T must convert from a colorscheme to another (eg color to B&W) this
  97.     parameter selects a fixed dither (4x4 or 8x8) method for target TIFF.
  98.     This may be used with CAUTION! The results are good, but source in
  99.     palettecolor will look ugly in target.
  100.  
  101. -BLACK
  102.     If T2T must convert from a colorscheme to another (eg color to B&W) this
  103.     parameter selects straightforward method for target TIFF. Can be used also
  104.     with colored source, but only a few (matching) number of colors is used
  105.     in target.
  106.  
  107. -SINGLE
  108.     Each target TIFF is singlepaged and named PAGEnnnn.TIF.
  109.  
  110.     CAUTION! Each time T2T is called, counter (nnnn) is reset to 1 and no check
  111.     is performed to prevent overwriting of existant files!
  112.  
  113. -S
  114.     Shortcut of SAME meaning of '-BLACK', DO NOT use it, because it will
  115.     be changed in next version (to blacktrigger and/or gamma).
  116.  
  117. -H or -?
  118.     Shows (a part of) this.
  119.  
  120.  
  121. 2) Parameters for configuration file
  122.  
  123.     Configuration file must be supplied at commandline with '-O@<filename>'.
  124.  
  125. SINGLE
  126.     Same as '-SINGLE' in commandline.
  127.  
  128. NORENAME
  129.     Same as '-NORENAME' in commandline.
  130.  
  131. DELETE
  132.     Same as '-DELETE' in commandline.
  133.  
  134. DIFFUSED
  135.     Same as '-DIFFUSED' in commandline.
  136.  
  137. DITHERED
  138.     Same as '-DITHERED' in commandline.
  139.  
  140. BLACK
  141.     Same as '-BLACK' in commandline.
  142.  
  143. 2D
  144.     Same as '-2D' in commandline.
  145.  
  146. 1D
  147.     Same as '-1D' in commandline.
  148.  
  149. 2F
  150.     Same as '-2F' in commandline.
  151.  
  152. 1F
  153.     Same as '-1F' in commandline.
  154.  
  155. GRAY [<no_of_bitspersample>]
  156.     Same as '-GRAY' in commandline.
  157.  
  158. COLOR [<no_of_bitspersample>]
  159.     Same as '-COLOR' in commandline.
  160.  
  161. INFILE <Infilename>
  162.     Same as '-I' in commandline.
  163.  
  164. TIFEXT
  165.     Used as extention for target TIFF. If both FAXLOG and FAXIDX are also
  166.     supplied (third party application) an extention of *.FAX is used by
  167.     default.
  168.  
  169. FILLORDER <rawdata_fillorder>
  170.     Same as '-FILLORDER' in commandline.
  171.  
  172. COMPRESSION <TIF_compression>
  173.     Same as '-COMPRESSION' in commandline.
  174.  
  175. PHOTOMETRIC <TIF_photometricinterpretation>
  176.     Valid valus here are:
  177.     0 ... for black&white, 0 (zero) is white and 1 (one) is black.
  178.           for GrayScale, 0 (zero) is white bitspersample^2 - 1 is black.
  179.     1 ... for black&white, 0 (zero) is black and 1 (one) is white.
  180.           for GrayScale, 0 (zero) is black bitspersample^2 - 1 is white.
  181.     2 ... Only for TrueColor (24 bit), no ColorMap is used.
  182.     3 ... Only for palettecolor (16 or 256 colors), a ColorMap is build.
  183.  
  184.     if nothing is defined, a value of 1 (one) is used for black&white and
  185.     GrayScale target. For colored target, the value is choosen from -COLOR.
  186.  
  187. BITSPERSAMPLE <TIF_bitspersample>
  188.     Not very meaningful to use this parameter, but it overwrites (if CFG is
  189.     defined after) the '-COLOR' and '-GRAY' settings.
  190.  
  191. FAXPATH <target_drive_and_directory>
  192.     Same as '-O' in commandline.
  193.  
  194. FAXLOG <Third_party_FAX.LOG>
  195.     Used if also 'FAXIDX' is defined, to create entry in third parties
  196.     application. Target is named FXnnnnnn.FAX in conjunction with number from
  197.     FAXIDX. 'FAXPATH' is used to form drive and directory. See also
  198.     documention for FREC.
  199.  
  200. FAXIDX
  201.     Used if also 'FAXLOG' is defined, to create entry in third parties
  202.     application. See there.
  203.  
  204. 3) Hints
  205.  
  206.     Conversion of (partially) distorted fax rawdata will normally FAIL because
  207.     T2T is not a special fax raw data converter (eg as FREC).
  208.  
  209.     Although, fax rawdata MAY be converted without faults, it is not the
  210.     intention of this application, to do this kind of job! No (dedicated)
  211.     resynchronisation is performed from T2T (as FREC does in realtime).
  212.  
  213.     While T2T.EXE is of small size, it is RECOMMANDED to use FREC instead to
  214.     yield best (in fact ABSOLUTLY best) results in converting fax raw data.
  215.  
  216.     Both FREC and T2T use the same TIFPROC.DLL to handle creation of TIF target,
  217.     but FREC uses its own dedicated resynchronisation routines, which are
  218.     not in T2T. There is also NO WAY to supply a mailers logfile to decide
  219.     which compression (and resolution) of rawdata should be used.
  220.  
  221.     Zyxels ZFAX fax format is only partial supported. This means that a
  222.     SINGLE page is normally accepted from T2T (as from FREC) but if file
  223.     contains MORE than one page, conversion is stopped if first EOP is
  224.     encountered (EOP = 6x EOL only).
  225.  
  226.