// Copyright (c) 2007, Niels Martin Hansen // 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. // // ----------------------------------------------------------------------------- // // AEGISUB // // Website: http://aegisub.cellosoft.com // Contact: mailto:jiifurusu@gmail.com // #pragma once #ifdef AUTO3LIB #include "lua/include/lua.h" #endif #ifdef __cplusplus extern "C" { #endif // On Win32, filenames are wide, but UTF-8 everywhere else #ifdef WIN32 typedef wchar_t* filename_t; #else typedef char* filename_t; #endif // All other strings involved are UTF-8, no need to do conversion back and forth here // So just hardcode char* as type for everything else #ifndef AUTO3LIB // Definitions used when building Aegisub (ie. importing the symbols) // I believe GCC also knows about __declspec(dllimport) etc. and does something sensible with it #define AUTO3_API __declspec(dllimport) #else // Otherwise we're exporting the symbols #define AUTO3_API __declspec(dllexport) #endif // Stuff for configuration dialogs enum Auto3ConfigOptionKind { COK_INVALID = 0, COK_LABEL, // static text COK_TEXT, // textbox COK_INT, // integer entry, should get spin-button is possible COK_FLOAT, // float entry, also try for spin-button on this COK_BOOL, // bool entry, use a checkbox COK_COLOUR, // colour entry, use a picker if possible, otherwise text box COK_STYLE // style name, listbox with names of styles defined in subs }; struct Auto3ConfigOption { char *name; enum Auto3ConfigOptionKind kind; char *label; char *hint; int hasmin : 1; // whether there is a min value int hasmax : 1; // whether there is a max value union { int intval; float floatval; } min, max; union { char *stringval; // text, colour (vb-hex style-line format), style int intval; // also bool, nonzero is true float floatval; } default_val, value; }; // Describes an interpreter struct Auto3Interpreter { // Public attributes, treat them as read-only filename_t filename; char *name; char *description; // Configuration dialog options // End of list marked with name==NULL // You may change the "value" field of these (in fact, do so) struct Auto3ConfigOption *config; // Callback stuff // The application should fill these with relevant stuff // Logging and status void *logcbdata; // pointer passed to logging/status callbacks void (*log_error)(void *cbdata, char *msg); // log error during script execution void (*log_message)(void *cbdata, char *msg); // log message during script execution void (*set_progress)(void *cbdata, float progress); // set progress during script execution void (*set_status)(void *cbdata, char* msg); // set status message during script execution // Reading/writing subtitles and related information void *rwcbdata; // pointer passed to read/write data callbacks void (*get_meta_info)(void *cbdata, int *res_x, int *res_y); // application sets *res_x and *res_y to appropriate values void (*reset_style_pointer)(void *cbdata); // set style pointer to point at first style // Get the next style, the application must fill the data into its own buffers, which it then fill in pointers to // When there are no more styles, set *name=NULL void (*get_next_style)( void *cbdata, char **name, char **fontname, int *fontsize, char **color1, char **color2, char **color3, char **color4, int *bold, int *italic, int *underline, int *strikeout, float *scale_x, float *scale_y, float *spacing, float *angle, int *borderstyle, float *outline, float *shadow, int *align, int *margin_l, int *margin_r, int *margin_v, int *encoding); void (*reset_subs_pointer)(void *cbdata); // set subtitle pointer to point at first subtitle line // Get next subtitle line, the application must fill the data into its own buffers, and then fill in pointers to those // When there are no more lines, set *text=NULL void (*get_next_sub)( void *cbdata, int *layer, int *start_time, int *end_time, char **style, char **actor, int *margin_l, int *margin_r, int *margin_v, char **effect, char **text); void (*start_subs_write)(void *cbdata); // start writing back new subtitles, application must clear all subtitle lines and be ready to write // Write a subtitle line back to subtitle file, char pointers are owned by the lib void (*write_sub)(void *cbdata, int layer, int start_time, int end_time, char *style, char *actor, int margin_l, int margin_r, int margin_v, char *effect, char *text); #ifdef AUTO3LIB // Private data lua_State *L; #endif }; // Create a new interpreter // Returns pointer to interpreter object if successful, otherwise NULL // If this function fails, the error message is filled into the char* pointed to by error (may be NULL) AUTO3_API struct Auto3Interpreter *CreateAuto3Script(filename_t filename, char **error); // Release an interpreter AUTO3_API void DestroyAuto3Script(struct Auto3Interpreter *script); // Our "malloc" function, allocate memory for strings with this AUTO3_API void *Auto3Malloc(size_t amount); // Our "free" function, free generated error messages with this AUTO3_API void Auto3Free(void *ptr); // Start the script execution // script->logcbdata and log->rwcbdata should be set to sensible values before this call. // The value fields in the config dialog should also be set to values entered by the user here. // This will first call get_meta_info, // then reset_style pointer followed by a number of calls to get_next_style, // then a call to reset_subs_pointer followed by a number of calls to get_next_sub, // then actual processing will take place. // After processing, start_subs_write will be called, followed by a number of calls to write_sub. // Any number of calls to the logging/status functions can take place during script execution AUTO3_API void RunAuto3Script(struct Auto3Interpreter *script); #ifdef __cplusplus }; // extern "C" #endif