Headless Mode modified by Julien Mer

Julien Mer — Sun, 12 Apr 2026 00:55:55 -0000

Headless Mode (-r)

Running scripts from the command line (-r mode) without the IDE GUI now works reliably.

The Problem

java -jar oculixide-3.0.1-complete-win.jar -r script.py
# → UnsatisfiedLinkError: 'long org.opencv.core.Mat.n_Mat()'

In SikuliX and early OculiX, the -r mode crashed because:

OpenCV native library was never loaded (name mismatch + silent failure)
SikulixIDE.showAfterStart() was called even without a GUI
resetBeforeScriptStart() threw errors in non-IDE context

The Fixes

OpenCV Loading (PR [#12])

Problem	Fix
`Core.NATIVE_LIBRARY_NAME` returned `opencv_java454` but DLL is `opencv_java4100`	Updated `Core.java` to match Apertix 4.10.0
`loadOpenCV()` set `libOpenCVloaded = true` even on failure	Only `true` on success, with 3-stage fallback
Apertix `nu.pattern.OpenCV.loadLocally()` never called	Now the primary loading method

JythonRunner Guard

// Before: always called, crashed in -r mode
SikulixIDE.showAfterStart();

// After: only in IDE mode
if (!Commons.hasOption(RUN)) {
    SikulixIDE.showAfterStart();
}

JythonSupport Safety

# Before: crashed if resetBeforeScriptStart() unavailable
resetBeforeScriptStart()

# After: safe fallback
try:
  resetBeforeScriptStart()
except:
  pass

Startup Flow Comparison

IDE Mode (normal)

main() → initOptions → SikulixIDE.start()
  → ... IDE initialization ...
  → Finder2 static {} → Commons.loadOpenCV()  (lazy, on first find)

-r Mode (headless)

main() → initOptions → Commons.hasOption(RUN)
  → Commons.loadOpenCV()         ← explicit, early
  → Runner.runScripts(scripts)   ← execute and exit
  → RunTime.terminate(exitCode)

Usage

# Run a Jython script headless
java -jar oculixide-3.0.1-complete-win.jar -r path/to/script.py

# With arguments passed to the script
java -jar oculixide-3.0.1-complete-win.jar -r script.py -- arg1 arg2

Recent changes to Headless Mode

Headless Mode modified by Julien Mer

Headless Mode (-r)

The Problem

The Fixes

OpenCV Loading (PR [#12])

JythonRunner Guard

JythonSupport Safety

Startup Flow Comparison

IDE Mode (normal)

-r Mode (headless)

Usage