h281handler.h

Go to the documentation of this file.

/*
 * h281handler.h
 *
 * H.281 protocol handler implementation for the OpenH323 Project.
 *
 * Copyright (c) 2006 Network for Educational Technology, ETH Zurich.
 * Written by Hannes Friederich.
 *
 * 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.
 *
 * Contributor(s): ______________________________________.
 *
 * $Log: h281handler.h,v $
 * Revision 1.3  2007/04/19 06:17:20  csoutheren
 * Fixes for precompiled headers with gcc
 *
 * Revision 1.2  2006/04/23 18:52:19  dsandras
 * Removed warnings when compiling with gcc on Linux.
 *
 * Revision 1.1  2006/04/20 16:48:17  hfriederich
 * Initial version of H.224/H.281 implementation.
 *
 */

#ifndef __OPAL_H281HANDLER_H
#define __OPAL_H281HANDLER_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif

#ifndef _PTLIB_H
#include <ptlib.h>
#endif

#include <h224/h224handler.h>
#include <h224/h281.h>

class OpalH224Handler;

class H281VideoSource : public PObject
{
  PCLASSINFO(H281VideoSource, PObject);

public:
        
  H281VideoSource();
  ~H281VideoSource();
        
  BOOL IsEnabled() const { return isEnabled; }
  void SetEnabled(BOOL flag) { isEnabled = flag; }
        
  BYTE GetVideoSourceNumber() const { return (firstOctet >> 4) & 0x0f; }
  void SetVideoSourceNumber(BYTE number);
        
  BOOL CanMotionVideo() const { return (firstOctet >> 2) & 0x01; }
  void SetCanMotionVideo(BOOL flag);

  BOOL CanNormalResolutionStillImage() const { return (firstOctet >> 1) & 0x01; }
  void SetCanNormalResolutionStillImage(BOOL flag);

  BOOL CanDoubleResolutionStillImage() const { return (firstOctet & 0x01); }
  void SetCanDoubleResolutionStillImage(BOOL flag);

  BOOL CanPan() const { return (secondOctet >> 7) & 0x01; }
  void SetCanPan(BOOL flag);
        
  BOOL CanTilt() const { return (secondOctet >> 6) & 0x01; }
  void SetCanTilt(BOOL flag);
        
  BOOL CanZoom() const { return (secondOctet >> 5) & 0x01; }
  void SetCanZoom(BOOL flag);
        
  BOOL CanFocus() const { return (secondOctet >> 4) & 0x01; }
  void SetCanFocus(BOOL flag);
        
  void Encode(BYTE *data) const;
  BOOL Decode(const BYTE *data);
        
protected:
        
  BOOL isEnabled;
  BYTE firstOctet;
  BYTE secondOctet;
        
};

class OpalH281Handler : public PObject
{
  PCLASSINFO(OpalH281Handler, PObject);
        
public:
        
  OpalH281Handler(OpalH224Handler & h224Handler);
  ~OpalH281Handler();
        
  enum VideoSource {
    CurrentVideoSource          = 0x00,
        MainCamera                              = 0x01,
        AuxiliaryCamera                 = 0x02,
        DocumentCamera                  = 0x03,
        AuxiliaryDocumentCamera = 0x04,
        VideoPlaybackSource             = 0x05
  };
        
  BOOL GetRemoteHasH281() const { return remoteHasH281; }
  void SetRemoteHasH281(BOOL flag) { remoteHasH281 = flag; }
        
  BYTE GetLocalNumberOfPresets() const { return localNumberOfPresets; }
  void SetLocalNumberOfPresets(BYTE presets) { localNumberOfPresets = presets; }
        
  BYTE GetRemoteNumberOfPresets() const { return remoteNumberOfPresets; }
        
  H281VideoSource & GetLocalVideoSource(VideoSource source);
  H281VideoSource & GetRemoteVideoSource(VideoSource source);
        
  void StartAction(H281_Frame::PanDirection panDirection,
                                   H281_Frame::TiltDirection tiltDirection,
                                   H281_Frame::ZoomDirection zoomDireciton,
                               H281_Frame::FocusDirection focusDirection);
  
  void StopAction();

  void SelectVideoSource(BYTE videoSourceNumber, H281_Frame::VideoMode videoMode);
  
  void StoreAsPreset(BYTE presetNumber);
  
  void ActivatePreset(BYTE presetNumber);
        
  void SendExtraCapabilities() const;
        
  void OnReceivedExtraCapabilities(const BYTE *capabilities, PINDEX size);
  void OnReceivedMessage(const H281_Frame & message);
        
  /*
   * methods that subclasses can override.
   * The default handler does not implement FECC on the local side.
   * Thus, the default behaviour is to do nothing.
   */
        
  virtual void OnRemoteCapabilitiesUpdated();
        
  virtual void OnStartAction(H281_Frame::PanDirection panDirection,
                                                         H281_Frame::TiltDirection tiltDirection,
                                                         H281_Frame::ZoomDirection zoomDirection,
                                                         H281_Frame::FocusDirection focusDirection);
        
  virtual void OnStopAction();
        
  virtual void OnSelectVideoSource(BYTE videoSourceNumber, H281_Frame::VideoMode videoMode);
        
  virtual void OnStoreAsPreset(BYTE presetNumber);

  virtual void OnActivatePreset(BYTE presetNumber);
        
protected:
                
  PDECLARE_NOTIFIER(PTimer, OpalH281Handler, ContinueAction);
  PDECLARE_NOTIFIER(PTimer, OpalH281Handler, StopActionLocally);
        
  OpalH224Handler & h224Handler;
  BOOL remoteHasH281;
  BYTE localNumberOfPresets;
  BYTE remoteNumberOfPresets;
  H281VideoSource localVideoSources[6];
  H281VideoSource remoteVideoSources[6];
        
  H281_Frame transmitFrame;
  PTimer transmitTimer;

  H281_Frame::PanDirection requestedPanDirection;
  H281_Frame::TiltDirection requestedTiltDirection;
  H281_Frame::ZoomDirection requestedZoomDirection;
  H281_Frame::FocusDirection requestedFocusDirection;
  PTimer receiveTimer;
};

#endif // __OPAL_H281HANDLER_H

---