Color Fax File Utility
CFCOLOR opname infile outfile [parm]
This utility program performs various operations needed to handle color fax files. The name of the required operation is specified as the first command line parameter. For general information about the use of this utility, see Color Faxing.
The available operation keywords are:
| ColorTIF_IPK | This operation will take a 24-bit color, PackBits-encoded, TIF file, such as can be created by the color print driver from ImageMaker, create from it temporary T.42-compliant JPEG files, and build them into an IPK file ready for transmission on a Brooktrout TR1034 board. The original TIF file can have multiple pages, and the images it contains should be exactly 1728 pixels wide. The input file should have extension .TIF and the output .IPK. The infile parameter may also take the form '+filelist' where each entry in the list is a .TIF file to be added to the same output file. |
| ColorTIF_ColorFaxJPEGs | This operation will take a 24-bit color, PackBits-encoded, TIF file, such as can be created by the color print driver from ImageMaker, and create from it T.42-compliant JPEG files. The original TIF file can have multiple pages, and the images it contains should be exactly 1728 pixels wide. The input file should have extension .TIF and the output .JPG or .JPEG. The actual files created will use the supplied names to form filenames outfile_001.JPG, outfile_002.JPG, etc. The infile parameter may also take the form '+filelist' where each entry in the list is a .TIF file to be added to the same sequence of output files. |
| IPK_ColorFaxJPEGs | This operation will take a color fax received on a Brooktrout TR1034 in an IPK file and extract the separate T.42 JPG files. These JPEG files will not be viewable in most imaging programs and browsers, which do not support this type of JPEG file. The input file should have extension .IPK and the output .JPG or .JPEG. The actual files created will use the supplied names to form filenames outfile_001.JPG, outfile_002.JPG, etc. If the incoming IPK file contains JFIF JPEG files (which should not happen) they will be converted to Color Fax (T.42) JPEG files. |
| IPK_JFIFJPEGs | This operation will take a color fax received on a Brooktrout TR1034 in an IPK file and extract the separate T.42 JPG files. These JPEG files will need to be decompressed and recompressed, but they will then be viewable in most imaging programs and browsers. The input file should have extension .IPK and the output .JPG or .JPEG. The actual files created will use the supplied names to form filenames outfile_001.JPG, outfile_002.JPG, etc. If the incoming IPK file contains JFIF JPEG files (which should not happen) they will be extracted but not converted. |
| JPEGs_IPK | This operation will take a sequence of JPEG files named infile_001.JPG, infile_002.JPG, etc., and copy them into an IPK file ready for transmission on a Brooktrout TR1034 board. If the infile name is that of an existing file, it will be taken as the specification of a single file and the scan for infile_001 etc will not be performed. The input file should have extension .JPG or .JPEG and the output .IPK. The input files can be either T.42 Color Fax JPEGs or JFIF JPEGs or a mixture of both, and will be converted to T.42 as necessary. The infile parameter may also take the form '+filelist' where each entry in the list is either a single JPEG file or the name of a file sequence (to which _001, _002 etc. will be added) to be added to the same output file. |
| IPK_ColorTIF | This operation will take a color fax received on a Brooktrout TR1034 in an IPK file, extract the contained files into separate JPEG files and from them create a 24-bit color, PackBits-encoded TIF file. The input file should have extension .IPK and the output .TIF. |
| IPK_MonoTIF | This operation will take a color fax received on a Brooktrout TR1034 in an IPK file, extract the contained files into separate JPEG files and from them create a dithered monochrome G4-encoded faxable TIF file, suitable for use as a 'fallback TIF' when a recipient fax machine has no color capability. The input file should have extension .IPK and the output .TIF. The monochrome file will not be faxable if the image widths in the original file were not 1728. |
| ColorTIF_MonoTIF | This operation will take a 24-bit color, PackBits-encoded, TIF file, such as can be created by the color print driver from ImageMaker, and convert it directly to a dithered monochrome G4-encoded faxable TIF file, suitable for use as a 'fallback TIF' when a recipient fax machine has no color capability. The original TIF file can have multiple pages. The input and output files should have extension .TIF. The monochrome file will not be faxable if the image width in the original file was not 1728. |
| JPEG_ColorFaxJPEG | This converts either type of JPEG to a T.42 compliant JPEG. The conversion is always performed. This operation should therefore not be performed on a JPEG that is already T.42. This function is principally for internal use by the other functions. |
| JPEG_JFIFJPEG | This converts either type of JPEG to a JFIF JPEG. The conversion is always performed. This operation should therefore not be performed on a JPEG that is already T.42. This function is principally for internal use by the other functions. |
The parm commmand-line parameter is used as follows: for operations requiring a JPEG compression, the value represents the quality level to be used. The default if this parameter is omitted is to use a value of 95 (out of 100). Reducing this value affects both the quality and the size and transmission time of the resulting compressed file. For operations involving the creation of a dithered monochrome TIF, the default is to use the highest-quality dithering algorithm (Floyd-Steinberg). A value of 1 in the parameter will select instead the Stevenson-Arce algorithm which typically results in files 30% smaller and slightly reduced quality.
The program returns a non-zero error-level if the conversion fails. FFTRACE running with CFCOLOR application tracing enabled will show details of the error.
Topic url:
http://www.copia.com/support/refmanual/index.html?cfcolor.htm
