Advertisement

Binding Native Functions for Imports

Started by September 24, 2014 04:58 PM
6 comments, last by WitchLord 10 years, 1 month ago

Hi,

The interface of the engine makes it possible to manually bind imported functions to native functions (instead of scripted functions from a module), which is very convenient if you want to create pseudo modules using native code: you can simply call BindImportedFunction() with the native function you want to bind.

However, the engine currently assumes that bound functions are always script functions (so doing what I described above crashes). Is there any good reason for that?

The attached patch seems to fix this (that's an ugly copy/paste from function call code so it can probably be cleaner than that). Would it make sense to support this behavior?

Btw, the m_regs.programPointer++; in the patch is a dumb copy/paste mistake...

Advertisement

The current import function feature is something I'm planning on retiring eventually.

It would be better if you used funcdefs and function handles, which support both script functions and registered functions, as well as delegates.

// use of the old import feature
import void func() from 'mod';  
 
// equivalent code with the more generic solution funcdefs and function handles
funcdef void FUNC();
FUNC @func;

The function handle can then be set from the application to point to whatever asIScriptFunction you want (as long as the signature matches :)).

AngelCode.com - game development and more - Reference DB - game developer references
AngelScript - free scripting library - BMFont - free bitmap font generator - Tower - free puzzle game


The current import function feature is something I'm planning on retiring eventually.

woops, good to know! What is the reason for that? It sounded like a nice feature to have such a built-in linker!


The function handle can then be set from the application to point to whatever asIScriptFunction you want (as long as the signature matches ).

That's a nice idea, indeed! (with probably less overhead too). However, the syntax is not very nice if there are lots of functions with different types to import.

In fact my goal is to allow script users to dynamically load native symbols from the script before using them, with something like:


#include "ModuleAHeader" // define functions for module A
#include "ModuleBHeader" // define functions for module B

void main()
{
   // load the module (all native functions)
   LoadModule("ModuleA");

   // Use functions from module A
   FuncFromModuleA();
}

And in "ModuleA.h"

// simple function declaration, but which clearly states that it is imported
import void FuncFromModuleA() from "ModuleA";
 

This is to avoid binding all symbols at script startup (and maybe choose different implementations of the same symbols as well). Is there maybe another clean way to do this already?

The current implementation of imports is very limited. I'm planning on replacing it with a better solution. In the new solution it will be possible to import not only functions, but variables, classes, and entire namespaces.

The syntax with the use of the funcdefs and function pointers may not be very nice, but this code can easily be generated by a pre-processor, so the actual syntax that the script writer writes may for example look like this:

#import void func() from "moduleA";

and the pre-processor would translate this into:

funcdef void func_t(); func_t @func;

The pre-processor would even be able to automatically set the function pointer after the compilation completes. In a similar manner to the BindImportedFunction function works today.

In fact, I'll probably implement this as part of the CScriptBuilder, as a way to provide some backwards compatibility once I retire the existing implementation for imported functions.

AngelCode.com - game development and more - Reference DB - game developer references
AngelScript - free scripting library - BMFont - free bitmap font generator - Tower - free puzzle game

I've included this patch in revision 2016. Thanks.

AngelCode.com - game development and more - Reference DB - game developer references
AngelScript - free scripting library - BMFont - free bitmap font generator - Tower - free puzzle game

Advertisement

Thanks! This also requires a change to the JIT. I'll submit a patch there too.

Your new system looks much better anyway. Do you know if this may happen in the near future?

Oh, it will likely take months yet before I even start working on this change.

AngelCode.com - game development and more - Reference DB - game developer references
AngelScript - free scripting library - BMFont - free bitmap font generator - Tower - free puzzle game

This topic is closed to new replies.

Advertisement