2007-01-15 23:19:50 +01:00
|
|
|
// Copyright (c) 2006, 2007, Niels Martin Hansen
|
2006-12-28 22:18:35 +01:00
|
|
|
// All rights reserved.
|
|
|
|
//
|
|
|
|
// Redistribution and use in source and binary forms, with or without
|
|
|
|
// modification, are permitted provided that the following conditions are met:
|
|
|
|
//
|
|
|
|
// * Redistributions of source code must retain the above copyright notice,
|
|
|
|
// this list of conditions and the following disclaimer.
|
|
|
|
// * Redistributions in binary form must reproduce the above copyright notice,
|
|
|
|
// this list of conditions and the following disclaimer in the documentation
|
|
|
|
// and/or other materials provided with the distribution.
|
|
|
|
// * Neither the name of the Aegisub Group nor the names of its contributors
|
|
|
|
// may be used to endorse or promote products derived from this software
|
|
|
|
// without specific prior written permission.
|
|
|
|
//
|
|
|
|
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
|
|
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
|
|
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
|
|
|
|
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
|
|
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
|
|
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
|
|
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
|
|
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
|
|
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
|
|
// POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
//
|
2009-07-29 07:43:02 +02:00
|
|
|
// Aegisub Project http://www.aegisub.org/
|
|
|
|
|
|
|
|
/// @file auto4_lua.cpp
|
|
|
|
/// @brief Lua 5.1-based scripting engine
|
|
|
|
/// @ingroup scripting
|
|
|
|
///
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2009-01-04 07:31:48 +01:00
|
|
|
#include "config.h"
|
|
|
|
|
2011-09-28 21:48:37 +02:00
|
|
|
#include "auto4_lua.h"
|
|
|
|
|
2012-11-26 19:46:03 +01:00
|
|
|
#include "auto4_lua_utils.h"
|
2006-12-28 22:18:35 +01:00
|
|
|
#include "ass_dialogue.h"
|
|
|
|
#include "ass_file.h"
|
2009-09-10 15:06:40 +02:00
|
|
|
#include "ass_style.h"
|
|
|
|
#include "auto4_lua_factory.h"
|
|
|
|
#include "auto4_lua_scriptreader.h"
|
2012-01-18 21:08:42 +01:00
|
|
|
#include "compat.h"
|
2011-09-28 21:48:47 +02:00
|
|
|
#include "include/aegisub/context.h"
|
2010-05-21 03:13:36 +02:00
|
|
|
#include "main.h"
|
2013-01-30 04:35:37 +01:00
|
|
|
#include "options.h"
|
2011-09-28 21:48:47 +02:00
|
|
|
#include "selection_controller.h"
|
2013-01-26 02:57:46 +01:00
|
|
|
#include "subs_controller.h"
|
2008-09-10 18:53:23 +02:00
|
|
|
#include "video_context.h"
|
2011-09-28 21:48:47 +02:00
|
|
|
#include "utils.h"
|
2008-03-05 05:10:20 +01:00
|
|
|
|
2013-01-04 16:01:50 +01:00
|
|
|
#include <libaegisub/access.h>
|
2013-01-30 04:35:37 +01:00
|
|
|
#include <libaegisub/path.h>
|
2013-01-04 16:01:50 +01:00
|
|
|
#include <libaegisub/scoped_ptr.h>
|
|
|
|
|
|
|
|
#include <algorithm>
|
|
|
|
#include <boost/algorithm/string/classification.hpp>
|
|
|
|
#include <boost/algorithm/string/predicate.hpp>
|
|
|
|
#include <boost/algorithm/string/replace.hpp>
|
|
|
|
#include <boost/format.hpp>
|
|
|
|
#include <boost/tokenizer.hpp>
|
|
|
|
#include <cassert>
|
|
|
|
#include <cstdint>
|
|
|
|
|
|
|
|
#include <wx/clipbrd.h>
|
|
|
|
#include <wx/filefn.h>
|
|
|
|
#include <wx/filename.h>
|
|
|
|
#include <wx/log.h>
|
|
|
|
#include <wx/msgdlg.h>
|
|
|
|
#include <wx/window.h>
|
|
|
|
|
2011-09-28 21:48:37 +02:00
|
|
|
namespace {
|
2011-09-28 21:49:47 +02:00
|
|
|
void set_context(lua_State *L, const agi::Context *c)
|
|
|
|
{
|
|
|
|
// Explicit cast is needed to discard the const
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, (void *)c);
|
2011-09-28 21:49:47 +02:00
|
|
|
lua_setfield(L, LUA_REGISTRYINDEX, "project_context");
|
|
|
|
}
|
|
|
|
|
|
|
|
const agi::Context *get_context(lua_State *L)
|
|
|
|
{
|
|
|
|
lua_getfield(L, LUA_REGISTRYINDEX, "project_context");
|
2012-01-09 21:31:19 +01:00
|
|
|
if (!lua_islightuserdata(L, -1)) {
|
|
|
|
lua_pop(L, 1);
|
|
|
|
return 0;
|
|
|
|
}
|
2011-09-28 21:49:47 +02:00
|
|
|
const agi::Context * c = static_cast<const agi::Context *>(lua_touserdata(L, -1));
|
|
|
|
lua_pop(L, 1);
|
|
|
|
return c;
|
|
|
|
}
|
2012-02-15 22:23:42 +01:00
|
|
|
|
2012-02-22 00:32:58 +01:00
|
|
|
int get_file_name(lua_State *L)
|
|
|
|
{
|
|
|
|
const agi::Context *c = get_context(L);
|
2013-01-26 02:57:46 +01:00
|
|
|
if (c && !c->subsController->Filename().empty())
|
|
|
|
push_value(L, c->subsController->Filename().filename());
|
2012-02-22 00:32:58 +01:00
|
|
|
else
|
|
|
|
lua_pushnil(L);
|
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
|
2012-03-13 00:35:29 +01:00
|
|
|
int get_translation(lua_State *L)
|
|
|
|
{
|
|
|
|
wxString str(check_wxstring(L, 1));
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, _(str));
|
2012-03-13 00:35:29 +01:00
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
|
2012-02-22 21:47:34 +01:00
|
|
|
int clipboard_get(lua_State *L)
|
|
|
|
{
|
2013-01-04 16:01:50 +01:00
|
|
|
std::string data = GetClipboard();
|
|
|
|
if (data.empty())
|
2012-02-22 21:47:34 +01:00
|
|
|
lua_pushnil(L);
|
2012-10-25 17:13:13 +02:00
|
|
|
else
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, data);
|
2012-02-22 21:47:34 +01:00
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
|
|
|
|
int clipboard_set(lua_State *L)
|
|
|
|
{
|
2013-01-04 16:01:50 +01:00
|
|
|
std::string str(luaL_checkstring(L, 1));
|
2012-02-22 21:47:34 +01:00
|
|
|
|
|
|
|
bool succeeded = false;
|
|
|
|
|
|
|
|
#if wxUSE_OLE
|
|
|
|
// OLE needs to be initialized on each thread that wants to write to
|
|
|
|
// the clipboard, which wx does not handle automatically
|
|
|
|
wxClipboard cb;
|
|
|
|
wxClipboard *theCB = &cb;
|
|
|
|
#else
|
|
|
|
wxClipboard *theCB = wxTheClipboard;
|
|
|
|
#endif
|
|
|
|
if (theCB->Open()) {
|
2013-01-04 16:01:50 +01:00
|
|
|
succeeded = theCB->SetData(new wxTextDataObject(to_wx(str)));
|
2012-02-22 21:47:34 +01:00
|
|
|
theCB->Close();
|
|
|
|
theCB->Flush();
|
|
|
|
}
|
|
|
|
|
|
|
|
lua_pushboolean(L, succeeded);
|
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
|
|
|
|
int clipboard_init(lua_State *L)
|
|
|
|
{
|
|
|
|
lua_newtable(L);
|
|
|
|
set_field(L, "get", clipboard_get);
|
|
|
|
set_field(L, "set", clipboard_set);
|
|
|
|
return 1;
|
|
|
|
}
|
2013-05-02 03:26:05 +02:00
|
|
|
|
|
|
|
struct table_pairs {
|
|
|
|
static void init(lua_State *L) { lua_pushnil(L); }
|
|
|
|
static int next(lua_State *L) {
|
|
|
|
luaL_checktype(L, 1, LUA_TTABLE);
|
|
|
|
lua_settop(L, 2);
|
|
|
|
if (lua_next(L, 1))
|
|
|
|
return 2;
|
|
|
|
lua_pushnil(L);
|
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
static const char *method() { return "__pairs"; }
|
|
|
|
};
|
|
|
|
|
|
|
|
struct table_ipairs {
|
|
|
|
static void init(lua_State *L) { push_value(L, 1); }
|
|
|
|
static int next(lua_State *L) {
|
|
|
|
luaL_checktype(L, 1, LUA_TTABLE);
|
|
|
|
int i = luaL_checkint(L, 2) + 1;
|
|
|
|
lua_pushinteger(L, i);
|
|
|
|
lua_rawgeti(L, 1, i);
|
|
|
|
return lua_isnil(L, -1) ? 1 : 2;
|
|
|
|
}
|
|
|
|
static const char *method() { return "__ipairs"; }
|
|
|
|
};
|
|
|
|
|
|
|
|
template<typename TableIter>
|
|
|
|
int pairs(lua_State *L) {
|
|
|
|
// If the metamethod is defined, call it instead
|
|
|
|
if (luaL_getmetafield(L, 1, TableIter::method())) {
|
|
|
|
lua_pushvalue(L, 1);
|
|
|
|
lua_call(L, 1, 3);
|
|
|
|
return 3;
|
|
|
|
}
|
|
|
|
|
|
|
|
// No metamethod, so use the table iterators
|
|
|
|
luaL_checktype(L, 1, LUA_TTABLE);
|
|
|
|
lua_pushcfunction(L, &TableIter::next);
|
|
|
|
lua_pushvalue(L, 1);
|
|
|
|
TableIter::init(L);
|
|
|
|
return 3;
|
|
|
|
}
|
2011-09-28 21:48:37 +02:00
|
|
|
}
|
Note: This was done using a script! it's far from perfect but 95% of the work has been done already formatting-wise.
Document all functions, class, struct, union, enum, macro, variable, typedefs. This isn't the actual document in itself but empty documentation using any old documentation if it was there.
This was done using exuberant ctags to get tag info, then a TCL script to parse/remove old comments and convert them into Doxygen-style.
Some notes:
* Anything labeled 'DOCME' needs to be documented, @param and @return have been left blank as it would be annoying to delete the 'DOCME' from every one of those.
* Some multiline comments may have been munged into single line comments
* Leave the /// comments above global variables with a space, if they're harder to read then we'll be less likey to use them.
* Enum comments can go after the enumeration itself '[value] /// comment'
* include/aegisub/*.h haven't been converted yet, this will be done in a later commit
* Some documentation blocks are in the wrong place, in the .h when it should be in the .cpp, or vice versa.
See http://devel.aegisub.org/wiki/Doxygen for some details on Doxygen and a 'style guide'.
Originally committed to SVN as r3312.
2009-07-30 00:59:22 +02:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
namespace Automation4 {
|
2013-04-10 05:46:59 +02:00
|
|
|
int regex_init(lua_State *L);
|
|
|
|
|
2006-12-28 22:18:35 +01:00
|
|
|
// LuaScript
|
2013-01-04 16:01:50 +01:00
|
|
|
LuaScript::LuaScript(agi::fs::path const& filename)
|
2011-09-28 21:48:37 +02:00
|
|
|
: Script(filename)
|
|
|
|
, L(0)
|
2006-12-28 22:18:35 +01:00
|
|
|
{
|
2007-02-14 01:43:01 +01:00
|
|
|
Create();
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
LuaScript::~LuaScript()
|
|
|
|
{
|
2011-09-28 21:48:37 +02:00
|
|
|
Destroy();
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
void LuaScript::Create()
|
|
|
|
{
|
|
|
|
Destroy();
|
|
|
|
|
|
|
|
try {
|
|
|
|
// create lua environment
|
|
|
|
L = lua_open();
|
|
|
|
LuaStackcheck _stackcheck(L);
|
|
|
|
|
|
|
|
// register standard libs
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, luaopen_base); lua_call(L, 0, 0);
|
|
|
|
push_value(L, luaopen_package); lua_call(L, 0, 0);
|
|
|
|
push_value(L, luaopen_string); lua_call(L, 0, 0);
|
|
|
|
push_value(L, luaopen_table); lua_call(L, 0, 0);
|
|
|
|
push_value(L, luaopen_math); lua_call(L, 0, 0);
|
|
|
|
push_value(L, luaopen_io); lua_call(L, 0, 0);
|
|
|
|
push_value(L, luaopen_os); lua_call(L, 0, 0);
|
2008-03-09 22:09:51 +01:00
|
|
|
_stackcheck.check_stack(0);
|
2011-09-28 21:52:20 +02:00
|
|
|
|
2006-12-28 22:18:35 +01:00
|
|
|
// dofile and loadfile are replaced with include
|
|
|
|
lua_pushnil(L);
|
|
|
|
lua_setglobal(L, "dofile");
|
|
|
|
lua_pushnil(L);
|
|
|
|
lua_setglobal(L, "loadfile");
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, LuaInclude);
|
2006-12-28 22:18:35 +01:00
|
|
|
lua_setglobal(L, "include");
|
|
|
|
|
2013-05-02 03:26:05 +02:00
|
|
|
// replace pairs and ipairs with lua 5.2-style versions
|
|
|
|
push_value(L, &pairs<table_pairs>);
|
|
|
|
lua_setglobal(L, "pairs");
|
|
|
|
push_value(L, &pairs<table_ipairs>);
|
|
|
|
lua_setglobal(L, "ipairs");
|
|
|
|
|
2010-01-24 20:07:34 +01:00
|
|
|
// add include_path to the module load path
|
|
|
|
lua_getglobal(L, "package");
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, "path");
|
|
|
|
push_value(L, "path");
|
2010-01-24 20:07:34 +01:00
|
|
|
lua_gettable(L, -3);
|
|
|
|
|
2013-01-04 16:01:50 +01:00
|
|
|
for (auto const& path : include_path) {
|
|
|
|
lua_pushfstring(L, ";%s/?.lua;%s/?/init.lua", path.string().c_str(), path.string().c_str());
|
2011-09-28 21:49:09 +02:00
|
|
|
lua_concat(L, 2);
|
2010-01-24 20:07:34 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
lua_settable(L, -3);
|
2010-01-28 02:13:13 +01:00
|
|
|
|
2011-09-28 21:48:37 +02:00
|
|
|
// Replace the default lua module loader with our unicode compatible one
|
2010-01-28 02:13:13 +01:00
|
|
|
lua_getfield(L, -1, "loaders");
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, LuaModuleLoader);
|
2010-01-28 02:13:13 +01:00
|
|
|
lua_rawseti(L, -2, 2);
|
|
|
|
lua_pop(L, 2);
|
2010-01-24 20:07:34 +01:00
|
|
|
_stackcheck.check_stack(0);
|
|
|
|
|
2006-12-28 22:18:35 +01:00
|
|
|
// prepare stuff in the registry
|
2011-09-28 21:52:20 +02:00
|
|
|
|
|
|
|
// store the script's filename
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, GetFilename().stem());
|
2011-09-28 21:52:20 +02:00
|
|
|
lua_setfield(L, LUA_REGISTRYINDEX, "filename");
|
|
|
|
_stackcheck.check_stack(0);
|
|
|
|
|
2006-12-28 22:18:35 +01:00
|
|
|
// reference to the script object
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, this);
|
2006-12-28 22:18:35 +01:00
|
|
|
lua_setfield(L, LUA_REGISTRYINDEX, "aegisub");
|
2008-03-09 22:09:51 +01:00
|
|
|
_stackcheck.check_stack(0);
|
2006-12-28 22:18:35 +01:00
|
|
|
|
|
|
|
// make "aegisub" table
|
|
|
|
lua_pushstring(L, "aegisub");
|
|
|
|
lua_newtable(L);
|
2011-09-28 21:48:37 +02:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
set_field(L, "register_macro", LuaCommand::LuaRegister);
|
|
|
|
set_field(L, "register_filter", LuaExportFilter::LuaRegister);
|
2011-09-28 21:48:37 +02:00
|
|
|
set_field(L, "text_extents", LuaTextExtents);
|
|
|
|
set_field(L, "frame_from_ms", LuaFrameFromMs);
|
|
|
|
set_field(L, "ms_from_frame", LuaMsFromFrame);
|
|
|
|
set_field(L, "video_size", LuaVideoSize);
|
2011-12-22 22:29:56 +01:00
|
|
|
set_field(L, "keyframes", LuaGetKeyframes);
|
2011-12-22 22:30:05 +01:00
|
|
|
set_field(L, "decode_path", LuaDecodePath);
|
2012-01-20 22:33:20 +01:00
|
|
|
set_field(L, "cancel", LuaCancel);
|
2011-09-28 21:48:37 +02:00
|
|
|
set_field(L, "lua_automation_version", 4);
|
2012-02-15 22:23:42 +01:00
|
|
|
set_field(L, "__init_regex", regex_init);
|
2012-02-22 21:47:34 +01:00
|
|
|
set_field(L, "__init_clipboard", clipboard_init);
|
2012-02-22 00:32:58 +01:00
|
|
|
set_field(L, "file_name", get_file_name);
|
2012-03-13 00:35:29 +01:00
|
|
|
set_field(L, "gettext", get_translation);
|
2011-09-28 21:48:37 +02:00
|
|
|
|
2006-12-28 22:18:35 +01:00
|
|
|
// store aegisub table to globals
|
|
|
|
lua_settable(L, LUA_GLOBALSINDEX);
|
2008-03-09 22:09:51 +01:00
|
|
|
_stackcheck.check_stack(0);
|
2006-12-28 22:18:35 +01:00
|
|
|
|
|
|
|
// load user script
|
2007-01-03 04:39:15 +01:00
|
|
|
LuaScriptReader script_reader(GetFilename());
|
2013-01-04 16:01:50 +01:00
|
|
|
if (lua_load(L, script_reader.reader_func, &script_reader, GetPrettyFilename().string().c_str())) {
|
2013-03-18 15:01:54 +01:00
|
|
|
std::string err = str(boost::format("Error loading Lua script \"%s\":\n\n%s") % GetPrettyFilename().string() % get_string_or_default(L, -1));
|
2012-08-20 05:32:18 +02:00
|
|
|
lua_pop(L, 1);
|
2013-01-04 16:01:50 +01:00
|
|
|
throw ScriptLoadError(err);
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
2008-03-09 22:09:51 +01:00
|
|
|
_stackcheck.check_stack(1);
|
2011-09-28 21:48:37 +02:00
|
|
|
|
2006-12-28 22:18:35 +01:00
|
|
|
// and execute it
|
|
|
|
// this is where features are registered
|
2007-04-22 17:45:29 +02:00
|
|
|
// don't thread this, as there's no point in it and it seems to break on wx 2.8.3, for some reason
|
|
|
|
if (lua_pcall(L, 0, 0, 0)) {
|
|
|
|
// error occurred, assumed to be on top of Lua stack
|
2013-03-18 15:01:54 +01:00
|
|
|
std::string err = str(boost::format("Error initialising Lua script \"%s\":\n\n%s") % GetPrettyFilename().string() % get_string_or_default(L, -1));
|
2012-08-20 05:32:18 +02:00
|
|
|
lua_pop(L, 1);
|
2013-01-04 16:01:50 +01:00
|
|
|
throw ScriptLoadError(err);
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
2008-03-09 22:09:51 +01:00
|
|
|
_stackcheck.check_stack(0);
|
2011-09-28 21:48:37 +02:00
|
|
|
|
2006-12-28 23:55:41 +01:00
|
|
|
lua_getglobal(L, "version");
|
2011-09-28 21:48:37 +02:00
|
|
|
if (lua_isnumber(L, -1) && lua_tointeger(L, -1) == 3) {
|
|
|
|
lua_pop(L, 1); // just to avoid tripping the stackcheck in debug
|
2011-09-28 21:48:28 +02:00
|
|
|
throw ScriptLoadError("Attempted to load an Automation 3 script as an Automation 4 Lua script. Automation 3 is no longer supported.");
|
2006-12-28 23:55:41 +01:00
|
|
|
}
|
2011-09-28 21:48:37 +02:00
|
|
|
|
|
|
|
name = get_global_string(L, "script_name");
|
|
|
|
description = get_global_string(L, "script_description");
|
|
|
|
author = get_global_string(L, "script_author");
|
|
|
|
version = get_global_string(L, "script_version");
|
|
|
|
|
|
|
|
if (name.empty())
|
2013-01-04 16:01:50 +01:00
|
|
|
name = GetPrettyFilename().string();
|
2011-09-28 21:48:37 +02:00
|
|
|
|
|
|
|
lua_pop(L, 1);
|
2006-12-28 22:18:35 +01:00
|
|
|
// if we got this far, the script should be ready
|
2008-03-09 22:09:51 +01:00
|
|
|
_stackcheck.check_stack(0);
|
2006-12-28 22:18:35 +01:00
|
|
|
|
|
|
|
}
|
2011-09-28 21:48:28 +02:00
|
|
|
catch (agi::Exception const& e) {
|
2007-02-14 01:43:01 +01:00
|
|
|
Destroy();
|
2013-01-04 16:01:50 +01:00
|
|
|
name = GetPrettyFilename().string();
|
|
|
|
description = e.GetChainedMessage();
|
2007-02-14 01:43:01 +01:00
|
|
|
}
|
2011-09-28 21:48:37 +02:00
|
|
|
}
|
Note: This was done using a script! it's far from perfect but 95% of the work has been done already formatting-wise.
Document all functions, class, struct, union, enum, macro, variable, typedefs. This isn't the actual document in itself but empty documentation using any old documentation if it was there.
This was done using exuberant ctags to get tag info, then a TCL script to parse/remove old comments and convert them into Doxygen-style.
Some notes:
* Anything labeled 'DOCME' needs to be documented, @param and @return have been left blank as it would be annoying to delete the 'DOCME' from every one of those.
* Some multiline comments may have been munged into single line comments
* Leave the /// comments above global variables with a space, if they're harder to read then we'll be less likey to use them.
* Enum comments can go after the enumeration itself '[value] /// comment'
* include/aegisub/*.h haven't been converted yet, this will be done in a later commit
* Some documentation blocks are in the wrong place, in the .h when it should be in the .cpp, or vice versa.
See http://devel.aegisub.org/wiki/Doxygen for some details on Doxygen and a 'style guide'.
Originally committed to SVN as r3312.
2009-07-30 00:59:22 +02:00
|
|
|
|
2006-12-28 22:18:35 +01:00
|
|
|
void LuaScript::Destroy()
|
|
|
|
{
|
|
|
|
// Assume the script object is clean if there's no Lua state
|
|
|
|
if (!L) return;
|
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
// loops backwards because commands remove themselves from macros when
|
|
|
|
// they're unregistered
|
|
|
|
for (int i = macros.size() - 1; i >= 0; --i)
|
|
|
|
cmd::unreg(macros[i]->name());
|
|
|
|
|
|
|
|
delete_clear(filters);
|
2006-12-28 22:18:35 +01:00
|
|
|
|
|
|
|
lua_close(L);
|
|
|
|
L = 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
void LuaScript::Reload()
|
|
|
|
{
|
|
|
|
Create();
|
|
|
|
}
|
|
|
|
|
2011-09-28 21:52:28 +02:00
|
|
|
void LuaScript::RegisterCommand(LuaCommand *command)
|
|
|
|
{
|
2012-11-04 04:53:03 +01:00
|
|
|
for (auto macro : macros) {
|
|
|
|
if (macro->name() == command->name()) {
|
2011-09-28 21:52:28 +02:00
|
|
|
luaL_error(L,
|
|
|
|
"A macro named '%s' is already defined in script '%s'",
|
2013-01-04 16:01:50 +01:00
|
|
|
command->StrDisplay(0).utf8_str().data(), name.c_str());
|
2011-09-28 21:52:28 +02:00
|
|
|
}
|
|
|
|
}
|
2011-09-28 21:48:47 +02:00
|
|
|
macros.push_back(command);
|
|
|
|
}
|
|
|
|
|
2011-09-28 21:52:28 +02:00
|
|
|
void LuaScript::UnregisterCommand(LuaCommand *command)
|
|
|
|
{
|
2011-09-28 21:48:47 +02:00
|
|
|
macros.erase(remove(macros.begin(), macros.end(), command), macros.end());
|
|
|
|
}
|
|
|
|
|
2011-09-28 21:52:28 +02:00
|
|
|
void LuaScript::RegisterFilter(LuaExportFilter *filter)
|
|
|
|
{
|
2011-09-28 21:48:47 +02:00
|
|
|
filters.push_back(filter);
|
|
|
|
}
|
|
|
|
|
2006-12-28 22:18:35 +01:00
|
|
|
LuaScript* LuaScript::GetScriptObject(lua_State *L)
|
|
|
|
{
|
|
|
|
lua_getfield(L, LUA_REGISTRYINDEX, "aegisub");
|
|
|
|
void *ptr = lua_touserdata(L, -1);
|
|
|
|
lua_pop(L, 1);
|
|
|
|
return (LuaScript*)ptr;
|
|
|
|
}
|
|
|
|
|
|
|
|
int LuaScript::LuaTextExtents(lua_State *L)
|
|
|
|
{
|
2011-09-28 21:48:47 +02:00
|
|
|
luaL_argcheck(L, lua_istable(L, 1), 1, "");
|
|
|
|
luaL_argcheck(L, lua_isstring(L, 2), 2, "");
|
2006-12-28 22:18:35 +01:00
|
|
|
|
|
|
|
lua_pushvalue(L, 1);
|
2011-09-28 21:48:37 +02:00
|
|
|
agi::scoped_ptr<AssEntry> et(LuaAssFile::LuaToAssEntry(L));
|
|
|
|
AssStyle *st = dynamic_cast<AssStyle*>(et.get());
|
2006-12-28 22:18:35 +01:00
|
|
|
lua_pop(L, 1);
|
2011-09-28 21:48:37 +02:00
|
|
|
if (!st)
|
|
|
|
return luaL_error(L, "Not a style entry");
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2007-01-15 18:02:39 +01:00
|
|
|
double width, height, descent, extlead;
|
2013-01-04 16:01:50 +01:00
|
|
|
if (!CalculateTextExtents(st, luaL_checkstring(L, 2), width, height, descent, extlead))
|
2011-09-28 21:48:37 +02:00
|
|
|
return luaL_error(L, "Some internal error occurred calculating text_extents");
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, width);
|
|
|
|
push_value(L, height);
|
|
|
|
push_value(L, descent);
|
|
|
|
push_value(L, extlead);
|
2006-12-28 22:18:35 +01:00
|
|
|
return 4;
|
|
|
|
}
|
|
|
|
|
2010-01-28 02:13:13 +01:00
|
|
|
/// @brief Module loader which uses our include rather than Lua's, for unicode file support
|
|
|
|
/// @param L The Lua state
|
|
|
|
/// @return Always 1 per loader_Lua?
|
|
|
|
int LuaScript::LuaModuleLoader(lua_State *L)
|
|
|
|
{
|
|
|
|
int pretop = lua_gettop(L);
|
2013-03-18 15:01:54 +01:00
|
|
|
std::string module(luaL_checkstring(L, -1));
|
2013-01-04 16:01:50 +01:00
|
|
|
boost::replace_all(module, ".", LUA_DIRSEP);
|
2010-01-28 02:13:13 +01:00
|
|
|
|
2011-09-28 21:52:02 +02:00
|
|
|
// Get the lua package include path (which the user may have modified)
|
2010-01-28 02:13:13 +01:00
|
|
|
lua_getglobal(L, "package");
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, "path");
|
2010-01-28 02:13:13 +01:00
|
|
|
lua_gettable(L, -2);
|
2013-03-18 15:01:54 +01:00
|
|
|
std::string package_paths(luaL_checkstring(L, -1));
|
2010-01-28 02:13:13 +01:00
|
|
|
lua_pop(L, 2);
|
|
|
|
|
2013-01-04 16:01:50 +01:00
|
|
|
boost::char_separator<char> sep(";");
|
|
|
|
for (auto filename : boost::tokenizer<boost::char_separator<char>>(package_paths, sep)) {
|
|
|
|
boost::replace_all(filename, "?", module);
|
2011-09-28 21:52:02 +02:00
|
|
|
try {
|
2010-01-28 02:13:13 +01:00
|
|
|
LuaScriptReader script_reader(filename);
|
2013-01-04 16:01:50 +01:00
|
|
|
if (lua_load(L, script_reader.reader_func, &script_reader, filename.c_str()))
|
2013-03-18 15:01:54 +01:00
|
|
|
return luaL_error(L, "Error loading Lua module \"%s\":\n\n%s", filename.c_str(), luaL_checkstring(L, -1));
|
2011-09-28 21:52:02 +02:00
|
|
|
break;
|
|
|
|
}
|
2013-01-04 16:01:50 +01:00
|
|
|
catch (agi::fs::FileNotFound const&) {
|
2011-09-28 21:52:02 +02:00
|
|
|
// Not an error so swallow and continue on
|
|
|
|
}
|
2013-01-04 16:01:50 +01:00
|
|
|
catch (agi::fs::NotAFile const&) {
|
2011-09-28 21:52:02 +02:00
|
|
|
// Not an error so swallow and continue on
|
|
|
|
}
|
|
|
|
catch (agi::Exception const& e) {
|
2013-01-04 16:01:50 +01:00
|
|
|
return luaL_error(L, "Error loading Lua module \"%s\":\n\n%s", filename.c_str(), e.GetChainedMessage().c_str());
|
2010-01-28 02:13:13 +01:00
|
|
|
}
|
|
|
|
}
|
2011-09-28 21:52:02 +02:00
|
|
|
|
2010-01-28 02:13:13 +01:00
|
|
|
return lua_gettop(L) - pretop;
|
|
|
|
}
|
|
|
|
|
2006-12-28 22:18:35 +01:00
|
|
|
int LuaScript::LuaInclude(lua_State *L)
|
|
|
|
{
|
2013-01-04 16:01:50 +01:00
|
|
|
const LuaScript *s = GetScriptObject(L);
|
|
|
|
|
|
|
|
const std::string filename(luaL_checkstring(L, 1));
|
|
|
|
agi::fs::path filepath;
|
|
|
|
|
|
|
|
// Relative or absolute path
|
|
|
|
if (!boost::all(filename, !boost::is_any_of("/\\")))
|
|
|
|
filepath = s->GetFilename().parent_path()/filename;
|
|
|
|
else { // Plain filename
|
|
|
|
for (auto const& dir : s->include_path) {
|
|
|
|
filepath = dir/filename;
|
|
|
|
if (agi::fs::FileExists(filepath))
|
|
|
|
break;
|
|
|
|
}
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
|
|
|
|
2013-01-04 16:01:50 +01:00
|
|
|
if (!agi::fs::FileExists(filepath))
|
|
|
|
return luaL_error(L, "Lua include not found: %s", filename.c_str());
|
|
|
|
|
|
|
|
LuaScriptReader script_reader(filepath);
|
|
|
|
if (lua_load(L, script_reader.reader_func, &script_reader, filename.c_str()))
|
2013-03-18 15:01:54 +01:00
|
|
|
return luaL_error(L, "Error loading Lua include \"%s\":\n\n%s", filename.c_str(), luaL_checkstring(L, -1));
|
2011-09-28 21:48:37 +02:00
|
|
|
|
2006-12-28 22:18:35 +01:00
|
|
|
int pretop = lua_gettop(L) - 1; // don't count the function value itself
|
|
|
|
lua_call(L, 0, LUA_MULTRET);
|
|
|
|
return lua_gettop(L) - pretop;
|
|
|
|
}
|
|
|
|
|
2007-02-15 13:56:36 +01:00
|
|
|
int LuaScript::LuaFrameFromMs(lua_State *L)
|
|
|
|
{
|
2011-09-28 21:49:47 +02:00
|
|
|
const agi::Context *c = get_context(L);
|
2011-09-28 21:48:37 +02:00
|
|
|
int ms = lua_tointeger(L, -1);
|
2007-02-15 13:56:36 +01:00
|
|
|
lua_pop(L, 1);
|
2012-01-09 21:31:19 +01:00
|
|
|
if (c && c->videoController->TimecodesLoaded())
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, c->videoController->FrameAtTime(ms, agi::vfr::START));
|
2011-09-28 21:48:37 +02:00
|
|
|
else
|
2007-02-15 13:56:36 +01:00
|
|
|
lua_pushnil(L);
|
|
|
|
|
2011-09-28 21:48:37 +02:00
|
|
|
return 1;
|
|
|
|
}
|
Note: This was done using a script! it's far from perfect but 95% of the work has been done already formatting-wise.
Document all functions, class, struct, union, enum, macro, variable, typedefs. This isn't the actual document in itself but empty documentation using any old documentation if it was there.
This was done using exuberant ctags to get tag info, then a TCL script to parse/remove old comments and convert them into Doxygen-style.
Some notes:
* Anything labeled 'DOCME' needs to be documented, @param and @return have been left blank as it would be annoying to delete the 'DOCME' from every one of those.
* Some multiline comments may have been munged into single line comments
* Leave the /// comments above global variables with a space, if they're harder to read then we'll be less likey to use them.
* Enum comments can go after the enumeration itself '[value] /// comment'
* include/aegisub/*.h haven't been converted yet, this will be done in a later commit
* Some documentation blocks are in the wrong place, in the .h when it should be in the .cpp, or vice versa.
See http://devel.aegisub.org/wiki/Doxygen for some details on Doxygen and a 'style guide'.
Originally committed to SVN as r3312.
2009-07-30 00:59:22 +02:00
|
|
|
|
2007-02-15 13:56:36 +01:00
|
|
|
int LuaScript::LuaMsFromFrame(lua_State *L)
|
|
|
|
{
|
2011-09-28 21:49:47 +02:00
|
|
|
const agi::Context *c = get_context(L);
|
2011-09-28 21:48:37 +02:00
|
|
|
int frame = lua_tointeger(L, -1);
|
2007-02-15 13:56:36 +01:00
|
|
|
lua_pop(L, 1);
|
2012-01-09 21:31:19 +01:00
|
|
|
if (c && c->videoController->TimecodesLoaded())
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, c->videoController->TimeAtFrame(frame, agi::vfr::START));
|
2011-09-28 21:48:37 +02:00
|
|
|
else
|
2007-02-15 13:56:36 +01:00
|
|
|
lua_pushnil(L);
|
2011-09-28 21:48:37 +02:00
|
|
|
return 1;
|
|
|
|
}
|
Note: This was done using a script! it's far from perfect but 95% of the work has been done already formatting-wise.
Document all functions, class, struct, union, enum, macro, variable, typedefs. This isn't the actual document in itself but empty documentation using any old documentation if it was there.
This was done using exuberant ctags to get tag info, then a TCL script to parse/remove old comments and convert them into Doxygen-style.
Some notes:
* Anything labeled 'DOCME' needs to be documented, @param and @return have been left blank as it would be annoying to delete the 'DOCME' from every one of those.
* Some multiline comments may have been munged into single line comments
* Leave the /// comments above global variables with a space, if they're harder to read then we'll be less likey to use them.
* Enum comments can go after the enumeration itself '[value] /// comment'
* include/aegisub/*.h haven't been converted yet, this will be done in a later commit
* Some documentation blocks are in the wrong place, in the .h when it should be in the .cpp, or vice versa.
See http://devel.aegisub.org/wiki/Doxygen for some details on Doxygen and a 'style guide'.
Originally committed to SVN as r3312.
2009-07-30 00:59:22 +02:00
|
|
|
|
2008-09-10 18:53:23 +02:00
|
|
|
int LuaScript::LuaVideoSize(lua_State *L)
|
|
|
|
{
|
2011-09-28 21:49:47 +02:00
|
|
|
const agi::Context *c = get_context(L);
|
2012-01-09 21:31:19 +01:00
|
|
|
if (c && c->videoController->IsLoaded()) {
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, c->videoController->GetWidth());
|
|
|
|
push_value(L, c->videoController->GetHeight());
|
|
|
|
push_value(L, c->videoController->GetAspectRatioValue());
|
|
|
|
push_value(L, (int)c->videoController->GetAspectRatioType());
|
2008-09-10 18:53:23 +02:00
|
|
|
return 4;
|
2011-09-28 21:49:47 +02:00
|
|
|
}
|
|
|
|
else {
|
2008-09-10 18:53:23 +02:00
|
|
|
lua_pushnil(L);
|
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2011-12-22 22:29:56 +01:00
|
|
|
int LuaScript::LuaGetKeyframes(lua_State *L)
|
|
|
|
{
|
|
|
|
const agi::Context *c = get_context(L);
|
2012-01-09 21:31:19 +01:00
|
|
|
if (!c) {
|
|
|
|
lua_pushnil(L);
|
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
|
2011-12-22 22:29:56 +01:00
|
|
|
std::vector<int> const& kf = c->videoController->GetKeyFrames();
|
|
|
|
|
|
|
|
lua_newtable(L);
|
|
|
|
for (size_t i = 0; i < kf.size(); ++i) {
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, kf[i]);
|
2011-12-22 22:29:56 +01:00
|
|
|
lua_rawseti(L, -2, i);
|
|
|
|
}
|
|
|
|
|
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
|
2011-12-22 22:30:05 +01:00
|
|
|
int LuaScript::LuaDecodePath(lua_State *L)
|
|
|
|
{
|
2013-01-04 16:01:50 +01:00
|
|
|
std::string path = luaL_checkstring(L, 1);
|
2011-12-22 22:30:05 +01:00
|
|
|
lua_pop(L, 1);
|
2013-01-30 04:35:37 +01:00
|
|
|
push_value(L, config::path->Decode(path));
|
2011-12-22 22:30:05 +01:00
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
|
2012-01-20 22:33:20 +01:00
|
|
|
int LuaScript::LuaCancel(lua_State *L)
|
|
|
|
{
|
|
|
|
lua_pushnil(L);
|
|
|
|
return lua_error(L);
|
|
|
|
}
|
|
|
|
|
2013-01-04 16:01:50 +01:00
|
|
|
void LuaThreadedCall(lua_State *L, int nargs, int nresults, std::string const& title, wxWindow *parent, bool can_open_config)
|
2011-09-28 21:47:40 +02:00
|
|
|
{
|
2011-10-25 03:15:03 +02:00
|
|
|
bool failed = false;
|
2011-09-28 21:47:40 +02:00
|
|
|
BackgroundScriptRunner bsr(parent, title);
|
2012-11-26 06:28:13 +01:00
|
|
|
bsr.Run([&](ProgressSink *ps) {
|
|
|
|
LuaProgressSink lps(L, ps, can_open_config);
|
|
|
|
|
|
|
|
if (lua_pcall(L, nargs, nresults, 0)) {
|
|
|
|
if (!lua_isnil(L, -1)) {
|
|
|
|
// if the call failed, log the error here
|
|
|
|
ps->Log("\n\nLua reported a runtime error:\n");
|
2013-03-18 15:01:54 +01:00
|
|
|
ps->Log(get_string_or_default(L, -1));
|
2012-11-26 06:28:13 +01:00
|
|
|
}
|
|
|
|
lua_pop(L, 1);
|
|
|
|
failed = true;
|
|
|
|
}
|
|
|
|
|
|
|
|
lua_gc(L, LUA_GCCOLLECT, 0);
|
|
|
|
});
|
2011-10-25 03:15:03 +02:00
|
|
|
if (failed)
|
|
|
|
throw agi::UserCancelException("Script threw an error");
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// LuaFeature
|
2011-09-28 21:48:47 +02:00
|
|
|
LuaFeature::LuaFeature(lua_State *L)
|
2012-10-26 16:09:14 +02:00
|
|
|
: myid(0)
|
|
|
|
, L(L)
|
2006-12-28 22:18:35 +01:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
void LuaFeature::RegisterFeature()
|
|
|
|
{
|
2011-09-28 21:48:47 +02:00
|
|
|
myid = luaL_ref(L, LUA_REGISTRYINDEX);
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
void LuaFeature::UnregisterFeature()
|
|
|
|
{
|
|
|
|
luaL_unref(L, LUA_REGISTRYINDEX, myid);
|
|
|
|
}
|
Note: This was done using a script! it's far from perfect but 95% of the work has been done already formatting-wise.
Document all functions, class, struct, union, enum, macro, variable, typedefs. This isn't the actual document in itself but empty documentation using any old documentation if it was there.
This was done using exuberant ctags to get tag info, then a TCL script to parse/remove old comments and convert them into Doxygen-style.
Some notes:
* Anything labeled 'DOCME' needs to be documented, @param and @return have been left blank as it would be annoying to delete the 'DOCME' from every one of those.
* Some multiline comments may have been munged into single line comments
* Leave the /// comments above global variables with a space, if they're harder to read then we'll be less likey to use them.
* Enum comments can go after the enumeration itself '[value] /// comment'
* include/aegisub/*.h haven't been converted yet, this will be done in a later commit
* Some documentation blocks are in the wrong place, in the .h when it should be in the .cpp, or vice versa.
See http://devel.aegisub.org/wiki/Doxygen for some details on Doxygen and a 'style guide'.
Originally committed to SVN as r3312.
2009-07-30 00:59:22 +02:00
|
|
|
|
2012-01-20 22:33:39 +01:00
|
|
|
void LuaFeature::GetFeatureFunction(const char *function) const
|
2006-12-28 22:18:35 +01:00
|
|
|
{
|
|
|
|
// get this feature's function pointers
|
2011-09-28 21:48:47 +02:00
|
|
|
lua_rawgeti(L, LUA_REGISTRYINDEX, myid);
|
2006-12-28 22:18:35 +01:00
|
|
|
// get pointer for validation function
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, function);
|
2011-09-28 21:48:47 +02:00
|
|
|
lua_rawget(L, -2);
|
|
|
|
// remove the function table
|
2006-12-28 22:18:35 +01:00
|
|
|
lua_remove(L, -2);
|
2011-09-28 21:48:47 +02:00
|
|
|
assert(lua_isfunction(L, -1));
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
// LuaFeatureMacro
|
|
|
|
int LuaCommand::LuaRegister(lua_State *L)
|
2006-12-28 22:18:35 +01:00
|
|
|
{
|
2011-09-28 21:48:47 +02:00
|
|
|
cmd::reg(new LuaCommand(L));
|
|
|
|
return 0;
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
LuaCommand::LuaCommand(lua_State *L)
|
|
|
|
: LuaFeature(L)
|
|
|
|
, display(check_wxstring(L, 1))
|
2012-01-25 01:21:37 +01:00
|
|
|
, help(get_wxstring(L, 2))
|
2011-09-28 21:48:47 +02:00
|
|
|
, cmd_type(cmd::COMMAND_NORMAL)
|
2006-12-28 22:18:35 +01:00
|
|
|
{
|
2011-09-28 21:52:20 +02:00
|
|
|
lua_getfield(L, LUA_REGISTRYINDEX, "filename");
|
2013-03-18 15:01:54 +01:00
|
|
|
cmd_name = str(boost::format("automation/lua/%s/%s") % luaL_checkstring(L, -1) % luaL_checkstring(L, 1));
|
2011-09-28 21:52:20 +02:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
if (!lua_isfunction(L, 3))
|
|
|
|
luaL_error(L, "The macro processing function must be a function");
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
if (lua_isfunction(L, 4))
|
|
|
|
cmd_type |= cmd::COMMAND_VALIDATE;
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
if (lua_isfunction(L, 5))
|
|
|
|
cmd_type |= cmd::COMMAND_TOGGLE;
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
// new table for containing the functions for this feature
|
|
|
|
lua_newtable(L);
|
Note: This was done using a script! it's far from perfect but 95% of the work has been done already formatting-wise.
Document all functions, class, struct, union, enum, macro, variable, typedefs. This isn't the actual document in itself but empty documentation using any old documentation if it was there.
This was done using exuberant ctags to get tag info, then a TCL script to parse/remove old comments and convert them into Doxygen-style.
Some notes:
* Anything labeled 'DOCME' needs to be documented, @param and @return have been left blank as it would be annoying to delete the 'DOCME' from every one of those.
* Some multiline comments may have been munged into single line comments
* Leave the /// comments above global variables with a space, if they're harder to read then we'll be less likey to use them.
* Enum comments can go after the enumeration itself '[value] /// comment'
* include/aegisub/*.h haven't been converted yet, this will be done in a later commit
* Some documentation blocks are in the wrong place, in the .h when it should be in the .cpp, or vice versa.
See http://devel.aegisub.org/wiki/Doxygen for some details on Doxygen and a 'style guide'.
Originally committed to SVN as r3312.
2009-07-30 00:59:22 +02:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
// store processing function
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, "run");
|
2011-09-28 21:48:47 +02:00
|
|
|
lua_pushvalue(L, 3);
|
|
|
|
lua_rawset(L, -3);
|
|
|
|
|
|
|
|
// store validation function
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, "validate");
|
2011-09-28 21:48:47 +02:00
|
|
|
lua_pushvalue(L, 4);
|
|
|
|
lua_rawset(L, -3);
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
// store active function
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, "isactive");
|
2011-09-28 21:48:47 +02:00
|
|
|
lua_pushvalue(L, 5);
|
|
|
|
lua_rawset(L, -3);
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
// store the table in the registry
|
|
|
|
RegisterFeature();
|
|
|
|
|
|
|
|
LuaScript::GetScriptObject(L)->RegisterCommand(this);
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
LuaCommand::~LuaCommand()
|
|
|
|
{
|
|
|
|
UnregisterFeature();
|
|
|
|
LuaScript::GetScriptObject(L)->UnregisterCommand(this);
|
|
|
|
}
|
Note: This was done using a script! it's far from perfect but 95% of the work has been done already formatting-wise.
Document all functions, class, struct, union, enum, macro, variable, typedefs. This isn't the actual document in itself but empty documentation using any old documentation if it was there.
This was done using exuberant ctags to get tag info, then a TCL script to parse/remove old comments and convert them into Doxygen-style.
Some notes:
* Anything labeled 'DOCME' needs to be documented, @param and @return have been left blank as it would be annoying to delete the 'DOCME' from every one of those.
* Some multiline comments may have been munged into single line comments
* Leave the /// comments above global variables with a space, if they're harder to read then we'll be less likey to use them.
* Enum comments can go after the enumeration itself '[value] /// comment'
* include/aegisub/*.h haven't been converted yet, this will be done in a later commit
* Some documentation blocks are in the wrong place, in the .h when it should be in the .cpp, or vice versa.
See http://devel.aegisub.org/wiki/Doxygen for some details on Doxygen and a 'style guide'.
Originally committed to SVN as r3312.
2009-07-30 00:59:22 +02:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
static int transform_selection(lua_State *L, const agi::Context *c)
|
2006-12-28 22:18:35 +01:00
|
|
|
{
|
2012-10-05 05:22:54 +02:00
|
|
|
SubtitleSelection const& sel = c->selectionController->GetSelectedSet();
|
2011-09-28 21:48:47 +02:00
|
|
|
AssDialogue *active_line = c->selectionController->GetActiveLine();
|
|
|
|
|
2006-12-28 22:18:35 +01:00
|
|
|
lua_newtable(L);
|
2011-09-28 21:48:47 +02:00
|
|
|
int active_idx = -1;
|
|
|
|
|
2012-11-04 04:53:03 +01:00
|
|
|
int row = 0;
|
2011-09-28 21:48:47 +02:00
|
|
|
int idx = 1;
|
2012-11-04 04:53:03 +01:00
|
|
|
for (auto& line : c->ass->Line) {
|
|
|
|
++row;
|
|
|
|
AssDialogue *diag = dynamic_cast<AssDialogue*>(&line);
|
2011-09-28 21:48:47 +02:00
|
|
|
if (!diag) continue;
|
|
|
|
|
|
|
|
if (diag == active_line) active_idx = row;
|
|
|
|
if (sel.count(diag)) {
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, row);
|
2011-09-28 21:48:47 +02:00
|
|
|
lua_rawseti(L, -2, idx++);
|
|
|
|
}
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
return active_idx;
|
|
|
|
}
|
Note: This was done using a script! it's far from perfect but 95% of the work has been done already formatting-wise.
Document all functions, class, struct, union, enum, macro, variable, typedefs. This isn't the actual document in itself but empty documentation using any old documentation if it was there.
This was done using exuberant ctags to get tag info, then a TCL script to parse/remove old comments and convert them into Doxygen-style.
Some notes:
* Anything labeled 'DOCME' needs to be documented, @param and @return have been left blank as it would be annoying to delete the 'DOCME' from every one of those.
* Some multiline comments may have been munged into single line comments
* Leave the /// comments above global variables with a space, if they're harder to read then we'll be less likey to use them.
* Enum comments can go after the enumeration itself '[value] /// comment'
* include/aegisub/*.h haven't been converted yet, this will be done in a later commit
* Some documentation blocks are in the wrong place, in the .h when it should be in the .cpp, or vice versa.
See http://devel.aegisub.org/wiki/Doxygen for some details on Doxygen and a 'style guide'.
Originally committed to SVN as r3312.
2009-07-30 00:59:22 +02:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
bool LuaCommand::Validate(const agi::Context *c)
|
2006-12-28 22:18:35 +01:00
|
|
|
{
|
2011-09-28 21:48:47 +02:00
|
|
|
if (!(cmd_type & cmd::COMMAND_VALIDATE)) return true;
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2011-09-28 21:49:47 +02:00
|
|
|
set_context(L, c);
|
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
GetFeatureFunction("validate");
|
|
|
|
LuaAssFile *subsobj = new LuaAssFile(L, c->ass);
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, transform_selection(L, c));
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2012-01-25 01:21:37 +01:00
|
|
|
int err = lua_pcall(L, 3, 2, 0);
|
2011-09-28 21:48:47 +02:00
|
|
|
|
|
|
|
subsobj->ProcessingComplete();
|
|
|
|
|
2012-01-25 01:21:37 +01:00
|
|
|
if (err) {
|
2011-09-28 21:48:47 +02:00
|
|
|
wxLogWarning("Runtime error in Lua macro validation function:\n%s", get_wxstring(L, -1));
|
2012-01-25 01:21:37 +01:00
|
|
|
lua_pop(L, 1);
|
|
|
|
return false;
|
|
|
|
}
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2012-01-25 01:21:37 +01:00
|
|
|
bool result = !!lua_toboolean(L, -2);
|
|
|
|
|
|
|
|
wxString new_help_string(get_wxstring(L, -1));
|
|
|
|
if (new_help_string.size()) {
|
|
|
|
help = new_help_string;
|
|
|
|
cmd_type |= cmd::COMMAND_DYNAMIC_HELP;
|
|
|
|
}
|
|
|
|
|
|
|
|
lua_pop(L, 2);
|
2006-12-28 22:18:35 +01:00
|
|
|
|
|
|
|
return result;
|
|
|
|
}
|
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
void LuaCommand::operator()(agi::Context *c)
|
2006-12-28 22:18:35 +01:00
|
|
|
{
|
2012-02-10 02:41:22 +01:00
|
|
|
LuaStackcheck stackcheck(L);
|
2011-09-28 21:49:47 +02:00
|
|
|
set_context(L, c);
|
2012-02-10 02:41:22 +01:00
|
|
|
stackcheck.check_stack(0);
|
2011-09-28 21:49:47 +02:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
GetFeatureFunction("run");
|
|
|
|
LuaAssFile *subsobj = new LuaAssFile(L, c->ass, true, true);
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, transform_selection(L, c));
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2011-09-28 21:50:14 +02:00
|
|
|
try {
|
2013-01-04 16:01:50 +01:00
|
|
|
LuaThreadedCall(L, 3, 2, from_wx(StrDisplay(c)), c->parent, true);
|
2011-09-28 21:50:14 +02:00
|
|
|
|
|
|
|
subsobj->ProcessingComplete(StrDisplay(c));
|
|
|
|
|
2012-01-31 01:44:16 +01:00
|
|
|
AssDialogue *active_line = 0;
|
|
|
|
int active_idx = 0;
|
|
|
|
|
|
|
|
// Check for a new active row
|
|
|
|
if (lua_isnumber(L, -1)) {
|
|
|
|
active_idx = lua_tointeger(L, -1);
|
|
|
|
if (active_idx < 1 || active_idx > (int)c->ass->Line.size()) {
|
|
|
|
wxLogError("Active row %d is out of bounds (must be 1-%u)", active_idx, c->ass->Line.size());
|
|
|
|
active_idx = 0;
|
|
|
|
}
|
|
|
|
}
|
2012-02-10 02:41:22 +01:00
|
|
|
|
|
|
|
stackcheck.check_stack(2);
|
2012-01-31 01:44:16 +01:00
|
|
|
lua_pop(L, 1);
|
|
|
|
|
2011-09-28 21:50:14 +02:00
|
|
|
// top of stack will be selected lines array, if any was returned
|
|
|
|
if (lua_istable(L, -1)) {
|
|
|
|
std::set<AssDialogue*> sel;
|
|
|
|
entryIter it = c->ass->Line.begin();
|
|
|
|
int last_idx = 1;
|
|
|
|
lua_pushnil(L);
|
|
|
|
while (lua_next(L, -2)) {
|
|
|
|
if (lua_isnumber(L, -1)) {
|
|
|
|
int cur = lua_tointeger(L, -1);
|
|
|
|
if (cur < 1 || cur > (int)c->ass->Line.size()) {
|
|
|
|
wxLogError("Selected row %d is out of bounds (must be 1-%u)", cur, c->ass->Line.size());
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
|
|
|
advance(it, cur - last_idx);
|
|
|
|
|
2012-10-12 19:16:39 +02:00
|
|
|
AssDialogue *diag = dynamic_cast<AssDialogue*>(&*it);
|
2011-09-28 21:50:14 +02:00
|
|
|
if (!diag) {
|
|
|
|
wxLogError("Selected row %d is not a dialogue line", cur);
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
|
|
|
sel.insert(diag);
|
|
|
|
last_idx = cur;
|
2012-01-31 01:44:16 +01:00
|
|
|
if (!active_line || active_idx == cur)
|
|
|
|
active_line = diag;
|
2011-09-28 21:48:47 +02:00
|
|
|
}
|
2011-09-28 21:50:14 +02:00
|
|
|
lua_pop(L, 1);
|
2007-07-06 16:26:04 +02:00
|
|
|
}
|
2011-09-28 21:48:47 +02:00
|
|
|
|
2012-05-05 04:11:09 +02:00
|
|
|
AssDialogue *new_active = c->selectionController->GetActiveLine();
|
|
|
|
if (active_line && (active_idx > 0 || !sel.count(new_active)))
|
|
|
|
new_active = active_line;
|
|
|
|
c->selectionController->SetSelectionAndActive(sel, new_active);
|
2011-09-28 21:50:14 +02:00
|
|
|
}
|
2012-02-10 02:41:22 +01:00
|
|
|
|
|
|
|
stackcheck.check_stack(1);
|
|
|
|
lua_pop(L, 1);
|
2011-09-28 21:50:14 +02:00
|
|
|
}
|
|
|
|
catch (agi::UserCancelException const&) {
|
|
|
|
subsobj->Cancel();
|
2007-07-06 16:26:04 +02:00
|
|
|
}
|
2012-02-10 03:16:49 +01:00
|
|
|
stackcheck.check_stack(0);
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
bool LuaCommand::IsActive(const agi::Context *c)
|
|
|
|
{
|
2011-09-28 21:49:18 +02:00
|
|
|
if (!(cmd_type & cmd::COMMAND_TOGGLE)) return false;
|
|
|
|
|
2012-02-10 03:16:49 +01:00
|
|
|
LuaStackcheck stackcheck(L);
|
|
|
|
|
2011-09-28 21:49:47 +02:00
|
|
|
set_context(L, c);
|
2012-02-10 03:16:49 +01:00
|
|
|
stackcheck.check_stack(0);
|
2011-09-28 21:49:47 +02:00
|
|
|
|
2011-09-28 21:49:18 +02:00
|
|
|
GetFeatureFunction("isactive");
|
|
|
|
LuaAssFile *subsobj = new LuaAssFile(L, c->ass);
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, transform_selection(L, c));
|
2011-09-28 21:49:18 +02:00
|
|
|
|
|
|
|
int err = lua_pcall(L, 3, 1, 0);
|
|
|
|
subsobj->ProcessingComplete();
|
|
|
|
|
|
|
|
bool result = false;
|
|
|
|
if (err)
|
|
|
|
wxLogWarning("Runtime error in Lua macro IsActive function:\n%s", get_wxstring(L, -1));
|
|
|
|
else
|
|
|
|
result = !!lua_toboolean(L, -1);
|
|
|
|
|
|
|
|
// clean up stack (result or error message)
|
2012-02-10 03:16:49 +01:00
|
|
|
stackcheck.check_stack(1);
|
2011-09-28 21:49:18 +02:00
|
|
|
lua_pop(L, 1);
|
|
|
|
|
|
|
|
return result;
|
2011-09-28 21:48:47 +02:00
|
|
|
}
|
2006-12-28 22:18:35 +01:00
|
|
|
|
|
|
|
// LuaFeatureFilter
|
2011-09-28 21:48:47 +02:00
|
|
|
LuaExportFilter::LuaExportFilter(lua_State *L)
|
2013-01-04 16:01:50 +01:00
|
|
|
: ExportFilter(luaL_checkstring(L, 1), lua_tostring(L, 2), lua_tointeger(L, 3))
|
2011-09-28 21:48:47 +02:00
|
|
|
, LuaFeature(L)
|
2006-12-28 22:18:35 +01:00
|
|
|
{
|
2011-09-28 21:48:47 +02:00
|
|
|
if (!lua_isfunction(L, 4))
|
|
|
|
luaL_error(L, "The filter processing function must be a function");
|
|
|
|
|
|
|
|
// new table for containing the functions for this feature
|
2006-12-28 22:18:35 +01:00
|
|
|
lua_newtable(L);
|
2011-09-28 21:48:47 +02:00
|
|
|
|
|
|
|
// store processing function
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, "run");
|
2006-12-28 22:18:35 +01:00
|
|
|
lua_pushvalue(L, 4);
|
2011-09-28 21:48:47 +02:00
|
|
|
lua_rawset(L, -3);
|
|
|
|
|
|
|
|
// store config function
|
2013-01-04 16:01:50 +01:00
|
|
|
push_value(L, "config");
|
2006-12-28 22:18:35 +01:00
|
|
|
lua_pushvalue(L, 5);
|
|
|
|
has_config = lua_isfunction(L, -1);
|
2011-09-28 21:48:47 +02:00
|
|
|
lua_rawset(L, -3);
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
// store the table in the registry
|
|
|
|
RegisterFeature();
|
Note: This was done using a script! it's far from perfect but 95% of the work has been done already formatting-wise.
Document all functions, class, struct, union, enum, macro, variable, typedefs. This isn't the actual document in itself but empty documentation using any old documentation if it was there.
This was done using exuberant ctags to get tag info, then a TCL script to parse/remove old comments and convert them into Doxygen-style.
Some notes:
* Anything labeled 'DOCME' needs to be documented, @param and @return have been left blank as it would be annoying to delete the 'DOCME' from every one of those.
* Some multiline comments may have been munged into single line comments
* Leave the /// comments above global variables with a space, if they're harder to read then we'll be less likey to use them.
* Enum comments can go after the enumeration itself '[value] /// comment'
* include/aegisub/*.h haven't been converted yet, this will be done in a later commit
* Some documentation blocks are in the wrong place, in the .h when it should be in the .cpp, or vice versa.
See http://devel.aegisub.org/wiki/Doxygen for some details on Doxygen and a 'style guide'.
Originally committed to SVN as r3312.
2009-07-30 00:59:22 +02:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
LuaScript::GetScriptObject(L)->RegisterFilter(this);
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
int LuaExportFilter::LuaRegister(lua_State *L)
|
2006-12-28 22:18:35 +01:00
|
|
|
{
|
2011-09-28 21:48:47 +02:00
|
|
|
(void)new LuaExportFilter(L);
|
2006-12-28 22:18:35 +01:00
|
|
|
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
void LuaExportFilter::ProcessSubs(AssFile *subs, wxWindow *export_dialog)
|
2006-12-28 22:18:35 +01:00
|
|
|
{
|
2008-01-24 00:02:26 +01:00
|
|
|
LuaStackcheck stackcheck(L);
|
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
GetFeatureFunction("run");
|
2008-03-09 22:09:51 +01:00
|
|
|
stackcheck.check_stack(1);
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2011-09-28 21:48:47 +02:00
|
|
|
// The entire point of an export filter is to modify the file, but
|
|
|
|
// setting undo points makes no sense
|
|
|
|
LuaAssFile *subsobj = new LuaAssFile(L, subs, true);
|
2008-01-24 00:02:26 +01:00
|
|
|
assert(lua_isuserdata(L, -1));
|
2008-03-09 22:09:51 +01:00
|
|
|
stackcheck.check_stack(2);
|
2011-09-28 21:48:47 +02:00
|
|
|
|
2006-12-28 22:18:35 +01:00
|
|
|
// config
|
|
|
|
if (has_config && config_dialog) {
|
2008-01-24 00:02:26 +01:00
|
|
|
int results_produced = config_dialog->LuaReadBack(L);
|
|
|
|
assert(results_produced == 1);
|
2008-03-13 20:12:55 +01:00
|
|
|
(void) results_produced; // avoid warning on release builds
|
2006-12-28 22:18:35 +01:00
|
|
|
// TODO, write back stored options here
|
2007-02-20 03:50:40 +01:00
|
|
|
} else {
|
|
|
|
// no config so put an empty table instead
|
|
|
|
lua_newtable(L);
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
2008-01-24 00:02:26 +01:00
|
|
|
assert(lua_istable(L, -1));
|
2008-03-09 22:09:51 +01:00
|
|
|
stackcheck.check_stack(3);
|
2006-12-28 22:18:35 +01:00
|
|
|
|
2011-09-28 21:50:14 +02:00
|
|
|
try {
|
|
|
|
LuaThreadedCall(L, 2, 0, GetName(), export_dialog, false);
|
|
|
|
stackcheck.check_stack(0);
|
|
|
|
subsobj->ProcessingComplete();
|
|
|
|
}
|
|
|
|
catch (agi::UserCancelException const&) {
|
|
|
|
subsobj->Cancel();
|
|
|
|
throw;
|
|
|
|
}
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
|
|
|
|
2011-09-28 21:49:27 +02:00
|
|
|
ScriptDialog* LuaExportFilter::GenerateConfigDialog(wxWindow *parent, agi::Context *c)
|
2006-12-28 22:18:35 +01:00
|
|
|
{
|
|
|
|
if (!has_config)
|
|
|
|
return 0;
|
|
|
|
|
2011-09-28 21:49:47 +02:00
|
|
|
set_context(L, c);
|
|
|
|
|
2011-11-30 00:17:20 +01:00
|
|
|
GetFeatureFunction("config");
|
2006-12-28 22:18:35 +01:00
|
|
|
|
|
|
|
// prepare function call
|
2011-09-28 21:48:47 +02:00
|
|
|
LuaAssFile *subsobj = new LuaAssFile(L, c->ass);
|
2006-12-28 22:18:35 +01:00
|
|
|
// stored options
|
|
|
|
lua_newtable(L); // TODO, nothing for now
|
|
|
|
|
|
|
|
// do call
|
2009-07-28 17:39:52 +02:00
|
|
|
int err = lua_pcall(L, 2, 1, 0);
|
2011-09-28 21:48:47 +02:00
|
|
|
subsobj->ProcessingComplete();
|
|
|
|
|
2009-07-28 17:39:52 +02:00
|
|
|
if (err) {
|
2011-09-28 21:48:47 +02:00
|
|
|
wxLogWarning("Runtime error in Lua config dialog function:\n%s", get_wxstring(L, -1));
|
2009-07-28 17:39:52 +02:00
|
|
|
lua_pop(L, 1); // remove error message
|
|
|
|
} else {
|
|
|
|
// Create config dialogue from table on top of stack
|
2011-09-28 21:49:27 +02:00
|
|
|
config_dialog = new LuaDialog(L, false);
|
2007-02-20 03:50:40 +01:00
|
|
|
}
|
2011-09-28 21:48:47 +02:00
|
|
|
|
|
|
|
return config_dialog;
|
2006-12-28 22:18:35 +01:00
|
|
|
}
|
|
|
|
|
2011-09-28 21:46:05 +02:00
|
|
|
LuaScriptFactory::LuaScriptFactory()
|
|
|
|
: ScriptFactory("Lua", "*.lua")
|
2008-03-09 22:49:46 +01:00
|
|
|
{
|
|
|
|
Register(this);
|
|
|
|
}
|
|
|
|
|
2013-01-04 16:01:50 +01:00
|
|
|
Script* LuaScriptFactory::Produce(agi::fs::path const& filename) const
|
2008-03-09 22:49:46 +01:00
|
|
|
{
|
|
|
|
// Just check if file extension is .lua
|
|
|
|
// Reject anything else
|
2013-01-04 16:01:50 +01:00
|
|
|
if (agi::fs::HasExtension(filename, "lua"))
|
2008-03-09 22:49:46 +01:00
|
|
|
return new LuaScript(filename);
|
2013-01-04 16:01:50 +01:00
|
|
|
else
|
2008-03-09 22:49:46 +01:00
|
|
|
return 0;
|
|
|
|
}
|
2011-09-28 21:48:47 +02:00
|
|
|
}
|