From 6e66ffb61abf0952f3ec8d820e58da9df7f6db6f Mon Sep 17 00:00:00 2001 From: Campbell Barton Date: Sun, 28 Feb 2016 05:10:00 +1100 Subject: Cleanup split creator.c creator.c was getting hard to follow. - Split off argument and signal handling into own files. - Move docstrings next to functions (to keep docs grouped with code). --- source/creator/CMakeLists.txt | 4 + source/creator/creator.c | 1831 +++----------------------------------- source/creator/creator_args.c | 1672 ++++++++++++++++++++++++++++++++++ source/creator/creator_intern.h | 95 ++ source/creator/creator_signals.c | 328 +++++++ 5 files changed, 2198 insertions(+), 1732 deletions(-) create mode 100644 source/creator/creator_args.c create mode 100644 source/creator/creator_intern.h create mode 100644 source/creator/creator_signals.c diff --git a/source/creator/CMakeLists.txt b/source/creator/CMakeLists.txt index 74b26d1fd4f..765f98baab5 100644 --- a/source/creator/CMakeLists.txt +++ b/source/creator/CMakeLists.txt @@ -102,6 +102,10 @@ endif() # Setup the exe sources and buildinfo set(SRC creator.c + creator_args.c + creator_signals.c + + creator_intern.h ) # MSVC 2010 gives linking errors with the manifest diff --git a/source/creator/creator.c b/source/creator/creator.c index b2bfe7f5d83..2c2af7c199a 100644 --- a/source/creator/creator.c +++ b/source/creator/creator.c @@ -29,1748 +29,137 @@ * \ingroup creator */ +#include +#include -#if defined(__linux__) && defined(__GNUC__) -# define _GNU_SOURCE -# include -#endif - -#if (defined(__APPLE__) && (defined(__i386__) || defined(__x86_64__))) -# define OSX_SSE_FPE -# include -#endif - -#ifdef WIN32 -# if defined(_MSC_VER) && defined(_M_X64) -# include /* needed for _set_FMA3_enable */ -# endif -# include -# include "utfconv.h" -#endif - -#include -#include -#include -#include -#include - -/* This little block needed for linking to Blender... */ - -#include "MEM_guardedalloc.h" - -#ifdef WIN32 -# include "BLI_winstuff.h" -#endif - -#include "BLI_args.h" -#include "BLI_threads.h" -#include "BLI_utildefines.h" -#include "BLI_callbacks.h" -#include "BLI_blenlib.h" -#include "BLI_mempool.h" -#include "BLI_system.h" -#include BLI_SYSTEM_PID_H - -#include "DNA_ID.h" -#include "DNA_scene_types.h" -#include "DNA_userdef_types.h" - -#include "BKE_appdir.h" -#include "BKE_blender.h" -#include "BKE_brush.h" -#include "BKE_context.h" -#include "BKE_depsgraph.h" /* for DAG_on_visible_update */ -#include "BKE_font.h" -#include "BKE_global.h" -#include "BKE_library.h" -#include "BKE_main.h" -#include "BKE_material.h" -#include "BKE_modifier.h" -#include "BKE_scene.h" -#include "BKE_node.h" -#include "BKE_report.h" -#include "BKE_sound.h" -#include "BKE_image.h" -#include "BKE_particle.h" - -#include "DEG_depsgraph.h" - -#include "IMB_imbuf.h" /* for IMB_init */ - -#ifdef WITH_PYTHON -#include "BPY_extern.h" -#endif - -#include "RE_engine.h" -#include "RE_pipeline.h" -#include "RE_render_ext.h" - -#include "ED_datafiles.h" -#include "ED_util.h" - -#include "WM_api.h" - -#include "RNA_define.h" - -#include "GPU_draw.h" -#include "GPU_extensions.h" - -#ifdef WITH_FREESTYLE -# include "FRS_freestyle.h" -#endif - -#ifdef WITH_BUILDINFO_HEADER -# define BUILD_DATE -#endif - -/* for passing information between creator and gameengine */ -#ifdef WITH_GAMEENGINE -# include "BL_System.h" -#else /* dummy */ -# define SYS_SystemHandle int -#endif - -#include - -#ifdef __FreeBSD__ -# include -# include -# include -#endif - -#ifdef WITH_BINRELOC -# include "binreloc.h" -#endif - -#ifdef WITH_LIBMV -# include "libmv-capi.h" -#endif - -#ifdef WITH_CYCLES_LOGGING -# include "CCL_api.h" -#endif - -#ifdef WITH_SDL_DYNLOAD -# include "sdlew.h" -#endif - -/* from buildinfo.c */ -#ifdef BUILD_DATE -extern char build_date[]; -extern char build_time[]; -extern char build_hash[]; -extern unsigned long build_commit_timestamp; - -/* TODO(sergey): ideally size need to be in sync with buildinfo.c */ -extern char build_commit_date[16]; -extern char build_commit_time[16]; - -extern char build_branch[]; -extern char build_platform[]; -extern char build_type[]; -extern char build_cflags[]; -extern char build_cxxflags[]; -extern char build_linkflags[]; -extern char build_system[]; -#endif - -/* Local Function prototypes */ -#ifdef WITH_PYTHON_MODULE -int main_python_enter(int argc, const char **argv); -void main_python_exit(void); -#else -static int print_help(int argc, const char **argv, void *data); -static int print_version(int argc, const char **argv, void *data); -#endif - -/* for the callbacks: */ -#ifndef WITH_PYTHON_MODULE -#define BLEND_VERSION_FMT "Blender %d.%02d (sub %d)" -#define BLEND_VERSION_ARG BLENDER_VERSION / 100, BLENDER_VERSION % 100, BLENDER_SUBVERSION -/* pass directly to printf */ -#define BLEND_VERSION_STRING_FMT BLEND_VERSION_FMT "\n", BLEND_VERSION_ARG -#endif - -/* Initialize callbacks for the modules that need them */ -static void setCallbacks(void); - -static unsigned char python_exit_code_on_error = 0; - -#ifndef WITH_PYTHON_MODULE - -static bool use_crash_handler = true; -static bool use_abort_handler = true; - -/* set breakpoints here when running in debug mode, useful to catch floating point errors */ -#if defined(__linux__) || defined(_WIN32) || defined(OSX_SSE_FPE) -static void fpe_handler(int UNUSED(sig)) -{ - fprintf(stderr, "debug: SIGFPE trapped\n"); -} -#endif - -/* handling ctrl-c event in console */ -#if !(defined(WITH_PYTHON_MODULE) || defined(WITH_HEADLESS)) -static void blender_esc(int sig) -{ - static int count = 0; - - G.is_break = true; /* forces render loop to read queue, not sure if its needed */ - - if (sig == 2) { - if (count) { - printf("\nBlender killed\n"); - exit(2); - } - printf("\nSent an internal break event. Press ^C again to kill Blender\n"); - count++; - } -} -#endif - -static int print_version(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - printf(BLEND_VERSION_STRING_FMT); -#ifdef BUILD_DATE - printf("\tbuild date: %s\n", build_date); - printf("\tbuild time: %s\n", build_time); - printf("\tbuild commit date: %s\n", build_commit_date); - printf("\tbuild commit time: %s\n", build_commit_time); - printf("\tbuild hash: %s\n", build_hash); - printf("\tbuild platform: %s\n", build_platform); - printf("\tbuild type: %s\n", build_type); - printf("\tbuild c flags: %s\n", build_cflags); - printf("\tbuild c++ flags: %s\n", build_cxxflags); - printf("\tbuild link flags: %s\n", build_linkflags); - printf("\tbuild system: %s\n", build_system); -#endif - exit(0); - - return 0; -} - -static int print_help(int UNUSED(argc), const char **UNUSED(argv), void *data) -{ - bArgs *ba = (bArgs *)data; - - printf(BLEND_VERSION_STRING_FMT); - printf("Usage: blender [args ...] [file] [args ...]\n\n"); - - printf("Render Options:\n"); - BLI_argsPrintArgDoc(ba, "--background"); - BLI_argsPrintArgDoc(ba, "--render-anim"); - BLI_argsPrintArgDoc(ba, "--scene"); - BLI_argsPrintArgDoc(ba, "--render-frame"); - BLI_argsPrintArgDoc(ba, "--frame-start"); - BLI_argsPrintArgDoc(ba, "--frame-end"); - BLI_argsPrintArgDoc(ba, "--frame-jump"); - BLI_argsPrintArgDoc(ba, "--render-output"); - BLI_argsPrintArgDoc(ba, "--engine"); - BLI_argsPrintArgDoc(ba, "--threads"); - - printf("\n"); - printf("Format Options:\n"); - BLI_argsPrintArgDoc(ba, "--render-format"); - BLI_argsPrintArgDoc(ba, "--use-extension"); - - printf("\n"); - printf("Animation Playback Options:\n"); - BLI_argsPrintArgDoc(ba, "-a"); - - printf("\n"); - printf("Window Options:\n"); - BLI_argsPrintArgDoc(ba, "--window-border"); - BLI_argsPrintArgDoc(ba, "--window-borderless"); - BLI_argsPrintArgDoc(ba, "--window-geometry"); - BLI_argsPrintArgDoc(ba, "--start-console"); - BLI_argsPrintArgDoc(ba, "--no-native-pixels"); - - - printf("\n"); - printf("Game Engine Specific Options:\n"); - BLI_argsPrintArgDoc(ba, "-g"); - - printf("\n"); - printf("Python Options:\n"); - BLI_argsPrintArgDoc(ba, "--enable-autoexec"); - BLI_argsPrintArgDoc(ba, "--disable-autoexec"); - - printf("\n"); - - BLI_argsPrintArgDoc(ba, "--python"); - BLI_argsPrintArgDoc(ba, "--python-text"); - BLI_argsPrintArgDoc(ba, "--python-expr"); - BLI_argsPrintArgDoc(ba, "--python-console"); - BLI_argsPrintArgDoc(ba, "--python-exit-code"); - BLI_argsPrintArgDoc(ba, "--addons"); - - - printf("\n"); - printf("Debug Options:\n"); - BLI_argsPrintArgDoc(ba, "--debug"); - BLI_argsPrintArgDoc(ba, "--debug-value"); - - printf("\n"); - BLI_argsPrintArgDoc(ba, "--debug-events"); -#ifdef WITH_FFMPEG - BLI_argsPrintArgDoc(ba, "--debug-ffmpeg"); -#endif - BLI_argsPrintArgDoc(ba, "--debug-handlers"); -#ifdef WITH_LIBMV - BLI_argsPrintArgDoc(ba, "--debug-libmv"); -#endif -#ifdef WITH_CYCLES_LOGGING - BLI_argsPrintArgDoc(ba, "--debug-cycles"); -#endif - BLI_argsPrintArgDoc(ba, "--debug-memory"); - BLI_argsPrintArgDoc(ba, "--debug-jobs"); - BLI_argsPrintArgDoc(ba, "--debug-python"); - BLI_argsPrintArgDoc(ba, "--debug-depsgraph"); - BLI_argsPrintArgDoc(ba, "--debug-depsgraph-no-threads"); - - BLI_argsPrintArgDoc(ba, "--debug-gpumem"); - BLI_argsPrintArgDoc(ba, "--debug-wm"); - BLI_argsPrintArgDoc(ba, "--debug-all"); - - printf("\n"); - BLI_argsPrintArgDoc(ba, "--debug-fpe"); - BLI_argsPrintArgDoc(ba, "--disable-crash-handler"); - - printf("\n"); - printf("Misc Options:\n"); - BLI_argsPrintArgDoc(ba, "--factory-startup"); - printf("\n"); - BLI_argsPrintArgDoc(ba, "--env-system-datafiles"); - BLI_argsPrintArgDoc(ba, "--env-system-scripts"); - BLI_argsPrintArgDoc(ba, "--env-system-python"); - printf("\n"); - BLI_argsPrintArgDoc(ba, "-nojoystick"); - BLI_argsPrintArgDoc(ba, "-noglsl"); - BLI_argsPrintArgDoc(ba, "-noaudio"); - BLI_argsPrintArgDoc(ba, "-setaudio"); - - printf("\n"); - - BLI_argsPrintArgDoc(ba, "--help"); - -#ifdef WIN32 - BLI_argsPrintArgDoc(ba, "-R"); - BLI_argsPrintArgDoc(ba, "-r"); -#endif - BLI_argsPrintArgDoc(ba, "--version"); - - BLI_argsPrintArgDoc(ba, "--"); - - printf("Other Options:\n"); - BLI_argsPrintOtherDoc(ba); - - printf("\n"); - printf("Experimental features:\n"); - BLI_argsPrintArgDoc(ba, "--enable-new-depsgraph"); - - printf("Argument Parsing:\n"); - printf("\tArguments must be separated by white space, eg:\n"); - printf("\t# blender -ba test.blend\n"); - printf("\t...will ignore the 'a'\n"); - printf("\t# blender -b test.blend -f8\n"); - printf("\t...will ignore '8' because there is no space between the '-f' and the frame value\n\n"); - - printf("Argument Order:\n"); - printf("\tArguments are executed in the order they are given. eg:\n"); - printf("\t# blender --background test.blend --render-frame 1 --render-output '/tmp'\n"); - printf("\t...will not render to '/tmp' because '--render-frame 1' renders before the output path is set\n"); - printf("\t# blender --background --render-output /tmp test.blend --render-frame 1\n"); - printf("\t...will not render to '/tmp' because loading the blend file overwrites the render output that was set\n"); - printf("\t# blender --background test.blend --render-output /tmp --render-frame 1\n"); - printf("\t...works as expected.\n\n"); - - printf("Environment Variables:\n"); - printf(" $BLENDER_USER_CONFIG Directory for user configuration files.\n"); - printf(" $BLENDER_USER_SCRIPTS Directory for user scripts.\n"); - printf(" $BLENDER_SYSTEM_SCRIPTS Directory for system wide scripts.\n"); - printf(" $BLENDER_USER_DATAFILES Directory for user data files (icons, translations, ..).\n"); - printf(" $BLENDER_SYSTEM_DATAFILES Directory for system wide data files.\n"); - printf(" $BLENDER_SYSTEM_PYTHON Directory for system python libraries.\n"); -#ifdef WIN32 - printf(" $TEMP Store temporary files here.\n"); -#else - printf(" $TMP or $TMPDIR Store temporary files here.\n"); -#endif -#ifdef WITH_SDL - printf(" $SDL_AUDIODRIVER LibSDL audio driver - alsa, esd, dma.\n"); -#endif - printf(" $PYTHONHOME Path to the python directory, eg. /usr/lib/python.\n\n"); - - exit(0); - - return 0; -} - -static bool parse_int_relative( - const char *str, int pos, int neg, - int *r_value, const char **r_err_msg) -{ - char *str_end = NULL; - long value; - - errno = 0; - - switch (*str) { - case '+': - value = pos + strtol(str + 1, &str_end, 10); - break; - case '-': - value = (neg - strtol(str + 1, &str_end, 10)) + 1; - break; - default: - value = strtol(str, &str_end, 10); - break; - } - - - if (*str_end != '\0') { - static const char *msg = "not a number"; - *r_err_msg = msg; - return false; - } - else if ((errno == ERANGE) || ((value < INT_MIN || value > INT_MAX))) { - static const char *msg = "exceeds range"; - *r_err_msg = msg; - return false; - } - else { - *r_value = (int)value; - return true; - } -} - -static bool parse_int_relative_clamp( - const char *str, int pos, int neg, int min, int max, - int *r_value, const char **r_err_msg) -{ - if (parse_int_relative(str, pos, neg, r_value, r_err_msg)) { - CLAMP(*r_value, min, max); - return true; - } - else { - return false; - } -} - -/** - * No clamping, fails with any number outside the range. - */ -static bool parse_int_strict_range( - const char *str, const int min, const int max, - int *r_value, const char **r_err_msg) -{ - char *str_end = NULL; - long value; - - errno = 0; - value = strtol(str, &str_end, 10); - - if (*str_end != '\0') { - static const char *msg = "not a number"; - *r_err_msg = msg; - return false; - } - else if ((errno == ERANGE) || ((value < min || value > max))) { - static const char *msg = "exceeds range"; - *r_err_msg = msg; - return false; - } - else { - *r_value = (int)value; - return true; - } -} - -static bool parse_int( - const char *str, - int *r_value, const char **r_err_msg) -{ - return parse_int_strict_range(str, INT_MIN, INT_MAX, r_value, r_err_msg); -} - -static bool parse_int_clamp( - const char *str, int min, int max, - int *r_value, const char **r_err_msg) -{ - if (parse_int(str, r_value, r_err_msg)) { - CLAMP(*r_value, min, max); - return true; - } - else { - return false; - } -} - -static int end_arguments(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - return -1; -} - -static int enable_python(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - G.f |= G_SCRIPT_AUTOEXEC; - G.f |= G_SCRIPT_OVERRIDE_PREF; - return 0; -} - -static int disable_python(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - G.f &= ~G_SCRIPT_AUTOEXEC; - G.f |= G_SCRIPT_OVERRIDE_PREF; - return 0; -} - -static int disable_crash_handler(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - use_crash_handler = false; - return 0; -} - -static int disable_abort_handler(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - use_abort_handler = false; - return 0; -} - -static int background_mode(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - G.background = 1; - return 0; -} - -static int debug_mode(int UNUSED(argc), const char **UNUSED(argv), void *data) -{ - G.debug |= G_DEBUG; /* std output printf's */ - printf(BLEND_VERSION_STRING_FMT); - MEM_set_memory_debug(); -#ifndef NDEBUG - BLI_mempool_set_memory_debug(); -#endif - -#ifdef WITH_BUILDINFO - printf("Build: %s %s %s %s\n", build_date, build_time, build_platform, build_type); -#endif - - BLI_argsPrint(data); - return 0; -} - -static int debug_mode_generic(int UNUSED(argc), const char **UNUSED(argv), void *data) -{ - G.debug |= GET_INT_FROM_POINTER(data); - return 0; -} - -#ifdef WITH_LIBMV -static int debug_mode_libmv(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - libmv_startDebugLogging(); - - return 0; -} -#endif - -#ifdef WITH_CYCLES_LOGGING -static int debug_mode_cycles(int UNUSED(argc), const char **UNUSED(argv), - void *UNUSED(data)) -{ - CCL_start_debug_logging(); - return 0; -} -#endif - -static int debug_mode_memory(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - MEM_set_memory_debug(); - return 0; -} - -static int set_debug_value(int argc, const char **argv, void *UNUSED(data)) -{ - const char *arg_id = "--debug-value"; - if (argc > 1) { - const char *err_msg = NULL; - int value; - if (!parse_int(argv[1], &value, &err_msg)) { - printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); - return 1; - } - - G.debug_value = value; - - return 1; - } - else { - printf("\nError: you must specify debug value to set.\n"); - return 0; - } -} - -static int set_fpe(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ -#if defined(__linux__) || defined(_WIN32) || defined(OSX_SSE_FPE) - /* zealous but makes float issues a heck of a lot easier to find! - * set breakpoints on fpe_handler */ - signal(SIGFPE, fpe_handler); - -# if defined(__linux__) && defined(__GNUC__) - feenableexcept(FE_DIVBYZERO | FE_INVALID | FE_OVERFLOW); -# endif /* defined(__linux__) && defined(__GNUC__) */ -# if defined(OSX_SSE_FPE) - /* OSX uses SSE for floating point by default, so here - * use SSE instructions to throw floating point exceptions */ - _MM_SET_EXCEPTION_MASK(_MM_MASK_MASK & ~ - (_MM_MASK_OVERFLOW | _MM_MASK_INVALID | _MM_MASK_DIV_ZERO)); -# endif /* OSX_SSE_FPE */ -# if defined(_WIN32) && defined(_MSC_VER) - _controlfp_s(NULL, 0, _MCW_EM); /* enables all fp exceptions */ - _controlfp_s(NULL, _EM_DENORMAL | _EM_UNDERFLOW | _EM_INEXACT, _MCW_EM); /* hide the ones we don't care about */ -# endif /* _WIN32 && _MSC_VER */ -#endif - - return 0; -} - -static void blender_crash_handler_backtrace(FILE *fp) -{ - fputs("\n# backtrace\n", fp); - BLI_system_backtrace(fp); -} - -static void blender_crash_handler(int signum) -{ - -#if 0 - { - char fname[FILE_MAX]; - - if (!G.main->name[0]) { - BLI_make_file_string("/", fname, BKE_tempdir_base(), "crash.blend"); - } - else { - BLI_strncpy(fname, G.main->name, sizeof(fname)); - BLI_replace_extension(fname, sizeof(fname), ".crash.blend"); - } - - printf("Writing: %s\n", fname); - fflush(stdout); - - BKE_undo_save_file(fname); - } -#endif - - FILE *fp; - char header[512]; - wmWindowManager *wm = G.main->wm.first; - - char fname[FILE_MAX]; - - if (!G.main->name[0]) { - BLI_join_dirfile(fname, sizeof(fname), BKE_tempdir_base(), "blender.crash.txt"); - } - else { - BLI_join_dirfile(fname, sizeof(fname), BKE_tempdir_base(), BLI_path_basename(G.main->name)); - BLI_replace_extension(fname, sizeof(fname), ".crash.txt"); - } - - printf("Writing: %s\n", fname); - fflush(stdout); - -#ifndef BUILD_DATE - BLI_snprintf(header, sizeof(header), "# " BLEND_VERSION_FMT ", Unknown revision\n", BLEND_VERSION_ARG); -#else - BLI_snprintf(header, sizeof(header), "# " BLEND_VERSION_FMT ", Commit date: %s %s, Hash %s\n", - BLEND_VERSION_ARG, build_commit_date, build_commit_time, build_hash); -#endif - - /* open the crash log */ - errno = 0; - fp = BLI_fopen(fname, "wb"); - if (fp == NULL) { - fprintf(stderr, "Unable to save '%s': %s\n", - fname, errno ? strerror(errno) : "Unknown error opening file"); - } - else { - if (wm) { - BKE_report_write_file_fp(fp, &wm->reports, header); - } - - blender_crash_handler_backtrace(fp); - - fclose(fp); - } - - /* Delete content of temp dir! */ - BKE_tempdir_session_purge(); - - /* really crash */ - signal(signum, SIG_DFL); -#ifndef WIN32 - kill(getpid(), signum); -#else - TerminateProcess(GetCurrentProcess(), signum); -#endif -} - -#ifdef WIN32 -LONG WINAPI windows_exception_handler(EXCEPTION_POINTERS *ExceptionInfo) -{ - switch (ExceptionInfo->ExceptionRecord->ExceptionCode) { - case EXCEPTION_ACCESS_VIOLATION: - fputs("Error: EXCEPTION_ACCESS_VIOLATION\n", stderr); - break; - case EXCEPTION_ARRAY_BOUNDS_EXCEEDED: - fputs("Error: EXCEPTION_ARRAY_BOUNDS_EXCEEDED\n", stderr); - break; - case EXCEPTION_BREAKPOINT: - fputs("Error: EXCEPTION_BREAKPOINT\n", stderr); - break; - case EXCEPTION_DATATYPE_MISALIGNMENT: - fputs("Error: EXCEPTION_DATATYPE_MISALIGNMENT\n", stderr); - break; - case EXCEPTION_FLT_DENORMAL_OPERAND: - fputs("Error: EXCEPTION_FLT_DENORMAL_OPERAND\n", stderr); - break; - case EXCEPTION_FLT_DIVIDE_BY_ZERO: - fputs("Error: EXCEPTION_FLT_DIVIDE_BY_ZERO\n", stderr); - break; - case EXCEPTION_FLT_INEXACT_RESULT: - fputs("Error: EXCEPTION_FLT_INEXACT_RESULT\n", stderr); - break; - case EXCEPTION_FLT_INVALID_OPERATION: - fputs("Error: EXCEPTION_FLT_INVALID_OPERATION\n", stderr); - break; - case EXCEPTION_FLT_OVERFLOW: - fputs("Error: EXCEPTION_FLT_OVERFLOW\n", stderr); - break; - case EXCEPTION_FLT_STACK_CHECK: - fputs("Error: EXCEPTION_FLT_STACK_CHECK\n", stderr); - break; - case EXCEPTION_FLT_UNDERFLOW: - fputs("Error: EXCEPTION_FLT_UNDERFLOW\n", stderr); - break; - case EXCEPTION_ILLEGAL_INSTRUCTION: - fputs("Error: EXCEPTION_ILLEGAL_INSTRUCTION\n", stderr); - break; - case EXCEPTION_IN_PAGE_ERROR: - fputs("Error: EXCEPTION_IN_PAGE_ERROR\n", stderr); - break; - case EXCEPTION_INT_DIVIDE_BY_ZERO: - fputs("Error: EXCEPTION_INT_DIVIDE_BY_ZERO\n", stderr); - break; - case EXCEPTION_INT_OVERFLOW: - fputs("Error: EXCEPTION_INT_OVERFLOW\n", stderr); - break; - case EXCEPTION_INVALID_DISPOSITION: - fputs("Error: EXCEPTION_INVALID_DISPOSITION\n", stderr); - break; - case EXCEPTION_NONCONTINUABLE_EXCEPTION: - fputs("Error: EXCEPTION_NONCONTINUABLE_EXCEPTION\n", stderr); - break; - case EXCEPTION_PRIV_INSTRUCTION: - fputs("Error: EXCEPTION_PRIV_INSTRUCTION\n", stderr); - break; - case EXCEPTION_SINGLE_STEP: - fputs("Error: EXCEPTION_SINGLE_STEP\n", stderr); - break; - case EXCEPTION_STACK_OVERFLOW: - fputs("Error: EXCEPTION_STACK_OVERFLOW\n", stderr); - break; - default: - fputs("Error: Unrecognized Exception\n", stderr); - break; - } - - fflush(stderr); - - /* If this is a stack overflow then we can't walk the stack, so just show - * where the error happened */ - if (EXCEPTION_STACK_OVERFLOW != ExceptionInfo->ExceptionRecord->ExceptionCode) { -#ifdef NDEBUG - TerminateProcess(GetCurrentProcess(), SIGSEGV); -#else - blender_crash_handler(SIGSEGV); -#endif - } - - return EXCEPTION_EXECUTE_HANDLER; -} -#endif - - -static void blender_abort_handler(int UNUSED(signum)) -{ - /* Delete content of temp dir! */ - BKE_tempdir_session_purge(); -} - -static int set_factory_startup(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - G.factory_startup = 1; - return 0; -} - -static int set_env(int argc, const char **argv, void *UNUSED(data)) -{ - /* "--env-system-scripts" --> "BLENDER_SYSTEM_SCRIPTS" */ - - char env[64] = "BLENDER"; - char *ch_dst = env + 7; /* skip BLENDER */ - const char *ch_src = argv[0] + 5; /* skip --env */ - - if (argc < 2) { - printf("%s requires one argument\n", argv[0]); - exit(1); - } - - for (; *ch_src; ch_src++, ch_dst++) { - *ch_dst = (*ch_src == '-') ? '_' : (*ch_src) - 32; /* toupper() */ - } - - *ch_dst = '\0'; - BLI_setenv(env, argv[1]); - return 1; -} - -static int playback_mode(int argc, const char **argv, void *UNUSED(data)) -{ - /* not if -b was given first */ - if (G.background == 0) { -#ifdef WITH_FFMPEG - /* Setup FFmpeg with current debug flags. */ - IMB_ffmpeg_init(); -#endif - - WM_main_playanim(argc, argv); /* not the same argc and argv as before */ - exit(0); /* 2.4x didn't do this */ - } - - return -2; -} - -static int prefsize(int argc, const char **argv, void *UNUSED(data)) -{ - const char *arg_id = "-p / --window-geometry"; - int params[4], i; - - if (argc < 5) { - fprintf(stderr, "Error: requires four arguments '%s'\n", arg_id); - exit(1); - } - - for (i = 0; i < 4; i++) { - const char *err_msg = NULL; - if (!parse_int(argv[i + 1], ¶ms[i], &err_msg)) { - printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); - exit(1); - } - } - - WM_init_state_size_set(UNPACK4(params)); - - return 4; -} - -static int native_pixels(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - WM_init_native_pixels(false); - return 0; -} - -static int with_borders(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - WM_init_state_normal_set(); - return 0; -} - -static int without_borders(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - WM_init_state_fullscreen_set(); - return 0; -} - -extern bool wm_start_with_console; /* wm_init_exit.c */ -static int start_with_console(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - wm_start_with_console = true; - return 0; -} - -static int register_extension(int UNUSED(argc), const char **UNUSED(argv), void *data) -{ -#ifdef WIN32 - if (data) - G.background = 1; - RegisterBlendExtension(); -#else - (void)data; /* unused */ -#endif - return 0; -} - -static int no_joystick(int UNUSED(argc), const char **UNUSED(argv), void *data) -{ -#ifndef WITH_GAMEENGINE - (void)data; -#else - SYS_SystemHandle *syshandle = data; - - /** - * don't initialize joysticks if user doesn't want to use joysticks - * failed joystick initialization delays over 5 seconds, before game engine start - */ - SYS_WriteCommandLineInt(*syshandle, "nojoystick", 1); - if (G.debug & G_DEBUG) printf("disabling nojoystick\n"); -#endif - - return 0; -} - -static int no_glsl(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - GPU_extensions_disable(); - return 0; -} - -static int no_audio(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - BKE_sound_force_device("Null"); - return 0; -} - -static int set_audio(int argc, const char **argv, void *UNUSED(data)) -{ - if (argc < 1) { - fprintf(stderr, "-setaudio require one argument\n"); - exit(1); - } - - BKE_sound_force_device(argv[1]); - return 1; -} - -static int set_output(int argc, const char **argv, void *data) -{ - bContext *C = data; - if (argc > 1) { - Scene *scene = CTX_data_scene(C); - if (scene) { - BLI_strncpy(scene->r.pic, argv[1], sizeof(scene->r.pic)); - } - else { - printf("\nError: no blend loaded. cannot use '-o / --render-output'.\n"); - } - return 1; - } - else { - printf("\nError: you must specify a path after '-o / --render-output'.\n"); - return 0; - } -} - -static int set_engine(int argc, const char **argv, void *data) -{ - bContext *C = data; - if (argc >= 2) { - if (STREQ(argv[1], "help")) { - RenderEngineType *type = NULL; - printf("Blender Engine Listing:\n"); - for (type = R_engines.first; type; type = type->next) { - printf("\t%s\n", type->idname); - } - exit(0); - } - else { - Scene *scene = CTX_data_scene(C); - if (scene) { - RenderData *rd = &scene->r; - - if (BLI_findstring(&R_engines, argv[1], offsetof(RenderEngineType, idname))) { - BLI_strncpy_utf8(rd->engine, argv[1], sizeof(rd->engine)); - } - else { - printf("\nError: engine not found '%s'\n", argv[1]); - exit(1); - } - } - else { - printf("\nError: no blend loaded. order the arguments so '-E / --engine ' is after a blend is loaded.\n"); - } - } - - return 1; - } - else { - printf("\nEngine not specified, give 'help' for a list of available engines.\n"); - return 0; - } -} - -static int set_image_type(int argc, const char **argv, void *data) -{ - bContext *C = data; - if (argc > 1) { - const char *imtype = argv[1]; - Scene *scene = CTX_data_scene(C); - if (scene) { - const char imtype_new = BKE_imtype_from_arg(imtype); - - if (imtype_new == R_IMF_IMTYPE_INVALID) { - printf("\nError: Format from '-F / --render-format' not known or not compiled in this release.\n"); - } - else { - scene->r.im_format.imtype = imtype_new; - } - } - else { - printf("\nError: no blend loaded. order the arguments so '-F / --render-format' is after the blend is loaded.\n"); - } - return 1; - } - else { - printf("\nError: you must specify a format after '-F / --render-foramt'.\n"); - return 0; - } -} - -static int set_threads(int argc, const char **argv, void *UNUSED(data)) -{ - const char *arg_id = "-t / --threads"; - const int min = 0, max = BLENDER_MAX_THREADS; - if (argc > 1) { - const char *err_msg = NULL; - int threads; - if (!parse_int_strict_range(argv[1], min, max, &threads, &err_msg)) { - printf("\nError: %s '%s %s', expected number in [%d..%d].\n", err_msg, arg_id, argv[1], min, max); - return 1; - } - - BLI_system_num_threads_override_set(threads); - return 1; - } - else { - printf("\nError: you must specify a number of threads in [%d..%d] '%s'.\n", min, max, arg_id); - return 0; - } -} - -static int depsgraph_use_new(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) -{ - printf("Using new dependency graph.\n"); - DEG_depsgraph_switch_to_new(); - return 0; -} - -static int set_verbosity(int argc, const char **argv, void *UNUSED(data)) -{ - const char *arg_id = "--verbose"; - if (argc > 1) { - const char *err_msg = NULL; - int level; - if (!parse_int(argv[1], &level, &err_msg)) { - printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); - } - -#ifdef WITH_LIBMV - libmv_setLoggingVerbosity(level); -#elif defined(WITH_CYCLES_LOGGING) - CCL_logging_verbosity_set(level); -#else - (void)level; -#endif - - return 1; - } - else { - printf("\nError: you must specify a verbosity level.\n"); - return 0; - } -} - -static int set_extension(int argc, const char **argv, void *data) -{ - bContext *C = data; - if (argc > 1) { - Scene *scene = CTX_data_scene(C); - if (scene) { - if (argv[1][0] == '0') { - scene->r.scemode &= ~R_EXTENSION; - } - else if (argv[1][0] == '1') { - scene->r.scemode |= R_EXTENSION; - } - else { - printf("\nError: Use '-x 1 / -x 0' To set the extension option or '--use-extension'\n"); - } - } - else { - printf("\nError: no blend loaded. order the arguments so '-o ' is after '-x '.\n"); - } - return 1; - } - else { - printf("\nError: you must specify a path after '- '.\n"); - return 0; - } -} - -static int set_ge_parameters(int argc, const char **argv, void *data) -{ - int a = 0; -#ifdef WITH_GAMEENGINE - SYS_SystemHandle syshandle = *(SYS_SystemHandle *)data; -#else - (void)data; -#endif - - /** - * gameengine parameters are automatically put into system - * -g [paramname = value] - * -g [boolparamname] - * example: - * -g novertexarrays - * -g maxvertexarraysize = 512 - */ - - if (argc >= 1) { - const char *paramname = argv[a]; - /* check for single value versus assignment */ - if (a + 1 < argc && (*(argv[a + 1]) == '=')) { - a++; - if (a + 1 < argc) { - a++; - /* assignment */ -#ifdef WITH_GAMEENGINE - SYS_WriteCommandLineString(syshandle, paramname, argv[a]); -#endif - } - else { - printf("error: argument assignment (%s) without value.\n", paramname); - return 0; - } - /* name arg eaten */ - - } - else { -#ifdef WITH_GAMEENGINE - SYS_WriteCommandLineInt(syshandle, argv[a], 1); +#ifdef WIN32 +# if defined(_MSC_VER) && defined(_M_X64) +# include /* needed for _set_FMA3_enable */ +# endif +# include +# include "utfconv.h" #endif - /* doMipMap */ - if (STREQ(argv[a], "nomipmap")) { - GPU_set_mipmap(0); //doMipMap = 0; - } - /* linearMipMap */ - if (STREQ(argv[a], "linearmipmap")) { - GPU_set_mipmap(1); - GPU_set_linear_mipmap(1); //linearMipMap = 1; - } - - - } /* if (*(argv[a + 1]) == '=') */ - } - - return a; -} - -static int render_frame(int argc, const char **argv, void *data) -{ - const char *arg_id = "-f / --render-frame"; - bContext *C = data; - Scene *scene = CTX_data_scene(C); - if (scene) { - Main *bmain = CTX_data_main(C); - - if (argc > 1) { - const char *err_msg = NULL; - Render *re; - int frame; - ReportList reports; - - if (!parse_int_relative_clamp( - argv[1], scene->r.sfra, scene->r.efra, MINAFRAME, MAXFRAME, - &frame, &err_msg)) - { - printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); - return 1; - } - - re = RE_NewRender(scene->id.name); - BLI_begin_threaded_malloc(); - BKE_reports_init(&reports, RPT_PRINT); - - RE_SetReports(re, &reports); - RE_BlenderAnim(re, bmain, scene, NULL, scene->lay, frame, frame, scene->r.frame_step); - RE_SetReports(re, NULL); - BLI_end_threaded_malloc(); - return 1; - } - else { - printf("\nError: frame number must follow '%s'.\n", arg_id); - return 0; - } - } - else { - printf("\nError: no blend loaded. cannot use '%s'.\n", arg_id); - return 0; - } -} -static int render_animation(int UNUSED(argc), const char **UNUSED(argv), void *data) -{ - bContext *C = data; - Scene *scene = CTX_data_scene(C); - if (scene) { - Main *bmain = CTX_data_main(C); - Render *re = RE_NewRender(scene->id.name); - ReportList reports; - BLI_begin_threaded_malloc(); - BKE_reports_init(&reports, RPT_PRINT); - RE_SetReports(re, &reports); - RE_BlenderAnim(re, bmain, scene, NULL, scene->lay, scene->r.sfra, scene->r.efra, scene->r.frame_step); - RE_SetReports(re, NULL); - BLI_end_threaded_malloc(); - } - else { - printf("\nError: no blend loaded. cannot use '-a'.\n"); - } - return 0; -} +#include "MEM_guardedalloc.h" -static int set_scene(int argc, const char **argv, void *data) -{ - if (argc > 1) { - bContext *C = data; - Scene *scene = BKE_scene_set_name(CTX_data_main(C), argv[1]); - if (scene) { - CTX_data_scene_set(C, scene); - } - return 1; - } - else { - printf("\nError: Scene name must follow '-S / --scene'.\n"); - return 0; - } -} +#ifdef WIN32 +# include "BLI_winstuff.h" +#endif -static int set_start_frame(int argc, const char **argv, void *data) -{ - const char *arg_id = "-s / --frame-start"; - bContext *C = data; - Scene *scene = CTX_data_scene(C); - if (scene) { - if (argc > 1) { - const char *err_msg = NULL; - if (!parse_int_relative_clamp( - argv[1], scene->r.sfra, scene->r.sfra - 1, MINAFRAME, MAXFRAME, - &scene->r.sfra, &err_msg)) - { - printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); - } - return 1; - } - else { - printf("\nError: frame number must follow '%s'.\n", arg_id); - return 0; - } - } - else { - printf("\nError: no blend loaded. cannot use '%s'.\n", arg_id); - return 0; - } -} +#include "BLI_args.h" +#include "BLI_threads.h" +#include "BLI_utildefines.h" +#include "BLI_callbacks.h" +#include "BLI_string.h" -static int set_end_frame(int argc, const char **argv, void *data) -{ - const char *arg_id = "-e / --frame-end"; - bContext *C = data; - Scene *scene = CTX_data_scene(C); - if (scene) { - if (argc > 1) { - const char *err_msg = NULL; - if (!parse_int_relative_clamp( - argv[1], scene->r.efra, scene->r.efra - 1, MINAFRAME, MAXFRAME, - &scene->r.efra, &err_msg)) - { - printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); - } - return 1; - } - else { - printf("\nError: frame number must follow '%s'.\n", arg_id); - return 0; - } - } - else { - printf("\nError: no blend loaded. cannot use '%s'.\n", arg_id); - return 0; - } -} +/* mostly init functions */ +#include "BKE_appdir.h" +#include "BKE_blender.h" +#include "BKE_brush.h" +#include "BKE_context.h" +#include "BKE_depsgraph.h" /* for DAG_init */ +#include "BKE_font.h" +#include "BKE_global.h" +#include "BKE_material.h" +#include "BKE_modifier.h" +#include "BKE_node.h" +#include "BKE_sound.h" +#include "BKE_image.h" +#include "BKE_particle.h" -static int set_skip_frame(int argc, const char **argv, void *data) -{ - const char *arg_id = "-j / --frame-jump"; - bContext *C = data; - Scene *scene = CTX_data_scene(C); - if (scene) { - if (argc > 1) { - const char *err_msg = NULL; - if (!parse_int_clamp(argv[1], 1, MAXFRAME, &scene->r.frame_step, &err_msg)) { - printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); - } - return 1; - } - else { - printf("\nError: number of frames to step must follow '%s'.\n", arg_id); - return 0; - } - } - else { - printf("\nError: no blend loaded. cannot use '%s'.\n", arg_id); - return 0; - } -} +#include "IMB_imbuf.h" /* for IMB_init */ -#ifdef WITH_PYTHON +#include "RE_engine.h" +#include "RE_render_ext.h" -/** \name Utilities Python Context Macro (#BPY_CTX_SETUP) - * \{ */ -struct BlendePyContextStore { - wmWindowManager *wm; - Scene *scene; - wmWindow *win; - bool has_win; -}; +#include "ED_datafiles.h" -static void blender_py_context_backup( - bContext *C, struct BlendePyContextStore *c_py, - const char *script_id) -{ - c_py->wm = CTX_wm_manager(C); - c_py->scene = CTX_data_scene(C); - c_py->has_win = !BLI_listbase_is_empty(&c_py->wm->windows); - if (c_py->has_win) { - c_py->win = CTX_wm_window(C); - CTX_wm_window_set(C, c_py->wm->windows.first); - } - else { - c_py->win = NULL; - fprintf(stderr, "Python script \"%s\" " - "running with missing context data.\n", script_id); - } -} +#include "WM_api.h" -static void blender_py_context_restore( - bContext *C, struct BlendePyContextStore *c_py) -{ - /* script may load a file, check old data is valid before using */ - if (c_py->has_win) { - if ((c_py->win == NULL) || - ((BLI_findindex(&G.main->wm, c_py->wm) != -1) && - (BLI_findindex(&c_py->wm->windows, c_py->win) != -1))) - { - CTX_wm_window_set(C, c_py->win); - } - } +#include "RNA_define.h" - if ((c_py->scene == NULL) || - BLI_findindex(&G.main->scene, c_py->scene) != -1) - { - CTX_data_scene_set(C, c_py->scene); - } -} +#ifdef WITH_FREESTYLE +# include "FRS_freestyle.h" +#endif -/* macro for context setup/reset */ -#define BPY_CTX_SETUP(_cmd) \ - { \ - struct BlendePyContextStore py_c; \ - blender_py_context_backup(C, &py_c, argv[1]); \ - { _cmd; } \ - blender_py_context_restore(C, &py_c); \ - } ((void)0) +/* for passing information between creator and gameengine */ +#ifdef WITH_GAMEENGINE +# include "BL_System.h" +#else /* dummy */ +# define SYS_SystemHandle int +#endif -#endif /* WITH_PYTHON */ +#include -/** \} */ +#ifdef __FreeBSD__ +# include +#endif +#ifdef WITH_BINRELOC +# include "binreloc.h" +#endif -static int run_python_file(int argc, const char **argv, void *data) -{ -#ifdef WITH_PYTHON - bContext *C = data; - - /* workaround for scripts not getting a bpy.context.scene, causes internal errors elsewhere */ - if (argc > 1) { - /* Make the path absolute because its needed for relative linked blends to be found */ - char filename[FILE_MAX]; - BLI_strncpy(filename, argv[1], sizeof(filename)); - BLI_path_cwd(filename, sizeof(filename)); - - bool ok; - BPY_CTX_SETUP(ok = BPY_execute_filepath(C, filename, NULL)); - if (!ok && python_exit_code_on_error) { - printf("\nError: script failed, file: '%s', exiting with code %d.\n", argv[1], python_exit_code_on_error); - exit(python_exit_code_on_error); - } - return 1; - } - else { - printf("\nError: you must specify a filepath after '%s'.\n", argv[0]); - return 0; - } -#else - UNUSED_VARS(argc, argv, data); - printf("This blender was built without python support\n"); - return 0; -#endif /* WITH_PYTHON */ -} +#ifdef WITH_LIBMV +# include "libmv-capi.h" +#endif -static int run_python_text(int argc, const char **argv, void *data) -{ -#ifdef WITH_PYTHON - bContext *C = data; +#ifdef WITH_CYCLES_LOGGING +# include "CCL_api.h" +#endif - /* workaround for scripts not getting a bpy.context.scene, causes internal errors elsewhere */ - if (argc > 1) { - /* Make the path absolute because its needed for relative linked blends to be found */ - struct Text *text = (struct Text *)BKE_libblock_find_name(ID_TXT, argv[1]); - bool ok; +#ifdef WITH_SDL_DYNLOAD +# include "sdlew.h" +#endif - if (text) { - BPY_CTX_SETUP(ok = BPY_execute_text(C, text, NULL, false)); - } - else { - printf("\nError: text block not found %s.\n", argv[1]); - ok = false; - } +#include "creator_intern.h" /* own include */ - if (!ok && python_exit_code_on_error) { - printf("\nError: script failed, text: '%s', exiting.\n", argv[1]); - exit(python_exit_code_on_error); - } - return 1; - } - else { - printf("\nError: you must specify a text block after '%s'.\n", argv[0]); - return 0; - } -#else - UNUSED_VARS(argc, argv, data); - printf("This blender was built without python support\n"); - return 0; -#endif /* WITH_PYTHON */ -} +/* Local Function prototypes */ +#ifdef WITH_PYTHON_MODULE +int main_python_enter(int argc, const char **argv); +void main_python_exit(void); +#endif -static int run_python_expr(int argc, const char **argv, void *data) -{ -#ifdef WITH_PYTHON - bContext *C = data; - - /* workaround for scripts not getting a bpy.context.scene, causes internal errors elsewhere */ - if (argc > 1) { - bool ok; - BPY_CTX_SETUP(ok = BPY_execute_string_ex(C, argv[1], false)); - if (!ok && python_exit_code_on_error) { - printf("\nError: script failed, expr: '%s', exiting.\n", argv[1]); - exit(python_exit_code_on_error); - } - return 1; - } - else { - printf("\nError: you must specify a Python expression after '%s'.\n", argv[0]); - return 0; +/* written to by 'creator_args.c' */ +struct ApplicationState app_state = { + .signal = { + .use_crash_handler = true, + .use_abort_handler = true, + }, + .exit_code_on_error = { + .python = 0, } -#else - UNUSED_VARS(argc, argv, data); - printf("This blender was built without python support\n"); - return 0; -#endif /* WITH_PYTHON */ -} - -static int run_python_console(int UNUSED(argc), const char **argv, void *data) -{ -#ifdef WITH_PYTHON - bContext *C = data; - - BPY_CTX_SETUP(BPY_execute_string(C, "__import__('code').interact()")); - - return 0; -#else - UNUSED_VARS(argv, data); - printf("This blender was built without python support\n"); - return 0; -#endif /* WITH_PYTHON */ -} +}; -static int set_python_exit_code(int argc, const char **argv, void *UNUSED(data)) -{ - const char *arg_id = "--python-exit-code"; - if (argc > 1) { - const char *err_msg = NULL; - const int min = 0, max = 255; - int exit_code; - if (!parse_int_strict_range(argv[1], min, max, &exit_code, &err_msg)) { - printf("\nError: %s '%s %s', expected number in [%d..%d].\n", err_msg, arg_id, argv[1], min, max); - return 1; - } +/* -------------------------------------------------------------------- */ - python_exit_code_on_error = (unsigned char)exit_code; - return 1; - } - else { - printf("\nError: you must specify an exit code number '%s'.\n", arg_id); - return 0; - } -} +/** \name Application Level Callbacks + * + * Initialize callbacks for the modules that need them. + * + * \{ */ -static int set_addons(int argc, const char **argv, void *data) +static void callback_mem_error(const char *errorStr) { - /* workaround for scripts not getting a bpy.context.scene, causes internal errors elsewhere */ - if (argc > 1) { -#ifdef WITH_PYTHON - const char script_str[] = - "from addon_utils import check, enable\n" - "for m in '%s'.split(','):\n" - " if check(m)[1] is False:\n" - " enable(m, persistent=True)"; - const int slen = strlen(argv[1]) + (sizeof(script_str) - 2); - char *str = malloc(slen); - bContext *C = data; - BLI_snprintf(str, slen, script_str, argv[1]); - - BLI_assert(strlen(str) + 1 == slen); - BPY_CTX_SETUP(BPY_execute_string_ex(C, str, false)); - free(str); -#else - UNUSED_VARS(argv, data); -#endif /* WITH_PYTHON */ - return 1; - } - else { - printf("\nError: you must specify a comma separated list after '--addons'.\n"); - return 0; - } + fputs(errorStr, stderr); + fflush(stderr); } -static int load_file(int UNUSED(argc), const char **argv, void *data) +static void main_callback_setup(void) { - bContext *C = data; - ReportList reports; - bool success; - - /* Make the path absolute because its needed for relative linked blends to be found */ - char filename[FILE_MAX]; - - /* note, we could skip these, but so far we always tried to load these files */ - if (argv[0][0] == '-') { - fprintf(stderr, "unknown argument, loading as file: %s\n", argv[0]); - } - - BLI_strncpy(filename, argv[0], sizeof(filename)); - BLI_path_cwd(filename, sizeof(filename)); - - /* load the file */ - BKE_reports_init(&reports, RPT_PRINT); - WM_file_autoexec_init(filename); - success = WM_file_read(C, filename, &reports); - BKE_reports_clear(&reports); - - if (success) { - if (G.background) { - /* ensuer we use 'C->data.scene' for background render */ - CTX_wm_window_set(C, NULL); - } - } - else { - /* failed to load file, stop processing arguments if running in background mode */ - if (G.background) { - /* Set is_break if running in the background mode so - * blender will return non-zero exit code which then - * could be used in automated script to control how - * good or bad things are. - */ - G.is_break = true; - return -1; - } - - /* Just pretend a file was loaded, so the user can press Save and it'll save at the filename from the CLI. */ - BLI_strncpy(G.main->name, filename, FILE_MAX); - G.relbase_valid = true; - G.save_over = true; - printf("... opened default scene instead; saving will write to %s\n", filename); - } - - G.file_loaded = 1; - - return 0; + /* Error output from the alloc routines: */ + MEM_set_error_callback(callback_mem_error); } -static void setupArguments(bContext *C, bArgs *ba, SYS_SystemHandle *syshandle) -{ - static char output_doc[] = "" - "\n\tSet the render path and file name." - "\n\tUse '//' at the start of the path to render relative to the blend file." - "\n" - "\n\tThe '#' characters are replaced by the frame number, and used to define zero padding." - "\n\t* 'ani_##_test.png' becomes 'ani_01_test.png'" - "\n\t* 'test-######.png' becomes 'test-000001.png'" - "\n" - "\n\tWhen the filename does not contain '#', The suffix '####' is added to the filename." - "\n" - "\n\tThe frame number will be added at the end of the filename, eg:" - "\n\t# blender -b foobar.blend -o //render_ -F PNG -x 1 -a" - "\n\t'//render_' becomes '//render_####', writing frames as '//render_0001.png'"; - - static char format_doc[] = "" - "\n\tSet the render format, Valid options are..." - "\n\t\tTGA IRIS JPEG MOVIE IRIZ RAWTGA" - "\n\t\tAVIRAW AVIJPEG PNG BMP FRAMESERVER" - "\n\t(formats that can be compiled into blender, not available on all systems)" - "\n\t\tHDR TIFF EXR MULTILAYER MPEG AVICODEC QUICKTIME CINEON DPX DDS"; - - static char playback_doc[] = " " - "\n\tPlayback , only operates this way when not running in background." - "\n\t\t-p \tOpen with lower left corner at , " - "\n\t\t-m\t\tRead from disk (Don't buffer)" - "\n\t\t-f \t\tSpecify FPS to start with" - "\n\t\t-j \tSet frame step to " - "\n\t\t-s \tPlay from " - "\n\t\t-e \tPlay until "; - - static char game_doc[] = "Game Engine specific options" - "\n\t-g fixedtime\t\tRun on 50 hertz without dropping frames" - "\n\t-g vertexarrays\t\tUse Vertex Arrays for rendering (usually faster)" - "\n\t-g nomipmap\t\tNo Texture Mipmapping" - "\n\t-g linearmipmap\t\tLinear Texture Mipmapping instead of Nearest (default)"; - - static char debug_doc[] = "\n\tTurn debugging on\n" - "\n\t* Enables memory error detection" - "\n\t* Disables mouse grab (to interact with a debugger in some cases)" - "\n\t* Keeps Python's 'sys.stdin' rather than setting it to None"; - - //BLI_argsAdd(ba, pass, short_arg, long_arg, doc, cb, C); - - /* end argument processing after -- */ - BLI_argsAdd(ba, -1, "--", NULL, "\n\tEnds option processing, following arguments passed unchanged. Access via Python's 'sys.argv'", end_arguments, NULL); - - /* first pass: background mode, disable python and commands that exit after usage */ - BLI_argsAdd(ba, 1, "-h", "--help", "\n\tPrint this help text and exit", print_help, ba); - /* Windows only */ - BLI_argsAdd(ba, 1, "/?", NULL, "\n\tPrint this help text and exit (windows only)", print_help, ba); - - BLI_argsAdd(ba, 1, "-v", "--version", "\n\tPrint Blender version and exit", print_version, NULL); - - /* only to give help message */ -#ifndef WITH_PYTHON_SECURITY /* default */ -# define PY_ENABLE_AUTO ", (default)" -# define PY_DISABLE_AUTO "" -#else -# define PY_ENABLE_AUTO "" -# define PY_DISABLE_AUTO ", (compiled as non-standard default)" -#endif - - BLI_argsAdd(ba, 1, "-y", "--enable-autoexec", "\n\tEnable automatic Python script execution" PY_ENABLE_AUTO, enable_python, NULL); - BLI_argsAdd(ba, 1, "-Y", "--disable-autoexec", "\n\tDisable automatic Python script execution (pydrivers & startup scripts)" PY_DISABLE_AUTO, disable_python, NULL); - - BLI_argsAdd(ba, 1, NULL, "--disable-crash-handler", "\n\tDisable the crash handler", disable_crash_handler, NULL); - BLI_argsAdd(ba, 1, NULL, "--disable-abort-handler", "\n\tDisable the abort handler", disable_abort_handler, NULL); - -#undef PY_ENABLE_AUTO -#undef PY_DISABLE_AUTO - - BLI_argsAdd(ba, 1, "-b", "--background", "\n\tRun in background (often used for UI-less rendering)", background_mode, NULL); - - BLI_argsAdd(ba, 1, "-a", NULL, playback_doc, playback_mode, NULL); - - BLI_argsAdd(ba, 1, "-d", "--debug", debug_doc, debug_mode, ba); - -#ifdef WITH_FFMPEG - BLI_argsAdd(ba, 1, NULL, "--debug-ffmpeg", "\n\tEnable debug messages from FFmpeg library", debug_mode_generic, (void *)G_DEBUG_FFMPEG); -#endif - -#ifdef WITH_FREESTYLE - BLI_argsAdd(ba, 1, NULL, "--debug-freestyle", "\n\tEnable debug/profiling messages from Freestyle rendering", debug_mode_generic, (void *)G_DEBUG_FREESTYLE); -#endif +/** \} */ - BLI_argsAdd(ba, 1, NULL, "--debug-python", "\n\tEnable debug messages for Python", debug_mode_generic, (void *)G_DEBUG_PYTHON); - BLI_argsAdd(ba, 1, NULL, "--debug-events", "\n\tEnable debug messages for the event system", debug_mode_generic, (void *)G_DEBUG_EVENTS); - BLI_argsAdd(ba, 1, NULL, "--debug-handlers", "\n\tEnable debug messages for event handling", debug_mode_generic, (void *)G_DEBUG_HANDLERS); - BLI_argsAdd(ba, 1, NULL, "--debug-wm", "\n\tEnable debug messages for the window manager, also prints every operator call", debug_mode_generic, (void *)G_DEBUG_WM); - BLI_argsAdd(ba, 1, NULL, "--debug-all", "\n\tEnable all debug messages (excludes libmv)", debug_mode_generic, (void *)G_DEBUG_ALL); - BLI_argsAdd(ba, 1, NULL, "--debug-fpe", "\n\tEnable floating point exceptions", set_fpe, NULL); -#ifdef WITH_LIBMV - BLI_argsAdd(ba, 1, NULL, "--debug-libmv", "\n\tEnable debug messages from libmv library", debug_mode_libmv, NULL); -#endif -#ifdef WITH_CYCLES_LOGGING - BLI_argsAdd(ba, 1, NULL, "--debug-cycles", "\n\tEnable debug messages from Cycles", debug_mode_cycles, NULL); -#endif - BLI_argsAdd(ba, 1, NULL, "--debug-memory", "\n\tEnable fully guarded memory allocation and debugging", debug_mode_memory, NULL); - - BLI_argsAdd(ba, 1, NULL, "--debug-value", "\n\tSet debug value of on startup\n", set_debug_value, NULL); - BLI_argsAdd(ba, 1, NULL, "--debug-jobs", "\n\tEnable time profiling for background jobs.", debug_mode_generic, (void *)G_DEBUG_JOBS); - BLI_argsAdd(ba, 1, NULL, "--debug-gpu", "\n\tEnable gpu debug context and information for OpenGL 4.3+.", debug_mode_generic, (void *)G_DEBUG_GPU); - BLI_argsAdd(ba, 1, NULL, "--debug-depsgraph", "\n\tEnable debug messages from dependency graph", debug_mode_generic, (void *)G_DEBUG_DEPSGRAPH); - BLI_argsAdd(ba, 1, NULL, "--debug-depsgraph-no-threads", "\n\tSwitch dependency graph to a single threaded evaluation", debug_mode_generic, (void *)G_DEBUG_DEPSGRAPH_NO_THREADS); - BLI_argsAdd(ba, 1, NULL, "--debug-gpumem", "\n\tEnable GPU memory stats in status bar", debug_mode_generic, (void *)G_DEBUG_GPU_MEM); - - BLI_argsAdd(ba, 1, NULL, "--enable-new-depsgraph", "\n\tUse new dependency graph", depsgraph_use_new, NULL); - - BLI_argsAdd(ba, 1, NULL, "--verbose", "\n\tSet logging verbosity level.", set_verbosity, NULL); - - BLI_argsAdd(ba, 1, NULL, "--factory-startup", "\n\tSkip reading the " STRINGIFY(BLENDER_STARTUP_FILE) " in the users home directory", set_factory_startup, NULL); - - /* TODO, add user env vars? */ - BLI_argsAdd(ba, 1, NULL, "--env-system-datafiles", "\n\tSet the "STRINGIFY_ARG (BLENDER_SYSTEM_DATAFILES)" environment variable", set_env, NULL); - BLI_argsAdd(ba, 1, NULL, "--env-system-scripts", "\n\tSet the "STRINGIFY_ARG (BLENDER_SYSTEM_SCRIPTS)" environment variable", set_env, NULL); - BLI_argsAdd(ba, 1, NULL, "--env-system-python", "\n\tSet the "STRINGIFY_ARG (BLENDER_SYSTEM_PYTHON)" environment variable", set_env, NULL); - - /* second pass: custom window stuff */ - BLI_argsAdd(ba, 2, "-p", "--window-geometry", " \n\tOpen with lower left corner at , and width and height as , ", prefsize, NULL); - BLI_argsAdd(ba, 2, "-w", "--window-border", "\n\tForce opening with borders (default)", with_borders, NULL); - BLI_argsAdd(ba, 2, "-W", "--window-borderless", "\n\tForce opening without borders", without_borders, NULL); - BLI_argsAdd(ba, 2, "-con", "--start-console", "\n\tStart with the console window open (ignored if -b is set), (Windows only)", start_with_console, NULL); - BLI_argsAdd(ba, 2, "-R", NULL, "\n\tRegister .blend extension, then exit (Windows only)", register_extension, NULL); - BLI_argsAdd(ba, 2, "-r", NULL, "\n\tSilently register .blend extension, then exit (Windows only)", register_extension, ba); - BLI_argsAdd(ba, 2, NULL, "--no-native-pixels", "\n\tDo not use native pixel size, for high resolution displays (MacBook 'Retina')", native_pixels, ba); - - /* third pass: disabling things and forcing settings */ - BLI_argsAddCase(ba, 3, "-nojoystick", 1, NULL, 0, "\n\tDisable joystick support", no_joystick, syshandle); - BLI_argsAddCase(ba, 3, "-noglsl", 1, NULL, 0, "\n\tDisable GLSL shading", no_glsl, NULL); - BLI_argsAddCase(ba, 3, "-noaudio", 1, NULL, 0, "\n\tForce sound system to None", no_audio, NULL); - BLI_argsAddCase(ba, 3, "-setaudio", 1, NULL, 0, "\n\tForce sound system to a specific device\n\tNULL SDL OPENAL JACK", set_audio, NULL); - - /* fourth pass: processing arguments */ - BLI_argsAdd(ba, 4, "-g", NULL, game_doc, set_ge_parameters, syshandle); - BLI_argsAdd(ba, 4, "-f", "--render-frame", "\n\tRender frame and save it.\n\t+ start frame relative, - end frame relative.", render_frame, C); - BLI_argsAdd(ba, 4, "-a", "--render-anim", "\n\tRender frames from start to end (inclusive)", render_animation, C); - BLI_argsAdd(ba, 4, "-S", "--scene", "\n\tSet the active scene for rendering", set_scene, C); - BLI_argsAdd(ba, 4, "-s", "--frame-start", "\n\tSet start to frame , supports +/- for relative frames too.", set_start_frame, C); - BLI_argsAdd(ba, 4, "-e", "--frame-end", "\n\tSet end to frame , supports +/- for relative frames too.", set_end_frame, C); - BLI_argsAdd(ba, 4, "-j", "--frame-jump", "\n\tSet number of frames to step forward after each rendered frame", set_skip_frame, C); - BLI_argsAdd(ba, 4, "-P", "--python", "\n\tRun the given Python script file", run_python_file, C); - BLI_argsAdd(ba, 4, NULL, "--python-text", "\n\tRun the given Python script text block", run_python_text, C); - BLI_argsAdd(ba, 4, NULL, "--python-expr", "\n\tRun the given expression as a Python script", run_python_expr, C); - BLI_argsAdd(ba, 4, NULL, "--python-console", "\n\tRun blender with an interactive console", run_python_console, C); - BLI_argsAdd(ba, 4, NULL, "--python-exit-code", "\n\tSet the exit-code in [0..255] to exit if a Python exception is raised (only for scripts executed from the command line), zero disables.", set_python_exit_code, NULL); - BLI_argsAdd(ba, 4, NULL, "--addons", "\n\tComma separated list of addons (no spaces)", set_addons, C); - - BLI_argsAdd(ba, 4, "-o", "--render-output", output_doc, set_output, C); - BLI_argsAdd(ba, 4, "-E", "--engine", "\n\tSpecify the render engine\n\tuse -E help to list available engines", set_engine, C); - - BLI_argsAdd(ba, 4, "-F", "--render-format", format_doc, set_image_type, C); - BLI_argsAdd(ba, 4, "-t", "--threads", "\n\tUse amount of for rendering and other operations\n\t[1-" STRINGIFY(BLENDER_MAX_THREADS) "], 0 for systems processor count.", set_threads, NULL); - BLI_argsAdd(ba, 4, "-x", "--use-extension", "\n\tSet option to add the file extension to the end of the file", set_extension, C); +/* -------------------------------------------------------------------- */ -} -#endif /* WITH_PYTHON_MODULE */ +/** \name Main Function + * \{ */ #ifdef WITH_PYTHON_MODULE /* allow python module to call main */ @@ -1898,7 +287,7 @@ int main( CCL_init_logging(argv[0]); #endif - setCallbacks(); + main_callback_setup(); #if defined(__APPLE__) && !defined(WITH_PYTHON_MODULE) /* patch to ignore argument finder gives us (pid?) */ @@ -1946,22 +335,11 @@ int main( /* first test for background */ #ifndef WITH_PYTHON_MODULE ba = BLI_argsInit(argc, (const char **)argv); /* skip binary path */ - setupArguments(C, ba, &syshandle); + main_args_setup(C, ba, &syshandle); BLI_argsParse(ba, 1, NULL, NULL); - if (use_crash_handler) { -#ifdef WIN32 - SetUnhandledExceptionFilter(windows_exception_handler); -#else - /* after parsing args */ - signal(SIGSEGV, blender_crash_handler); -#endif - } - - if (use_abort_handler) { - signal(SIGABRT, blender_abort_handler); - } + main_signal_setup(); #else G.factory_startup = true; /* using preferences or user startup makes no sense for py-as-module */ @@ -1984,9 +362,8 @@ int main( #if defined(WITH_PYTHON_MODULE) || defined(WITH_HEADLESS) G.background = true; /* python module mode ALWAYS runs in background mode (for now) */ #else - /* for all platforms, even windos has it! */ if (G.background) { - signal(SIGINT, blender_esc); /* ctrl c out bg render */ + main_signal_setup_background(); } #endif @@ -2044,7 +421,7 @@ int main( /* OK we are ready for it */ #ifndef WITH_PYTHON_MODULE - BLI_argsParse(ba, 4, load_file, C); + main_args_setup_post(C, ba); if (G.background == 0) { if (!G.file_loaded) @@ -2107,14 +484,4 @@ void main_python_exit(void) } #endif -static void mem_error_cb(const char *errorStr) -{ - fputs(errorStr, stderr); - fflush(stderr); -} - -static void setCallbacks(void) -{ - /* Error output from the alloc routines: */ - MEM_set_error_callback(mem_error_cb); -} +/** \} */ diff --git a/source/creator/creator_args.c b/source/creator/creator_args.c new file mode 100644 index 00000000000..c70f275d540 --- /dev/null +++ b/source/creator/creator_args.c @@ -0,0 +1,1672 @@ +/* + * ***** BEGIN GPL LICENSE BLOCK ***** + * + * This program 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. + * + * This program 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 this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + * + * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file creator/creator_args.c + * \ingroup creator + */ + +#ifndef WITH_PYTHON_MODULE + +#include +#include +#include + +#include "MEM_guardedalloc.h" + +#ifdef WIN32 +# include "BLI_winstuff.h" +#endif + +#include "BLI_args.h" +#include "BLI_threads.h" +#include "BLI_utildefines.h" +#include "BLI_listbase.h" +#include "BLI_string.h" +#include "BLI_string_utf8.h" +#include "BLI_path_util.h" +#include "BLI_fileops.h" +#include "BLI_mempool.h" + +#include "BKE_blender.h" +#include "BKE_context.h" + +#include "BKE_global.h" +#include "BKE_library.h" +#include "BKE_main.h" +#include "BKE_scene.h" +#include "BKE_report.h" +#include "BKE_sound.h" +#include "BKE_image.h" + +#include "DEG_depsgraph.h" + +#ifdef WITH_FFMPEG +#include "IMB_imbuf.h" +#endif + +#ifdef WITH_PYTHON +#include "BPY_extern.h" +#endif + +#include "RE_engine.h" +#include "RE_pipeline.h" + +#include "ED_datafiles.h" + +#include "WM_api.h" + +#include "GPU_draw.h" +#include "GPU_extensions.h" + +/* for passing information between creator and gameengine */ +#ifdef WITH_GAMEENGINE +# include "BL_System.h" +#else /* dummy */ +# define SYS_SystemHandle int +#endif + +#ifdef WITH_LIBMV +# include "libmv-capi.h" +#endif + +#ifdef WITH_CYCLES_LOGGING +# include "CCL_api.h" +#endif + +#include "creator_intern.h" /* own include */ + + +/* -------------------------------------------------------------------- */ + +/** \name Utility String Parsing + * \{ */ + +static bool parse_int_relative( + const char *str, int pos, int neg, + int *r_value, const char **r_err_msg) +{ + char *str_end = NULL; + long value; + + errno = 0; + + switch (*str) { + case '+': + value = pos + strtol(str + 1, &str_end, 10); + break; + case '-': + value = (neg - strtol(str + 1, &str_end, 10)) + 1; + break; + default: + value = strtol(str, &str_end, 10); + break; + } + + + if (*str_end != '\0') { + static const char *msg = "not a number"; + *r_err_msg = msg; + return false; + } + else if ((errno == ERANGE) || ((value < INT_MIN || value > INT_MAX))) { + static const char *msg = "exceeds range"; + *r_err_msg = msg; + return false; + } + else { + *r_value = (int)value; + return true; + } +} + +static bool parse_int_relative_clamp( + const char *str, int pos, int neg, int min, int max, + int *r_value, const char **r_err_msg) +{ + if (parse_int_relative(str, pos, neg, r_value, r_err_msg)) { + CLAMP(*r_value, min, max); + return true; + } + else { + return false; + } +} + +/** + * No clamping, fails with any number outside the range. + */ +static bool parse_int_strict_range( + const char *str, const int min, const int max, + int *r_value, const char **r_err_msg) +{ + char *str_end = NULL; + long value; + + errno = 0; + value = strtol(str, &str_end, 10); + + if (*str_end != '\0') { + static const char *msg = "not a number"; + *r_err_msg = msg; + return false; + } + else if ((errno == ERANGE) || ((value < min || value > max))) { + static const char *msg = "exceeds range"; + *r_err_msg = msg; + return false; + } + else { + *r_value = (int)value; + return true; + } +} + +static bool parse_int( + const char *str, + int *r_value, const char **r_err_msg) +{ + return parse_int_strict_range(str, INT_MIN, INT_MAX, r_value, r_err_msg); +} + +static bool parse_int_clamp( + const char *str, int min, int max, + int *r_value, const char **r_err_msg) +{ + if (parse_int(str, r_value, r_err_msg)) { + CLAMP(*r_value, min, max); + return true; + } + else { + return false; + } +} + +/** \} */ + + +/* -------------------------------------------------------------------- */ + +#ifdef WITH_PYTHON + +/** \name Utilities Python Context Macro (#BPY_CTX_SETUP) + * \{ */ +struct BlendePyContextStore { + wmWindowManager *wm; + Scene *scene; + wmWindow *win; + bool has_win; +}; + +static void arg_py_context_backup( + bContext *C, struct BlendePyContextStore *c_py, + const char *script_id) +{ + c_py->wm = CTX_wm_manager(C); + c_py->scene = CTX_data_scene(C); + c_py->has_win = !BLI_listbase_is_empty(&c_py->wm->windows); + if (c_py->has_win) { + c_py->win = CTX_wm_window(C); + CTX_wm_window_set(C, c_py->wm->windows.first); + } + else { + c_py->win = NULL; + fprintf(stderr, "Python script \"%s\" " + "running with missing context data.\n", script_id); + } +} + +static void arg_py_context_restore( + bContext *C, struct BlendePyContextStore *c_py) +{ + /* script may load a file, check old data is valid before using */ + if (c_py->has_win) { + if ((c_py->win == NULL) || + ((BLI_findindex(&G.main->wm, c_py->wm) != -1) && + (BLI_findindex(&c_py->wm->windows, c_py->win) != -1))) + { + CTX_wm_window_set(C, c_py->win); + } + } + + if ((c_py->scene == NULL) || + BLI_findindex(&G.main->scene, c_py->scene) != -1) + { + CTX_data_scene_set(C, c_py->scene); + } +} + +/* macro for context setup/reset */ +#define BPY_CTX_SETUP(_cmd) \ + { \ + struct BlendePyContextStore py_c; \ + arg_py_context_backup(C, &py_c, argv[1]); \ + { _cmd; } \ + arg_py_context_restore(C, &py_c); \ + } ((void)0) + +#endif /* WITH_PYTHON */ + +/** \} */ + + +/* -------------------------------------------------------------------- */ + +/** \name Handle Argument Callbacks + * \{ */ + +static const char arg_handle_print_version_doc[] = +"\n\tPrint Blender version and exit" +; +static int arg_handle_print_version(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + printf(BLEND_VERSION_STRING_FMT); +#ifdef BUILD_DATE + printf("\tbuild date: %s\n", build_date); + printf("\tbuild time: %s\n", build_time); + printf("\tbuild commit date: %s\n", build_commit_date); + printf("\tbuild commit time: %s\n", build_commit_time); + printf("\tbuild hash: %s\n", build_hash); + printf("\tbuild platform: %s\n", build_platform); + printf("\tbuild type: %s\n", build_type); + printf("\tbuild c flags: %s\n", build_cflags); + printf("\tbuild c++ flags: %s\n", build_cxxflags); + printf("\tbuild link flags: %s\n", build_linkflags); + printf("\tbuild system: %s\n", build_system); +#endif + exit(0); + + return 0; +} + +static const char arg_handle_print_help_doc[] = +"\n\tPrint this help text and exit" +; +static const char arg_handle_print_help_doc_win32[] = +"\n\tPrint this help text and exit (windows only)" +; +static int arg_handle_print_help(int UNUSED(argc), const char **UNUSED(argv), void *data) +{ + bArgs *ba = (bArgs *)data; + + printf(BLEND_VERSION_STRING_FMT); + printf("Usage: blender [args ...] [file] [args ...]\n\n"); + + printf("Render Options:\n"); + BLI_argsPrintArgDoc(ba, "--background"); + BLI_argsPrintArgDoc(ba, "--render-anim"); + BLI_argsPrintArgDoc(ba, "--scene"); + BLI_argsPrintArgDoc(ba, "--render-frame"); + BLI_argsPrintArgDoc(ba, "--frame-start"); + BLI_argsPrintArgDoc(ba, "--frame-end"); + BLI_argsPrintArgDoc(ba, "--frame-jump"); + BLI_argsPrintArgDoc(ba, "--render-output"); + BLI_argsPrintArgDoc(ba, "--engine"); + BLI_argsPrintArgDoc(ba, "--threads"); + + printf("\n"); + printf("Format Options:\n"); + BLI_argsPrintArgDoc(ba, "--render-format"); + BLI_argsPrintArgDoc(ba, "--use-extension"); + + printf("\n"); + printf("Animation Playback Options:\n"); + BLI_argsPrintArgDoc(ba, "-a"); + + printf("\n"); + printf("Window Options:\n"); + BLI_argsPrintArgDoc(ba, "--window-border"); + BLI_argsPrintArgDoc(ba, "--window-borderless"); + BLI_argsPrintArgDoc(ba, "--window-geometry"); + BLI_argsPrintArgDoc(ba, "--start-console"); + BLI_argsPrintArgDoc(ba, "--no-native-pixels"); + + + printf("\n"); + printf("Game Engine Specific Options:\n"); + BLI_argsPrintArgDoc(ba, "-g"); + + printf("\n"); + printf("Python Options:\n"); + BLI_argsPrintArgDoc(ba, "--enable-autoexec"); + BLI_argsPrintArgDoc(ba, "--disable-autoexec"); + + printf("\n"); + + BLI_argsPrintArgDoc(ba, "--python"); + BLI_argsPrintArgDoc(ba, "--python-text"); + BLI_argsPrintArgDoc(ba, "--python-expr"); + BLI_argsPrintArgDoc(ba, "--python-console"); + BLI_argsPrintArgDoc(ba, "--python-exit-code"); + BLI_argsPrintArgDoc(ba, "--addons"); + + + printf("\n"); + printf("Debug Options:\n"); + BLI_argsPrintArgDoc(ba, "--debug"); + BLI_argsPrintArgDoc(ba, "--debug-value"); + + printf("\n"); + BLI_argsPrintArgDoc(ba, "--debug-events"); +#ifdef WITH_FFMPEG + BLI_argsPrintArgDoc(ba, "--debug-ffmpeg"); +#endif + BLI_argsPrintArgDoc(ba, "--debug-handlers"); +#ifdef WITH_LIBMV + BLI_argsPrintArgDoc(ba, "--debug-libmv"); +#endif +#ifdef WITH_CYCLES_LOGGING + BLI_argsPrintArgDoc(ba, "--debug-cycles"); +#endif + BLI_argsPrintArgDoc(ba, "--debug-memory"); + BLI_argsPrintArgDoc(ba, "--debug-jobs"); + BLI_argsPrintArgDoc(ba, "--debug-python"); + BLI_argsPrintArgDoc(ba, "--debug-depsgraph"); + BLI_argsPrintArgDoc(ba, "--debug-depsgraph-no-threads"); + + BLI_argsPrintArgDoc(ba, "--debug-gpumem"); + BLI_argsPrintArgDoc(ba, "--debug-wm"); + BLI_argsPrintArgDoc(ba, "--debug-all"); + + printf("\n"); + BLI_argsPrintArgDoc(ba, "--debug-fpe"); + BLI_argsPrintArgDoc(ba, "--disable-crash-handler"); + + printf("\n"); + printf("Misc Options:\n"); + BLI_argsPrintArgDoc(ba, "--factory-startup"); + printf("\n"); + BLI_argsPrintArgDoc(ba, "--env-system-datafiles"); + BLI_argsPrintArgDoc(ba, "--env-system-scripts"); + BLI_argsPrintArgDoc(ba, "--env-system-python"); + printf("\n"); + BLI_argsPrintArgDoc(ba, "-nojoystick"); + BLI_argsPrintArgDoc(ba, "-noglsl"); + BLI_argsPrintArgDoc(ba, "-noaudio"); + BLI_argsPrintArgDoc(ba, "-setaudio"); + + printf("\n"); + + BLI_argsPrintArgDoc(ba, "--help"); + +#ifdef WIN32 + BLI_argsPrintArgDoc(ba, "-R"); + BLI_argsPrintArgDoc(ba, "-r"); +#endif + BLI_argsPrintArgDoc(ba, "--version"); + + BLI_argsPrintArgDoc(ba, "--"); + + printf("Other Options:\n"); + BLI_argsPrintOtherDoc(ba); + + printf("\n"); + printf("Experimental features:\n"); + BLI_argsPrintArgDoc(ba, "--enable-new-depsgraph"); + + printf("Argument Parsing:\n"); + printf("\tArguments must be separated by white space, eg:\n"); + printf("\t# blender -ba test.blend\n"); + printf("\t...will ignore the 'a'\n"); + printf("\t# blender -b test.blend -f8\n"); + printf("\t...will ignore '8' because there is no space between the '-f' and the frame value\n\n"); + + printf("Argument Order:\n"); + printf("\tArguments are executed in the order they are given. eg:\n"); + printf("\t# blender --background test.blend --render-frame 1 --render-output '/tmp'\n"); + printf("\t...will not render to '/tmp' because '--render-frame 1' renders before the output path is set\n"); + printf("\t# blender --background --render-output /tmp test.blend --render-frame 1\n"); + printf("\t...will not render to '/tmp' because loading the blend file overwrites the render output that was set\n"); + printf("\t# blender --background test.blend --render-output /tmp --render-frame 1\n"); + printf("\t...works as expected.\n\n"); + + printf("Environment Variables:\n"); + printf(" $BLENDER_USER_CONFIG Directory for user configuration files.\n"); + printf(" $BLENDER_USER_SCRIPTS Directory for user scripts.\n"); + printf(" $BLENDER_SYSTEM_SCRIPTS Directory for system wide scripts.\n"); + printf(" $BLENDER_USER_DATAFILES Directory for user data files (icons, translations, ..).\n"); + printf(" $BLENDER_SYSTEM_DATAFILES Directory for system wide data files.\n"); + printf(" $BLENDER_SYSTEM_PYTHON Directory for system python libraries.\n"); +#ifdef WIN32 + printf(" $TEMP Store temporary files here.\n"); +#else + printf(" $TMP or $TMPDIR Store temporary files here.\n"); +#endif +#ifdef WITH_SDL + printf(" $SDL_AUDIODRIVER LibSDL audio driver - alsa, esd, dma.\n"); +#endif + printf(" $PYTHONHOME Path to the python directory, eg. /usr/lib/python.\n\n"); + + exit(0); + + return 0; +} + +static const char arg_handle_arguments_end_doc[] = +"\n\tEnds option processing, following arguments passed unchanged. Access via Python's 'sys.argv'" +; +static int arg_handle_arguments_end(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + return -1; +} + +/* only to give help message */ +#ifndef WITH_PYTHON_SECURITY /* default */ +# define PY_ENABLE_AUTO ", (default)" +# define PY_DISABLE_AUTO "" +#else +# define PY_ENABLE_AUTO "" +# define PY_DISABLE_AUTO ", (compiled as non-standard default)" +#endif + +static const char arg_handle_python_set_doc_enable[] = +"\n\tEnable automatic Python script execution" PY_ENABLE_AUTO +; +static const char arg_handle_python_set_doc_disable[] = +"\n\tDisable automatic Python script execution (pydrivers & startup scripts)" PY_DISABLE_AUTO +; +#undef PY_ENABLE_AUTO +#undef PY_DISABLE_AUTO + +static int arg_handle_python_set(int UNUSED(argc), const char **UNUSED(argv), void *data) +{ + if ((bool)data) { + G.f |= G_SCRIPT_AUTOEXEC; + } + else { + G.f &= ~G_SCRIPT_AUTOEXEC; + } + G.f |= G_SCRIPT_OVERRIDE_PREF; + return 0; +} + +static const char arg_handle_crash_handler_disable_doc[] = +"\n\tDisable the crash handler" +; +static int arg_handle_crash_handler_disable(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + app_state.signal.use_crash_handler = false; + return 0; +} + +static const char arg_handle_abort_handler_disable_doc[] = +"\n\tDisable the abort handler" +; +static int arg_handle_abort_handler_disable(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + app_state.signal.use_abort_handler = false; + return 0; +} + +static const char arg_handle_background_mode_set_doc[] = +"\n\tRun in background (often used for UI-less rendering)" +; +static int arg_handle_background_mode_set(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + G.background = 1; + return 0; +} + +static const char arg_handle_debug_mode_set_doc[] = +"\n\tTurn debugging on\n" +"\n\t* Enables memory error detection" +"\n\t* Disables mouse grab (to interact with a debugger in some cases)" +"\n\t* Keeps Python's 'sys.stdin' rather than setting it to None" +; +static int arg_handle_debug_mode_set(int UNUSED(argc), const char **UNUSED(argv), void *data) +{ + G.debug |= G_DEBUG; /* std output printf's */ + printf(BLEND_VERSION_STRING_FMT); + MEM_set_memory_debug(); +#ifndef NDEBUG + BLI_mempool_set_memory_debug(); +#endif + +#ifdef WITH_BUILDINFO + printf("Build: %s %s %s %s\n", build_date, build_time, build_platform, build_type); +#endif + + BLI_argsPrint(data); + return 0; +} + +#ifdef WITH_FFMPEG +static const char arg_handle_debug_mode_generic_set_doc_ffmpeg[] = +"\n\tEnable debug messages from FFmpeg library"; +#endif +#ifdef WITH_FREESTYLE +static const char arg_handle_debug_mode_generic_set_doc_freestyle[] = +"\n\tEnable debug messages for FreeStyle"; +#endif +static const char arg_handle_debug_mode_generic_set_doc_python[] = +"\n\tEnable debug messages for Python"; +static const char arg_handle_debug_mode_generic_set_doc_events[] = +"\n\tEnable debug messages for the event system"; +static const char arg_handle_debug_mode_generic_set_doc_handlers[] = +"\n\tEnable debug messages for event handling"; +static const char arg_handle_debug_mode_generic_set_doc_wm[] = +"\n\tEnable debug messages for the window manager, also prints every operator call"; +static const char arg_handle_debug_mode_generic_set_doc_all[] = +"\n\tEnable all debug messages (excludes libmv)"; +static const char arg_handle_debug_mode_generic_set_doc_jobs[] = +"\n\tEnable time profiling for background jobs."; +static const char arg_handle_debug_mode_generic_set_doc_gpu[] = +"\n\tEnable gpu debug context and information for OpenGL 4.3+."; +static const char arg_handle_debug_mode_generic_set_doc_depsgraph[] = +"\n\tEnable debug messages from dependency graph"; +static const char arg_handle_debug_mode_generic_set_doc_depsgraph_no_threads[] = +"\n\tSwitch dependency graph to a single threaded evaluation"; +static const char arg_handle_debug_mode_generic_set_doc_gpumem[] = +"\n\tEnable GPU memory stats in status bar"; + +static int arg_handle_debug_mode_generic_set(int UNUSED(argc), const char **UNUSED(argv), void *data) +{ + G.debug |= GET_INT_FROM_POINTER(data); + return 0; +} + +#ifdef WITH_LIBMV +static const char arg_handle_debug_mode_libmv_doc[] = +"\n\tEnable debug messages from libmv library" +; +static int arg_handle_debug_mode_libmv(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + libmv_startDebugLogging(); + + return 0; +} +#endif + +#ifdef WITH_CYCLES_LOGGING +static const char arg_handle_debug_mode_cycles_doc[] = +"\n\tEnable debug messages from Cycles" +; +static int arg_handle_debug_mode_cycles(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + CCL_start_debug_logging(); + return 0; +} +#endif + +static const char arg_handle_debug_mode_memory_set_doc[] = +"\n\tEnable fully guarded memory allocation and debugging" +; +static int arg_handle_debug_mode_memory_set(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + MEM_set_memory_debug(); + return 0; +} + +static const char arg_handle_debug_value_set_doc[] = +"\n\tSet debug value of on startup\n" +; +static int arg_handle_debug_value_set(int argc, const char **argv, void *UNUSED(data)) +{ + const char *arg_id = "--debug-value"; + if (argc > 1) { + const char *err_msg = NULL; + int value; + if (!parse_int(argv[1], &value, &err_msg)) { + printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); + return 1; + } + + G.debug_value = value; + + return 1; + } + else { + printf("\nError: you must specify debug value to set.\n"); + return 0; + } +} + +static const char arg_handle_debug_fpe_set_doc[] = +"\n\tEnable floating point exceptions" +; +static int arg_handle_debug_fpe_set(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + main_signal_setup_fpe(); + return 0; +} + +static const char arg_handle_factory_startup_set_doc[] = +"\n\tSkip reading the " STRINGIFY(BLENDER_STARTUP_FILE) " in the users home directory" +; +static int arg_handle_factory_startup_set(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + G.factory_startup = 1; + return 0; +} + +static const char arg_handle_env_system_set_doc_datafiles[] = +"\n\tSet the "STRINGIFY_ARG (BLENDER_SYSTEM_DATAFILES)" environment variable"; +static const char arg_handle_env_system_set_doc_scripts[] = +"\n\tSet the "STRINGIFY_ARG (BLENDER_SYSTEM_SCRIPTS)" environment variable"; +static const char arg_handle_env_system_set_doc_python[] = +"\n\tSet the "STRINGIFY_ARG (BLENDER_SYSTEM_PYTHON)" environment variable"; + +static int arg_handle_env_system_set(int argc, const char **argv, void *UNUSED(data)) +{ + /* "--env-system-scripts" --> "BLENDER_SYSTEM_SCRIPTS" */ + + char env[64] = "BLENDER"; + char *ch_dst = env + 7; /* skip BLENDER */ + const char *ch_src = argv[0] + 5; /* skip --env */ + + if (argc < 2) { + printf("%s requires one argument\n", argv[0]); + exit(1); + } + + for (; *ch_src; ch_src++, ch_dst++) { + *ch_dst = (*ch_src == '-') ? '_' : (*ch_src) - 32; /* toupper() */ + } + + *ch_dst = '\0'; + BLI_setenv(env, argv[1]); + return 1; +} + +static const char arg_handle_playback_mode_doc[] = +" \n" +"\tPlayback , only operates this way when not running in background.\n" +"\t\t-p \tOpen with lower left corner at , \n" +"\t\t-m\t\tRead from disk (Don't buffer)\n" +"\t\t-f \t\tSpecify FPS to start with\n" +"\t\t-j \tSet frame step to \n" +"\t\t-s \tPlay from \n" +"\t\t-e \tPlay until " +; +static int arg_handle_playback_mode(int argc, const char **argv, void *UNUSED(data)) +{ + /* not if -b was given first */ + if (G.background == 0) { +#ifdef WITH_FFMPEG + /* Setup FFmpeg with current debug flags. */ + IMB_ffmpeg_init(); +#endif + + WM_main_playanim(argc, argv); /* not the same argc and argv as before */ + exit(0); /* 2.4x didn't do this */ + } + + return -2; +} + +static const char arg_handle_window_geometry_doc[] = +" \n" +"\tOpen with lower left corner at , and width and height as , " +; +static int arg_handle_window_geometry(int argc, const char **argv, void *UNUSED(data)) +{ + const char *arg_id = "-p / --window-geometry"; + int params[4], i; + + if (argc < 5) { + fprintf(stderr, "Error: requires four arguments '%s'\n", arg_id); + exit(1); + } + + for (i = 0; i < 4; i++) { + const char *err_msg = NULL; + if (!parse_int(argv[i + 1], ¶ms[i], &err_msg)) { + printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); + exit(1); + } + } + + WM_init_state_size_set(UNPACK4(params)); + + return 4; +} + +static const char arg_handle_native_pixels_set_doc[] = +"\n\tDo not use native pixel size, for high resolution displays (MacBook 'Retina')" +; +static int arg_handle_native_pixels_set(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + WM_init_native_pixels(false); + return 0; +} + +static const char arg_handle_with_borders_doc[] = +"\n\tForce opening without borders" +; +static int arg_handle_with_borders(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + WM_init_state_normal_set(); + return 0; +} + +static const char arg_handle_without_borders_doc[] = +"\n\tForce opening without borders" +; +static int arg_handle_without_borders(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + WM_init_state_fullscreen_set(); + return 0; +} + +extern bool wm_start_with_console; /* wm_init_exit.c */ + +static const char arg_handle_start_with_console_doc[] = +"\n\tStart with the console window open (ignored if -b is set), (Windows only)" +; +static int arg_handle_start_with_console(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + wm_start_with_console = true; + return 0; +} + +static const char arg_handle_register_extension_doc[] = +"\n\tRegister .blend extension, then exit (Windows only)" +; +static const char arg_handle_register_extension_doc_silent[] = +"\n\tSilently register .blend extension, then exit (Windows only)" +; +static int arg_handle_register_extension(int UNUSED(argc), const char **UNUSED(argv), void *data) +{ +#ifdef WIN32 + if (data) + G.background = 1; + RegisterBlendExtension(); +#else + (void)data; /* unused */ +#endif + return 0; +} + +static const char arg_handle_joystick_disable_doc[] = +"\n\tDisable joystick support" +; +static int arg_handle_joystick_disable(int UNUSED(argc), const char **UNUSED(argv), void *data) +{ +#ifndef WITH_GAMEENGINE + (void)data; +#else + SYS_SystemHandle *syshandle = data; + + /** + * don't initialize joysticks if user doesn't want to use joysticks + * failed joystick initialization delays over 5 seconds, before game engine start + */ + SYS_WriteCommandLineInt(*syshandle, "nojoystick", 1); + if (G.debug & G_DEBUG) printf("disabling nojoystick\n"); +#endif + + return 0; +} + +static const char arg_handle_glsl_disable_doc[] = +"\n\tDisable GLSL shading" +; +static int arg_handle_glsl_disable(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + GPU_extensions_disable(); + return 0; +} + +static const char arg_handle_audio_disable_doc[] = +"\n\tForce sound system to None" +; +static int arg_handle_audio_disable(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + BKE_sound_force_device("Null"); + return 0; +} + +static const char arg_handle_audio_set_doc[] = +"\n\tForce sound system to a specific device\n\tNULL SDL OPENAL JACK" +; +static int arg_handle_audio_set(int argc, const char **argv, void *UNUSED(data)) +{ + if (argc < 1) { + fprintf(stderr, "-setaudio require one argument\n"); + exit(1); + } + + BKE_sound_force_device(argv[1]); + return 1; +} + +static const char arg_handle_output_set_doc[] = +"\n" +"\tSet the render path and file name.\n" +"\tUse '//' at the start of the path to render relative to the blend file.\n" +"\n" +"\tThe '#' characters are replaced by the frame number, and used to define zero padding.\n" +"\t* 'ani_##_test.png' becomes 'ani_01_test.png'\n" +"\t* 'test-######.png' becomes 'test-000001.png'\n" +"\n" +"\tWhen the filename does not contain '#', The suffix '####' is added to the filename.\n" +"\n" +"\tThe frame number will be added at the end of the filename, eg:\n" +"\t# blender -b foobar.blend -o //render_ -F PNG -x 1 -a\n" +"\t'//render_' becomes '//render_####', writing frames as '//render_0001.png'" +; +static int arg_handle_output_set(int argc, const char **argv, void *data) +{ + bContext *C = data; + if (argc > 1) { + Scene *scene = CTX_data_scene(C); + if (scene) { + BLI_strncpy(scene->r.pic, argv[1], sizeof(scene->r.pic)); + } + else { + printf("\nError: no blend loaded. cannot use '-o / --render-output'.\n"); + } + return 1; + } + else { + printf("\nError: you must specify a path after '-o / --render-output'.\n"); + return 0; + } +} + +static const char arg_handle_engine_set_doc[] = +"\n" +"\tSpecify the render engine\n\tuse -E help to list available engines" +; +static int arg_handle_engine_set(int argc, const char **argv, void *data) +{ + bContext *C = data; + if (argc >= 2) { + if (STREQ(argv[1], "help")) { + RenderEngineType *type = NULL; + printf("Blender Engine Listing:\n"); + for (type = R_engines.first; type; type = type->next) { + printf("\t%s\n", type->idname); + } + exit(0); + } + else { + Scene *scene = CTX_data_scene(C); + if (scene) { + RenderData *rd = &scene->r; + + if (BLI_findstring(&R_engines, argv[1], offsetof(RenderEngineType, idname))) { + BLI_strncpy_utf8(rd->engine, argv[1], sizeof(rd->engine)); + } + else { + printf("\nError: engine not found '%s'\n", argv[1]); + exit(1); + } + } + else { + printf("\nError: no blend loaded. order the arguments so '-E / --engine ' is after a blend is loaded.\n"); + } + } + + return 1; + } + else { + printf("\nEngine not specified, give 'help' for a list of available engines.\n"); + return 0; + } +} + +static const char arg_handle_image_type_set_doc[] = +"\n" +"\tSet the render format, Valid options are...\n" +"\t\tTGA IRIS JPEG MOVIE IRIZ RAWTGA\n" +"\t\tAVIRAW AVIJPEG PNG BMP FRAMESERVER\n" +"\t(formats that can be compiled into blender, not available on all systems)\n" +"\t\tHDR TIFF EXR MULTILAYER MPEG AVICODEC QUICKTIME CINEON DPX DDS" +; +static int arg_handle_image_type_set(int argc, const char **argv, void *data) +{ + bContext *C = data; + if (argc > 1) { + const char *imtype = argv[1]; + Scene *scene = CTX_data_scene(C); + if (scene) { + const char imtype_new = BKE_imtype_from_arg(imtype); + + if (imtype_new == R_IMF_IMTYPE_INVALID) { + printf("\nError: Format from '-F / --render-format' not known or not compiled in this release.\n"); + } + else { + scene->r.im_format.imtype = imtype_new; + } + } + else { + printf("\nError: no blend loaded. order the arguments so '-F / --render-format' is after the blend is loaded.\n"); + } + return 1; + } + else { + printf("\nError: you must specify a format after '-F / --render-foramt'.\n"); + return 0; + } +} + +static const char arg_handle_threads_set_doc[] = +"\n" +"\tUse amount of for rendering and other operations\n" +"\t[1-" STRINGIFY(BLENDER_MAX_THREADS) "], 0 for systems processor count." +; +static int arg_handle_threads_set(int argc, const char **argv, void *UNUSED(data)) +{ + const char *arg_id = "-t / --threads"; + const int min = 0, max = BLENDER_MAX_THREADS; + if (argc > 1) { + const char *err_msg = NULL; + int threads; + if (!parse_int_strict_range(argv[1], min, max, &threads, &err_msg)) { + printf("\nError: %s '%s %s', expected number in [%d..%d].\n", err_msg, arg_id, argv[1], min, max); + return 1; + } + + BLI_system_num_threads_override_set(threads); + return 1; + } + else { + printf("\nError: you must specify a number of threads in [%d..%d] '%s'.\n", min, max, arg_id); + return 0; + } +} + +static const char arg_handle_depsgraph_use_new_doc[] = +"\n\tUse new dependency graph" +; +static int arg_handle_depsgraph_use_new(int UNUSED(argc), const char **UNUSED(argv), void *UNUSED(data)) +{ + printf("Using new dependency graph.\n"); + DEG_depsgraph_switch_to_new(); + return 0; +} + +static const char arg_handle_verbosity_set_doc[] = +"\n\tSet logging verbosity level." +; +static int arg_handle_verbosity_set(int argc, const char **argv, void *UNUSED(data)) +{ + const char *arg_id = "--verbose"; + if (argc > 1) { + const char *err_msg = NULL; + int level; + if (!parse_int(argv[1], &level, &err_msg)) { + printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); + } + +#ifdef WITH_LIBMV + libmv_setLoggingVerbosity(level); +#elif defined(WITH_CYCLES_LOGGING) + CCL_logging_verbosity_set(level); +#else + (void)level; +#endif + + return 1; + } + else { + printf("\nError: you must specify a verbosity level.\n"); + return 0; + } +} + +static const char arg_handle_extension_set_doc[] = +"\n" +"\tSet option to add the file extension to the end of the file" +; +static int arg_handle_extension_set(int argc, const char **argv, void *data) +{ + bContext *C = data; + if (argc > 1) { + Scene *scene = CTX_data_scene(C); + if (scene) { + if (argv[1][0] == '0') { + scene->r.scemode &= ~R_EXTENSION; + } + else if (argv[1][0] == '1') { + scene->r.scemode |= R_EXTENSION; + } + else { + printf("\nError: Use '-x 1 / -x 0' To set the extension option or '--use-extension'\n"); + } + } + else { + printf("\nError: no blend loaded. order the arguments so '-o ' is after '-x '.\n"); + } + return 1; + } + else { + printf("\nError: you must specify a path after '- '.\n"); + return 0; + } +} + +static const char arg_handle_ge_parameters_set_doc[] = +"Game Engine specific options\n" +"\t-g fixedtime\t\tRun on 50 hertz without dropping frames\n" +"\t-g vertexarrays\t\tUse Vertex Arrays for rendering (usually faster)\n" +"\t-g nomipmap\t\tNo Texture Mipmapping\n" +"\t-g linearmipmap\t\tLinear Texture Mipmapping instead of Nearest (default)" +; +static int arg_handle_ge_parameters_set(int argc, const char **argv, void *data) +{ + int a = 0; +#ifdef WITH_GAMEENGINE + SYS_SystemHandle syshandle = *(SYS_SystemHandle *)data; +#else + (void)data; +#endif + + /** + * gameengine parameters are automatically put into system + * -g [paramname = value] + * -g [boolparamname] + * example: + * -g novertexarrays + * -g maxvertexarraysize = 512 + */ + + if (argc >= 1) { + const char *paramname = argv[a]; + /* check for single value versus assignment */ + if (a + 1 < argc && (*(argv[a + 1]) == '=')) { + a++; + if (a + 1 < argc) { + a++; + /* assignment */ +#ifdef WITH_GAMEENGINE + SYS_WriteCommandLineString(syshandle, paramname, argv[a]); +#endif + } + else { + printf("error: argument assignment (%s) without value.\n", paramname); + return 0; + } + /* name arg eaten */ + + } + else { +#ifdef WITH_GAMEENGINE + SYS_WriteCommandLineInt(syshandle, argv[a], 1); +#endif + /* doMipMap */ + if (STREQ(argv[a], "nomipmap")) { + GPU_set_mipmap(0); //doMipMap = 0; + } + /* linearMipMap */ + if (STREQ(argv[a], "linearmipmap")) { + GPU_set_mipmap(1); + GPU_set_linear_mipmap(1); //linearMipMap = 1; + } + + + } /* if (*(argv[a + 1]) == '=') */ + } + + return a; +} + +static const char arg_handle_render_frame_doc[] = +"\n\tRender frame and save it.\n\t+ start frame relative, - end frame relative." +; +static int arg_handle_render_frame(int argc, const char **argv, void *data) +{ + const char *arg_id = "-f / --render-frame"; + bContext *C = data; + Scene *scene = CTX_data_scene(C); + if (scene) { + Main *bmain = CTX_data_main(C); + + if (argc > 1) { + const char *err_msg = NULL; + Render *re; + int frame; + ReportList reports; + + if (!parse_int_relative_clamp( + argv[1], scene->r.sfra, scene->r.efra, MINAFRAME, MAXFRAME, + &frame, &err_msg)) + { + printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); + return 1; + } + + re = RE_NewRender(scene->id.name); + BLI_begin_threaded_malloc(); + BKE_reports_init(&reports, RPT_PRINT); + + RE_SetReports(re, &reports); + RE_BlenderAnim(re, bmain, scene, NULL, scene->lay, frame, frame, scene->r.frame_step); + RE_SetReports(re, NULL); + BLI_end_threaded_malloc(); + return 1; + } + else { + printf("\nError: frame number must follow '%s'.\n", arg_id); + return 0; + } + } + else { + printf("\nError: no blend loaded. cannot use '%s'.\n", arg_id); + return 0; + } +} + +static const char arg_handle_render_animation_doc[] = +"\n\tRender frames from start to end (inclusive)" +; +static int arg_handle_render_animation(int UNUSED(argc), const char **UNUSED(argv), void *data) +{ + bContext *C = data; + Scene *scene = CTX_data_scene(C); + if (scene) { + Main *bmain = CTX_data_main(C); + Render *re = RE_NewRender(scene->id.name); + ReportList reports; + BLI_begin_threaded_malloc(); + BKE_reports_init(&reports, RPT_PRINT); + RE_SetReports(re, &reports); + RE_BlenderAnim(re, bmain, scene, NULL, scene->lay, scene->r.sfra, scene->r.efra, scene->r.frame_step); + RE_SetReports(re, NULL); + BLI_end_threaded_malloc(); + } + else { + printf("\nError: no blend loaded. cannot use '-a'.\n"); + } + return 0; +} + +static const char arg_handle_scene_set_doc[] = +"\n" +"\tSet the active scene for rendering" +; +static int arg_handle_scene_set(int argc, const char **argv, void *data) +{ + if (argc > 1) { + bContext *C = data; + Scene *scene = BKE_scene_set_name(CTX_data_main(C), argv[1]); + if (scene) { + CTX_data_scene_set(C, scene); + } + return 1; + } + else { + printf("\nError: Scene name must follow '-S / --scene'.\n"); + return 0; + } +} + +static const char arg_handle_frame_start_set_doc[] = +"\n\tSet start to frame , supports +/- for relative frames too." +; +static int arg_handle_frame_start_set(int argc, const char **argv, void *data) +{ + const char *arg_id = "-s / --frame-start"; + bContext *C = data; + Scene *scene = CTX_data_scene(C); + if (scene) { + if (argc > 1) { + const char *err_msg = NULL; + if (!parse_int_relative_clamp( + argv[1], scene->r.sfra, scene->r.sfra - 1, MINAFRAME, MAXFRAME, + &scene->r.sfra, &err_msg)) + { + printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); + } + return 1; + } + else { + printf("\nError: frame number must follow '%s'.\n", arg_id); + return 0; + } + } + else { + printf("\nError: no blend loaded. cannot use '%s'.\n", arg_id); + return 0; + } +} + +static const char arg_handle_frame_end_set_doc[] = +"\n" +"\tSet end to frame , supports +/- for relative frames too." +; +static int arg_handle_frame_end_set(int argc, const char **argv, void *data) +{ + const char *arg_id = "-e / --frame-end"; + bContext *C = data; + Scene *scene = CTX_data_scene(C); + if (scene) { + if (argc > 1) { + const char *err_msg = NULL; + if (!parse_int_relative_clamp( + argv[1], scene->r.efra, scene->r.efra - 1, MINAFRAME, MAXFRAME, + &scene->r.efra, &err_msg)) + { + printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); + } + return 1; + } + else { + printf("\nError: frame number must follow '%s'.\n", arg_id); + return 0; + } + } + else { + printf("\nError: no blend loaded. cannot use '%s'.\n", arg_id); + return 0; + } +} + +static const char arg_handle_frame_skip_set_doc[] = +"\n\tSet number of frames to step forward after each rendered frame" +; +static int arg_handle_frame_skip_set(int argc, const char **argv, void *data) +{ + const char *arg_id = "-j / --frame-jump"; + bContext *C = data; + Scene *scene = CTX_data_scene(C); + if (scene) { + if (argc > 1) { + const char *err_msg = NULL; + if (!parse_int_clamp(argv[1], 1, MAXFRAME, &scene->r.frame_step, &err_msg)) { + printf("\nError: %s '%s %s'.\n", err_msg, arg_id, argv[1]); + } + return 1; + } + else { + printf("\nError: number of frames to step must follow '%s'.\n", arg_id); + return 0; + } + } + else { + printf("\nError: no blend loaded. cannot use '%s'.\n", arg_id); + return 0; + } +} + +static const char arg_handle_python_file_run_doc[] = +"\n" +"\tRun the given Python script file" +; +static int arg_handle_python_file_run(int argc, const char **argv, void *data) +{ +#ifdef WITH_PYTHON + bContext *C = data; + + /* workaround for scripts not getting a bpy.context.scene, causes internal errors elsewhere */ + if (argc > 1) { + /* Make the path absolute because its needed for relative linked blends to be found */ + char filename[FILE_MAX]; + BLI_strncpy(filename, argv[1], sizeof(filename)); + BLI_path_cwd(filename, sizeof(filename)); + + bool ok; + BPY_CTX_SETUP(ok = BPY_execute_filepath(C, filename, NULL)); + if (!ok && app_state.exit_code_on_error.python) { + printf("\nError: script failed, file: '%s', exiting.\n", argv[1]); + exit(app_state.exit_code_on_error.python); + } + return 1; + } + else { + printf("\nError: you must specify a filepath after '%s'.\n", argv[0]); + return 0; + } +#else + UNUSED_VARS(argc, argv, data); + printf("This blender was built without python support\n"); + return 0; +#endif /* WITH_PYTHON */ +} + +static const char arg_handle_python_text_run_doc[] = +"\n" +"\tRun the given Python script text block" +; +static int arg_handle_python_text_run(int argc, const char **argv, void *data) +{ +#ifdef WITH_PYTHON + bContext *C = data; + + /* workaround for scripts not getting a bpy.context.scene, causes internal errors elsewhere */ + if (argc > 1) { + /* Make the path absolute because its needed for relative linked blends to be found */ + struct Text *text = (struct Text *)BKE_libblock_find_name(ID_TXT, argv[1]); + bool ok; + + if (text) { + BPY_CTX_SETUP(ok = BPY_execute_text(C, text, NULL, false)); + } + else { + printf("\nError: text block not found %s.\n", argv[1]); + ok = false; + } + + if (!ok && app_state.exit_code_on_error.python) { + printf("\nError: script failed, text: '%s', exiting.\n", argv[1]); + exit(app_state.exit_code_on_error.python); + } + + return 1; + } + else { + printf("\nError: you must specify a text block after '%s'.\n", argv[0]); + return 0; + } +#else + UNUSED_VARS(argc, argv, data); + printf("This blender was built without python support\n"); + return 0; +#endif /* WITH_PYTHON */ +} + +static const char arg_handle_python_expr_run_doc[] = +"\n" +"\tRun the given expression as a Python script" +; +static int arg_handle_python_expr_run(int argc, const char **argv, void *data) +{ +#ifdef WITH_PYTHON + bContext *C = data; + + /* workaround for scripts not getting a bpy.context.scene, causes internal errors elsewhere */ + if (argc > 1) { + bool ok; + BPY_CTX_SETUP(ok = BPY_execute_string_ex(C, argv[1], false)); + if (!ok && app_state.exit_code_on_error.python) { + printf("\nError: script failed, expr: '%s', exiting.\n", argv[1]); + exit(app_state.exit_code_on_error.python); + } + return 1; + } + else { + printf("\nError: you must specify a Python expression after '%s'.\n", argv[0]); + return 0; + } +#else + UNUSED_VARS(argc, argv, data); + printf("This blender was built without python support\n"); + return 0; +#endif /* WITH_PYTHON */ +} + +static const char arg_handle_python_console_run_doc[] = +"\n\tRun blender with an interactive console" +; +static int arg_handle_python_console_run(int UNUSED(argc), const char **argv, void *data) +{ +#ifdef WITH_PYTHON + bContext *C = data; + + BPY_CTX_SETUP(BPY_execute_string(C, "__import__('code').interact()")); + + return 0; +#else + UNUSED_VARS(argv, data); + printf("This blender was built without python support\n"); + return 0; +#endif /* WITH_PYTHON */ +} + +static const char arg_handle_python_exit_code_set_doc[] = +"\n\tSet the exit-code in [0..255] to exit if a Python exception is raised\n" +"\t(only for scripts executed from the command line), zero disables." +; +static int arg_handle_python_exit_code_set(int argc, const char **argv, void *UNUSED(data)) +{ + const char *arg_id = "--python-exit-code"; + if (argc > 1) { + const char *err_msg = NULL; + const int min = 0, max = 255; + int exit_code; + if (!parse_int_strict_range(argv[1], min, max, &exit_code, &err_msg)) { + printf("\nError: %s '%s %s', expected number in [%d..%d].\n", err_msg, arg_id, argv[1], min, max); + return 1; + } + + app_state.exit_code_on_error.python = (unsigned char)exit_code; + return 1; + } + else { + printf("\nError: you must specify an exit code number '%s'.\n", arg_id); + return 0; + } +} + +static const char arg_handle_addons_set_doc[] = +"\n\tComma separated list of addons (no spaces)" +; +static int arg_handle_addons_set(int argc, const char **argv, void *data) +{ + /* workaround for scripts not getting a bpy.context.scene, causes internal errors elsewhere */ + if (argc > 1) { +#ifdef WITH_PYTHON + const char script_str[] = + "from addon_utils import check, enable\n" + "for m in '%s'.split(','):\n" + " if check(m)[1] is False:\n" + " enable(m, persistent=True)"; + const int slen = strlen(argv[1]) + (sizeof(script_str) - 2); + char *str = malloc(slen); + bContext *C = data; + BLI_snprintf(str, slen, script_str, argv[1]); + + BLI_assert(strlen(str) + 1 == slen); + BPY_CTX_SETUP(BPY_execute_string_ex(C, str, false)); + free(str); +#else + UNUSED_VARS(argv, data); +#endif /* WITH_PYTHON */ + return 1; + } + else { + printf("\nError: you must specify a comma separated list after '--addons'.\n"); + return 0; + } +} + +static int arg_handle_load_file(int UNUSED(argc), const char **argv, void *data) +{ + bContext *C = data; + ReportList reports; + bool success; + + /* Make the path absolute because its needed for relative linked blends to be found */ + char filename[FILE_MAX]; + + /* note, we could skip these, but so far we always tried to load these files */ + if (argv[0][0] == '-') { + fprintf(stderr, "unknown argument, loading as file: %s\n", argv[0]); + } + + BLI_strncpy(filename, argv[0], sizeof(filename)); + BLI_path_cwd(filename, sizeof(filename)); + + /* load the file */ + BKE_reports_init(&reports, RPT_PRINT); + WM_file_autoexec_init(filename); + success = WM_file_read(C, filename, &reports); + BKE_reports_clear(&reports); + + if (success) { + if (G.background) { + /* ensuer we use 'C->data.scene' for background render */ + CTX_wm_window_set(C, NULL); + } + } + else { + /* failed to load file, stop processing arguments if running in background mode */ + if (G.background) { + /* Set is_break if running in the background mode so + * blender will return non-zero exit code which then + * could be used in automated script to control how + * good or bad things are. + */ + G.is_break = true; + return -1; + } + + /* Just pretend a file was loaded, so the user can press Save and it'll save at the filename from the CLI. */ + BLI_strncpy(G.main->name, filename, FILE_MAX); + G.relbase_valid = true; + G.save_over = true; + printf("... opened default scene instead; saving will write to %s\n", filename); + } + + G.file_loaded = 1; + + return 0; +} + + +void main_args_setup(bContext *C, bArgs *ba, SYS_SystemHandle *syshandle) +{ + +#define CB(a) a##_doc, a +#define CB_EX(a, b) a##_doc_##b, a + + //BLI_argsAdd(ba, pass, short_arg, long_arg, doc, cb, C); + + /* end argument processing after -- */ + BLI_argsAdd(ba, -1, "--", NULL, arg_handle_arguments_end_doc, arg_handle_arguments_end, NULL); + + /* first pass: background mode, disable python and commands that exit after usage */ + BLI_argsAdd(ba, 1, "-h", "--help", CB(arg_handle_print_help), ba); + /* Windows only */ + BLI_argsAdd(ba, 1, "/?", NULL, CB_EX(arg_handle_print_help, win32), ba); + + BLI_argsAdd(ba, 1, "-v", "--version", CB(arg_handle_print_version), NULL); + + BLI_argsAdd(ba, 1, "-y", "--enable-autoexec", CB_EX(arg_handle_python_set, enable), (void *)true); + BLI_argsAdd(ba, 1, "-Y", "--disable-autoexec", CB_EX(arg_handle_python_set, disable), (void *)false); + + BLI_argsAdd(ba, 1, NULL, "--disable-crash-handler", CB(arg_handle_crash_handler_disable), NULL); + BLI_argsAdd(ba, 1, NULL, "--disable-abort-handler", CB(arg_handle_abort_handler_disable), NULL); + + BLI_argsAdd(ba, 1, "-b", "--background", CB(arg_handle_background_mode_set), NULL); + + BLI_argsAdd(ba, 1, "-a", NULL, CB(arg_handle_playback_mode), NULL); + + BLI_argsAdd(ba, 1, "-d", "--debug", CB(arg_handle_debug_mode_set), ba); + +#ifdef WITH_FFMPEG + BLI_argsAdd(ba, 1, NULL, "--debug-ffmpeg", + CB_EX(arg_handle_debug_mode_generic_set, ffmpeg), (void *)G_DEBUG_FFMPEG); +#endif + +#ifdef WITH_FREESTYLE + BLI_argsAdd(ba, 1, NULL, "--debug-freestyle", + CB_EX(arg_handle_debug_mode_generic_set, freestyle), (void *)G_DEBUG_FREESTYLE); +#endif + + BLI_argsAdd(ba, 1, NULL, "--debug-python", + CB_EX(arg_handle_debug_mode_generic_set, python), (void *)G_DEBUG_PYTHON); + BLI_argsAdd(ba, 1, NULL, "--debug-events", + CB_EX(arg_handle_debug_mode_generic_set, events), (void *)G_DEBUG_EVENTS); + BLI_argsAdd(ba, 1, NULL, "--debug-handlers", + CB_EX(arg_handle_debug_mode_generic_set, handlers), (void *)G_DEBUG_HANDLERS); + BLI_argsAdd(ba, 1, NULL, "--debug-wm", + CB_EX(arg_handle_debug_mode_generic_set, wm), (void *)G_DEBUG_WM); + BLI_argsAdd(ba, 1, NULL, "--debug-all", + CB_EX(arg_handle_debug_mode_generic_set, all), (void *)G_DEBUG_ALL); + + BLI_argsAdd(ba, 1, NULL, "--debug-fpe", + CB(arg_handle_debug_fpe_set), NULL); + +#ifdef WITH_LIBMV + BLI_argsAdd(ba, 1, NULL, "--debug-libmv", CB(arg_handle_debug_mode_libmv), NULL); +#endif +#ifdef WITH_CYCLES_LOGGING + BLI_argsAdd(ba, 1, NULL, "--debug-cycles", CB(arg_handle_debug_mode_cycles), NULL); +#endif + BLI_argsAdd(ba, 1, NULL, "--debug-memory", CB(arg_handle_debug_mode_memory_set), NULL); + + BLI_argsAdd(ba, 1, NULL, "--debug-value", + CB(arg_handle_debug_value_set), NULL); + BLI_argsAdd(ba, 1, NULL, "--debug-jobs", + CB_EX(arg_handle_debug_mode_generic_set, jobs), (void *)G_DEBUG_JOBS); + BLI_argsAdd(ba, 1, NULL, "--debug-gpu", + CB_EX(arg_handle_debug_mode_generic_set, gpu), (void *)G_DEBUG_GPU); + BLI_argsAdd(ba, 1, NULL, "--debug-depsgraph", + CB_EX(arg_handle_debug_mode_generic_set, depsgraph), (void *)G_DEBUG_DEPSGRAPH); + BLI_argsAdd(ba, 1, NULL, "--debug-depsgraph-no-threads", + CB_EX(arg_handle_debug_mode_generic_set, depsgraph_no_threads), (void *)G_DEBUG_DEPSGRAPH_NO_THREADS); + BLI_argsAdd(ba, 1, NULL, "--debug-gpumem", + CB_EX(arg_handle_debug_mode_generic_set, gpumem), (void *)G_DEBUG_GPU_MEM); + + BLI_argsAdd(ba, 1, NULL, "--enable-new-depsgraph", CB(arg_handle_depsgraph_use_new), NULL); + + BLI_argsAdd(ba, 1, NULL, "--verbose", CB(arg_handle_verbosity_set), NULL); + + BLI_argsAdd(ba, 1, NULL, "--factory-startup", CB(arg_handle_factory_startup_set), NULL); + + /* TODO, add user env vars? */ + BLI_argsAdd(ba, 1, NULL, "--env-system-datafiles", CB_EX(arg_handle_env_system_set, datafiles), NULL); + BLI_argsAdd(ba, 1, NULL, "--env-system-scripts", CB_EX(arg_handle_env_system_set, scripts), NULL); + BLI_argsAdd(ba, 1, NULL, "--env-system-python", CB_EX(arg_handle_env_system_set, python), NULL); + + /* second pass: custom window stuff */ + BLI_argsAdd(ba, 2, "-p", "--window-geometry", CB(arg_handle_window_geometry), NULL); + BLI_argsAdd(ba, 2, "-w", "--window-border", CB(arg_handle_with_borders), NULL); + BLI_argsAdd(ba, 2, "-W", "--window-borderless", CB(arg_handle_without_borders), NULL); + BLI_argsAdd(ba, 2, "-con", "--start-console", CB(arg_handle_start_with_console), NULL); + BLI_argsAdd(ba, 2, "-R", NULL, CB(arg_handle_register_extension), NULL); + BLI_argsAdd(ba, 2, "-r", NULL, CB_EX(arg_handle_register_extension, silent), ba); + BLI_argsAdd(ba, 2, NULL, "--no-native-pixels", CB(arg_handle_native_pixels_set), ba); + + /* third pass: disabling things and forcing settings */ + BLI_argsAddCase(ba, 3, "-nojoystick", 1, NULL, 0, CB(arg_handle_joystick_disable), syshandle); + BLI_argsAddCase(ba, 3, "-noglsl", 1, NULL, 0, CB(arg_handle_glsl_disable), NULL); + BLI_argsAddCase(ba, 3, "-noaudio", 1, NULL, 0, CB(arg_handle_audio_disable), NULL); + BLI_argsAddCase(ba, 3, "-setaudio", 1, NULL, 0, CB(arg_handle_audio_set), NULL); + + /* fourth pass: processing arguments */ + BLI_argsAdd(ba, 4, "-g", NULL, CB(arg_handle_ge_parameters_set), syshandle); + BLI_argsAdd(ba, 4, "-f", "--render-frame", CB(arg_handle_render_frame), C); + BLI_argsAdd(ba, 4, "-a", "--render-anim", CB(arg_handle_render_animation), C); + BLI_argsAdd(ba, 4, "-S", "--scene", CB(arg_handle_scene_set), C); + BLI_argsAdd(ba, 4, "-s", "--frame-start", CB(arg_handle_frame_start_set), C); + BLI_argsAdd(ba, 4, "-e", "--frame-end", CB(arg_handle_frame_end_set), C); + BLI_argsAdd(ba, 4, "-j", "--frame-jump", CB(arg_handle_frame_skip_set), C); + BLI_argsAdd(ba, 4, "-P", "--python", CB(arg_handle_python_file_run), C); + BLI_argsAdd(ba, 4, NULL, "--python-text", CB(arg_handle_python_text_run), C); + BLI_argsAdd(ba, 4, NULL, "--python-expr", CB(arg_handle_python_expr_run), C); + BLI_argsAdd(ba, 4, NULL, "--python-console", CB(arg_handle_python_console_run), C); + BLI_argsAdd(ba, 4, NULL, "--python-exit-code", CB(arg_handle_python_exit_code_set), NULL); + BLI_argsAdd(ba, 4, NULL, "--addons", CB(arg_handle_addons_set), C); + + BLI_argsAdd(ba, 4, "-o", "--render-output", CB(arg_handle_output_set), C); + BLI_argsAdd(ba, 4, "-E", "--engine", CB(arg_handle_engine_set), C); + + BLI_argsAdd(ba, 4, "-F", "--render-format", CB(arg_handle_image_type_set), C); + BLI_argsAdd(ba, 4, "-t", "--threads", CB(arg_handle_threads_set), NULL); + BLI_argsAdd(ba, 4, "-x", "--use-extension", CB(arg_handle_extension_set), C); + +#undef CB +#undef CB_EX + +} + +/** + * Needs to be added separately. + */ +void main_args_setup_post(bContext *C, bArgs *ba) +{ + BLI_argsParse(ba, 4, arg_handle_load_file, C); +} + +/** \} */ + +#endif /* WITH_PYTHON_MODULE */ diff --git a/source/creator/creator_intern.h b/source/creator/creator_intern.h new file mode 100644 index 00000000000..a972a926677 --- /dev/null +++ b/source/creator/creator_intern.h @@ -0,0 +1,95 @@ +/* + * ***** BEGIN GPL LICENSE BLOCK ***** + * + * This program 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. + * + * This program 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 this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + * + * ***** END GPL LICENSE BLOCK ***** + */ + +#ifndef __CREATOR_INTERN_H__ +#define __CREATOR_INTERN_H__ + +/** \file creator/creator_intern.h + * \ingroup creator + * + * Functionality for main() initialization. + */ + +struct bArgs; +struct bContext; + +#ifndef WITH_PYTHON_MODULE + +/* creator_args.c */ +void main_args_setup(struct bContext *C, struct bArgs *ba, SYS_SystemHandle *syshandle); +void main_args_setup_post(struct bContext *C, struct bArgs *ba); + + +/* creator_signals.c */ +void main_signal_setup(void); +void main_signal_setup_background(void); +void main_signal_setup_fpe(void); + +#endif /* WITH_PYTHON_MODULE */ + + +/* Shared data for argument handlers to store state in */ +struct ApplicationState { + struct { + bool use_crash_handler; + bool use_abort_handler; + } signal; + + /* we may want to set different exit codes for other kinds of errors */ + struct { + unsigned char python; + } exit_code_on_error; + +}; +extern struct ApplicationState app_state; /* creator.c */ + +/* for the callbacks: */ +#ifndef WITH_PYTHON_MODULE +#define BLEND_VERSION_FMT "Blender %d.%02d (sub %d)" +#define BLEND_VERSION_ARG BLENDER_VERSION / 100, BLENDER_VERSION % 100, BLENDER_SUBVERSION +/* pass directly to printf */ +#define BLEND_VERSION_STRING_FMT BLEND_VERSION_FMT "\n", BLEND_VERSION_ARG +#endif + +#ifdef WITH_BUILDINFO_HEADER +# define BUILD_DATE +#endif + +/* from buildinfo.c */ +#ifdef BUILD_DATE + extern char build_date[]; +extern char build_time[]; +extern char build_hash[]; +extern unsigned long build_commit_timestamp; + +/* TODO(sergey): ideally size need to be in sync with buildinfo.c */ +extern char build_commit_date[16]; +extern char build_commit_time[16]; + +extern char build_branch[]; +extern char build_platform[]; +extern char build_type[]; +extern char build_cflags[]; +extern char build_cxxflags[]; +extern char build_linkflags[]; +extern char build_system[]; +#endif + +#endif /* __CREATOR_INTERN_H__ */ diff --git a/source/creator/creator_signals.c b/source/creator/creator_signals.c new file mode 100644 index 00000000000..b25d7c56f6e --- /dev/null +++ b/source/creator/creator_signals.c @@ -0,0 +1,328 @@ +/* + * ***** BEGIN GPL LICENSE BLOCK ***** + * + * This program 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. + * + * This program 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 this program; if not, write to the Free Software Foundation, + * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + * + * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file creator/creator_signals.c + * \ingroup creator + */ + +#ifndef WITH_PYTHON_MODULE + +#if defined(__linux__) && defined(__GNUC__) +# define _GNU_SOURCE +# include +#endif + +#if (defined(__APPLE__) && (defined(__i386__) || defined(__x86_64__))) +# define OSX_SSE_FPE +# include +#endif + +#ifdef WIN32 +# if defined(_MSC_VER) && defined(_M_X64) +# include /* needed for _set_FMA3_enable */ +# endif +# include +# include +#endif + +#include +#include +#include + +#include "BLI_sys_types.h" + +#ifdef WIN32 +# include "BLI_winstuff.h" +#endif +#include "BLI_utildefines.h" +#include "BLI_string.h" +#include "BLI_path_util.h" +#include "BLI_fileops.h" +#include "BLI_system.h" +#include BLI_SYSTEM_PID_H + +#include "BKE_appdir.h" /* BKE_tempdir_base */ +#include "BKE_blender.h" +#include "BKE_global.h" +#include "BKE_main.h" +#include "BKE_report.h" + +/* for passing information between creator and gameengine */ +#ifdef WITH_GAMEENGINE +# include "BL_System.h" +#else /* dummy */ +# define SYS_SystemHandle int +#endif + +#include + +#include "creator_intern.h" /* own include */ + +/* set breakpoints here when running in debug mode, useful to catch floating point errors */ +#if defined(__linux__) || defined(_WIN32) || defined(OSX_SSE_FPE) +static void sig_handle_fpe(int UNUSED(sig)) +{ + fprintf(stderr, "debug: SIGFPE trapped\n"); +} +#endif + +/* handling ctrl-c event in console */ +#if !defined(WITH_HEADLESS) +static void sig_handle_blender_esc(int sig) +{ + static int count = 0; + + G.is_break = true; /* forces render loop to read queue, not sure if its needed */ + + if (sig == 2) { + if (count) { + printf("\nBlender killed\n"); + exit(2); + } + printf("\nSent an internal break event. Press ^C again to kill Blender\n"); + count++; + } +} +#endif + +static void sig_handle_crash_backtrace(FILE *fp) +{ + fputs("\n# backtrace\n", fp); + BLI_system_backtrace(fp); +} + +static void sig_handle_crash(int signum) +{ + +#if 0 + { + char fname[FILE_MAX]; + + if (!G.main->name[0]) { + BLI_make_file_string("/", fname, BKE_tempdir_base(), "crash.blend"); + } + else { + BLI_strncpy(fname, G.main->name, sizeof(fname)); + BLI_replace_extension(fname, sizeof(fname), ".crash.blend"); + } + + printf("Writing: %s\n", fname); + fflush(stdout); + + BKE_undo_save_file(fname); + } +#endif + + FILE *fp; + char header[512]; + wmWindowManager *wm = G.main->wm.first; + + char fname[FILE_MAX]; + + if (!G.main->name[0]) { + BLI_join_dirfile(fname, sizeof(fname), BKE_tempdir_base(), "blender.crash.txt"); + } + else { + BLI_join_dirfile(fname, sizeof(fname), BKE_tempdir_base(), BLI_path_basename(G.main->name)); + BLI_replace_extension(fname, sizeof(fname), ".crash.txt"); + } + + printf("Writing: %s\n", fname); + fflush(stdout); + +#ifndef BUILD_DATE + BLI_snprintf(header, sizeof(header), "# " BLEND_VERSION_FMT ", Unknown revision\n", BLEND_VERSION_ARG); +#else + BLI_snprintf(header, sizeof(header), "# " BLEND_VERSION_FMT ", Commit date: %s %s, Hash %s\n", + BLEND_VERSION_ARG, build_commit_date, build_commit_time, build_hash); +#endif + + /* open the crash log */ + errno = 0; + fp = BLI_fopen(fname, "wb"); + if (fp == NULL) { + fprintf(stderr, "Unable to save '%s': %s\n", + fname, errno ? strerror(errno) : "Unknown error opening file"); + } + else { + if (wm) { + BKE_report_write_file_fp(fp, &wm->reports, header); + } + + sig_handle_crash_backtrace(fp); + + fclose(fp); + } + + /* Delete content of temp dir! */ + BKE_tempdir_session_purge(); + + /* really crash */ + signal(signum, SIG_DFL); +#ifndef WIN32 + kill(getpid(), signum); +#else + TerminateProcess(GetCurrentProcess(), signum); +#endif +} + +#ifdef WIN32 +LONG WINAPI windows_exception_handler(EXCEPTION_POINTERS *ExceptionInfo) +{ + switch (ExceptionInfo->ExceptionRecord->ExceptionCode) { + case EXCEPTION_ACCESS_VIOLATION: + fputs("Error: EXCEPTION_ACCESS_VIOLATION\n", stderr); + break; + case EXCEPTION_ARRAY_BOUNDS_EXCEEDED: + fputs("Error: EXCEPTION_ARRAY_BOUNDS_EXCEEDED\n", stderr); + break; + case EXCEPTION_BREAKPOINT: + fputs("Error: EXCEPTION_BREAKPOINT\n", stderr); + break; + case EXCEPTION_DATATYPE_MISALIGNMENT: + fputs("Error: EXCEPTION_DATATYPE_MISALIGNMENT\n", stderr); + break; + case EXCEPTION_FLT_DENORMAL_OPERAND: + fputs("Error: EXCEPTION_FLT_DENORMAL_OPERAND\n", stderr); + break; + case EXCEPTION_FLT_DIVIDE_BY_ZERO: + fputs("Error: EXCEPTION_FLT_DIVIDE_BY_ZERO\n", stderr); + break; + case EXCEPTION_FLT_INEXACT_RESULT: + fputs("Error: EXCEPTION_FLT_INEXACT_RESULT\n", stderr); + break; + case EXCEPTION_FLT_INVALID_OPERATION: + fputs("Error: EXCEPTION_FLT_INVALID_OPERATION\n", stderr); + break; + case EXCEPTION_FLT_OVERFLOW: + fputs("Error: EXCEPTION_FLT_OVERFLOW\n", stderr); + break; + case EXCEPTION_FLT_STACK_CHECK: + fputs("Error: EXCEPTION_FLT_STACK_CHECK\n", stderr); + break; + case EXCEPTION_FLT_UNDERFLOW: + fputs("Error: EXCEPTION_FLT_UNDERFLOW\n", stderr); + break; + case EXCEPTION_ILLEGAL_INSTRUCTION: + fputs("Error: EXCEPTION_ILLEGAL_INSTRUCTION\n", stderr); + break; + case EXCEPTION_IN_PAGE_ERROR: + fputs("Error: EXCEPTION_IN_PAGE_ERROR\n", stderr); + break; + case EXCEPTION_INT_DIVIDE_BY_ZERO: + fputs("Error: EXCEPTION_INT_DIVIDE_BY_ZERO\n", stderr); + break; + case EXCEPTION_INT_OVERFLOW: + fputs("Error: EXCEPTION_INT_OVERFLOW\n", stderr); + break; + case EXCEPTION_INVALID_DISPOSITION: + fputs("Error: EXCEPTION_INVALID_DISPOSITION\n", stderr); + break; + case EXCEPTION_NONCONTINUABLE_EXCEPTION: + fputs("Error: EXCEPTION_NONCONTINUABLE_EXCEPTION\n", stderr); + break; + case EXCEPTION_PRIV_INSTRUCTION: + fputs("Error: EXCEPTION_PRIV_INSTRUCTION\n", stderr); + break; + case EXCEPTION_SINGLE_STEP: + fputs("Error: EXCEPTION_SINGLE_STEP\n", stderr); + break; + case EXCEPTION_STACK_OVERFLOW: + fputs("Error: EXCEPTION_STACK_OVERFLOW\n", stderr); + break; + default: + fputs("Error: Unrecognized Exception\n", stderr); + break; + } + + fflush(stderr); + + /* If this is a stack overflow then we can't walk the stack, so just show + * where the error happened */ + if (EXCEPTION_STACK_OVERFLOW != ExceptionInfo->ExceptionRecord->ExceptionCode) { +#ifdef NDEBUG + TerminateProcess(GetCurrentProcess(), SIGSEGV); +#else + sig_handle_crash(SIGSEGV); +#endif + } + + return EXCEPTION_EXECUTE_HANDLER; +} +#endif + +static void sig_handle_abort(int UNUSED(signum)) +{ + /* Delete content of temp dir! */ + BKE_tempdir_session_purge(); +} + + +void main_signal_setup(void) +{ + if (app_state.signal.use_crash_handler) { +#ifdef WIN32 + SetUnhandledExceptionFilter(windows_exception_handler); +#else + /* after parsing args */ + signal(SIGSEGV, sig_handle_crash); +#endif + } + + if (app_state.signal.use_abort_handler) { + signal(SIGABRT, sig_handle_abort); + } +} + +void main_signal_setup_background(void) +{ + /* for all platforms, even windos has it! */ + BLI_assert(G.background); + +#if !defined(WITH_HEADLESS) + signal(SIGINT, sig_handle_blender_esc); /* ctrl c out bg render */ +#endif +} + + +void main_signal_setup_fpe(void) +{ +#if defined(__linux__) || defined(_WIN32) || defined(OSX_SSE_FPE) + /* zealous but makes float issues a heck of a lot easier to find! + * set breakpoints on sig_handle_fpe */ + signal(SIGFPE, sig_handle_fpe); + +# if defined(__linux__) && defined(__GNUC__) + feenableexcept(FE_DIVBYZERO | FE_INVALID | FE_OVERFLOW); +# endif /* defined(__linux__) && defined(__GNUC__) */ +# if defined(OSX_SSE_FPE) + /* OSX uses SSE for floating point by default, so here + * use SSE instructions to throw floating point exceptions */ + _MM_SET_EXCEPTION_MASK(_MM_MASK_MASK & ~ + (_MM_MASK_OVERFLOW | _MM_MASK_INVALID | _MM_MASK_DIV_ZERO)); +# endif /* OSX_SSE_FPE */ +# if defined(_WIN32) && defined(_MSC_VER) + _controlfp_s(NULL, 0, _MCW_EM); /* enables all fp exceptions */ + _controlfp_s(NULL, _EM_DENORMAL | _EM_UNDERFLOW | _EM_INEXACT, _MCW_EM); /* hide the ones we don't care about */ +# endif /* _WIN32 && _MSC_VER */ +#endif +} + +#endif /* WITH_PYTHON_MODULE */ \ No newline at end of file -- cgit v1.2.3