source: orxonox.OLD/trunk/src/story_entities/story_entity.cc @ 10715

/*
   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: Patrick Boenzli
   co-programmer:
*/


#define DEBUG_SPECIAL_MODULE DEBUG_MODULE_WORLD


#include "story_entity.h"

#include "loading/load_param.h"
#include "loading/resource_manager.h"

#include "debug.h"

ObjectListDefinition(StoryEntity);

/**
 *  default constructor initializes all needed data
 */
StoryEntity::StoryEntity ()
{
  this->registerObject(this, StoryEntity::_objectList);

  this->bInit = false;
  this->bPaused = false;
  this->bRunning = false;

  this->loadFile = "";
  this->storyID = -1;
  this->description = "";
  this->menuItemImage = "";
  this->menuScreenshoot = "";
  this->nextStoryID = WORLD_ID_GAMEEND;
  this->bMenuEntry = false;
}


/**
 *  deconstructor
 */
StoryEntity::~StoryEntity ()
{}


/**
 *  loads the Parameters of a Campaign
 * @param root: The XML-element to load from
 */
void StoryEntity::loadParams(const TiXmlElement* root)
{
  BaseObject::loadParams(root);

  LoadParam(root, "identifier", this, StoryEntity, setStoryID)
  .describe("A Unique Identifier for this StoryEntity");

  LoadParam(root, "path", this, StoryEntity, setLoadFile)
  .describe("DEPRICATED FORM OF file. The Filename of this StoryEntity (relative from the data-dir)");

  LoadParam(root, "file", this, StoryEntity, setLoadFile)
  .describe("The Filename of this StoryEntity (relative from the data-dir)");

  LoadParam(root, "nextid", this, StoryEntity, setNextStoryID)
  .describe("Sets the ID of the next StoryEntity");

  LoadParam(root, "menu-entry", this, StoryEntity, addToGameMenu)
      .describe("If this entry is 1, the world is contained in the SimpleGameMenu");



  // so we can also do these things in the Campaign. (will be overwritten from the entities file)
  LoadParam(root, "description", this, StoryEntity, setDescription)
      .describe("Sets the description of this StoryEntity");

  LoadParam(root, "menu-item-image", this, StoryEntity, setMenuItemImage)
      .describe("If this entry is 1, the world is contained in the SimpleGameMenu");

  LoadParam(root, "screenshoot", this, StoryEntity, setMenuScreenshoot)
      .describe("If this entry is 1, the world is contained in the SimpleGameMenu");

  PRINTF(4)("Loaded StoryEntity specific stuff\n");
}


/**
 *  sets the track path of this world
 * @param name the name of the path
 */
void StoryEntity::setLoadFile(const std::string& fileName)
{
  if (File(fileName).isFile())
  {
    this->loadFile =  fileName;
  }
  else
    this->loadFile = Resources::ResourceManager::getInstance()->prependAbsoluteMainPath(fileName);

  this->grabWorldInfo();
}


/**
 * sets the descroption of this StoryEntity
 * @param name name
 */
void StoryEntity::setDescription(const std::string& description)
{
  this->description = description;
}

/**
 * sets the id of the next story entity: StoryEntities can choose their following entity themselfs.
 * the entity id defined here  will be startet after this entity ends. this can be convenient if you
 * want to have a non linear story with switches.
 * @param nextStoryID the story id of the next StoryEntity
 */
void StoryEntity::setNextStoryID(int nextStoryID)
{
  this->nextStoryID = nextStoryID;
}


/**
 * sets the id of the next story entity by name
 * @param nextStoryName the story name of the next StoryEntity
 */
bool StoryEntity::setNextStoryName(const std::string& nextStoryName)
{
  for (ObjectList<StoryEntity>::const_iterator it = StoryEntity::objectList().begin();
       it != StoryEntity::objectList().end();
       ++it)
    if( (*it)->getName().compare(nextStoryName) == 0)
     {
      this->setNextStoryID( (*it)->getStoryID() );
      return true;
     }

     return false;
}


/**
 * @brief grabs settings needed for displaying a MenuScreen.
 */
void StoryEntity::grabWorldInfo()
{
  PRINTF(3)("Grabbing the Worlds Settings\n", this->getLoadFile().c_str());
  if( getLoadFile().empty())
        return;
  TiXmlDocument XMLDoc(this->getLoadFile());
  // load the xml world file for further loading
  if( !XMLDoc.LoadFile())
  {
    PRINTF(1)("loading XML File: %s @ %s:l%d:c%d\n", XMLDoc.ErrorDesc(), this->getLoadFile().c_str(), XMLDoc.ErrorRow(), XMLDoc.ErrorCol());
    return;
  }
  TiXmlElement* root = XMLDoc.RootElement();
  if (root == NULL)
    return;

  if (root->Value() != NULL && !strcmp(root->Value(), "WorldDataFile"))
  {
    BaseObject::loadParams(root);

    LoadParam(root, "description", this, StoryEntity, setDescription)
    .describe("Sets the description of this StoryEntity");

    LoadParam(root, "menu-item-image", this, StoryEntity, setMenuItemImage)
    .describe("If this entry is 1, the world is contained in the SimpleGameMenu");

    LoadParam(root, "screenshoot", this, StoryEntity, setMenuScreenshoot)
    .describe("If this entry is 1, the world is contained in the SimpleGameMenu");
  }
}

/**
 * sets the menu item image of this StoryEntity
 * @param name name
 */
void StoryEntity::setMenuItemImage(const std::string& image)
{
  this->menuItemImage = image;
}


/** sets the menu screenshoot of this StoryEntity
 * @param name name
 */
void StoryEntity::setMenuScreenshoot(const std::string& image)
{
  this->menuScreenshoot = image;
}