Integrando Lua en el proyecto

Para intercambiar información entre Lua y C++ hay que utilizar la pila virtual de Lua, las funciones y sus parámetros se van apilando y desapilando según se van llamando, dejando en la cima de la pila el resultado. Esta interacción se realiza mediante la API de Lua, y requiere definir expresamente cada una de las funciones de C++ que se quieran utilizar en los scripts mediante esta API.

Esto es un trabajo bastante engorroso si se quieren utilizar muchas funciones de C++, se produce mucho código que hay que mantener, y si se hacen cambios en la interfaces utilizadas de C++ hay que volver a revisar dicho código. Afortunadamente existen herramientas como Swig, que automatizan bastante esta tarea.

La ventaja de Swig frente a otras soluciones es que es una herramienta madura, bien documentada, soporta muchos lenguajes de scripting (entre ellos Lua 5.1), el código generado sólo depende de Lua, y es capaz de leer directamente los ficheros ".h" donde se definen las interfaces de las clases (con algunas pequeñas limitaciones), disminuyendo así la cantidad de código a mantener.

Esto no pretende ser un tutorial de Swig, lo mejor para saber como usar Swig junto a Lua es en la documentación oficial. Hay que tener cuidado porque algunos ejemplos utilizan C en vez de C++, y la definición de los módulos generados por Swig cambia. En C++ hay que hacer algo similar a esto:

extern "C"
{
#include <lua.h>
#include <lualib.h>
#include <lauxlib.h>

int luaopen_nombreModulo(lua_State* L); // declare the wrapped module
}