CommFax project page

turkey

!!NEWS!! Now MR mode is supported (with class 1.0 fax modem)

MR mode is 2D compress mode for faxing. MR mode can compress 20-30% smaller than normal MH mode (Depend on its image type). High compression rate means that you can send fax faster and save $.

For my best knowledge, open-source fax software that support 2D compression mode was only HylaFax. And CommFax will be the second choice.

Thank you for visit CommFax web page. This software is still in development, however, it can send and receive fax documents with sample application. For developer who want to make their own application, there is sufficient documentation for that API. This documents will be released after the completion of the coding software

What is it?

CommFax is an fax extension module for ruby language. It's unique features are the followings;

CommFax itself is an extension module, so that, it cannot work as a fax itself. A sample script is also provided to send, receive and polling fax. If you want more high function fax software like fax on demand, IVR machine, you can develop with ruby language.

This project is still in before alpha stage, however it works if you want just send or receiving fax documents with provided sample commands.


Release Info

Srouce Release version 0.1.1
	This version CAN do;
		* sending & receiving fax through MH encoding.
		* receving fax through MR encoding.
		* sending fax through MR encoding.

	and CANNOT
                * Send & receive in ECM mode.  

	Also, polling mode is avairable(for calling station and called station).

	Comatibilities are tested with the following Fax.
		* MYTALK Fax on Windows 2000
		* Speax31TA (NEC's fax machine)

        If you find some imcompatibilities with some other fax machine,
        please inform me.

        The log file may help to resolve problem, however, the log file
        may contain your personal infromation such as telephone number,
        so please review information and remove before submit bug report.

        Basically, there is two types of information include in the log.
               * Dial number
                    - This comes immidiate after the Dial command,
 
               * Station ID information
                    - TSI & CSI


	
[To be fixed]
	* Too many log output.

[Fixed]
	* Cannot terminate from console with Ctrl-C (use kill instead)

 

Install

Prerequisites

OS

CommFax is build and tested with GNU Linux on Intel architecture.

Required software

Useful software

Installation

       [extract archive and change directory into]
        $ cd rubyext
        $ ./build_all.sh
        $ su
        # make install

Usage

CommFax is an extension of ruby - a script language, howver, it comes with some sample script. For sending and receving fax is pretty simple. Now, this software comes with sample application for the function below;

  • send
  • receive
  • polling
  • For more information please see the file;

    distribution/app/basic/README


    
    
    
    **
       
    	reset.rb 	- Initialize modem command.
    
       
    	./reset.rb
    	
       
    	This command reset the modem specified in 'faxsettings.rb';
    	
    	If some error happend with this commands, please
    	check the modem line or its device access control.
    
    **	
       
    	receive.rb	- recieve fax image command.
    
       
    	./receive.rb
    
    
       
    	This command receive fax.
    
    	The incoming fax will be saved as
    		receive_fax.tif
    
    	This is TIFF/F format image file, so that
    	you can view this image with standard tools
    
    	For example the commands below will show
    	the received image.
    
    		viewfax receive_fax.tif
    		
    
    **
      
    	send.rb		- send fax image command.
    
      
    	./send.rb dial_number fax_image [fax_images ....]
    
      
    	This command send fax to specified dial_number.
    
    	Dial number must be an consequence number,
    	namely you must specify
    		1234567890
    	instead of
    		123-456-789
    	
    	Also, if you use plus type line, add 'P' at the head like,
    		P123456789
    	If your line is Tone dial type, use 'T' instead.
    
    
    **
      
     	pollingserver.rb   - accept polling request and send fax images.
    
      
    	./pollingserver.rb fax_image [fax_images ...]
    
      
    	This command wait call and accept polling request form other fax.
    	On accept the calling, the specified fax_images will be sent to
    	the calling station.
    	
    
    

    Thank you for supporting CommFax project.

    For main site SourceForge Logo

    For sub Japanese site SourceForge.jp


    YASUKAWA Takeo

    $Id: index.html,v 1.9 2003/05/18 17:09:08 yasstake Exp $