TerrainAsset.cpp 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543
  1. //-----------------------------------------------------------------------------
  2. // Copyright (c) 2013 GarageGames, LLC
  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
  6. // deal in the Software without restriction, including without limitation the
  7. // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
  8. // sell 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
  19. // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  20. // IN THE SOFTWARE.
  21. //-----------------------------------------------------------------------------
  22. #ifndef TERRAINASSET_H
  23. #include "TerrainAsset.h"
  24. #endif
  25. #ifndef _ASSET_MANAGER_H_
  26. #include "assets/assetManager.h"
  27. #endif
  28. #ifndef _CONSOLETYPES_H_
  29. #include "console/consoleTypes.h"
  30. #endif
  31. #ifndef _TAML_
  32. #include "persistence/taml/taml.h"
  33. #endif
  34. #ifndef _ASSET_PTR_H_
  35. #include "assets/assetPtr.h"
  36. #endif
  37. #include "T3D/assets/TerrainMaterialAsset.h"
  38. #include "assetImporter.h"
  39. //-----------------------------------------------------------------------------
  40. IMPLEMENT_CONOBJECT(TerrainAsset);
  41. ConsoleType(TerrainAssetPtr, TypeTerrainAssetPtr, TerrainAsset, ASSET_ID_FIELD_PREFIX)
  42. //-----------------------------------------------------------------------------
  43. ConsoleGetType(TypeTerrainAssetPtr)
  44. {
  45. // Fetch asset Id.
  46. return (*((AssetPtr<TerrainAsset>*)dptr)).getAssetId();
  47. }
  48. //-----------------------------------------------------------------------------
  49. ConsoleSetType(TypeTerrainAssetPtr)
  50. {
  51. // Was a single argument specified?
  52. if (argc == 1)
  53. {
  54. // Yes, so fetch field value.
  55. const char* pFieldValue = argv[0];
  56. // Fetch asset pointer.
  57. AssetPtr<TerrainAsset>* pAssetPtr = dynamic_cast<AssetPtr<TerrainAsset>*>((AssetPtrBase*)(dptr));
  58. // Is the asset pointer the correct type?
  59. if (pAssetPtr == NULL)
  60. {
  61. // No, so fail.
  62. //Con::warnf("(TypeMaterialAssetPtr) - Failed to set asset Id '%d'.", pFieldValue);
  63. return;
  64. }
  65. // Set asset.
  66. pAssetPtr->setAssetId(pFieldValue);
  67. return;
  68. }
  69. // Warn.
  70. Con::warnf("(TypeTerrainAssetPtr) - Cannot set multiple args to a single asset.");
  71. }
  72. //-----------------------------------------------------------------------------
  73. ConsoleType(assetIdString, TypeTerrainAssetId, const char*, ASSET_ID_FIELD_PREFIX)
  74. ConsoleGetType(TypeTerrainAssetId)
  75. {
  76. // Fetch asset Id.
  77. return *((const char**)(dptr));
  78. }
  79. ConsoleSetType(TypeTerrainAssetId)
  80. {
  81. // Was a single argument specified?
  82. if (argc == 1)
  83. {
  84. *((const char**)dptr) = StringTable->insert(argv[0]);
  85. return;
  86. }
  87. // Warn.
  88. Con::warnf("(TypeAssetId) - Cannot set multiple args to a single asset.");
  89. }
  90. //-----------------------------------------------------------------------------
  91. TerrainAsset::TerrainAsset()
  92. {
  93. mTerrainFileName = StringTable->EmptyString();
  94. mTerrainFilePath = StringTable->EmptyString();
  95. }
  96. //-----------------------------------------------------------------------------
  97. TerrainAsset::~TerrainAsset()
  98. {
  99. }
  100. //-----------------------------------------------------------------------------
  101. void TerrainAsset::initPersistFields()
  102. {
  103. docsURL;
  104. // Call parent.
  105. Parent::initPersistFields();
  106. //addField("shaderGraph", TypeRealString, Offset(mShaderGraphFile, TerrainAsset), "");
  107. addProtectedField("terrainFile", TypeAssetLooseFilePath, Offset(mTerrainFileName, TerrainAsset),
  108. &setTerrainFileName, &getTerrainFileName, "Path to the file containing the terrain data.");
  109. }
  110. void TerrainAsset::setDataField(StringTableEntry slotName, const char* array, const char* value)
  111. {
  112. Parent::setDataField(slotName, array, value);
  113. //Now, if it's a material slot of some fashion, set it up
  114. StringTableEntry matSlotName = StringTable->insert("terrainMaterialAsset");
  115. if (String(slotName).startsWith(matSlotName))
  116. {
  117. StringTableEntry matId = StringTable->insert(value);
  118. mTerrMaterialAssetIds.push_back(matId);
  119. }
  120. }
  121. void TerrainAsset::initializeAsset()
  122. {
  123. // Call parent.
  124. Parent::initializeAsset();
  125. mTerrainFilePath = getOwned() ? expandAssetFilePath(mTerrainFileName) : mTerrainFilePath;
  126. load();
  127. }
  128. void TerrainAsset::onAssetRefresh()
  129. {
  130. mTerrainFilePath = getOwned() ? expandAssetFilePath(mTerrainFileName) : mTerrainFilePath;
  131. load();
  132. }
  133. void TerrainAsset::setTerrainFileName(const char* pScriptFile)
  134. {
  135. // Sanity!
  136. AssertFatal(pScriptFile != NULL, "Cannot use a NULL terrain file.");
  137. pScriptFile = StringTable->insert(pScriptFile, true);
  138. // Ignore no change,
  139. if (pScriptFile == mTerrainFileName)
  140. return;
  141. // Update.
  142. mTerrainFileName = getOwned() ? expandAssetFilePath(pScriptFile) : pScriptFile;
  143. // Refresh the asset.
  144. refreshAsset();
  145. }
  146. U32 TerrainAsset::load()
  147. {
  148. if (mLoadedState == AssetErrCode::Ok)
  149. return mLoadedState;
  150. if (!Torque::FS::IsFile(mTerrainFilePath))
  151. {
  152. mLoadedState = BadFileReference;
  153. return mLoadedState;
  154. }
  155. mTerrMaterialAssets.clear();
  156. mTerrMaterialAssetIds.clear();
  157. StringTableEntry terrainMatAssetType = StringTable->insert("TerrainMaterialAsset");
  158. //First, load any material, animation, etc assets we may be referencing in our asset
  159. // Find any asset dependencies.
  160. AssetManager::typeAssetDependsOnHash::Iterator assetDependenciesItr = mpOwningAssetManager->getDependedOnAssets()->find(mpAssetDefinition->mAssetId);
  161. // Does the asset have any dependencies?
  162. if (assetDependenciesItr != mpOwningAssetManager->getDependedOnAssets()->end())
  163. {
  164. // Iterate all dependencies.
  165. while (assetDependenciesItr != mpOwningAssetManager->getDependedOnAssets()->end() && assetDependenciesItr->key == mpAssetDefinition->mAssetId)
  166. {
  167. StringTableEntry assetType = mpOwningAssetManager->getAssetType(assetDependenciesItr->value);
  168. if (assetType == terrainMatAssetType)
  169. {
  170. StringTableEntry assetId = StringTable->insert(assetDependenciesItr->value);
  171. mTerrMaterialAssetIds.push_front(assetId);
  172. //Force the asset to become initialized if it hasn't been already
  173. AssetPtr<TerrainMaterialAsset> matAsset = assetId;
  174. mTerrMaterialAssets.push_front(matAsset);
  175. }
  176. // Next dependency.
  177. assetDependenciesItr++;
  178. }
  179. }
  180. mTerrainFile = ResourceManager::get().load(mTerrainFilePath);
  181. if (mTerrainFile)
  182. {
  183. mLoadedState = Ok;
  184. }
  185. else
  186. {
  187. mLoadedState = BadFileReference;
  188. }
  189. return mLoadedState;
  190. }
  191. //------------------------------------------------------------------------------
  192. //------------------------------------------------------------------------------
  193. //Utility function to 'fill out' bindings and resources with a matching asset if one exists
  194. bool TerrainAsset::getAssetByFilename(StringTableEntry fileName, AssetPtr<TerrainAsset>* shapeAsset)
  195. {
  196. AssetQuery query;
  197. S32 foundAssetcount = AssetDatabase.findAssetLooseFile(&query, fileName);
  198. if (foundAssetcount == 0)
  199. {
  200. //Didn't find any assets
  201. //If possible, see if we can run an in-place import and the get the asset from that
  202. #ifdef TORQUE_DEBUG
  203. Con::warnf("TerrainAsset::getAssetByFilename - Attempted to in-place import a terrainFile(%s) that had no associated asset", fileName);
  204. #endif
  205. Torque::Path terrFilePath = fileName;
  206. TerrainAsset* newTerrainAsset = new TerrainAsset();
  207. String assetName = terrFilePath.getFileName();
  208. assetName.replace(" ", "_");
  209. newTerrainAsset->setAssetName(assetName.c_str());
  210. String terrainPathBind = terrFilePath.getFileName() + terrFilePath.getExtension();
  211. newTerrainAsset->mTerrainFileName = StringTable->insert(terrainPathBind.c_str());
  212. newTerrainAsset->saveAsset();
  213. Taml taml;
  214. // Yes, so set it.
  215. taml.setFormatMode(Taml::getFormatModeEnum("xml"));
  216. // Turn-off auto-formatting.
  217. taml.setAutoFormat(false);
  218. String tamlPath = terrFilePath.getFullPath() + "/" + assetName + ".asset.taml";
  219. // Read object.
  220. bool success = taml.write(newTerrainAsset, tamlPath.c_str());
  221. if (!success)
  222. {
  223. Con::printf("TerrainAsset::getAssetByFilename() - failed to auto-import terrainfile(%s) as an TerrainAsset", fileName);
  224. return false;
  225. }
  226. ModuleDefinition* targetModuleDef = AssetImporter::getModuleFromPath(fileName);
  227. if (!targetModuleDef)
  228. {
  229. Con::printf("TerrainAsset::getAssetByFilename() - failed to auto-import terrainfile(%s) as an TerrainAsset, unable to find a valid Module for the filePath", fileName);
  230. return false;
  231. }
  232. success = AssetDatabase.addDeclaredAsset(targetModuleDef, tamlPath.c_str());
  233. if (!success)
  234. {
  235. Con::printf("TerrainAsset::getAssetByFilename() - failed to auto-import terrainfile(%s) as an TerrainAsset, unable to find a register asset with path", tamlPath.c_str());
  236. return false;
  237. }
  238. String assetId = targetModuleDef->getModuleId();
  239. assetId += ":";
  240. assetId += assetName.c_str();
  241. StringTableEntry resultingAssetId = StringTable->insert(assetId.c_str());
  242. if (resultingAssetId != StringTable->EmptyString())
  243. {
  244. shapeAsset->setAssetId(resultingAssetId);
  245. if (!shapeAsset->isNull())
  246. return true;
  247. }
  248. //That didn't work, so fail out
  249. return false;
  250. }
  251. else
  252. {
  253. //acquire and bind the asset, and return it out
  254. shapeAsset->setAssetId(query.mAssetList[0]);
  255. return true;
  256. }
  257. }
  258. StringTableEntry TerrainAsset::getAssetIdByFilename(StringTableEntry fileName)
  259. {
  260. if (fileName == StringTable->EmptyString())
  261. return StringTable->EmptyString();
  262. StringTableEntry shapeAssetId = StringTable->EmptyString();
  263. AssetQuery query;
  264. S32 foundAssetcount = AssetDatabase.findAssetLooseFile(&query, fileName);
  265. if (foundAssetcount == 0)
  266. {
  267. //Didn't find any assets
  268. //If possible, see if we can run an in-place import and the get the asset from that
  269. #if TORQUE_DEBUG
  270. Con::warnf("TerrainAsset::getAssetByFilename - Attempted to in-place import a terrainFile(%s) that had no associated asset", fileName);
  271. #endif
  272. Torque::Path terrFilePath = fileName;
  273. TerrainAsset* newTerrainAsset = new TerrainAsset();
  274. String assetName = terrFilePath.getFileName();
  275. assetName.replace(" ", "_");
  276. newTerrainAsset->setAssetName(assetName.c_str());
  277. String terrainPathBind = terrFilePath.getFileName() + "." + terrFilePath.getExtension();
  278. newTerrainAsset->mTerrainFileName = StringTable->insert(terrainPathBind.c_str());
  279. newTerrainAsset->saveAsset();
  280. Taml taml;
  281. // Yes, so set it.
  282. taml.setFormatMode(Taml::getFormatModeEnum("xml"));
  283. // Turn-off auto-formatting.
  284. taml.setAutoFormat(false);
  285. String tamlPath = terrFilePath.getPath() + "/" + assetName + ".asset.taml";
  286. // Read object.
  287. bool success = taml.write(newTerrainAsset, tamlPath.c_str());
  288. if (!success)
  289. {
  290. Con::printf("TerrainAsset::getAssetIdByFilename() - failed to auto-import terrainfile(%s) as an TerrainAsset", fileName);
  291. return StringTable->EmptyString();
  292. }
  293. ModuleDefinition* targetModuleDef = AssetImporter::getModuleFromPath(fileName);
  294. if (!targetModuleDef)
  295. {
  296. Con::printf("TerrainAsset::getAssetIdByFilename() - failed to auto-import terrainfile(%s) as an TerrainAsset, unable to find a valid Module for the filePath", fileName);
  297. return StringTable->EmptyString();
  298. }
  299. success = AssetDatabase.addDeclaredAsset(targetModuleDef, tamlPath.c_str());
  300. if (!success)
  301. {
  302. Con::printf("TerrainAsset::getAssetIdByFilename() - failed to auto-import terrainfile(%s) as an TerrainAsset, unable to find a register asset with path", tamlPath.c_str());
  303. return StringTable->EmptyString();
  304. }
  305. String assetId = targetModuleDef->getModuleId();
  306. assetId += ":";
  307. assetId += assetName.c_str();
  308. StringTableEntry resultingAssetId = StringTable->insert(assetId.c_str());
  309. if (resultingAssetId != StringTable->EmptyString())
  310. {
  311. shapeAssetId = resultingAssetId;
  312. return shapeAssetId;
  313. }
  314. }
  315. else
  316. {
  317. //acquire and bind the asset, and return it out
  318. shapeAssetId = query.mAssetList[0];
  319. }
  320. return shapeAssetId;
  321. }
  322. bool TerrainAsset::getAssetById(StringTableEntry assetId, AssetPtr<TerrainAsset>* shapeAsset)
  323. {
  324. (*shapeAsset) = assetId;
  325. if (!shapeAsset->isNull())
  326. return true;
  327. return false;
  328. }
  329. //------------------------------------------------------------------------------
  330. void TerrainAsset::copyTo(SimObject* object)
  331. {
  332. // Call to parent.
  333. Parent::copyTo(object);
  334. }
  335. DefineEngineMethod(TerrainAsset, getTerrainFilePath, const char*, (), ,
  336. "Gets the terrain filepath of this asset.\n"
  337. "@return File path of the terrain file.")
  338. {
  339. return object->getTerrainFilePath();
  340. }
  341. #ifdef TORQUE_TOOLS
  342. //-----------------------------------------------------------------------------
  343. // GuiInspectorTypeAssetId
  344. //-----------------------------------------------------------------------------
  345. IMPLEMENT_CONOBJECT(GuiInspectorTypeTerrainAssetPtr);
  346. ConsoleDocClass(GuiInspectorTypeTerrainAssetPtr,
  347. "@brief Inspector field type for Material Asset Objects\n\n"
  348. "Editor use only.\n\n"
  349. "@internal"
  350. );
  351. void GuiInspectorTypeTerrainAssetPtr::consoleInit()
  352. {
  353. Parent::consoleInit();
  354. ConsoleBaseType::getType(TypeTerrainAssetPtr)->setInspectorFieldType("GuiInspectorTypeTerrainAssetPtr");
  355. }
  356. GuiControl* GuiInspectorTypeTerrainAssetPtr::constructEditControl()
  357. {
  358. // Create base filename edit controls
  359. GuiControl* retCtrl = Parent::constructEditControl();
  360. if (retCtrl == NULL)
  361. return retCtrl;
  362. // Change filespec
  363. char szBuffer[512];
  364. dSprintf(szBuffer, sizeof(szBuffer), "AssetBrowser.showDialog(\"TerrainAsset\", \"AssetBrowser.changeAsset\", %s, %s);",
  365. mInspector->getIdString(), mCaption);
  366. mBrowseButton->setField("Command", szBuffer);
  367. setDataField(StringTable->insert("targetObject"), NULL, mInspector->getInspectObject()->getIdString());
  368. // Create "Open in ShapeEditor" button
  369. mShapeEdButton = new GuiBitmapButtonCtrl();
  370. mShapeEdButton->setField("Command", "EditorGui.setEditor(TerrainEditorPlugin);");
  371. char bitmapName[512] = "ToolsModule:TerrainBlock_image";
  372. mShapeEdButton->setBitmap(StringTable->insert(bitmapName));
  373. mShapeEdButton->setDataField(StringTable->insert("Profile"), NULL, "GuiButtonProfile");
  374. mShapeEdButton->setDataField(StringTable->insert("tooltipprofile"), NULL, "GuiToolTipProfile");
  375. mShapeEdButton->setDataField(StringTable->insert("hovertime"), NULL, "1000");
  376. mShapeEdButton->setDataField(StringTable->insert("tooltip"), NULL, "Open this file in the Shape Editor");
  377. mShapeEdButton->registerObject();
  378. addObject(mShapeEdButton);
  379. return retCtrl;
  380. }
  381. bool GuiInspectorTypeTerrainAssetPtr::updateRects()
  382. {
  383. S32 dividerPos, dividerMargin;
  384. mInspector->getDivider(dividerPos, dividerMargin);
  385. Point2I fieldExtent = getExtent();
  386. Point2I fieldPos = getPosition();
  387. mCaptionRect.set(0, 0, fieldExtent.x - dividerPos - dividerMargin, fieldExtent.y);
  388. mEditCtrlRect.set(fieldExtent.x - dividerPos + dividerMargin, 1, dividerPos - dividerMargin - 34, fieldExtent.y);
  389. bool resized = mEdit->resize(mEditCtrlRect.point, mEditCtrlRect.extent);
  390. if (mBrowseButton != NULL)
  391. {
  392. mBrowseRect.set(fieldExtent.x - 32, 2, 14, fieldExtent.y - 4);
  393. resized |= mBrowseButton->resize(mBrowseRect.point, mBrowseRect.extent);
  394. }
  395. if (mShapeEdButton != NULL)
  396. {
  397. RectI shapeEdRect(fieldExtent.x - 16, 2, 14, fieldExtent.y - 4);
  398. resized |= mShapeEdButton->resize(shapeEdRect.point, shapeEdRect.extent);
  399. }
  400. return resized;
  401. }
  402. IMPLEMENT_CONOBJECT(GuiInspectorTypeTerrainAssetId);
  403. ConsoleDocClass(GuiInspectorTypeTerrainAssetId,
  404. "@brief Inspector field type for Shapes\n\n"
  405. "Editor use only.\n\n"
  406. "@internal"
  407. );
  408. void GuiInspectorTypeTerrainAssetId::consoleInit()
  409. {
  410. Parent::consoleInit();
  411. ConsoleBaseType::getType(TypeTerrainAssetId)->setInspectorFieldType("GuiInspectorTypeTerrainAssetId");
  412. }
  413. #endif