| 1 | /* | 
|---|
| 2 |    orxonox - the future of 3D-vertical-scrollers | 
|---|
| 3 |  | 
|---|
| 4 |    Copyright (C) 2004 orx | 
|---|
| 5 |  | 
|---|
| 6 |    This program is free software; you can redistribute it and/or modify | 
|---|
| 7 |    it under the terms of the GNU General Public License as published by | 
|---|
| 8 |    the Free Software Foundation; either version 2, or (at your option) | 
|---|
| 9 |    any later version. | 
|---|
| 10 |  | 
|---|
| 11 | ### File Specific: | 
|---|
| 12 |    main-programmer: Silvan Nellen | 
|---|
| 13 |    co-programmer: Benjamin Grauer | 
|---|
| 14 | */ | 
|---|
| 15 |  | 
|---|
| 16 | #include "script.h" | 
|---|
| 17 | #include "script_class.h" | 
|---|
| 18 | #include "luaincl.h" | 
|---|
| 19 | #include "debug.h" | 
|---|
| 20 |  | 
|---|
| 21 | #include "loading/resource_manager.h" | 
|---|
| 22 | #include "loading/load_param.h" | 
|---|
| 23 | #include "parser/tinyxml/tinyxml.h" | 
|---|
| 24 |  | 
|---|
| 25 | ObjectListDefinition(Script); | 
|---|
| 26 |  | 
|---|
| 27 |  | 
|---|
| 28 | Script::Script(const TiXmlElement* root) | 
|---|
| 29 | { | 
|---|
| 30 |   this->registerObject(this, Script::_objectList); | 
|---|
| 31 |  | 
|---|
| 32 |   returnCount = argumentCount = 0; | 
|---|
| 33 |  | 
|---|
| 34 |   luaState = lua_open(); | 
|---|
| 35 |  | 
|---|
| 36 |   luaopen_base(luaState); | 
|---|
| 37 |   luaopen_table(luaState); | 
|---|
| 38 |   luaopen_io(luaState); | 
|---|
| 39 |   luaopen_string(luaState); | 
|---|
| 40 |   luaopen_math(luaState); | 
|---|
| 41 |   luaopen_debug(luaState); | 
|---|
| 42 |   if (root != NULL) | 
|---|
| 43 |     this->loadParams(root); | 
|---|
| 44 | } | 
|---|
| 45 |  | 
|---|
| 46 |  | 
|---|
| 47 | Script::Script(const std::string& filename) | 
|---|
| 48 | { | 
|---|
| 49 |   this->registerObject(this, Script::_objectList); | 
|---|
| 50 |  | 
|---|
| 51 |   returnCount = argumentCount = 0; | 
|---|
| 52 |  | 
|---|
| 53 |   luaState = lua_open(); | 
|---|
| 54 |  | 
|---|
| 55 |   luaopen_base(luaState); | 
|---|
| 56 |   luaopen_table(luaState); | 
|---|
| 57 |   luaopen_io(luaState); | 
|---|
| 58 |   luaopen_string(luaState); | 
|---|
| 59 |   luaopen_math(luaState); | 
|---|
| 60 |   luaopen_debug(luaState); | 
|---|
| 61 |  | 
|---|
| 62 |   this->loadFile(filename); | 
|---|
| 63 |  | 
|---|
| 64 | } | 
|---|
| 65 |  | 
|---|
| 66 | Script::~Script() | 
|---|
| 67 | { | 
|---|
| 68 |   lua_setgcthreshold(luaState, 0);  // collected garbage | 
|---|
| 69 |   lua_close(luaState); | 
|---|
| 70 | } | 
|---|
| 71 |  | 
|---|
| 72 |  | 
|---|
| 73 | void Script::loadParams(const TiXmlElement* root) | 
|---|
| 74 | { | 
|---|
| 75 |   //printf(("Loading params for %p \n",this); | 
|---|
| 76 |   BaseObject::loadParams(root); | 
|---|
| 77 |  | 
|---|
| 78 |  LOAD_PARAM_START_CYCLE(root, object); | 
|---|
| 79 |   { | 
|---|
| 80 |     LoadParam_CYCLE(object, "object", this, Script, addObject) | 
|---|
| 81 |        .describe("The name of an object that is needed by a script"); | 
|---|
| 82 |   } | 
|---|
| 83 |  LOAD_PARAM_END_CYCLE(object); | 
|---|
| 84 |  | 
|---|
| 85 |  | 
|---|
| 86 |   LoadParam(root, "file", this, Script, loadFileNoRet) | 
|---|
| 87 |       .describe("the fileName of the script, that should be loaded into this world") | 
|---|
| 88 |       .defaultValues(""); | 
|---|
| 89 | } | 
|---|
| 90 |  | 
|---|
| 91 |  | 
|---|
| 92 |  | 
|---|
| 93 | bool Script::loadFile(const std::string& filename) | 
|---|
| 94 |  { | 
|---|
| 95 |    std::string filedest(Resources::ResourceManager::getInstance()->mainGlobalPath().name()); | 
|---|
| 96 |  | 
|---|
| 97 |    std::string directory = ""; | 
|---|
| 98 |    std::string file = filename; | 
|---|
| 99 |  | 
|---|
| 100 |    unsigned int seperation =  filename.find_last_of('/'); | 
|---|
| 101 |    if (seperation != std::string::npos) | 
|---|
| 102 |    { | 
|---|
| 103 |     directory = filename.substr( 0, seperation+1 ); | 
|---|
| 104 |     file = filename.substr( seperation+1 ); | 
|---|
| 105 |    } | 
|---|
| 106 |    filedest += "scripts/" + directory + file; | 
|---|
| 107 |  | 
|---|
| 108 |    this->addStandartObjects(); | 
|---|
| 109 |    this->registerStandartClasses(); | 
|---|
| 110 |  | 
|---|
| 111 |    if(currentFile.length() != 0) | 
|---|
| 112 |    { | 
|---|
| 113 |      printf("ERROR IN SCRIPT %s :   Could not load %s because an other file is already loaded: %s\n",currentFile.c_str(),filename.c_str(), currentFile.c_str()); | 
|---|
| 114 |      return false; | 
|---|
| 115 |     } | 
|---|
| 116 |  | 
|---|
| 117 |    int error = luaL_loadfile (luaState, filedest.c_str()); | 
|---|
| 118 |  | 
|---|
| 119 |    if(error == 0) | 
|---|
| 120 |    { | 
|---|
| 121 |      currentFile = file; | 
|---|
| 122 |      error = lua_pcall(luaState, 0, 0, 0); | 
|---|
| 123 |  | 
|---|
| 124 |      if(error == 0) | 
|---|
| 125 |      { | 
|---|
| 126 |       return true; | 
|---|
| 127 |      } | 
|---|
| 128 |      else | 
|---|
| 129 |      { | 
|---|
| 130 |        reportError(error); | 
|---|
| 131 |      } | 
|---|
| 132 |  | 
|---|
| 133 |    } | 
|---|
| 134 |    else | 
|---|
| 135 |    { | 
|---|
| 136 |      reportError(error); | 
|---|
| 137 |    } | 
|---|
| 138 |  | 
|---|
| 139 |    printf("ERROR IN SCRIPT:  Could not load file %s \n",filename.c_str()); | 
|---|
| 140 |    return false; | 
|---|
| 141 |  } | 
|---|
| 142 |  | 
|---|
| 143 |  | 
|---|
| 144 |  void Script::addObject(const std::string& className, const std::string& objectName) | 
|---|
| 145 |  { | 
|---|
| 146 |    //printf(("Script %s: I am about to add %s of class %s\n",this->getName(),objectName.c_str(),className.c_str()); | 
|---|
| 147 |  | 
|---|
| 148 |    ScriptClass* scriptClass = ScriptClass::objectList().getObject(className); | 
|---|
| 149 |   // printf(("The script class for %s is at %p \n",className.c_str(),scriptClass); | 
|---|
| 150 |    WorldObject tmpObj; | 
|---|
| 151 |    if (scriptClass != NULL) | 
|---|
| 152 |    { | 
|---|
| 153 |      tmpObj.type = className; | 
|---|
| 154 |      if( !classIsRegistered(className) ) | 
|---|
| 155 |      { | 
|---|
| 156 |        scriptClass->registerClass(this); | 
|---|
| 157 |      } | 
|---|
| 158 |  | 
|---|
| 159 |      BaseObject* object = ObjectListBase::getBaseObject(className, objectName); | 
|---|
| 160 |     // printf(("%s is at %p \n",objectName.c_str(),object); | 
|---|
| 161 |      if (object != NULL && !objectIsAdded(objectName)) | 
|---|
| 162 |      { | 
|---|
| 163 |         scriptClass->insertObject(this, object, false); | 
|---|
| 164 |         tmpObj.name = objectName; | 
|---|
| 165 |         registeredObjects.push_back(tmpObj); | 
|---|
| 166 |         return; | 
|---|
| 167 |      } | 
|---|
| 168 |    } | 
|---|
| 169 |    printf("ERROR IN SCRIPT %s: Could not add %s of class %s\n",this->currentFile.c_str(),objectName.c_str(),className.c_str()); | 
|---|
| 170 |  } | 
|---|
| 171 |  | 
|---|
| 172 |  | 
|---|
| 173 | void Script::addObjectAsName( const std::string& className, const std::string& objectName, const std::string& nameInScript) | 
|---|
| 174 |  { | 
|---|
| 175 |    ScriptClass* scriptClass = ScriptClass::objectList().getObject(className); | 
|---|
| 176 |    WorldObject tmpObj; | 
|---|
| 177 |    if (scriptClass != NULL) | 
|---|
| 178 |    { | 
|---|
| 179 |      tmpObj.type = className; | 
|---|
| 180 |      if( !classIsRegistered(className) ) | 
|---|
| 181 |      { | 
|---|
| 182 |        scriptClass->registerClass(this); | 
|---|
| 183 |      } | 
|---|
| 184 |      BaseObject* object = ObjectListBase::getBaseObject(className, objectName); | 
|---|
| 185 |      if (object != NULL && !objectIsAdded(objectName)) | 
|---|
| 186 |      { | 
|---|
| 187 |         scriptClass->insertObject(this, object,nameInScript, false); | 
|---|
| 188 |         tmpObj.name = objectName; | 
|---|
| 189 |         registeredObjects.push_back(tmpObj); | 
|---|
| 190 |         return; | 
|---|
| 191 |      } | 
|---|
| 192 |    } | 
|---|
| 193 |    printf("ERROR IN SCRIPT %s: Could not add %s of class %s\n",this->currentFile.c_str(),objectName.c_str(),className.c_str()); | 
|---|
| 194 |  } | 
|---|
| 195 |  | 
|---|
| 196 |  | 
|---|
| 197 |  | 
|---|
| 198 |  bool Script::executeFile() | 
|---|
| 199 |  { | 
|---|
| 200 |    PRINTF(2)("script.executeFile is not implemented yet\n"); | 
|---|
| 201 |    /*if(currentFile.length() != 0) | 
|---|
| 202 |    { | 
|---|
| 203 |     int error = lua_pcall(luaState, 0, 0, 0); | 
|---|
| 204 |     if( error == 0) | 
|---|
| 205 |       return true; | 
|---|
| 206 |      else | 
|---|
| 207 |       { | 
|---|
| 208 |        reportError(error); | 
|---|
| 209 |        return false; | 
|---|
| 210 |       } | 
|---|
| 211 |  }*/ | 
|---|
| 212 |    return false; | 
|---|
| 213 |  } | 
|---|
| 214 |  | 
|---|
| 215 |  bool Script::selectFunction(const std::string& functionName, int retCount) | 
|---|
| 216 |  { | 
|---|
| 217 |    if(returnCount == 0 && currentFunction.length() == 0) //no return values left on the stack and no other function selected | 
|---|
| 218 |    { | 
|---|
| 219 |    lua_pushlstring(luaState, functionName.c_str(), functionName.size() ); | 
|---|
| 220 |    lua_gettable(luaState, LUA_GLOBALSINDEX); | 
|---|
| 221 |  | 
|---|
| 222 |    if(lua_isfunction( luaState , -1)) | 
|---|
| 223 |    { | 
|---|
| 224 |      returnCount = retCount; | 
|---|
| 225 |      argumentCount = 0; | 
|---|
| 226 |      currentFunction = functionName; | 
|---|
| 227 |      return true; | 
|---|
| 228 |    } | 
|---|
| 229 |    else | 
|---|
| 230 |     return false; | 
|---|
| 231 |    } | 
|---|
| 232 |    else | 
|---|
| 233 |      printf("ERROR IN SCRIPT %s :   There is an other function active ( %s ) or there are unremoved return values on the stack. Please remove them first.\n",currentFile.c_str(),currentFunction.c_str()); | 
|---|
| 234 |    return false; | 
|---|
| 235 |  } | 
|---|
| 236 |  | 
|---|
| 237 |  //return number of returned values | 
|---|
| 238 |  bool Script::executeFunction() | 
|---|
| 239 |  { | 
|---|
| 240 |    if(currentFunction.length() != 0 ) | 
|---|
| 241 |    { | 
|---|
| 242 |     int error = lua_pcall(luaState, argumentCount, returnCount,0); | 
|---|
| 243 |     if(error != 0) | 
|---|
| 244 |     { | 
|---|
| 245 |       PRINTF(1)("Script '%s' : Failed to execute function '%s': \n",currentFile.c_str(),currentFunction.c_str()); | 
|---|
| 246 |      reportError(error); | 
|---|
| 247 |      //clean up | 
|---|
| 248 |      currentFunction.assign(""); | 
|---|
| 249 |      argumentCount = returnCount = 0; | 
|---|
| 250 |      return false; | 
|---|
| 251 |     } | 
|---|
| 252 |     else | 
|---|
| 253 |     { | 
|---|
| 254 |       currentFunction.assign("");//a function gets unusable after beeing called for the first time | 
|---|
| 255 |       argumentCount = 0; | 
|---|
| 256 |       return true; | 
|---|
| 257 |     } | 
|---|
| 258 |    } | 
|---|
| 259 |    else | 
|---|
| 260 |      PRINTF(1)("SCRIPT '%s' : No function selected.\n",currentFile.c_str()); | 
|---|
| 261 |  | 
|---|
| 262 |    return false; | 
|---|
| 263 |  } | 
|---|
| 264 |  | 
|---|
| 265 |  | 
|---|
| 266 |  //overload this function to add different types | 
|---|
| 267 |  bool Script::pushParam(int param, std::string& toFunction) | 
|---|
| 268 |  { | 
|---|
| 269 |    if(currentFunction == toFunction) | 
|---|
| 270 |    { | 
|---|
| 271 |      lua_pushnumber(luaState, (lua_Number) param); | 
|---|
| 272 |      argumentCount++; | 
|---|
| 273 |      return true; | 
|---|
| 274 |    } | 
|---|
| 275 |    else | 
|---|
| 276 |    { | 
|---|
| 277 |      printf("ERROR IN SCRIPT %s :   Couldn't add parameter because the wrong function is selected: %s instead of %s\n",currentFile.c_str(), currentFunction.c_str(), toFunction.c_str()); | 
|---|
| 278 |     return false; | 
|---|
| 279 |    } | 
|---|
| 280 |  | 
|---|
| 281 |  } | 
|---|
| 282 |  | 
|---|
| 283 |  | 
|---|
| 284 |  bool Script::pushParam(float param, std::string& toFunction) | 
|---|
| 285 |  { | 
|---|
| 286 |    if(currentFunction.compare(toFunction) == 0) | 
|---|
| 287 |    { | 
|---|
| 288 |      lua_pushnumber(luaState,(lua_Number) param); | 
|---|
| 289 |      argumentCount++; | 
|---|
| 290 |      return true; | 
|---|
| 291 |    } | 
|---|
| 292 |    else | 
|---|
| 293 |    { | 
|---|
| 294 |      printf("ERROR IN SCRIPT %s :   Couldn't add parameter because the wrong function is selected: %s instead of %s\n",currentFile.c_str(), currentFunction.c_str(), toFunction.c_str()); | 
|---|
| 295 |      return false; | 
|---|
| 296 |    } | 
|---|
| 297 |  | 
|---|
| 298 |  } | 
|---|
| 299 |  | 
|---|
| 300 |  bool Script::pushParam(double param, std::string& toFunction) | 
|---|
| 301 |  { | 
|---|
| 302 |    if(currentFunction.compare(toFunction) == 0) | 
|---|
| 303 |    { | 
|---|
| 304 |      lua_pushnumber(luaState,(lua_Number) param); | 
|---|
| 305 |      argumentCount++; | 
|---|
| 306 |      return true; | 
|---|
| 307 |    } | 
|---|
| 308 |    else | 
|---|
| 309 |    { | 
|---|
| 310 |      printf("ERROR IN SCRIPT %s :  Couldn't add parameter because the wrong function is selected: %s instead of %s\n",currentFile.c_str(), currentFunction.c_str(), toFunction.c_str()); | 
|---|
| 311 |      return false; | 
|---|
| 312 |    } | 
|---|
| 313 |  | 
|---|
| 314 |  } | 
|---|
| 315 |  | 
|---|
| 316 |  int Script::getReturnedInt() | 
|---|
| 317 |  { | 
|---|
| 318 |    int returnValue = 0; | 
|---|
| 319 |    if(returnCount > 0) | 
|---|
| 320 |    { | 
|---|
| 321 |      if(lua_isnumber(luaState, -1*returnCount)) | 
|---|
| 322 |      { | 
|---|
| 323 |        returnValue = (int)lua_tonumber(luaState, -1*returnCount); | 
|---|
| 324 |        lua_remove(luaState,-1*returnCount); | 
|---|
| 325 |        returnCount--; | 
|---|
| 326 |  | 
|---|
| 327 |      } | 
|---|
| 328 |    } | 
|---|
| 329 |    return returnValue; | 
|---|
| 330 |  } | 
|---|
| 331 |  | 
|---|
| 332 |  | 
|---|
| 333 |  bool Script::getReturnedBool() | 
|---|
| 334 |  { | 
|---|
| 335 |    bool returnValue = false; | 
|---|
| 336 |    if(returnCount > 0) | 
|---|
| 337 |    { | 
|---|
| 338 |      if(lua_isboolean(luaState, -1*returnCount)) | 
|---|
| 339 |      { | 
|---|
| 340 |        returnValue = (bool)lua_toboolean(luaState, -1*returnCount); | 
|---|
| 341 |        lua_remove(luaState,-1*returnCount); | 
|---|
| 342 |        returnCount--; | 
|---|
| 343 |      } | 
|---|
| 344 |      else | 
|---|
| 345 |        printf("ERROR IN SCRIPT %s :  Trying to retreive non bolean value\n",this->currentFile.c_str()); | 
|---|
| 346 |    } | 
|---|
| 347 |    return returnValue; | 
|---|
| 348 |  } | 
|---|
| 349 |  | 
|---|
| 350 | float Script::getReturnedFloat() | 
|---|
| 351 |  { | 
|---|
| 352 |    float returnValue = 0.0f; | 
|---|
| 353 |    if(returnCount > 0) | 
|---|
| 354 |    { | 
|---|
| 355 |      if(lua_isnumber(luaState, -1*returnCount)) | 
|---|
| 356 |      { | 
|---|
| 357 |        returnValue = (float)lua_tonumber(luaState, -1*returnCount); | 
|---|
| 358 |        lua_remove(luaState,-1*returnCount); | 
|---|
| 359 |        returnCount--; | 
|---|
| 360 |      } | 
|---|
| 361 |    } | 
|---|
| 362 |    return returnValue; | 
|---|
| 363 |  } | 
|---|
| 364 |  | 
|---|
| 365 |  void Script::getReturnedString(std::string& string) | 
|---|
| 366 |  { | 
|---|
| 367 |    const char* returnValue = ""; | 
|---|
| 368 |    if(returnCount > 0) | 
|---|
| 369 |    { | 
|---|
| 370 |      if(lua_isstring(luaState, -1*returnCount)) | 
|---|
| 371 |      { | 
|---|
| 372 |        returnValue = lua_tostring(luaState, -1*returnCount); | 
|---|
| 373 |        lua_remove(luaState,-1*returnCount); | 
|---|
| 374 |        returnCount--; | 
|---|
| 375 |      } | 
|---|
| 376 |    } | 
|---|
| 377 |   string.assign(returnValue); | 
|---|
| 378 |  } | 
|---|
| 379 |  | 
|---|
| 380 |  | 
|---|
| 381 | void Script::addThisScript() | 
|---|
| 382 | { | 
|---|
| 383 |   ScriptClass* scriptClass = ScriptClass::objectList().getObject("Script"); | 
|---|
| 384 |  | 
|---|
| 385 |   if (scriptClass != NULL) | 
|---|
| 386 |    { | 
|---|
| 387 |      scriptClass->registerClass(this); | 
|---|
| 388 |      scriptClass->insertObject(this, this,"thisscript", false); | 
|---|
| 389 |    } | 
|---|
| 390 | } | 
|---|
| 391 |  | 
|---|
| 392 |  int Script::reportError(int error) | 
|---|
| 393 |  { | 
|---|
| 394 |  if(error != 0) | 
|---|
| 395 |  { | 
|---|
| 396 |   const char *msg = lua_tostring(luaState, -1); | 
|---|
| 397 |   if (msg == NULL) msg = "(error with no message)\n"; | 
|---|
| 398 |   printf("ERROR IN SCRIPT %s : %s\n",currentFile.c_str(), msg); | 
|---|
| 399 |   lua_pop(luaState, 1); | 
|---|
| 400 |  } | 
|---|
| 401 |   return error; | 
|---|
| 402 |  } | 
|---|
| 403 |  | 
|---|
| 404 |  bool Script::registerStandartClasses() | 
|---|
| 405 |  { | 
|---|
| 406 |    bool success = false; | 
|---|
| 407 |  | 
|---|
| 408 |     this->registerClass("SpaceTrigger"); | 
|---|
| 409 |     this->registerClass("TickTrigger"); | 
|---|
| 410 |     this->registerClass("TimeTrigger"); | 
|---|
| 411 |  | 
|---|
| 412 |    return success; | 
|---|
| 413 |  } | 
|---|
| 414 |  | 
|---|
| 415 | bool Script::addStandartObjects() | 
|---|
| 416 |  { | 
|---|
| 417 |    bool success = true; | 
|---|
| 418 |  | 
|---|
| 419 |    this->addThisScript(); | 
|---|
| 420 |  | 
|---|
| 421 |    return success; | 
|---|
| 422 |  } | 
|---|
| 423 |  | 
|---|
| 424 |  | 
|---|
| 425 |  void Script::registerClass( const std::string& className) | 
|---|
| 426 |  { | 
|---|
| 427 |    ScriptClass* scriptClass = ScriptClass::objectList().getObject(className); | 
|---|
| 428 |    //printf(("The script class for %s is at %p \n",className.c_str(),scriptClass); | 
|---|
| 429 |  | 
|---|
| 430 |    WorldObject tmpObj; | 
|---|
| 431 |    if (scriptClass != NULL) | 
|---|
| 432 |    { | 
|---|
| 433 |      tmpObj.type = className; | 
|---|
| 434 |      if( !classIsRegistered(className) ) | 
|---|
| 435 |      { | 
|---|
| 436 |        static_cast<ScriptClass*>(scriptClass)->registerClass(this); | 
|---|
| 437 |        tmpObj.name = ""; | 
|---|
| 438 |        registeredObjects.push_back(tmpObj); | 
|---|
| 439 |        return; | 
|---|
| 440 |      } | 
|---|
| 441 |    } | 
|---|
| 442 |  | 
|---|
| 443 |  } | 
|---|
| 444 |  | 
|---|
| 445 |  bool Script::classIsRegistered(const std::string& type) | 
|---|
| 446 |  { | 
|---|
| 447 |    for(std::list<WorldObject>::const_iterator it = registeredObjects.begin(); it != registeredObjects.end(); it++ ) | 
|---|
| 448 |    { | 
|---|
| 449 |      if( (*it).type == type) | 
|---|
| 450 |      { | 
|---|
| 451 |        return true; | 
|---|
| 452 |      } | 
|---|
| 453 |    } | 
|---|
| 454 |    return false; | 
|---|
| 455 |  } | 
|---|
| 456 |  | 
|---|
| 457 |  | 
|---|
| 458 |  | 
|---|
| 459 |  bool Script::objectIsAdded(const std::string& name) | 
|---|
| 460 |  { | 
|---|
| 461 |    for(std::list<WorldObject>::const_iterator it = registeredObjects.begin(); it != registeredObjects.end(); it++ ) | 
|---|
| 462 |    { | 
|---|
| 463 |      if( (*it).name == name) | 
|---|
| 464 |      { | 
|---|
| 465 |        return true; | 
|---|
| 466 |      } | 
|---|
| 467 |    } | 
|---|
| 468 |    return false; | 
|---|
| 469 |  | 
|---|
| 470 |  | 
|---|
| 471 |  } | 
|---|