rfax_help.html

You can send a fax from ANY application that can print to a standard unix printer using the spooli

create text fax producer</font></font></font></i>
<br><i><font face="Arial, Helvetica, sans-serif"><font size=-1>producer
p=new FaxTextProducer();</font></font></i>
<br><i><font face="Arial, Helvetica, sans-serif"><font size=-1>p.text=this.txt.getText("Hello,
\n\n this is a fax sent with RFax\n\nregards\n\nJ4L");</font></font></i>
<br><i><font face="Arial, Helvetica, sans-serif"><font size=-1>p.pageImage=this.createImage(800,1290);
<font color="#009900">//
create working image, it can also be a Buffered image</font></font></font></i>
<br><i><font face="Arial, Helvetica, sans-serif"><font size=-1>p.prepare();</font></font></i></ul>
</ul>

<ul>
<li>
<font face="Arial, Helvetica, sans-serif">HtmlFaxProducer : Uses HTML as
source.</font></li>
</ul>

<blockquote>
<blockquote><i><font face="Arial, Helvetica, sans-serif"><font color="#009900"><font size=-1>//
create html fax producer</font></font></font></i>
<br><i><font face="Arial, Helvetica, sans-serif"><font size=-1>producer
p=new HtmlTextProducer();</font></font></i>
<br><i><font face="Arial, Helvetica, sans-serif"><font size=-1>String[]
t= new String[2]; <font color="#009900">// 2 pages</font></font></font></i>
<br><i><font face="Arial, Helvetica, sans-serif"><font size=-1>t[0]="&lt;HTML>&lt;BODY>page
1&lt;/BODY>&lt;/HTML>";</font></font></i>
<br><i><font face="Arial, Helvetica, sans-serif"><font size=-1>t[1]="&lt;HTML>&lt;BODY>page
2&lt;/BODY>&lt;/HTML>";</font></font></i>
<br><i><font face="Arial, Helvetica, sans-serif"><font size=-1>p.text=t;</font></font></i>
<br><i><font face="Arial, Helvetica, sans-serif"><font size=-1>p.pageImage=this.createImage(800,1290);
<font color="#009900">//
create working image, it can also be a Buffered image</font></font></font></i></blockquote>
</blockquote>
<b><u><font face="Arial, Helvetica, sans-serif">2. Use faxModem to send
the fax</font></u></b>
<p><font face="Arial, Helvetica, sans-serif">The second step is to create
a <i>faxModem </i>object, set up port and modem configurations and call
the <i>sendFax()</i> method.</font>
<p><font face="Arial, Helvetica, sans-serif">For example:</font>
<blockquote>&nbsp; <br>
  <i><font face="Arial, Helvetica, sans-serif"><font size=-1>import java.awt.*;</font></font></i> 
  <br>
  <i><font face="Arial, Helvetica, sans-serif"><font size=-1>import java.io.*;</font></font></i> 
  <br>
  <i><font face="Arial, Helvetica, sans-serif"><font size=-1>import com.java4less.rfax.*;</font></font></i> 
  <br>
  <i><font face="Arial, Helvetica, sans-serif"><font size=-1>import java.util.*;</font></font></i> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font size=-1>public class Example 
    extends Frame&nbsp; implements <b>FaxProducer</b> {</font></font></i> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp;public static 
    void main(String[] args) {</font></font></i> <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp; Example 
    c=new Example();</font></font></i> <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp; c.setBackground(java.awt.Color.white);</font></font></i> 
    <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp; c.send();</font></font></i> 
    <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp;}</font></font></i> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font color="#009900"><font size=-1>// 
    faxProducer Interface</font></font></font></i> <br>
    <b><i><font face="Arial, Helvetica, sans-serif"><font color="#3333FF"><font size=-1>public 
    java.awt.Image getFaxPage(int page) {</font></font></font></i></b> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp;// we send 
    only 1 page</font></font></i> <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp; if (page>0) 
    return null;</font></font></i> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font size=-1>// create an image 
    and write something on it</font></font></i> <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp; java.awt.Image 
    i=this.createImage(800,1000);</font></font></i> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp; Graphics 
    g=i.getGraphics();</font></font></i><i><font face="Arial, Helvetica, sans-serif"><font size=-1></font></font></i> 
  <p><i><font face="Arial,Helvetica"><font size=-1>&nbsp;// clear background</font></font></i> 
    <br>
    <i><font face="Arial,Helvetica"><font size=-1>&nbsp;&nbsp; g.setColor(java.awt.Color.white);</font></font></i> 
    <br>
    <i><font face="Arial,Helvetica"><font size=-1>&nbsp;&nbsp; g.fillRect(0,0,pageImage.getWidth(null),pageImage.getHeight(null));</font></font></i><i><font face="Arial, Helvetica, sans-serif"><font size=-1></font></font></i> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp; g.setColor(java.awt.Color.black);</font></font></i> 
    <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp; g.setFont(new 
    Font("Serif",Font.PLAIN,20));</font></font></i> <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp; g.drawString("This 
    is my first fax",100,100);</font></font></i> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp; return 
    i;</font></font></i> <br>
    <b><i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp;<font color="#3333FF">}</font></font></font></i></b> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font color="#009900"><font size=-1>// 
    send fax</font></font></font></i> <br>
    <b><i><font face="Arial, Helvetica, sans-serif"><font color="#3333FF"><font size=-1>public 
    void send() {</font></font></font></i></b> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp;FaxModem 
    m=<b>new FaxModem()</b>;</font></font></i> <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp;<b>m.setPortName</b>("COM1");</font></font></i> 
    <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp;<b>m.faxClass</b>=2;</font></font></i> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font color="#009900"><font size=-1>// 
    set RtsCts flow Control</font></font></font></i> <br>
    <b><i><font face="Arial, Helvetica, sans-serif"><font size=-1>m.flowControl=FLOWCONTROL_RTSCTS;</font></font></i></b> 
    <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1><font color="#009900">// 
    command required by the modem to set RtsCts flow control. </font><font color="#CC0000">This 
    will depend on your Modem, check your modem manual.</font></font></font></i> 
    <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1><b>m.ATFlowControlRTSCTS="AT&amp;K3"; 
    </b>// another commoun command is AT\Q3</font></font></i> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font color="#009900"><font size=-1>// 
    set vertical resolution to 98 dpi (aprox. 1190 pixels)</font></font></font></i> 
    <br>
    <b><i><font face="Arial, Helvetica, sans-serif"><font size=-1>m.resolution=m.RESOLUTION_NORMAL;</font></font></i></b> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font size=-1>&nbsp;<b>m.open</b>(this); 
    <font color="#009900">// "this" implements fax producer</font></font></font></i> 
    <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1>if (<b>m.sendFax</b>("123456789")) 
    System.out.println("Success ***");</font></font></i> <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1>else System.out.println("Failure: 
    " + <b>m.lastError</b>);</font></font></i> 
  <p><i><font face="Arial, Helvetica, sans-serif"><font size=-1><b>m.close()</b>;</font></font></i> 
    <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size=-1>System.exit(0);</font></font></i> 
    <br>
    <b><i><font face="Arial, Helvetica, sans-serif"><font color="#3333FF"><font size=-1>}</font></font></font></i></b> 
    <br>
    <b><i><font face="Arial, Helvetica, sans-serif"><font color="#3333FF"><font size=-1>}</font></font></font></i></b>
  <p>&nbsp;
  <h2><a name="rec"></a><font face="Arial, Helvetica, sans-serif">How to receive 
    faxes in your programs</font></h2>
  <p><br>
    <font face="Arial, Helvetica, sans-serif">The steps you must follow to receive 
    faxes are:</font> 
  <p><b><u><font face="Arial, Helvetica, sans-serif">1. Implement the IFaxReceiver 
    interface</font></u></b> 
  <p><font face="Arial, Helvetica, sans-serif">this interface is used to receive 
    a notification when a fax has been received. The only function you must implement 
    is: </font> 
  <blockquote><i>public void faxReceived(String callerId, boolean success,String 
    file,int pages);</i></blockquote>
  <b><u><font face="Arial, Helvetica, sans-serif">2. Use FaxReceiverModem to wait 
  for a fax</font></u></b> 
  <p><font face="Arial, Helvetica, sans-serif">The second step is to create a 
    <i>FaxReceiverModem </i>object, set up port and modem configurations , and 
    call the <i>waitForFax()</i> method.</font> 
  <p><font face="Arial, Helvetica, sans-serif">For example:</font> 
  <blockquote>&nbsp; <br>
    <i><font face="Arial, Helvetica, sans-serif"><font size="-1">import java.awt.*;</font></font> 
    <font face="Arial, Helvetica, sans-serif" size="-1"><br>
    import java.io.*; <br>
    import com.java4less.rfax.*; <br>
    import java.util.*; </font> </i> 
    <p><i><font face="Arial, Helvetica, sans-serif" size="-1">public class Example 
      extends Frame&nbsp; implements <b>IFaxReceiver</b>{ </font></i>
    <p><i><font face="Arial, Helvetica, sans-serif" size="-1"><b><font color="#0066FF">&nbsp;public 
      static void main(String[] args) { </font></b><br>
      </font></i>
    <p>&nbsp;
    <p><i><font face="Arial, Helvetica, sans-serif" size="-1"> <font color="#000000">FaxReceiverModem 
      m= new FaxReceiverModem();</font><br>
      m.ATFlowControlRTSCTS=&quot;AT&amp;K3&quot;; <br>
      m.flowControl=m.FLOWCONTROL_RTSCTS; <br>
      m.setPortName(&quot;COM3&quot;);<br>
      m.debug=true;<br>
      m.faxClass=1;<br>
      m.faxReceiver=new Example(); <br>
      if (m.openReception()) m.waitForFax(); <font color="#009900">// the waitForFax() 
      method will create a thread that will wait for faxes.</font></font></i>
    <p><i><font face="Arial, Helvetica, sans-serif" size="-1"><br>
      <b><font color="#3366FF">&nbsp;} </font></b></font></i>
    <p><i><font face="Arial, Helvetica, sans-serif" size="-1"><font color="#009900">// 
      IFaxReceiver Interface</font> <br>
      <font color="#3333FF"><b>public void faxReceived(String callerId, boolean 
      success,String file,int pages) { </b></font></font></i>
    <p><i><font face="Arial, Helvetica, sans-serif" size="-1">System.out.println(&quot;&quot;);<br>
      System.out.println(&quot;Fax from &quot; +callerId);<br>
      System.out.println(&quot;Success &quot; +success);<br>
      System.out.println(&quot;File &quot; +file);</font></i>
    <p><i><font face="Arial, Helvetica, sans-serif" size="-1"><b>&nbsp;<font color="#3333FF">}</font></b> 
      </font></i>
    <p><i><font face="Arial, Helvetica, sans-serif" size="-1"><b><font color="#3333FF">}</font></b></font></i>
  </blockquote>
  <p><font face="Arial, Helvetica, sans-serif">If you want to stop the thread 
    that is listening to the modem and waiting for faxes, you must execute:</font> 
  <blockquote>
    <p><i>m.close();</i></p>
  </blockquote>
  <hr>
  <div align="center"> 
    <blockquote><b><font face="Arial, Helvetica, sans-serif"><font size=-1>Java, 
      JSP, JDBC, JDK and all Java-based marks are trademarks or registered trademarks 
      of Sun Microsystems, Inc. in the U.S. and other countries. J4L Components 
      is independent of Sun Microsystems, Inc.</font></font></b> </blockquote>
  </div>
  <p>&nbsp; 
</blockquote>

</body>
</html>