Method setup

tests/crash_handler_win.h:657–684

    // --- Setup ---

    void setup() {
        const char* disable_handler = getenv("FASTLED_DISABLE_CRASH_HANDLER");
        if (disable_handler && (strcmp(disable_handler, "1") == 0 || strcmp(disable_handler, "true") == 0)) {
            printf("Crash handler disabled (FASTLED_DISABLE_CRASH_HANDLER set)\n");
            printf("This allows external debuggers to attach for deadlock detection.\n");
            return;
        }

        if (GetModuleHandleA("clang_rt.asan_dynamic-x86_64.dll") != NULL ||
            GetModuleHandleA("libclang_rt.asan_dynamic-x86_64.dll") != NULL) {
            printf("Crash handler disabled (AddressSanitizer detected)\n");
            return;
        }

        printf("Setting up Windows crash handler...\n");

        AddVectoredExceptionHandler(1, exception_handler_callback);
        SetUnhandledExceptionFilter(exception_handler_callback);

        signal(SIGABRT, signal_handler_callback);
        signal(SIGFPE, signal_handler_callback);
        signal(SIGILL, signal_handler_callback);
        signal(SIGINT, signal_handler_callback);
        signal(SIGSEGV, signal_handler_callback);
        signal(SIGTERM, signal_handler_callback);

        printf("Windows crash handler setup complete.\n");
    }
};

// --- Free-function API (delegates to singleton) ---