Hey Daniel Been coming round here occasionally to see what's going on with good old Torque. Thought I may as well contribute something, even if it's just random comments.Whoah, it's @ Rene Damm!
Aside from the benefits you mentioned, engineAPI was mainly meant to hide all the internals of how the interop works (such as the manual string parsing that the old console methods were doing) such that the interop can be done in whatever way you want without changing any of the script methods.Interesting Rene... I always wondered how the engineAPI info was meant to be used. Before I couldn't really find a concrete explanation for the merits of such a system besides "better docs" or "better parameter type checking".
I investigated making use of the information myself for embedding but didn't find it useful enough since certain things seemed to be missing (I forget which, it was a while ago), memory management seemed a bit weird, and the whole process seemed a bit backwards if you weren't intending to use it to generate a C#, Java, or a basic <insert favourite scripting vm here> module. Also no varargs
As a veteran torque dev, IMO one of the strengths of the older console system is I can quickly make scriptable functions or objects anywhere and rebuild the exe without having to worry about external tools in the pipeline. That seemed to be missing a bit in engineAPI. Thinking about it though I guess one could probably achieve something similar with engineAPI if they made use of a scripting API which relies on an FFI-like interface (like LuaJIT or Angelscript), though then again its probably not going to be good enough unless the DLL-with-a-processing-tool approach is used.
The "final" version also supported varargs. What's now in T3D is sort of engineAPI v0.8.
We eventually used it from C# without any generator tool. It requires manually adding some interop stuff but .NET makes that very, very easy. Still, once it was set up, the interop generator actually made for a really nice experience. Add something in C++, hit build, and continue writing in C# with VS/ReSharper seeing all the new definitions (and even documentation; we converted the docs added in C++ to XML docs in C#).