source: orxonox.OLD/orxonox/branches/levelloader/src/track_manager.cc @ 3603

/* 
   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 Grauer
   co-programmer: Christian Meyer
*/


#include "track_manager.h"

#include "p_node.h"
#include "substring.h"

#include <stdarg.h>

using namespace std;

/**
   \brief initializes a TrackElement (sets the default values)
*/
TrackElement::TrackElement(void)
{
  this->isFresh = true;
  this->isHotPoint = false;
  this->isSavePoint = false;
  this->isFork = false;
  this->isJoined = false;
  this->mainJoin = false;
  this->cond; //!< todo think!!
  this->ID = -1;
  this->startingTime = 0; //!< \todo eventually set this to the max time of TrackManager.
  this->duration = 1;
  this->endTime = 1;
  this->jumpTime = 0;
  this->curveType = BEZIERCURVE;
  this->nodeCount = 0;
  this->childCount = 0;
  this->name = NULL;
  this->curve = NULL;
  this->children = NULL;
}

/** 
    \brief destroys all alocated memory)
    \todo eventually when deleting a TrackElement you would not like to delete all its preceding TrackElements
*/
TrackElement::~TrackElement(void)
{
  if (this->name)
    delete []name;
  if (this->curve)
    delete this->curve;
  if ((!this->isJoined &&this->childCount > 0) || (this->isJoined && this->mainJoin))
    {
      for (int i=0; i < this->childCount; i++)
        delete this->children[i];
      delete this->children;
    }
}

/**
   \brief Searches through all the TrackElements for trackID.
   \param trackID The ID to search for.
   \returns The TrackElement if Found, NULL otherwise.
   
   \todo make this more modular, to search for different things
*/
TrackElement* TrackElement::findByID(unsigned int trackID)
{
  // return if Found.
  if (this->ID == trackID)
    return this;
  // search on.
  if (this->childCount > 0)
    for (int i=0; i < this->childCount; i++)
      {
        TrackElement* tmpElem;
        if ((tmpElem = this->children[i]->findByID(trackID)))
          return tmpElem;
      }
  else return NULL;
}

/**
   \brief Sets the name of this TrackElement
   \param trackName The new name for this element
*/
void TrackElement::setName(const char* trackName)
{
        if( this->name != NULL) delete this->name;
        
        this->name = new char[strlen(trackName) + 1];
        strcpy( this->name, trackName);
}

/**
   \brief Searches through all the TrackElements for trackName.
   \param trackName The name to search for.
   \returns The TrackElement if Found, NULL otherwise.
   
   \todo make this more modular, to search for different things
*/
TrackElement* TrackElement::findByName(const char* trackName)
{
  // return if Found.
  if ( this->name != NULL && !strcmp( this->name, trackName))
    return this;
  // search on.
  if (this->childCount > 0)
    for (int i=0; i < this->childCount; i++)
      {
        TrackElement* tmpElem;
        if ((tmpElem = this->children[i]->findByName(trackName)))
          return tmpElem;
      }
  else return NULL;
}




/////////////////////////////////////
///// TRACKMANAGER //////////////////
/////////////////////////////////////
/**
   \brief standard constructor

*/
TrackManager::TrackManager(void)
{
  this->setClassName ("TrackManager");

  PRINTF(3)("Initializing the TrackManager\n");
  this->firstTrackElem = new TrackElement();
  this->firstTrackElem->ID = 1;
  this->currentTrackElem = firstTrackElem;
  this->localTime = 0;
  this->maxTime = 0;
  this->trackElemCount = 1;
  this->bindSlave = NULL;
}


/**
   \brief standard destructor

*/
TrackManager::~TrackManager(void)
{
  PRINTF(3)("Destruct TrackManager\n");

  PRINTF(3)("Deleting all the TrackElements\n");
  delete this->firstTrackElem;
  // delete this->name;

  // we do not have a TrackManager anymore
  singletonRef = NULL;
}

TrackManager* TrackManager::singletonRef = NULL;

/**
   \returns The reference on the TrackManager.

   If the TrackManager does not exist, it will be created.
*/
TrackManager* TrackManager::getInstance(void) 
{
  if (singletonRef)
    return singletonRef;
  else
    return singletonRef = new TrackManager();
}

/**
   \brief reserves Space for childCount children
   \param childCount The Count of children to make space for.
*/
void TrackManager::initChildren(unsigned int childCount, SubString* names)
{
  this->currentTrackElem->childCount = childCount;
  this->currentTrackElem->mainJoin = true;
  this->currentTrackElem->children = new TrackElement*[childCount];
  for (int i=0; i<childCount; i++)
    {
            
      this->currentTrackElem->children[i] = new TrackElement();
      this->currentTrackElem->children[i]->ID = ++trackElemCount;
      this->currentTrackElem->children[i]->startingTime = this->currentTrackElem->endTime + this->currentTrackElem->jumpTime;
      this->addPoint(this->currentTrackElem->curve->getNode(this->currentTrackElem->curve->getNodeCount()), this->currentTrackElem->children[i]);
        if( names != NULL)
        {
                // todo check for duplicate track names to avoid confusion
                /*if( this->findTrackElementByName( names->getString(i)) != NULL)
                        PRINTF0("Track name '%s' already taken", names->getString(i));
                else*/
                        this->currentTrackElem->children[i]->setName( names->getString(i)); 
            }
            
   }
}

/**
   \brief Searches for a given trackID.
   \param trackID the trackID to search for.
   \returns The TrackElement #trackID if found, NULL otherwise.
*/
TrackElement* TrackManager::findTrackElementByID(unsigned int trackID) const
{
  return firstTrackElem->findByID(trackID);
}

/**
   \brief Searches for a given trackname.
   \param trackName the trackName to search for.
   \returns The TrackElement if found, NULL otherwise.
*/
TrackElement* TrackManager::findTrackElementByName(const char* trackName) const
{
  return firstTrackElem->findByName(trackName);
}
// INITIALIZE //

/**
   \brief Sets the trackID we are working on.
   \param trackID the trackID we are working on
*/
void TrackManager::workOn(unsigned int trackID)
{
  TrackElement* tmpElem = findTrackElementByID(trackID);
  if (tmpElem)
    this->currentTrackElem = tmpElem;
  else
    printf("TrackElement not Found, leaving unchanged\n");
  printf("now Working on %d\n", this->currentTrackElem->ID);

}

/**
   \brief Sets the Type of the Curve
   \brief curveType The Type to set
*/
void TrackManager::setCurveType(CurveType curveType, TrackElement* trackElem)
{
  if (!trackElem->isFresh)
    {
      PRINTF(2)("It is not possible to change the type of a Curve after you have have appended some points to it\n");
      return;
    }
  trackElem->curveType = curveType;
  switch (curveType)
    {
    case BEZIERCURVE:
      trackElem->curve = new BezierCurve();
      break;
    case UPOINTCURVE:
      trackElem->curve = new UPointCurve();
      break;
    }
}

/**
   \brief Sets the duration of the current path in seconds.
   \param time The duration in seconds.
*/

void TrackManager::setDuration(float time)
{
  this->currentTrackElem->duration = time;
  this->currentTrackElem->endTime = this->currentTrackElem->startingTime + time;
}

/**
   \brief adds a point to the current TrackElement
   \param newPoint The point to add.
*/
bool TrackManager::addPoint(Vector newPoint)
{
  return this->addPoint(newPoint, this->currentTrackElem);
}

/**
   \brief adds a point to trackElem
   \param newPoint The point to add.
   \param trackElem The TrackElement to add the Point to
*/
bool TrackManager::addPoint(Vector newPoint, TrackElement* trackElem)
{
  if (trackElem->isFresh)
    {
      this->setCurveType(BEZIERCURVE, trackElem);
      trackElem->isFresh = false;
    }
  trackElem->curve->addNode(newPoint);
  trackElem->nodeCount++;
}

/**
   \brief adds save/splitpoint.
   \param newPoint The point to add.
   \returns A Pointer to a newly appended Curve
*/
int TrackManager::addHotPoint(Vector newPoint)
{
  printf("setting up a HotPoint\n");
  if (this->currentTrackElem->isFresh)
    {
      this->setCurveType(BEZIERCURVE);
      this->currentTrackElem->isFresh = false;
    }

  // \todo HotPoint Handling.
  this->currentTrackElem->curve->addNode(newPoint);
  this->currentTrackElem->nodeCount++;
  this->initChildren(1);
  this->currentTrackElem = this->currentTrackElem->children[0];
}

/**
   \brief Sets the last HotPoint into a savePoint.
   \returns A Pointer to a newly appended Curve
   
   If no HotPoint was defined the last added Point will be rendered into a savePoint. \n
   If the HotPoint was defined as a fork the Point will \b not be set into a savePoint.
*/
int TrackManager::setSavePoint(void)
{
  printf("setting up a SavePoint.\n");
  if (this->currentTrackElem->isFork || this->currentTrackElem->isSavePoint)
    return this->currentTrackElem->children[1]->ID;
  this->currentTrackElem->isSavePoint = true;
  this->currentTrackElem->isHotPoint = true;

  this->initChildren(1);
  this->currentTrackElem = this->currentTrackElem->children[0];
}

/**
   \brief adds some interessting non-linear movments through the level.
   \param count The Count of childrens the current HotPoint will have.

   If no HotPoint was defined the last added Point will be rendered into a fork. \n
   If the HotPoint was defined as a savePoint the Point will \b not be set into a fork.
*/
void TrackManager::fork(unsigned int count, ...)
{
  int* trackIDs = new int[count];
  this->forkV(count, trackIDs);
  va_list ID;
  va_start (ID, count);
  for(int i = 0; i < count; i++)
    {
      *va_arg (ID, int*) = trackIDs[i];
    }
  va_end(ID);  
  delete []trackIDs;
}

/**
   \brief adds some interessting non-linear movments through the level.
   \param count The Count of childrens the current HotPoint will have.
   \param trackIDs A Pointer to an Array of ints which will hold the trackID's (the user will have to reserve space for this).
   \param names A SubString containing the trackNames for the new tracks, if NULL, no names will be assigned

   \see void TrackManager::fork(int count, ...)

   \todo initialisation is wrong!! also in setSavePoint.
*/
void TrackManager::forkV(unsigned int count, int* trackIDs, SubString* names)
{
  printf("Forking with %d children\n", count);
  if (this->currentTrackElem->isSavePoint)
  {
        PRINTF0("Cannot fork a SavePoint - skipped\n");
    return;
  }
  this->currentTrackElem->isFork = true;
  this->currentTrackElem->isHotPoint = true;
  for(int i = 0; i < count; i++)
    trackIDs[i]=this->trackElemCount+1+i;
  this->initChildren(count, names);
}

/**
   \brief decides under what condition a certain Path will be chosen.
   \param groupID the ID on which to choose the preceding move
   \param cond \todo think about this
*/
void TrackManager::condition(unsigned int groupID, PathCondition cond)
{
  
}

/**
   \brief joins some tracks together again. 
   \param count The count of Paths to join.

   Join will set the localTime to the longest time a Path has to get to this Point. \n
   Join will join all curves to the first curve, meaning that all the tangents will be matched.
*/
void TrackManager::join(unsigned int count, ...)
{
  int* trackIDs = new int [count];
  va_list ID;
  va_start (ID, count);
  for(int i = 0; i < count; i++)
    {
      trackIDs[i] = va_arg (ID, int);
    }
  va_end(ID);
  this->joinV(count, trackIDs);
  delete []trackIDs;
}

/**
   \brief joins some tracks together again. 
   \param count The count of Paths to join.
   \param trackIDs an Array with the trackID's to join

   \see void TrackManager::join(int count, ...)
*/
void TrackManager::joinV(unsigned int count, int* trackIDs)
{
  printf("Joining %d tracks and merging to Track %d\n", count, trackIDs[0]);

  // chanching work-on to temporary value. going back at the end.
  int tmpCurrentWorkingID = this->currentTrackElem->ID;
  this->workOn(trackIDs[0]);
  TrackElement* firstJoint = this->currentTrackElem;
  float tmpLatestTime = firstJoint->endTime;

  Vector tmpEndPoint = firstJoint->curve->getNode(firstJoint->curve->getNodeCount());
  Vector tmpTangentPoint = firstJoint->curve->getNode(firstJoint->curve->getNodeCount()-1);
  Vector tmpc2Point = firstJoint->curve->getNode(firstJoint->curve->getNodeCount()-2);
  firstJoint->isJoined = true;
  //  firstJoint->mainJoin = true;
  if(!firstJoint->isHotPoint)
    this->setSavePoint();
  // Timing:
  for (int i = 0; i < count; i++)
    {
      TrackElement* tmpJoinElem = this->findTrackElementByID(trackIDs[i]);
      if (tmpJoinElem->childCount == 0
          && tmpJoinElem->endTime > tmpLatestTime)
        tmpLatestTime = tmpJoinElem->endTime;
    }
  // time the main Join.
  firstJoint->jumpTime = tmpLatestTime - firstJoint->endTime;
  
  // Joining:
  for (int i = 1; i < count; i++)
    {
      TrackElement* tmpJoinElem = this->findTrackElementByID(trackIDs[i]);
      if (tmpJoinElem->childCount > 0)
        printf("!!This Curve has children, and as such will not be joined!!\n You can try joining other childless TrackElements to this one!");
      else
        {
          this->addPoint(tmpc2Point, tmpJoinElem);
          this->addPoint(tmpTangentPoint, tmpJoinElem);
          this->addPoint(tmpEndPoint, tmpJoinElem);
          // time all other Joins
          tmpJoinElem->jumpTime = tmpLatestTime - tmpJoinElem->endTime;
          
          //Copying Joint-Info
          tmpJoinElem->children = firstJoint->children;
          tmpJoinElem->childCount = firstJoint->childCount;
          tmpJoinElem->isSavePoint = firstJoint->isSavePoint;
          tmpJoinElem->isFork = firstJoint->isFork;

          tmpJoinElem->isJoined = true;
        }
    }
  if(firstJoint->childCount > 0)
    for(int i = 0; i < firstJoint->childCount; i++)
      {
        printf("Setting startingTime of %d to %f.\n", firstJoint->children[i]->ID, tmpLatestTime);
        firstJoint->children[i]->startingTime = tmpLatestTime;
        firstJoint->children[i]->endTime = tmpLatestTime+firstJoint->children[i]->duration;
      } 

  // returning to the TrackElement we were working on.
  this->workOn(tmpCurrentWorkingID);
}

/**
   \brief finalizes the TrackSystem. after this it will not be editable anymore

   \todo check for any inconsistencies, output errors
*/
void TrackManager::finalize(void)
{
  for (int i = 1; i<= trackElemCount ;i++)
    {
      TrackElement* tmpElem = findTrackElementByID(i);
      if (tmpElem->childCount>0 && tmpElem->mainJoin)
        {
          for (int j = 0; j < tmpElem->childCount; j++)
            {
              
              // c1-continuity
              tmpElem->children[j]->curve->addNode(tmpElem->children[j]->curve->getNode(0) +
                                                   ((tmpElem->children[j]->curve->getNode(0) - 
                                                    tmpElem->curve->getNode(tmpElem->curve->getNodeCount()-1))
                                                    ),2);
              tmpElem->children[j]->nodeCount++;
              // c2-continuity
              tmpElem->children[j]->curve->addNode((tmpElem->curve->getNode(tmpElem->curve->getNodeCount())-
                                                    tmpElem->curve->getNode(tmpElem->curve->getNodeCount()-1)) * 4 +
                                                   tmpElem->curve->getNode(tmpElem->curve->getNodeCount()-2), 3);
              tmpElem->children[j]->nodeCount++;                                                    
              printf("accelerations: %d-in: count: %d, %f, %f, %f\n                  %d-out: count: %d %f, %f, %f\n",
                     tmpElem->ID, tmpElem->nodeCount,
                     tmpElem->curve->calcAcc(0.999).x, tmpElem->curve->calcAcc(0.999).y, tmpElem->curve->calcAcc(0.999).z,
                     tmpElem->children[j]->ID, tmpElem->children[j]->nodeCount,
                     tmpElem->children[j]->curve->calcAcc(0).x, tmpElem->children[j]->curve->calcAcc(0).y, tmpElem->children[j]->curve->calcAcc(0).z);
            }
        }
    }
}


// RUNTIME //

/**
   \brief calculates the Position for the localTime of the Track.
   \returns the calculated Position
*/
Vector TrackManager::calcPos() const
{
  //  PRINTF(0)("TrackElement:%d, localTime: %f\n",this->currentTrackElem->ID, this->localTime);
  return this->currentTrackElem->curve->calcPos((this->localTime-this->currentTrackElem->startingTime)/this->currentTrackElem->duration);
}

/**
   \brief calculates the Rotation for the localTime of the Track.
   \returns the calculated Rotation
*/
Vector TrackManager::calcDir() const
{
  return this->currentTrackElem->curve->calcDir((this->localTime - this->currentTrackElem->startingTime)/this->currentTrackElem->duration);
}

/**
   \brief Advances the local-time of the Track around dt
   \param dt The time about which to advance.

   This function also checks, if the TrackElement has to be changed.
*/
void TrackManager::tick(float dt)
{
  dt /= 1000;
  printf("CurrentTrackID: %d, LocalTime is: %f, timestep is: %f\n", this->currentTrackElem->ID, this->localTime, dt);
  if (this->localTime <= this->firstTrackElem->duration)
    this->jumpTo(this->localTime);
  this->localTime += dt;
  if (this->localTime > this->currentTrackElem->endTime
      && this->currentTrackElem->children)
    {
      if (this->currentTrackElem->jumpTime > 0) 
        this->jumpTo(this->localTime + this->currentTrackElem->jumpTime);
      this->currentTrackElem = this->currentTrackElem->children[0];
    }
  if (this->bindSlave)
    {
      Vector tmp = this->calcPos();
      Quaternion quat = Quaternion(this->calcDir(), Vector(this->currentTrackElem->curve->calcAcc((localTime-this->currentTrackElem->startingTime)/this->currentTrackElem->duration).x,1,this->currentTrackElem->curve->calcAcc((localTime-this->currentTrackElem->startingTime)/this->currentTrackElem->duration).z)); 
      this->bindSlave->setAbsCoor(&tmp);
      this->bindSlave->setAbsDir(&quat);
    }
}

/**
   \brief Jumps to a certain point on the Track.
   \param time The time on the Track to jump to.

   This should be used to Jump backwards on a Track, because moving forward means to change between the Path. (it then tries to choose the default.)
   Max is trackLengthMax.
*/
void TrackManager::jumpTo(float time)
{
  if (time == 0)
    this->currentTrackElem = this->firstTrackElem;
  this->localTime = time;
}

/**
   \brief a Function that decides which Path we should follow.
   \param graphID The Path to choose.
   
*/
void TrackManager::choosePath(int graphID)
{

}

/**
   \brief Sets the PNode, that should be moved along the Tack
   \param bindSlave the PNode to set
*/
void TrackManager::setBindSlave(PNode* bindSlave)
{
  if (!this->bindSlave)
    this->bindSlave = bindSlave;
}


// DEBUG //

/**
   \brief Imports a model of the Graph into the OpenGL-environment.
   \param dt The Iterator used in seconds for Painting the Graph.

   This is for testing facility only. Do this if you want to see the Path inside the Level.
   eventually this will all be packed into a gl-list.
*/
void TrackManager::drawGraph(float dt) const
{

  for (int i = 1; i <= trackElemCount; i++)
    {
      glBegin(GL_LINE_STRIP);
      TrackElement* tmpElem = this->findTrackElementByID(i);
      if (tmpElem->curve)
        for(float f = 0.0; f < 1.0; f+=dt)
          {
            //      printf("%f, %f, %f\n",trackManager->calcPos().x, trackManager->calcPos().y, trackManager->calcPos().z);
            Vector tmpVector = tmpElem->curve->calcPos(f);
            glVertex3f(tmpVector.x, tmpVector.y, tmpVector.z);
          }
  glEnd();
    }
}

/**
   \brief outputs debug information about the trackManager
   \param level how much debug
*/
void TrackManager::debug(unsigned int level) const
{
  printf("::CLASS TRACKMANAGER::debug information::\n");
  //  printf("Status is: %
  printf(" Consists of %d elements\n", this->trackElemCount);
  printf(" localTime is: %f\n", this->localTime);
  if (level >= 2)
    {
      for (int i = 1; i <= trackElemCount; i++)
        {
          TrackElement* tmpElem = this->findTrackElementByID(i);
          printf("  ::TrackElement:%i::", tmpElem->ID);
          if(tmpElem->name)
            printf("name:%s::", tmpElem->name);
          if(tmpElem->isFresh)
            printf("   has not jet eddited in any way\n");
          printf("\n   TimeTable: startingTime=%f; endTime=%f; duration=%f; jumpTime=%f\n", tmpElem->startingTime, tmpElem->endTime, tmpElem->duration, tmpElem->jumpTime);
          printf("   consists of %d Points\n", tmpElem->nodeCount);
          if (tmpElem->childCount == 0)
            printf("   has no child\n");            
          else if (tmpElem->childCount == 1)
            printf("   has 1 child: ==%d==\n", tmpElem->children[0]->ID);
          else if (tmpElem->childCount > 1)
            {
              printf("   has %d children: ", tmpElem->childCount);
              for(int i = 0; i < tmpElem->childCount; i++)
                printf("=%d= ", tmpElem->children[i]->ID);
              printf("\n");
            }

          if(tmpElem->isHotPoint)
            printf("   is a special Point:\n");
          if(tmpElem->isSavePoint)
            printf("    is a SavePoint\n");
          if(tmpElem->isFork)
            {
              printf("    is A Fork with with %d children.\n", tmpElem->childCount);
            }
          if(tmpElem->isJoined)
            printf("   is Joined at the End\n");
        }
    }
}

/**
   \brief loads track data from a XML Element
   \param root the element containing all track data
*/
void TrackManager::loadTrack( TiXmlElement* root)
{
        assert( root != NULL);
        
        TiXmlElement* element;
        TiXmlNode* container;
        double x, y, z, d;
        
        element = root->FirstChildElement();
        
        while( element != NULL)
        {
                if( !strcmp( element->Value(), "Point"))
                {
                        container = element->FirstChild();
                        if( container->ToText())
                        {
                                assert( container->Value() != NULL);
                                if( sscanf( container->Value(), "%lf,%lf,%lf", &x, &y, &z) == 3)
                                {
                                        PRINTF0("Loaded Point: %lf,%lf,%lf (%s)\n", x, y, z, container->Value());
                                        addPoint( Vector( x, y, z));
                                }
                                else
                                {
                                        PRINTF0("Invalid Point in Track (skipped)\n");
                                }                       
                        }
                }
                else if( !strcmp( element->Value(), "Duration"))
                {
                        container = element->FirstChild();
                        if( container->ToText())
                        {
                                assert( container->Value() != NULL);
                                if( sscanf( container->Value(), "%lf", &d) == 1)
                                {
                                        PRINTF0("Loaded Duration: %lf (%s)\n", d, container->Value());
                                        setDuration( d);
                                }
                                else
                                {
                                        PRINTF0("Invalid Duration in Track (skipped)\n");
                                }                       
                        }
                }
                else if( !strcmp( element->Value(), "SavePoint"))
                {
                        PRINTF0("Loaded Savepoint\n");
                        setSavePoint();
                }
                else if( !strcmp( element->Value(), "Fork"))
                {
                        container = element->FirstChild();
                        if( container->ToText())
                        {
                                assert( container->Value() != NULL);
                                PRINTF0("Loaded Fork: %s\n", container->Value());
                                forkS( container->Value());
                        }
                }
                else if( !strcmp( element->Value(), "Join"))
                {
                        container = element->FirstChild();
                        if( container->ToText())
                        {
                                assert( container->Value() != NULL);
                                PRINTF0("Loaded Join: %s\n", container->Value());
                                joinS( container->Value());
                        }
                }
                else if( !strcmp( element->Value(), "WorkOn"))
                {
                        container = element->FirstChild();
                        if( container->ToText())
                        {
                                assert( container->Value() != NULL);
                                PRINTF0("Loaded WorkOn: %s\n", container->Value());
                                workOnS( container->Value());
                        }
                }
                
                element = element->NextSiblingElement();
        }
}

/**
   \brief forks the current track and names the resulting tracks
   \param string the names of the new tracks, separated by commas
   
   The names used have to be unique within a particular track system.
*/
void TrackManager::forkS( const char* string)
{
        // get the names for the tracks and therefore the amount of new tracks
        SubString* parts = new SubString( string);
        int *IDs;
        int n = parts->getN();
        
        assert( n != 0);
        
        IDs = new int[n];
        
        forkV( n, IDs, parts);
        
        // IDs are irrelevant when assigning string names to tracks
        delete IDs;
        delete parts;
}

/**
   \brief joins the named strings
   \param string the names of the track to be joined, separated by commas
*/
void TrackManager::joinS( const char* string)
{
        SubString* parts = new SubString( string);
        int *IDs;
        int n = parts->getN();
        
        assert( n != 0);
        
        IDs = new int[n];
        
        int d, t;
        d = 0;
        t = n;
        
        PRINTF(4)("Joining tracks:");
        
        for( int i = 0; i < n; i++)
        {
                TrackElement* element = this->findTrackElementByName(parts->getString( i));
                if( element == NULL)
                {
                        PRINTF(1)("Track name '%s' unknown, could not join\n", parts->getString( i));
                        t--;
                }
                else
                {
                        PRINTF(4)(" '%s'(%d)", parts->getString( i), element->ID);
                        IDs[d] = element->ID;
                        d++;
                }
        }
        
        PRINTF(4)("\n");

        joinV( t, IDs);
                
        delete IDs;
        delete parts;
}

/**
   \brief set the piece of track to work on
   \param string the name of the track to work on (must have been previosly set by forkS)
*/
void TrackManager::workOnS( const char* string)
{
  TrackElement* tmpElem = findTrackElementByName( string);
  if (tmpElem)
    this->currentTrackElem = tmpElem;
  else
    PRINTF(1)("TrackElement not Found, leaving unchanged\n");
  PRINTF(4)("now Working on %d\n", this->currentTrackElem->ID);
}