AssetTroubleshooting

From Horde3D Wiki
Revision as of 23:49, 5 January 2009 by Marciano (talk | contribs) (Added article about Asset Import Troubleshooting)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Troubleshooting for Asset Import

Feel free to extend this article with your own experience and tips!


You are trying to load and display your model in one of the Horde3D samples (or your own app) but don't see it. What could go wrong?

  • First check the messages that ColladaConv outputs. The converter is usually quite verbose and outputs warnings when some unsupported Collada tags are found. If there are serious warnings or even errors chances are high that your model won't be displayed correctly.
  • Optionally check the files that ColladaConv has written. There should be one .scene.xml file and one .geo file, possibly also an .anim file if your model has animations. You can quickly look into the scene.xml file to check that it looks like valid XML (no obvious errors). You should see a Model node as root node and some Mesh and possibly Joint nodes. There should also be at least on material which is created by the converter.
  • After having started (and quit again) your application, check the EngineLog.html file to see if some resources could not be loaded or if some other problems occurred.
  • If there are no related errors in the log, enable debug view in your application (default in samples is F7). This shows you the raw geometry without any pipeline commands and shaders applied. If the model is visible, you can assume that it is a problem with the materials, shader or pipeline. If the model is not visible, either the geometry is not valid or you have placed the model scene node somewhere outside the camera frustum.
  • If the debug view test revealed that it is a rendering (material, shader, pipelie problem), you can look into the material files of your model. Usually materials should have a shader specified and in the standard case a diffuse texture. Please note, currently there is no shader in the SDK which just uses a plain color for diffuse (but it is very easy to write one if you know about shaders). A simple workaround is to apply a very small texture map to your model that contains the desired color.