Script.cpp 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730
  1. //
  2. // Copyright (c) 2008-2014 the Urho3D project.
  3. //
  4. // Permission is hereby granted, free of charge, to any person obtaining a copy
  5. // of this software and associated documentation files (the "Software"), to deal
  6. // in the Software without restriction, including without limitation the rights
  7. // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  8. // copies of the Software, and to permit persons to whom the Software is
  9. // furnished to do so, subject to the following conditions:
  10. //
  11. // The above copyright notice and this permission notice shall be included in
  12. // all copies or substantial portions of the Software.
  13. //
  14. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  17. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  18. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  19. // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  20. // THE SOFTWARE.
  21. //
  22. #include "Precompiled.h"
  23. #include "Addons.h"
  24. #include "Context.h"
  25. #include "EngineEvents.h"
  26. #include "File.h"
  27. #include "FileSystem.h"
  28. #include "Log.h"
  29. #include "Profiler.h"
  30. #include "Scene.h"
  31. #include "Script.h"
  32. #include "ScriptAPI.h"
  33. #include "ScriptFile.h"
  34. #include "ScriptInstance.h"
  35. #include <angelscript.h>
  36. #include "DebugNew.h"
  37. namespace Urho3D
  38. {
  39. /// %Object property info for scripting API dump.
  40. struct PropertyInfo
  41. {
  42. /// Construct.
  43. PropertyInfo() :
  44. read_(false),
  45. write_(false),
  46. indexed_(false)
  47. {
  48. }
  49. /// Property name.
  50. String name_;
  51. /// Property data type.
  52. String type_;
  53. /// Reading supported flag.
  54. bool read_;
  55. /// Writing supported flag.
  56. bool write_;
  57. /// Indexed flag.
  58. bool indexed_;
  59. };
  60. void ExtractPropertyInfo(const String& functionName, const String& declaration, Vector<PropertyInfo>& propertyInfos)
  61. {
  62. String propertyName = functionName.Substring(4);
  63. PropertyInfo* info = 0;
  64. for (unsigned k = 0; k < propertyInfos.Size(); ++k)
  65. {
  66. if (propertyInfos[k].name_ == propertyName)
  67. {
  68. info = &propertyInfos[k];
  69. break;
  70. }
  71. }
  72. if (!info)
  73. {
  74. propertyInfos.Resize(propertyInfos.Size() + 1);
  75. info = &propertyInfos.Back();
  76. info->name_ = propertyName;
  77. }
  78. if (functionName.Contains("get_"))
  79. {
  80. info->read_ = true;
  81. // Extract type from the return value
  82. Vector<String> parts = declaration.Split(' ');
  83. if (parts.Size())
  84. {
  85. if (parts[0] != "const")
  86. info->type_ = parts[0];
  87. else if (parts.Size() > 1)
  88. info->type_ = parts[1];
  89. }
  90. // If get method has parameters, it is indexed
  91. if (!declaration.Contains("()"))
  92. {
  93. info->indexed_ = true;
  94. info->type_ += "[]";
  95. }
  96. // Sanitate the reference operator away
  97. info->type_.Replace("&", "");
  98. }
  99. if (functionName.Contains("set_"))
  100. {
  101. info->write_ = true;
  102. if (info->type_.Empty())
  103. {
  104. // Extract type from parameters
  105. unsigned begin = declaration.Find(',');
  106. if (begin == String::NPOS)
  107. begin = declaration.Find('(');
  108. else
  109. info->indexed_ = true;
  110. if (begin != String::NPOS)
  111. {
  112. ++begin;
  113. unsigned end = declaration.Find(')');
  114. if (end != String::NPOS)
  115. {
  116. info->type_ = declaration.Substring(begin, end - begin);
  117. // Sanitate const & reference operator away
  118. info->type_.Replace("const ", "");
  119. info->type_.Replace("&in", "");
  120. info->type_.Replace("&", "");
  121. }
  122. }
  123. }
  124. }
  125. }
  126. bool ComparePropertyStrings(const String& lhs, const String& rhs)
  127. {
  128. int spaceLhs = lhs.Find(' ');
  129. int spaceRhs = rhs.Find(' ');
  130. if (spaceLhs != String::NPOS && spaceRhs != String::NPOS)
  131. return String::Compare(lhs.CString() + spaceLhs, rhs.CString() + spaceRhs, true) < 0;
  132. else
  133. return String::Compare(lhs.CString(), rhs.CString(), true) < 0;
  134. }
  135. bool ComparePropertyInfos(const PropertyInfo& lhs, const PropertyInfo& rhs)
  136. {
  137. return String::Compare(lhs.name_.CString(), rhs.name_.CString(), true) < 0;
  138. }
  139. Script::Script(Context* context) :
  140. Object(context),
  141. scriptEngine_(0),
  142. immediateContext_(0),
  143. scriptNestingLevel_(0),
  144. executeConsoleCommands_(true)
  145. {
  146. scriptEngine_ = asCreateScriptEngine(ANGELSCRIPT_VERSION);
  147. if (!scriptEngine_)
  148. {
  149. LOGERROR("Could not create AngelScript engine");
  150. return;
  151. }
  152. scriptEngine_->SetUserData(this);
  153. scriptEngine_->SetEngineProperty(asEP_USE_CHARACTER_LITERALS, true);
  154. scriptEngine_->SetEngineProperty(asEP_ALLOW_UNSAFE_REFERENCES, true);
  155. scriptEngine_->SetEngineProperty(asEP_ALLOW_IMPLICIT_HANDLE_TYPES, true);
  156. scriptEngine_->SetEngineProperty(asEP_BUILD_WITHOUT_LINE_CUES, true);
  157. scriptEngine_->SetMessageCallback(asMETHOD(Script, MessageCallback), this, asCALL_THISCALL);
  158. // Create the context for immediate execution
  159. immediateContext_ = scriptEngine_->CreateContext();
  160. immediateContext_->SetExceptionCallback(asMETHOD(Script, ExceptionCallback), this, asCALL_THISCALL);
  161. // Register Script library object factories
  162. RegisterScriptLibrary(context_);
  163. // Register the Array, String & Dictionary API
  164. RegisterArray(scriptEngine_);
  165. RegisterString(scriptEngine_);
  166. RegisterDictionary(scriptEngine_);
  167. // Register the rest of the script API
  168. RegisterMathAPI(scriptEngine_);
  169. RegisterCoreAPI(scriptEngine_);
  170. RegisterIOAPI(scriptEngine_);
  171. RegisterResourceAPI(scriptEngine_);
  172. RegisterSceneAPI(scriptEngine_);
  173. RegisterGraphicsAPI(scriptEngine_);
  174. RegisterInputAPI(scriptEngine_);
  175. RegisterAudioAPI(scriptEngine_);
  176. RegisterUIAPI(scriptEngine_);
  177. RegisterNetworkAPI(scriptEngine_);
  178. RegisterPhysicsAPI(scriptEngine_);
  179. RegisterNavigationAPI(scriptEngine_);
  180. RegisterLogicAPI(scriptEngine_);
  181. RegisterUrho2DAPI(scriptEngine_);
  182. RegisterScriptAPI(scriptEngine_);
  183. RegisterEngineAPI(scriptEngine_);
  184. // Subscribe to console commands
  185. SubscribeToEvent(E_CONSOLECOMMAND, HANDLER(Script, HandleConsoleCommand));
  186. }
  187. Script::~Script()
  188. {
  189. if (immediateContext_)
  190. {
  191. immediateContext_->Release();
  192. immediateContext_ = 0;
  193. }
  194. for (unsigned i = 0 ; i < scriptFileContexts_.Size(); ++i)
  195. scriptFileContexts_[i]->Release();
  196. if (scriptEngine_)
  197. {
  198. scriptEngine_->Release();
  199. scriptEngine_ = 0;
  200. }
  201. }
  202. bool Script::Execute(const String& line)
  203. {
  204. // Note: compiling code each time is slow. Not to be used for performance-critical or repeating activity
  205. PROFILE(ExecuteImmediate);
  206. ClearObjectTypeCache();
  207. String wrappedLine = "void f(){\n" + line + ";\n}";
  208. // If no immediate mode script file set, create a dummy module for compiling the line
  209. asIScriptModule* module = 0;
  210. if (defaultScriptFile_)
  211. module = defaultScriptFile_->GetScriptModule();
  212. if (!module)
  213. module = scriptEngine_->GetModule("ExecuteImmediate", asGM_CREATE_IF_NOT_EXISTS);
  214. if (!module)
  215. return false;
  216. asIScriptFunction *function = 0;
  217. if (module->CompileFunction("", wrappedLine.CString(), -1, 0, &function) < 0)
  218. return false;
  219. if (immediateContext_->Prepare(function) < 0)
  220. {
  221. function->Release();
  222. return false;
  223. }
  224. bool success = immediateContext_->Execute() >= 0;
  225. immediateContext_->Unprepare();
  226. function->Release();
  227. return success;
  228. }
  229. void Script::SetDefaultScriptFile(ScriptFile* file)
  230. {
  231. defaultScriptFile_ = file;
  232. }
  233. void Script::SetDefaultScene(Scene* scene)
  234. {
  235. defaultScene_ = scene;
  236. }
  237. void Script::SetExecuteConsoleCommands(bool enable)
  238. {
  239. executeConsoleCommands_ = enable;
  240. }
  241. void Script::DumpAPI(DumpMode mode)
  242. {
  243. // Does not use LOGRAW macro here to ensure the messages are always dumped regardless of ENABLE_LOGGING compiler directive and of Log subsystem availability
  244. if (mode == DOXYGEN)
  245. Log::WriteRaw("namespace Urho3D\n{\n\n/**\n\\page ScriptAPI Scripting API\n\n");
  246. else if (mode == C_HEADER)
  247. Log::WriteRaw("// Script API header intended to be 'force included' in IDE for AngelScript content assist / code completion\n\n"
  248. "#define int8 signed char\n"
  249. "#define int16 signed short\n"
  250. "#define int64 long\n"
  251. "#define uint8 unsigned char\n"
  252. "#define uint16 unsigned short\n"
  253. "#define uint64 unsigned long\n"
  254. "#define null 0\n");
  255. if (mode == DOXYGEN)
  256. Log::WriteRaw("\\section ScriptAPI_Classes Classes\n");
  257. else if (mode == C_HEADER)
  258. Log::WriteRaw("\n// Classes\n");
  259. unsigned types = scriptEngine_->GetObjectTypeCount();
  260. Vector<Pair<String, unsigned> > sortedTypes;
  261. for (unsigned i = 0; i < types; ++i)
  262. {
  263. asIObjectType* type = scriptEngine_->GetObjectTypeByIndex(i);
  264. if (type)
  265. {
  266. String typeName(type->GetName());
  267. sortedTypes.Push(MakePair(typeName, i));
  268. }
  269. }
  270. Sort(sortedTypes.Begin(), sortedTypes.End());
  271. for (unsigned i = 0; i < sortedTypes.Size(); ++i)
  272. {
  273. asIObjectType* type = scriptEngine_->GetObjectTypeByIndex(sortedTypes[i].second_);
  274. if (type)
  275. {
  276. String typeName(type->GetName());
  277. Vector<String> methodDeclarations;
  278. Vector<PropertyInfo> propertyInfos;
  279. if (mode == DOXYGEN)
  280. Log::WriteRaw("\n### " + typeName + "\n");
  281. else if (mode == C_HEADER)
  282. {
  283. ///\todo Find a cleaner way to do this instead of hardcoding
  284. if (typeName == "Array")
  285. Log::WriteRaw("\ntemplate <class T> class " + typeName + "\n{\n");
  286. else
  287. Log::WriteRaw("\nclass " + typeName + "\n{\n");
  288. }
  289. unsigned methods = type->GetMethodCount();
  290. for (unsigned j = 0; j < methods; ++j)
  291. {
  292. asIScriptFunction* method = type->GetMethodByIndex(j);
  293. String methodName(method->GetName());
  294. String declaration(method->GetDeclaration());
  295. if (methodName.Contains("get_") || methodName.Contains("set_"))
  296. ExtractPropertyInfo(methodName, declaration, propertyInfos);
  297. else
  298. {
  299. // Sanitate the method name. \todo For now, skip the operators
  300. if (!declaration.Contains("::op"))
  301. {
  302. String prefix(typeName + "::");
  303. declaration.Replace(prefix, "");
  304. ///\todo Is there a better way to mark deprecated API bindings for AngelScript?
  305. unsigned posBegin = declaration.FindLast("const String&in = \"deprecated:");
  306. if (posBegin != String::NPOS)
  307. {
  308. // Assume this 'mark' is added as the last parameter
  309. unsigned posEnd = declaration.Find(')', posBegin);
  310. if (posBegin != String::NPOS)
  311. {
  312. declaration.Replace(posBegin, posEnd - posBegin, "");
  313. posBegin = declaration.Find(", ", posBegin - 2);
  314. if (posBegin != String::NPOS)
  315. declaration.Replace(posBegin, 2, "");
  316. if (mode == DOXYGEN)
  317. declaration += " // deprecated";
  318. else if (mode == C_HEADER)
  319. declaration = "/* deprecated */\n" + declaration;
  320. }
  321. }
  322. methodDeclarations.Push(declaration);
  323. }
  324. }
  325. }
  326. // Assume that the same property is never both an accessor property, and a direct one
  327. unsigned properties = type->GetPropertyCount();
  328. for (unsigned j = 0; j < properties; ++j)
  329. {
  330. const char* propertyName;
  331. const char* propertyDeclaration;
  332. int typeId;
  333. type->GetProperty(j, &propertyName, &typeId);
  334. propertyDeclaration = scriptEngine_->GetTypeDeclaration(typeId);
  335. PropertyInfo newInfo;
  336. newInfo.name_ = String(propertyName);
  337. newInfo.type_ = String(propertyDeclaration);
  338. newInfo.read_ = newInfo.write_ = true;
  339. propertyInfos.Push(newInfo);
  340. }
  341. Sort(methodDeclarations.Begin(), methodDeclarations.End(), ComparePropertyStrings);
  342. Sort(propertyInfos.Begin(), propertyInfos.End(), ComparePropertyInfos);
  343. if (!methodDeclarations.Empty())
  344. {
  345. if (mode == DOXYGEN)
  346. Log::WriteRaw("\nMethods:\n\n");
  347. else if (mode == C_HEADER)
  348. Log::WriteRaw("// Methods:\n");
  349. for (unsigned j = 0; j < methodDeclarations.Size(); ++j)
  350. OutputAPIRow(mode, methodDeclarations[j]);
  351. }
  352. if (!propertyInfos.Empty())
  353. {
  354. if (mode == DOXYGEN)
  355. Log::WriteRaw("\nProperties:\n\n");
  356. else if (mode == C_HEADER)
  357. Log::WriteRaw("\n// Properties:\n");
  358. for (unsigned j = 0; j < propertyInfos.Size(); ++j)
  359. {
  360. String remark;
  361. String cppdoc;
  362. if (!propertyInfos[j].write_)
  363. remark = "readonly";
  364. else if (!propertyInfos[j].read_)
  365. remark = "writeonly";
  366. if (!remark.Empty())
  367. {
  368. if (mode == DOXYGEN)
  369. {
  370. remark = " // " + remark;
  371. }
  372. else if (mode == C_HEADER)
  373. {
  374. cppdoc = "/* " + remark + " */\n";
  375. remark.Clear();
  376. }
  377. }
  378. OutputAPIRow(mode, cppdoc + propertyInfos[j].type_ + " " + propertyInfos[j].name_ + remark);
  379. }
  380. }
  381. if (mode == DOXYGEN)
  382. Log::WriteRaw("\n");
  383. else if (mode == C_HEADER)
  384. Log::WriteRaw("};\n");
  385. }
  386. }
  387. Vector<PropertyInfo> globalPropertyInfos;
  388. Vector<String> globalFunctions;
  389. unsigned functions = scriptEngine_->GetGlobalFunctionCount();
  390. for (unsigned i = 0; i < functions; ++i)
  391. {
  392. asIScriptFunction* function = scriptEngine_->GetGlobalFunctionByIndex(i);
  393. String functionName(function->GetName());
  394. String declaration(function->GetDeclaration());
  395. if (functionName.Contains("set_") || functionName.Contains("get_"))
  396. ExtractPropertyInfo(functionName, declaration, globalPropertyInfos);
  397. else
  398. globalFunctions.Push(declaration);
  399. }
  400. Sort(globalFunctions.Begin(), globalFunctions.End(), ComparePropertyStrings);
  401. Sort(globalPropertyInfos.Begin(), globalPropertyInfos.End(), ComparePropertyInfos);
  402. if (mode == DOXYGEN)
  403. Log::WriteRaw("\\section ScriptAPI_Enums Enumerations\n");
  404. else if (mode == C_HEADER)
  405. Log::WriteRaw("\n// Enumerations\n");
  406. unsigned enums = scriptEngine_->GetEnumCount();
  407. Vector<Pair<String, unsigned> > sortedEnums;
  408. for (unsigned i = 0; i < enums; ++i)
  409. {
  410. int typeId;
  411. sortedEnums.Push(MakePair(String(scriptEngine_->GetEnumByIndex(i, &typeId)), i));
  412. }
  413. Sort(sortedEnums.Begin(), sortedEnums.End());
  414. for (unsigned i = 0; i < sortedEnums.Size(); ++i)
  415. {
  416. int typeId;
  417. if (mode == DOXYGEN)
  418. Log::WriteRaw("\n### " + String(scriptEngine_->GetEnumByIndex(sortedEnums[i].second_, &typeId)) + "\n\n");
  419. else if (mode == C_HEADER)
  420. Log::WriteRaw("\nenum " + String(scriptEngine_->GetEnumByIndex(sortedEnums[i].second_, &typeId)) + "\n{\n");
  421. for (unsigned j = 0; j < (unsigned)scriptEngine_->GetEnumValueCount(typeId); ++j)
  422. {
  423. int value = 0;
  424. const char* name = scriptEngine_->GetEnumValueByIndex(typeId, j, &value);
  425. OutputAPIRow(mode, String(name), false, ",");
  426. }
  427. if (mode == DOXYGEN)
  428. Log::WriteRaw("\n");
  429. else if (mode == C_HEADER)
  430. Log::WriteRaw("};\n");
  431. }
  432. if (mode == DOXYGEN)
  433. Log::WriteRaw("\\section ScriptAPI_GlobalFunctions Global functions\n");
  434. else if (mode == C_HEADER)
  435. Log::WriteRaw("\n// Global functions\n");
  436. for (unsigned i = 0; i < globalFunctions.Size(); ++i)
  437. OutputAPIRow(mode, globalFunctions[i]);
  438. if (mode == DOXYGEN)
  439. Log::WriteRaw("\\section ScriptAPI_GlobalProperties Global properties\n");
  440. else if (mode == C_HEADER)
  441. Log::WriteRaw("\n// Global properties\n");
  442. for (unsigned i = 0; i < globalPropertyInfos.Size(); ++i)
  443. OutputAPIRow(mode, globalPropertyInfos[i].type_ + " " + globalPropertyInfos[i].name_, true);
  444. if (mode == DOXYGEN)
  445. Log::WriteRaw("\\section ScriptAPI_GlobalConstants Global constants\n");
  446. else if (mode == C_HEADER)
  447. Log::WriteRaw("\n// Global constants\n");
  448. Vector<String> globalConstants;
  449. unsigned properties = scriptEngine_->GetGlobalPropertyCount();
  450. for (unsigned i = 0; i < properties; ++i)
  451. {
  452. const char* propertyName;
  453. const char* propertyDeclaration;
  454. int typeId;
  455. scriptEngine_->GetGlobalPropertyByIndex(i, &propertyName, 0, &typeId);
  456. propertyDeclaration = scriptEngine_->GetTypeDeclaration(typeId);
  457. String type(propertyDeclaration);
  458. globalConstants.Push(type + " " + String(propertyName));
  459. }
  460. Sort(globalConstants.Begin(), globalConstants.End(), ComparePropertyStrings);
  461. for (unsigned i = 0; i < globalConstants.Size(); ++i)
  462. OutputAPIRow(mode, globalConstants[i], true);
  463. // Dump event descriptions in Doxygen mode. This means going through the header files, as the information is not
  464. // available otherwise
  465. if (mode == DOXYGEN)
  466. {
  467. FileSystem* fileSystem = GetSubsystem<FileSystem>();
  468. Vector<String> headerFiles;
  469. String path = fileSystem->GetProgramDir();
  470. path.Replace("/Bin", "/Source/Engine");
  471. fileSystem->ScanDir(headerFiles, path, "*.h", SCAN_FILES, true);
  472. if (!headerFiles.Empty())
  473. {
  474. Log::WriteRaw("\n\\page EventList Event list\n");
  475. Sort(headerFiles.Begin(), headerFiles.End());
  476. }
  477. for (unsigned i = 0; i < headerFiles.Size(); ++i)
  478. {
  479. if (headerFiles[i].EndsWith("Events.h"))
  480. {
  481. SharedPtr<File> file(new File(context_, path + headerFiles[i], FILE_READ));
  482. if (!file->IsOpen())
  483. continue;
  484. unsigned start = headerFiles[i].Find('/') + 1;
  485. unsigned end = headerFiles[i].Find("Events.h");
  486. Log::WriteRaw("\n## %" + headerFiles[i].Substring(start, end - start) + " events\n");
  487. while (!file->IsEof())
  488. {
  489. String line = file->ReadLine();
  490. if (line.StartsWith("EVENT"))
  491. {
  492. Vector<String> parts = line.Split(',');
  493. if (parts.Size() == 2)
  494. Log::WriteRaw("\n### " + parts[1].Substring(0, parts[1].Length() - 1).Trimmed() + "\n");
  495. }
  496. if (line.Contains("PARAM"))
  497. {
  498. Vector<String> parts = line.Split(',');
  499. if (parts.Size() == 2)
  500. {
  501. String paramName = parts[1].Substring(0, parts[1].Find(')')).Trimmed();
  502. String paramType = parts[1].Substring(parts[1].Find("// ") + 3);
  503. if (!paramName.Empty() && !paramType.Empty())
  504. Log::WriteRaw("- %" + paramName + " : " + paramType + "\n");
  505. }
  506. }
  507. }
  508. }
  509. }
  510. if (!headerFiles.Empty())
  511. Log::WriteRaw("\n");
  512. }
  513. if (mode == DOXYGEN)
  514. Log::WriteRaw("*/\n\n}\n");
  515. }
  516. void Script::MessageCallback(const asSMessageInfo* msg)
  517. {
  518. String message;
  519. message.AppendWithFormat("%s:%d,%d %s", msg->section, msg->row, msg->col, msg->message);
  520. switch (msg->type)
  521. {
  522. case asMSGTYPE_ERROR:
  523. LOGERROR(message);
  524. break;
  525. case asMSGTYPE_WARNING:
  526. LOGWARNING(message);
  527. break;
  528. default:
  529. LOGINFO(message);
  530. break;
  531. }
  532. }
  533. void Script::ExceptionCallback(asIScriptContext* context)
  534. {
  535. String message;
  536. message.AppendWithFormat("- Exception '%s' in '%s'\n%s", context->GetExceptionString(), context->GetExceptionFunction()->GetDeclaration(), GetCallStack(context).CString());
  537. asSMessageInfo msg;
  538. msg.row = context->GetExceptionLineNumber(&msg.col, &msg.section);
  539. msg.type = asMSGTYPE_ERROR;
  540. msg.message = message.CString();
  541. MessageCallback(&msg);
  542. }
  543. String Script::GetCallStack(asIScriptContext* context)
  544. {
  545. String str("AngelScript callstack:\n");
  546. // Append the call stack
  547. for (asUINT i = 0; i < context->GetCallstackSize(); i++)
  548. {
  549. asIScriptFunction* func;
  550. const char* scriptSection;
  551. int line, column;
  552. func = context->GetFunction(i);
  553. line = context->GetLineNumber(i, &column, &scriptSection);
  554. str.AppendWithFormat("\t%s:%s:%d,%d\n", scriptSection, func->GetDeclaration(), line, column);
  555. }
  556. return str;
  557. }
  558. ScriptFile* Script::GetDefaultScriptFile() const
  559. {
  560. return defaultScriptFile_;
  561. }
  562. Scene* Script::GetDefaultScene() const
  563. {
  564. return defaultScene_;
  565. }
  566. void Script::ClearObjectTypeCache()
  567. {
  568. objectTypes_.Clear();
  569. }
  570. asIObjectType* Script::GetObjectType(const char* declaration)
  571. {
  572. HashMap<const char*, asIObjectType*>::ConstIterator i = objectTypes_.Find(declaration);
  573. if (i != objectTypes_.End())
  574. return i->second_;
  575. asIObjectType* type = scriptEngine_->GetObjectTypeById(scriptEngine_->GetTypeIdByDecl(declaration));
  576. objectTypes_[declaration] = type;
  577. return type;
  578. }
  579. asIScriptContext* Script::GetScriptFileContext()
  580. {
  581. while (scriptNestingLevel_ >= scriptFileContexts_.Size())
  582. {
  583. asIScriptContext* newContext = scriptEngine_->CreateContext();
  584. newContext->SetExceptionCallback(asMETHOD(Script, ExceptionCallback), this, asCALL_THISCALL);
  585. scriptFileContexts_.Push(newContext);
  586. }
  587. return scriptFileContexts_[scriptNestingLevel_];
  588. }
  589. void Script::OutputAPIRow(DumpMode mode, const String& row, bool removeReference, String separator)
  590. {
  591. String out(row);
  592. ///\todo We need C++11 <regex> in String class to handle REGEX whole-word replacement correctly. Can't do that since we still support VS2008.
  593. // Commenting out to temporary fix property name like 'doubleClickInterval' from being wrongly replaced.
  594. // Fortunately, there is no occurence of type 'double' in the API at the moment.
  595. //out.Replace("double", "float"); // s/\bdouble\b/float/g
  596. out.Replace("&in", "&");
  597. out.Replace("&out", "&");
  598. if (removeReference)
  599. out.Replace("&", "");
  600. if (mode == DOXYGEN)
  601. Log::WriteRaw("- " + out + "\n");
  602. else if (mode == C_HEADER)
  603. {
  604. out.Replace("@", "");
  605. out.Replace("?&", "void*");
  606. // s/(\w+)\[\]/Array<\1>/g
  607. unsigned posBegin = String::NPOS;
  608. while (1) // Loop to cater for array of array of T
  609. {
  610. unsigned posEnd = out.Find("[]");
  611. if (posEnd == String::NPOS)
  612. break;
  613. if (posBegin > posEnd)
  614. posBegin = posEnd - 1;
  615. while (posBegin < posEnd && isalnum(out[posBegin]))
  616. --posBegin;
  617. ++posBegin;
  618. out.Replace(posBegin, posEnd - posBegin + 2, "Array<" + out.Substring(posBegin, posEnd - posBegin) + ">");
  619. }
  620. Log::WriteRaw(out + separator + "\n");
  621. }
  622. }
  623. void Script::HandleConsoleCommand(StringHash eventType, VariantMap& eventData)
  624. {
  625. using namespace ConsoleCommand;
  626. if (executeConsoleCommands_)
  627. Execute(eventData[P_COMMAND].GetString());
  628. }
  629. void RegisterScriptLibrary(Context* context)
  630. {
  631. ScriptFile::RegisterObject(context);
  632. ScriptInstance::RegisterObject(context);
  633. }
  634. }