/* Copyright (C) 2009 Wildfire Games.
* This file is part of 0 A.D.
*
* 0 A.D. is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 2 of the License, or
* (at your option) any later version.
*
* 0 A.D. is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with 0 A.D. If not, see .
*/
#include
#include
#ifdef _WIN32
# define XP_WIN
# define WIN32 // SpiderMonkey expects this
// The jsval struct type causes crashes due to weird miscompilation
// issues in (at least) VC2008, so force it to be the less-type-safe
// non-struct type instead
# define JS_NO_JSVAL_JSID_STRUCT_TYPES
#else
# define XP_UNIX
#endif // (we don't support XP_OS2 or XP_BEOS)
#include "js/jsapi.h"
class wxWindow;
class wxString;
class wxPanel;
namespace AtlasMessage { struct mWorldCommand; }
typedef void (*SubmitCommand)(AtlasMessage::mWorldCommand* command);
struct ScriptInterface_impl;
class ScriptInterface
{
public:
ScriptInterface(SubmitCommand submitCommand);
~ScriptInterface();
void SetCallbackData(void* cbdata);
static void* GetCallbackData(JSContext* cx);
template bool SetValue(const wxString& name, const T& val);
template bool GetValue(const wxString& name, T& ret);
bool CallFunction(jsval val, const char* name);
template
bool CallFunction(jsval val, const char* name, const T& a, R& ret);
template
bool CallFunction(jsval val, const char* name, const T& a, const S& b, R& ret);
bool Eval(const wxString& script);
template bool Eval(const wxString& script, T& ret);
// Defined elsewhere:
// template
// void RegisterFunction(const char* functionName);
// (NOTE: The return type must be defined as a ToJSVal
specialisation
// in ScriptInterface.cpp, else you'll end up with linker errors.)
void LoadScript(const wxString& filename, const wxString& code);
wxPanel* LoadScriptAsPanel(const wxString& name, wxWindow* parent);
std::pair LoadScriptAsSidebar(const wxString& name, wxWindow* side, wxWindow* bottom);
// Convert a jsval to a C++ type. (This might trigger GC.)
template static bool FromJSVal(JSContext* cx, jsval val, T& ret);
// Convert a C++ type to a jsval. (This might trigger GC. The return
// value must be rooted if you don't want it to be collected.)
template static jsval ToJSVal(JSContext* cx, const T& val);
bool AddRoot(jsval* ptr);
bool RemoveRoot(jsval* ptr);
private:
JSContext* GetContext();
bool SetValue_(const wxString& name, jsval val);
bool GetValue_(const wxString& name, jsval& ret);
bool CallFunction_(jsval val, const char* name, std::vector& args, jsval& ret);
bool Eval_(const wxString& name, jsval& ret);
void Register(const char* name, JSNative fptr, size_t nargs);
std::auto_ptr m;
// The nasty macro/template bits are split into a separate file so you don't have to look at them
#include "NativeWrapper.inl"
template
bool ScriptInterface::SetValue(const wxString& name, const T& val)
{
return SetValue_(name, ToJSVal(GetContext(), val));
}
template
bool ScriptInterface::GetValue(const wxString& name, T& ret)
{
jsval jsRet;
if (! GetValue_(name, jsRet)) return false;
return FromJSVal(GetContext(), jsRet, ret);
}
template
bool ScriptInterface::CallFunction(jsval val, const char* name, const T& a, R& ret)
{
jsval jsRet;
std::vector argv;
argv.push_back(ToJSVal(GetContext(), a));
bool ok = CallFunction_(val, name, argv, jsRet);
if (! ok) return false;
return FromJSVal(GetContext(), jsRet, ret);
}
template
bool ScriptInterface::CallFunction(jsval val, const char* name, const T& a, const S& b, R& ret)
{
jsval jsRet;
std::vector argv;
argv.push_back(ToJSVal(GetContext(), a));
argv.push_back(ToJSVal(GetContext(), b));
bool ok = CallFunction_(val, name, argv, jsRet);
if (! ok) return false;
return FromJSVal(GetContext(), jsRet, ret);
}
template
bool ScriptInterface::Eval(const wxString& script, T& ret)
{
jsval jsRet;
if (! Eval_(script, jsRet)) return false;
return FromJSVal(GetContext(), jsRet, ret);
}
/**
* A trivial wrapper around a jsval. Used to avoid template overload ambiguities
* with jsval (which is just an integer), for any code that uses
* ScriptInterface::ToJSVal or ScriptInterface::FromJSVal
*/
class CScriptVal
{
public:
CScriptVal() : m_Val(JSVAL_VOID) { }
CScriptVal(jsval val) : m_Val(val) { }
jsval get() const { return m_Val; }
private:
jsval m_Val;
};