hpreview

Beschreibung

hpreview ist ein schneller Viewer für Dictionary-, Deep-Learning-Modell-, 3D-Objektmodell- und Objektdateien von HALCON. Es durchsucht einen Ordner mit HALCON-Dateien wie ein Bildbetrachter - blättern Sie mit Bild-Auf/Bild-Ab durch die Dateien, untersuchen Sie jeden Wert in einer aufklappbaren Baumansicht, und sehen Sie eingebettete Bilder automatisch gerendert, direkt aus dem Pixel-Puffer von HALCON.

• Unterstützte Dateien: .hdict, .json (über HALCONs eigenes read_dict), .hobj, .hdl und .onnx (Deep-Learning-Modelle), 3D-Objektmodelle (.om3, .dxf, .off, .ply, .obj, .stl, .step/.stp, .pts, .ptx, .xyz, .pcd), Bilder (.png, .tif/.tiff, .jpg/.jpeg, .bmp, .jp2, .ima) sowie HALCON-Bildsequenzen (.seq).
• Vollständige Baumansicht: jeder Schlüssel, Typ und Wert - einschließlich Bildern, Regionen, XLD-Konturen/Polygonen/Parallelen und Deep-Learning-Modellparametern - generisch erkannt, nicht anhand einer fest hinterlegten, versionsspezifischen Liste.
• Bild- und Overlay-Vorschau: Bilder werden direkt aus dem Pixel-Puffer von HALCON gerendert (korrekte Behandlung HALCON-spezifischer Pixeltypen und reduzierter Domänen); Regionen, Konturen, Polygone und Parallelen werden als Overlay gezeichnet, allein oder kombiniert mit einem Bild.
• Tupel-Werte als Bilder laden: Bei Tupeln von Dateinamen, wie sie z. B. in Deep-Learning-Dataset-Dictionaries vorkommen, kann jede referenzierte Bilddatei optional direkt aufgelöst und angezeigt werden.
• Speichern und Exportieren: Speichern Sie das Originalobjekt mit HALCONs eigenem Writer (write_object/write_image/write_contour_xld_dxf), oder exportieren Sie die gerenderte Vorschau als PNG/JPG/BMP.
• Kommandozeilen-Tool (hpreviewcli) zur Skriptsteuerung: den Baum einer Datei als Text ausgeben, zwischen .hdict und .json konvertieren, oder alle iconischen Objekte eines Dictionarys auf die Festplatte extrahieren.
• Läuft unter Windows und Linux (unter Linux als eigenständiges AppImage) und erkennt automatisch, welche HALCON-Version auf Ihrem Rechner aktuell aktiv ist. Unter Windows werden alle HALCON-Versionen von 18.11 bis 26.05 unterstützt, unter Linux aktuell die Steady Editions 18.11, 20.11, 22.11 und 24.11 - weitere Versionen auf Anfrage.

HALCON ist eine Marke der MVTec Software GmbH. hpreview ist ein unabhängiges Produkt und steht in keiner Verbindung zu MVTec und wird nicht von MVTec unterstützt.

Versionshistorie

1.1 (veröffentlicht 18.09.2026)

Highlight: Mit Find bekommt hpreview eine richtige Suche.

• ONNX-Modelle (.onnx) lassen sich jetzt direkt öffnen, gleichberechtigt neben .hdl - dieselbe generische Baumansicht zur Introspektion, keine Zweitklassigkeit. (HALCONs eigene ONNX-Importgrenzen gelten weiterhin: Opset <=13, ausschließlich float32-Tensoren, eine Teilmenge der Operatoren.)
• Find (Strg+F): eine Suchleiste mit Live-Trefferzähler, Highlight-all, Regex-Modus und getrennter Schlüssel-/Wert-Suche - inklusive optionaler unbegrenzter Suche über die standardmäßige Anzeigegrenze von 1000 Elementen hinaus. Treffer springen automatisch an und klappen eingeklappte Knoten auf; die Baumansicht erhielt außerdem Expand All/Collapse All.

 

1.0 (veröffentlicht 17.09.2026)

Highlight: hpreview wird plattformübergreifend. Linux steht jetzt gleichberechtigt neben Windows.

• Vollständige Linux-Unterstützung, ausgeliefert als eigenständiges AppImage - herunterladen, ausführbar machen, starten. Kein Installer, keine Abhängigkeiten, die erst gesucht werden müssen.
• "Try loading tuple values as images" löst jetzt auch .hobj-Dateien und Pfade ohne Dateiendung auf, nicht nur die offensichtlichen Bildformate.
• Ein neues Menü File > Open Recent merkt sich, wo Sie zuletzt waren.
• Zoom und Bildausschnitt bleiben beim Wechsel zwischen gleich großen Bildern erhalten.
• Typen zeigen jetzt ihren echten HALCON-Subtyp (xld_poly, region, ...) statt eines generischen object.
• Dutzende kleinere Korrekturen: aufklappbare abgeschnittene Werte, zuverlässiges Kopieren mit Strg+C und eine vollständig überarbeitete Hilfe samt EULA.

 

0.9 (veröffentlicht 22.08.2026)

Highlight: vollständige Region- und Kontur-Visualisierung.

• Region- und Kontur-Handling umfassend überarbeitet: XLD-Polygone und -Parallelen visualisieren und speichern, als DXF exportieren, sowie echte Wertzusammenfassungen statt Platzhaltern.
• Ein SPDX Software Bill of Materials erzeugt, im Vorgriff auf den EU Cyber Resilience Act.
• Auf Qt 6.11.2 umgestellt.
• Neu laden mit F5.

 

0.8 (veröffentlicht 20.08.2026)

Highlight: hpreviews erste öffentliche Vorschau.

• Der Kern-Viewer: HALCON-Dictionaries, Bilder, Regionen und Konturen durchsuchen, mit Zoom, Bildausschnitt und Live-Pixelanzeige.
• Deep-Learning-Modell-Inspektion (.hdl) steht neben .hdict, .json und 3D-Objektmodellen zur Verfügung.
• hpreviewcli kommt hinzu: dieselbe Fähigkeit zum Durchsuchen, Ausgeben und Extrahieren - direkt aus dem Terminal oder der CI-Pipeline.
• Von Beginn an auf einer Multi-HALCON-Versions-Adapter-Architektur aufgebaut, sodass hpreview mit der tatsächlich installierten HALCON-Version arbeitet - nicht nur mit einer einzigen.
• Windows-Dateityp-Verknüpfung: Doppelklick auf eine HALCON-Datei genügt, und sie öffnet sich.

Lizenzierung

hpreview ist kostenlos nutzbar für Evaluierung und nicht-kommerzielle Zwecke. Für die kommerzielle Nutzung ist eine Lizenz erforderlich.

Ihre Lizenz ist an die Host-ID Ihres Rechners gebunden (dieselbe ID, die auf Ihrem HALCON-Dongle aufgedruckt ist und in Ihrer HALCON-Lizenzdatei verwendet wird) - senden Sie zum Erhalt einer Lizenz Ihren Namen und diese Host-ID (im Dialog Enter License... von hpreview ersichtlich) an hpreview@heindl-solutions.com. Wir erstellen und senden Ihnen anschließend eine Rechnung.

Eine Lizenz kostet 800 € und wird ausschließlich auf Business-to-Business-Basis (B2B) verkauft. Benötigen Sie mehr als eine Lizenz? Sprechen Sie uns an - bei mehreren Lizenzen bieten wir reduzierte Preise.

Nach Zahlungseingang erhalten Sie einen Lizenzschlüssel per E-Mail. Fügen Sie ihn im Dialog Enter License... ein und klicken Sie auf Save - hpreview prüft ihn gegen Ihre Host-ID und speichert ihn automatisch.

Wechsel auf einen neuen Rechner oder eine andere HALCON-Installation? Da Ihre Lizenz an die Host-ID dieses Rechners gebunden ist, benötigen Sie dafür einen neuen Schlüssel - kontaktieren Sie uns einfach mit der neuen Host-ID.

Download

hpreview 1.1 - Windows-Installer

hpreview 1.1 - Linux AppImage (x86_64)

Erfordert eine funktionierende HALCON-Installation (jede aktuelle Version) - HALCON selbst ist nicht enthalten und muss separat bei der MVTec Software GmbH lizenziert werden.

Unter Windows wird hpreviewcli.exe direkt neben hpreview.exe installiert und kann unmittelbar ausgeführt werden. Das Linux-AppImage enthält GUI und hpreviewcli in einer einzigen Datei - direktes Ausführen oder Doppelklick startet die GUI; um stattdessen die CLI zu starten, legen Sie einen Symlink namens hpreviewcli an, der auf das AppImage zeigt, und führen Sie diesen aus (die übliche AppImage-Konvention, um zwischen enthaltenen Programmen zu wählen), zum Beispiel ln -sf hpreview-1.1-x86_64.AppImage $HOME/bin/hpreviewcli - liegt $HOME/bin in Ihrem PATH, funktioniert hpreviewcli <file> anschließend von überall aus.