<html>
<head>
    <base href="https://wiki.asterisk.org/wiki">
            <link rel="stylesheet" href="/wiki/s/en/2176/25/9/_/styles/combined.css?spaceKey=AST&amp;forWysiwyg=true" type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+Application_ReceiveFAX_app_fax">Asterisk 10 Application_ReceiveFAX_app_fax</a></h2>
    <h4>Page  <b>added</b> by             <a href="https://wiki.asterisk.org/wiki/display/~wikibot">Wiki Bot</a>
    </h4>
         <br/>
    <div class="notificationGreySide">
         <h1><a name="Asterisk10Application_ReceiveFAX_app_fax-ReceiveFAX%28%29%5Cappfax%5C"></a>ReceiveFAX() - [app_fax]</h1>

<h3><a name="Asterisk10Application_ReceiveFAX_app_fax-Synopsis"></a>Synopsis</h3>

<p>Receive a Fax</p>

<h3><a name="Asterisk10Application_ReceiveFAX_app_fax-Description"></a>Description</h3>

<p>Receives a FAX from the channel into the given filename overwriting the file if it already exists.</p>

<p>File created will be in TIFF format.</p>

<p>This application sets the following channel variables:</p>

<ul>
        <li><tt>LOCALSTATIONID</tt> - To identify itself to the remote end</li>
        <li><tt>LOCALHEADERINFO</tt> - To generate a header line on each page</li>
        <li><tt>FAXSTATUS</tt>
        <ul>
                <li>SUCCESS</li>
                <li>FAILED</li>
        </ul>
        </li>
        <li><tt>FAXERROR</tt> - Cause of failure</li>
        <li><tt>REMOTESTATIONID</tt> - The CSID of the remote side</li>
        <li><tt>FAXPAGES</tt> - Number of pages sent</li>
        <li><tt>FAXBITRATE</tt> - Transmission rate</li>
        <li><tt>FAXRESOLUTION</tt> - Resolution of sent fax</li>
</ul>



<h3><a name="Asterisk10Application_ReceiveFAX_app_fax-Syntax"></a>Syntax</h3>

<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>ReceiveFAX(filename[,c])</pre>
</div></div>

<h5><a name="Asterisk10Application_ReceiveFAX_app_fax-Arguments"></a>Arguments</h5>

<ul>
        <li><tt>filename</tt> - Filename of TIFF file save incoming fax</li>
        <li><tt>c</tt> - Makes the application behave as the calling machine<br/>
(Default behavior is as answering machine)</li>
</ul>



<h3><a name="Asterisk10Application_ReceiveFAX_app_fax-ImportVersion"></a>Import Version</h3>

<p>This documentation was imported from Asterisk Version SVN-branch-10-r378689</p>
    </div>
    <div id="commentsSection" class="wiki-content pageSection">
       <div style="float: right;" class="grey">
                        <a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST">Stop watching space</a>
            <span style="padding: 0px 5px;">|</span>
                <a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action">Change email notification preferences</a>
</div>
       <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+Application_ReceiveFAX_app_fax">View Online</a>
              |
       <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+Application_ReceiveFAX_app_fax?showComments=true&amp;showCommentArea=true#addcomment">Add Comment</a>
           </div>
</div>
</div>
</div>
</div>
</body>
</html>