Recent changes to OpenCV Migrationhttps://sourceforge.net/p/oculix/wiki/OpenCV%2520Migration/Recent changes to OpenCV MigrationenSun, 12 Apr 2026 00:55:56 -0000OpenCV Migration modified by Julien Merhttps://sourceforge.net/p/oculix/wiki/OpenCV%2520Migration/<div class="markdown_content"><h1 id="h-opencv-migration-openpnp-to-apertix">OpenCV Migration: openpnp to Apertix</h1> <p><img alt="Upgrade" rel="nofollow" src="https://img.shields.io/badge/type-upgrade-blue?style=for-the-badge"/><br/> <img alt="OpenCV 4.10.0" rel="nofollow" src="https://img.shields.io/badge/OpenCV-4.10.0-green?style=for-the-badge&amp;logo=opencv"/></p> <blockquote> <p>OculiX migrated from openpnp/opencv 4.5.4 (JNI) to Apertix 4.10.0-0 (JNA).</p> </blockquote> <hr/> <h2 id="h-why-migrate">Why Migrate</h2> <table> <thead> <tr> <th>Issue with openpnp 4.5.4</th> <th>Resolution with Apertix 4.10.0</th> </tr> </thead> <tbody> <tr> <td>OpenCV 4.5.4 is outdated (2021)</td> <td>OpenCV 4.10.0 (2024)</td> </tr> <tr> <td>JNI-based native loading (fragile)</td> <td>JNA-based (robust, cross-platform)</td> </tr> <tr> <td><code>System.loadLibrary</code> conflicts</td> <td><code>nu.pattern.OpenCV.loadLocally()</code></td> </tr> <tr> <td>No Apple Silicon support</td> <td>Apple Silicon via JNA</td> </tr> </tbody> </table> <h2 id="h-what-is-apertix">What is Apertix</h2> <p><a href="https://github.com/julienmerconsulting/Apertix" rel="nofollow">Apertix</a> is a custom fork of openpnp/opencv by the OculiX maintainer:</p> <ul> <li>OpenCV 4.10.0 with JNA migration</li> <li>Packaging under <code>nu.pattern.OpenCV</code></li> <li>Published to Maven Central</li> <li>24 PRs of build infrastructure work</li> </ul> <h2 id="h-maven-dependency">Maven Dependency</h2> <div class="codehilite"><pre><span></span><code><span class="cm">&lt;!-- Before (SikuliX) --&gt;</span> <span class="nt">&lt;dependency&gt;</span> <span class="w"> </span><span class="nt">&lt;groupId&gt;</span>org.openpnp<span class="nt">&lt;/groupId&gt;</span> <span class="w"> </span><span class="nt">&lt;artifactId&gt;</span>opencv<span class="nt">&lt;/artifactId&gt;</span> <span class="w"> </span><span class="nt">&lt;version&gt;</span>4.5.4<span class="nt">&lt;/version&gt;</span> <span class="nt">&lt;/dependency&gt;</span> <span class="cm">&lt;!-- After (OculiX) --&gt;</span> <span class="nt">&lt;dependency&gt;</span> <span class="w"> </span><span class="nt">&lt;groupId&gt;</span>io.github.julienmerconsulting.apertix<span class="nt">&lt;/groupId&gt;</span> <span class="w"> </span><span class="nt">&lt;artifactId&gt;</span>opencv<span class="nt">&lt;/artifactId&gt;</span> <span class="w"> </span><span class="nt">&lt;version&gt;</span>4.10.0-0<span class="nt">&lt;/version&gt;</span> <span class="nt">&lt;/dependency&gt;</span> </code></pre></div> <h2 id="h-loading-mechanism">Loading Mechanism</h2> <p><code>Commons.loadOpenCV()</code> uses a 3-stage fallback:</p> <div class="codehilite"><pre><span></span><code><span class="n">Stage</span><span class="w"> </span><span class="mi">1</span><span class="p">:</span><span class="w"> </span><span class="n">nu</span><span class="o">.</span><span class="n">pattern</span><span class="o">.</span><span class="n">OpenCV</span><span class="o">.</span><span class="n">loadLocally</span><span class="p">()</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="n">Apertix</span><span class="w"> </span><span class="p">(</span><span class="n">preferred</span><span class="p">)</span> <span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="n">fail</span> <span class="n">Stage</span><span class="w"> </span><span class="mi">2</span><span class="p">:</span><span class="w"> </span><span class="n">System</span><span class="o">.</span><span class="n">loadLibrary</span><span class="p">(</span><span class="s2">"opencv_java4100"</span><span class="p">)</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="n">java</span><span class="o">.</span><span class="n">library</span><span class="o">.</span><span class="n">path</span> <span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="n">fail</span> <span class="n">Stage</span><span class="w"> </span><span class="mi">3</span><span class="p">:</span><span class="w"> </span><span class="n">Extract</span><span class="w"> </span><span class="n">DLL</span><span class="w"> </span><span class="n">from</span><span class="w"> </span><span class="n">JAR</span><span class="w"> </span><span class="err">→</span><span class="w"> </span><span class="n">System</span><span class="o">.</span><span class="n">load</span><span class="p">()</span><span class="w"> </span><span class="err">←</span><span class="w"> </span><span class="n">manual</span><span class="w"> </span><span class="n">extraction</span> <span class="w"> </span><span class="err">│</span><span class="w"> </span><span class="n">fail</span> <span class="w"> </span><span class="err">└──</span><span class="w"> </span><span class="n">Log</span><span class="w"> </span><span class="n">error</span><span class="w"> </span><span class="p">(</span><span class="n">libOpenCVloaded</span><span class="w"> </span><span class="n">stays</span><span class="w"> </span><span class="bp">false</span><span class="p">)</span> </code></pre></div> <blockquote> <p><strong>Critical fix (PR <span><span>[#12]</span></span>):</strong> <code>libOpenCVloaded</code> is only set to <code>true</code> on actual success. Previously it was always <code>true</code>, masking load failures.</p> </blockquote> <h2 id="h-files-changed">Files Changed</h2> <table> <thead> <tr> <th>File</th> <th>Change</th> </tr> </thead> <tbody> <tr> <td><code>Core.java</code></td> <td><code>NATIVE_LIBRARY_NAME</code>: <code>opencv_java454</code> → <code>opencv_java4100</code></td> </tr> <tr> <td><code>Commons.java</code></td> <td><code>loadOpenCV()</code> rewritten with 3-stage fallback</td> </tr> <tr> <td><code>sikulixcontent</code></td> <td>Manifest aligned to <code>opencv_java4100</code></td> </tr> <tr> <td><code>API/pom.xml</code></td> <td>Dependency changed to Apertix</td> </tr> </tbody> </table> <h2 id="h-impact">Impact</h2> <ul> <li><strong>Java 17 mandatory</strong>: Apertix 4.10.0-0 is compiled with Java 17 (class file version 61.0)</li> <li><strong>JNA 5.14.0 required</strong>: for glibc + Apple Silicon compatibility</li> </ul></div>Julien MerSun, 12 Apr 2026 00:55:56 -0000https://sourceforge.net9599c00e104944d5cf3fd908dea860e3808d72c3