source: orxonox.OLD/branches/network/src/lib/network/data_stream.cc @ 5611

/*
   orxonox - the future of 3D-vertical-scrollers

   Copyright (C) 2004 orx

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2, or (at your option)
   any later version.

   ### File Specific:
   main-programmer: Benjamin Knecht
   co-programmer: ...
*/

/* include Data_stream Header */
#include "data_stream.h"




/* using namespace std is default, this needs to be here */
using namespace std;

/**
 * This is the empty construktor
 */
DataStream::DataStream()
{
                        
}

/**
 * This constructor creates a new DataStream and connects it to both streams (upStream, downStream)
 */
DataStream::DataStream(DataStream& inStream, DataStream& outStream)
{
    this->setClassID(CL_DATA_STREAM, "DataStream");
    downStream = &outStream;
    upStream = &inStream;
}

/**
 * This constructor creates a new DataStream and connects it to a synchronizeable object and the NetworkSocket
 */
DataStream::DataStream(Synchronizeable& sync, NetworkSocket& socket)
{
    this->setClassID(CL_DATA_STREAM, "DataStream");
    nSocket = &socket;
}

/**
 * This constructor creates a new DataStream and connects the Synchronizeable to it
 */
DataStream::DataStream(Synchronizeable& sync, DataStream& outStream)
{
    this->setClassID(CL_DATA_STREAM, "DataStream");
    downStream = &outStream;
}

/**
 * This constructor creates a new DataStream and connects the NetworkSocket to it
 */
DataStream::DataStream(DataStream& inStream, NetworkSocket& socket)
{
     this->setClassID(CL_DATA_STREAM, "DataStream");
     upStream = &inStream;
     nSocket = &socket;
}

/**
 *  standart deconstructor
 */
DataStream::~DataStream()
{

}

/**
 * This funtion connects this stream to a Synchronizable object. This stream is the top of the stream-chain.
 */
void DataStream::connectSynchronizeable(Synchronizeable& sync)
{
     
}
   
/**
 * And this function disconnects the Synch-object and sets it to NULL   
 */
void DataStream::disconnectSynchronizeable()
{
     
}

/**
 * This function connects the stream to a NetworkSocket. This stream is the bottom of the stream-chain
 */   
void DataStream::connectNetworkSocket(NetworkSocket& socket)
{
     
}
   
/**
 * And this function disconnects the Socket and sets it to NULL
 */   
void DataStream::disconnectNetworkSocket()
{
     
}

/**
 * This function connects this stream to another stream. The connected DataStream is an up-stream, meaning
 * that the stream is "further away" from the NetworkSocket. The local reference upStream will be set to this
 * Stream
 */
void DataStream::connectUpStream(DataStream& upStream)
{

}

/**
 * This function connects this stream to another stream. The connected DataStream is an down-stream, meaning
 * that the stream is "closer" to the NetworkSocket.
 */
void DataStream::connectDownStream(DataStream& upStream)
{

}

/**
 * This function disconnects the upStream and sets it to NULL
 */
void DataStream::disconnectUpStream()
{

}

/**
 * This function disconnects the downStream and sets it to NULL
 */
void DataStream::disconnectDownStream()
{

}

/**
 * This function moves the data from the downStream object to the upStream object and changes the data if necessary.
 * This function is virtual and therefore needs to be extended by the derived class
 */
void DataStream::processData()
{

}

/**
 * Following functions are protected and only visible inside the object and from derived classes
 */

/**
 * This function writes the binary data to the local data. You will have to copy each byte and not only dublicate
 * it.
 */
void DataStream::writeBytes(byte& data)
{

}


/**
 * This function returns a reference to the local upData data array. So it can be read by an upper Stream
 * The reading function will have to copy the whole data and musn't just reference it!
 * This function is only called from other connected DataStreams to read the data.
 */
byte& DataStream::readBytes()
{

}