t38proto.h

Go to the documentation of this file.

/*
 * t38proto.h
 *
 * T.38 protocol handler
 *
 * Open Phone Abstraction Library
 *
 * Copyright (c) 2001 Equivalence Pty. Ltd.
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is Open H323 Library.
 *
 * The Initial Developer of the Original Code is Equivalence Pty. Ltd.
 *
 * Contributor(s): ______________________________________.
 *
 * $Revision: 24162 $
 * $Author: rjongbloed $
 * $Date: 2010-03-29 02:46:26 -0500 (Mon, 29 Mar 2010) $
 */

#ifndef OPAL_T38_T38PROTO_H
#define OPAL_T38_T38PROTO_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif

#include <opal/buildopts.h>


#if OPAL_FAX

#include <ptlib/pipechan.h>

#include <opal/mediafmt.h>
#include <opal/mediastrm.h>
#include <opal/endpoint.h>


class OpalTransport;
class T38_IFPPacket;
class PASN_OctetString;
class OpalFaxConnection;



class OpalFaxConnection;

class OpalFaxEndPoint : public OpalEndPoint
{
  PCLASSINFO(OpalFaxEndPoint, OpalEndPoint);
  public:
    OpalFaxEndPoint(
      OpalManager & manager,        
      const char * g711Prefix = "fax", 
      const char * t38Prefix = "t38"  
    );

    ~OpalFaxEndPoint();

    virtual PSafePtr<OpalConnection> MakeConnection(
      OpalCall & call,          
      const PString & party,    
      void * userData = NULL,          
      unsigned int options = 0,     
      OpalConnection::StringOptions * stringOptions = NULL
    );

    virtual OpalFaxConnection * CreateConnection(
      OpalCall & call,          
      void * userData,
      OpalConnection::StringOptions * stringOptions,
      const PString & filename, 
      bool receiving,
      bool disableT38
    );

    virtual OpalMediaFormatList GetMediaFormats() const;

    virtual void AcceptIncomingConnection(
      const PString & connectionToken 
    );

    virtual void OnFaxCompleted(
      OpalFaxConnection & connection, 
      bool failed   
    );

    const PString & GetDefaultDirectory() const { return m_defaultDirectory; }

    void SetDefaultDirectory(
      const PString & dir    
    ) { m_defaultDirectory = dir; }

    const PString & GetT38Prefix() const { return m_t38Prefix; }

  protected:
    PString    m_t38Prefix;
    PDirectory m_defaultDirectory;
};



class OpalFaxConnection : public OpalConnection
{
  PCLASSINFO(OpalFaxConnection, OpalConnection);
  public:
    OpalFaxConnection(
      OpalCall & call,                 
      OpalFaxEndPoint & endpoint,      
      const PString & filename,        
      bool receiving,                  
      bool disableT38,                 
      OpalConnection::StringOptions * stringOptions = NULL
    );

    ~OpalFaxConnection();

    virtual PString GetPrefixName() const;

    virtual bool IsNetworkConnection() const { return false; }

    virtual void ApplyStringOptions(OpalConnection::StringOptions & stringOptions);
    virtual OpalMediaFormatList GetMediaFormats() const;
    virtual void AdjustMediaFormats(bool local, OpalMediaFormatList & mediaFormats, OpalConnection * otherConnection) const;

    virtual PBoolean SetUpConnection();

    virtual PBoolean SetAlerting(
      const PString & calleeName,   
      PBoolean withMedia                
    );

    virtual PBoolean SetConnected();
    virtual void OnEstablished();
    virtual void OnReleased();
    virtual OpalMediaStream * CreateMediaStream(const OpalMediaFormat & mediaFormat, unsigned sessionID, PBoolean isSource);
    virtual void OnStartMediaPatch(OpalMediaPatch & patch);
    virtual void OnStopMediaPatch(OpalMediaPatch & patch);
    virtual PBoolean SendUserInputTone(char tone, unsigned duration);
    virtual void OnUserInputTone(char tone, unsigned duration);
    virtual bool SwitchFaxMediaStreams(bool enableFax);
    virtual void OnSwitchedFaxMediaStreams(bool enabledFax);

    virtual void AcceptIncoming();

    virtual void OnFaxCompleted(
      bool failed   
    );

#if OPAL_STATISTICS

    virtual void GetStatistics(
      OpalMediaStatistics & statistics  
    ) const;
#endif

    const PString & GetFileName() const { return m_filename; }

    bool IsReceive() const { return m_receiving; }

  protected:
    PDECLARE_NOTIFIER(PTimer,  OpalFaxConnection, OnSendCNGCED);
    PDECLARE_NOTIFIER(PThread, OpalFaxConnection, OpenFaxStreams);
    PDECLARE_NOTIFIER(PThread, OpalFaxConnection, ReleaseConnection);


    OpalFaxEndPoint & m_endpoint;
    PString           m_filename;
    bool              m_receiving;
    PString           m_stationId;
    bool              m_disableT38;
    PTimeInterval     m_releaseTimeout;
    PTimeInterval     m_switchTimeout;
    OpalMediaFormat   m_tiffFileFormat;

    bool     m_awaitingSwitchToT38;
    PTimer   m_faxTimer;

  friend class OpalFaxMediaStream;
};


typedef OpalFaxConnection OpalT38Connection; // For backward compatibility


#endif // OPAL_FAX

#endif // OPAL_T38_T38PROTO_H

---