Die INI-Datei von MERLIC

Auf dieser Seite wird die allgemeine Konfigurationsdatei von MERLIC beschrieben. Sie heißt standardmäßig „MERLIC5.ini“. Damit können Sie verschiedene Einstellungen für die einzelnen Komponenten von MERLIC konfigurieren. Die Konfigurationseigenschaften sind in verschiedenen Abschnitten gruppiert.

Sie können außerdem weitere Konfigurationsdateien mit angepassten Einstellungen für spezielle Anwendungsfälle erstellen. Dies bietet auch die Möglichkeit, mehrere MERLIC- oder MERLIC RTE-Instanzen mit unterschiedlichen Konfigurationen zu verwenden. Wenn Sie die Konfiguration einer INI-Datei verwenden möchten, müssen Sie MERLIC oder MERLIC RTE mit der entsprechenden INI-Datei starten. Weitere Informationen finden Sie unter Mehrere MERLIC RTE-Instanzen verwenden.

Die folgenden Abschnitte enthalten einige allgemeine Informationen, z. B. Informationen zum Speicherort der Konfigurationsdatei oder Informationen zum Definieren weiterer Konfigurationsdateien. Darüber hinaus finden Sie ausführliche Informationen zu den verfügbaren Konfigurationseigenschaften. Die Konfigurationsdatei im Allgemeinen wird einfach als „INI-Datei“ bezeichnet, um Missverständnisse zu vermeiden, auf welche Konfigurationsdatei verwiesen wird.

Allgemeine Informationen

Speicherort

Unter Windows befindet sich die automatisch erzeugte „MERLIC5.ini“-Datei im folgenden Standardverzeichnis: „C:\Users\<username>\AppData\Roaming\MVTec“. Sie können auch „%APPDATA%\MVTec“ im Datei-Explorer eingeben, um zu diesem Verzeichnis zu gelangen.

Unter Linux müssen Sie die INI-Datei nach der Installation manuell bereitstellen. Die standardmäßige „MERLIC5.ini“ wird im folgenden Verzeichnis erwartet: „~/.config/MVTec/“. Weitere Informationen finden Sie im Abschnitt MERLIC5.ini-Datei bereitstellen unter MERLIC unter Linux installieren.

Versionen

Bei der Aktualisierung auf eine neue Version von MERLIC kann die Abwärtskompatibilität der INI-Datei beeinträchtigt werden. Daher wird empfohlen, eine Kopie Ihrer INI-Datei und Ihrer MVApps zu speichern, bevor sie in einer neuen Version von MERLIC verwendet werden.

Für diese MERLIC-Version heißt die standardmäßig erzeugte und verwendete INI-Datei „MERLIC5.ini“. Für frühere Hauptversionen von MERLIC wird standardmäßig eine andere INI-Datei verwendet.

MERLIC-Version	Name der INI-Datei
≥ 26.03	MERLIC5.ini
5,0 bis 5,8	MERLIC5.ini
4,4 bis 4,8	MERLIC4.ini
< 4,4	MERLIC.ini

Es gibt zwei Möglichkeiten, um Ihre MERLIC-Version zu ermitteln:

Öffnen Sie im MERLIC Creator über den Menüeintrag „Hilfe → Über“ das Dialogfeld „Über MERLIC“.
Verwenden Sie die Kommandozeilenoption „-V“ oder „‑‑version“ für die ausführbare MERLIC-Datei „merlic_creator.exe“. Weitere Informationen zu den verfügbaren Kommandozeilenoptionen finden Sie unter MERLIC Frontend unter Windows starten.

Zusätzliche INI-Dateien verwenden

Standardmäßig wird MERLIC mit der Konfiguration der „MERLIC5.ini“-Standarddatei gestartet. Sie können aber auch eine weitere INI-Datei mit einer anderen Konfiguration erstellen und MERLIC dann mit der neuen INI-Datei starten. Auf diese Weise können Sie verschiedene Konfigurationen für verschiedene Anwendungsfälle erstellen, beispielsweise, wenn Sie gleichzeitig mehrere Instanzen von MERLIC mit unterschiedlichen Konfigurationen verwenden möchten.

Um eine neue INI-Datei zu erstellen, können Sie die standardmäßige „MERLIC5.ini“ kopieren, die Konfiguration wie gewünscht anpassen und die Datei am gewünschten Speicherort speichern.

Um MERLIC mit einer bestimmten INI-Datei zu starten, müssen Sie wie nachstehend beschrieben die Kommandozeile verwenden:

Öffnen Sie eine Eingabeaufforderung und wechseln Sie in das Verzeichnis „bin\x64-win64“ unter dem MERLIC-Installationspfad, z. B. „%PROGRAMFILES%\MVTec\MERLIC-26.10\bin\x64-win64“.
Verwenden Sie die Kommandozeilenoption „‑‑ini“, um den Pfad und den Namen der gewünschten INI-Datei wie im folgenden Beispiel gezeigt anzugeben. Wenn die INI-Datei nicht vorhanden ist, wird sie bei diesem Aufruf automatisch erstellt.
Kopieren
```
merlic_creator.exe --ini <FILE>
```

Die Kommandozeilenoption „‑‑ini“ kann auch für die ausführbare Datei anderer MERLIC-Anwendungen verwendet werden:

merlic_creator.exe
merlic_frontend.exe
merlic_rte.exe
merlic_rte_setup.exe

Weitere Informationen zum Starten der jeweiligen MERLIC-Anwendung finden Sie auf den folgenden Seiten:

Eigenschaften in der INI-Datei außer Kraft setzen

Wenn Sie MERLIC über die Kommandozeile starten, haben Sie die Möglichkeit, einige Eigenschaften der INI-Datei außer Kraft zu setzen. Mit den verfügbaren Kommandozeilenoptionen können Sie spezielle Einstellungen für die aktuelle Sitzung definieren. Die angegebene Option in der Kommandozeile überschreibt den Wert, der für die jeweilige Eigenschaft in der INI-Datei festgelegt ist.

Gleiches gilt für zusätzliche INI-Dateien. Wenn MERLIC mit einer angepassten INI-Datei verwendet wird, überschreiben die Eigenschaften in der jeweiligen INI-Datei die Konfiguration der standardmäßigen „MERLIC5.ini“-Datei.

Es gilt folgende Hierarchie für Startoptionen:

Kommandozeilenoptionen.
Optionen der in der Kommandozeile angegebenen INI-Datei.
Optionen der „MERLIC5.ini“-Standarddatei.
Wenn keine INI-Datei vorhanden ist, erstellt MERLIC beim Start eine solche Datei im Standardverzeichnis oder in dem in der Kommandozeile angegebenen Verzeichnis.

Aufbau und Codierung

Die INI-Datei besteht aus verschiedenen Abschnitten, die Einstellungen für die jeweilige Komponente enthalten. Die Abschnitte werden chronologisch hinzugefügt und von MERLIC ggf. automatisch umgeordnet. Die Namen der Abschnitte in der INI-Datei stehen in eckigen Klammern [ ]. Wenn Sie die INI-Datei manuell bearbeiten, können Sie neue Abschnitte beliebig über oder unter vorhandenen Abschnitten hinzufügen.

Die INI-Datei muss auf allen Plattformen die UTF-8-Zeichencodierung aufweisen. Es ist möglich, normale Schrägstriche „/“ und umgekehrte Schrägstriche „\“ als Pfadtrennzeichen in der INI-Datei zu verwenden. Zeilen, die mit „#“ beginnen, werden von MERLIC ignoriert.

Abschnitte

Nachstehend finden Sie ausführliche Informationen zu den verfügbaren Abschnitten und Eigenschaften für die INI-Datei. Derzeit können Sie Eigenschaften in den folgenden Abschnitten definieren:

General
colors
Communicator
Designer
Frontend
Logging
ProcessIntegration
RecentlyWorkedOn
RTESetup
Server
UserManagement

[General]

Eigenschaft	Standardwert	Beschreibung
GuiLanguage		Mit dieser Option können Sie die Sprache der Benutzeroberfläche ändern. MERLIC verwendet standardmäßig die Sprache, die bei der Installation von MERLIC ausgewählt wurde. Die folgenden Sprachen sind verfügbar: de_DE: Deutsch de_DE: Englisch ja_JP: Japanisch zh_CN: Vereinfachtes Chinesisch Das MERLIC Frontend bietet weitere Sprachoptionen: Weitere Informationen zum Festlegen der Sprache des Frontends finden Sie unter Sprache für das MERLIC Frontend ändern. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden. „Bearbeiten → Einstellungen → Allgemein → Sprache“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
HalconDisableCudnnOptimization	true	Mit dieser Eigenschaft können die dynamischen Optimierungen über die NVIDIA® CUDA® Deep Neural Network-Bibliothek (cuDNN) aktiviert oder deaktiviert werden. Diese Optimierung bezieht sich auf MERLIC-Tools mit Deep Learning-Technologie, z. B. Anomalien finden. Standardmäßig ist diese Eigenschaft auf „true“ festgelegt, d. h., es wird keine zusätzliche Optimierung durchgeführt. Bei Einstellung auf „false“ werden zusätzliche Optimierungen durchgeführt, wenn in einem MERLIC-Tool eine GPU als Recheneinheit ausgewählt wird. Abhängig von den Fähigkeiten der ausgewählten GPU beansprucht die aktivierte Optimierung erheblich mehr Zeit. Sie führt in der Regel aber zu einer besseren Inferenzleistung und somit zu kürzeren Zykluszeiten. Durch die Optimierung wird die erforderliche Dauer für die folgenden Prozesse verbessert: Laden von MVApps, die MERLIC-Tools mit Deep Learning-Technologie enthalten Beim Konfigurieren eines MERLIC-Tools mit Deep Learning-Technologie: Übernehmen der Trainingsdaten (sofern ein Trainingsmodus für das Tool verfügbar ist) Auswählen einer anderen Modelldatei Festlegen einer GPU als Recheneinheit Wenn Sie die cuDNN-Optimierung verwenden möchten, müssen Sie den Treiber der GPU auf die neueste Version aktualisieren. Andernfalls wird die Optimierung über die cuDNN-Bibliothek möglicherweise nicht unterstützt. MERLIC muss neu gestartet werden, wenn diese Einstellung geändert wird. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden. „Bearbeiten → Einstellungen → Allgemein → Modell-Optimierung deaktivieren“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
HDevelopDebugPort	57786	Diese Eigenschaft definiert den HDevelop Debug-Port, der für die Verbindung zu MERLIC zum Debuggen von benutzerdefinierten Tools in einem speziellen Debugmodus von HDevelop verwendet wird. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden: „Bearbeiten → Einstellungen → Benutzerdefinierte Tools → HDevelop Debug-Port“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
HDevelopDebugServer	false	Diese Eigenschaft legt fest, ob der HDevelop-Debugserver, der zum Debuggen von benutzerdefinierten MERLIC-Tools in einem speziellen Debugmodus von HDevelop erforderlich ist, aktiviert wird. Sie können die folgenden Werte festlegen: true: Der HDevelop-Debugserver wird beim Start von MERLIC automatisch gestartet. false: Der HDevelop-Debugserver wird nicht aktiviert. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden. „Bearbeiten → Einstellungen → Benutzerdefinierte Tools → HDevelop Remote-Debugging aktivieren“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
IniVersion	4	Diese Eigenschaft wird von MERLIC verwendet, um gültige Schlüssel und Werte zu bestimmen. Für die aktuelle MERLIC-Version muss sie auf 4 festgelegt werden.
LineWidth	2 [px]	Diese Eigenschaft speichert die Breite von Linien, die in MERLIC visualisiert werden. Die Angabe erfolgt in Pixeln. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden: „Bearbeiten → Einstellungen → Allgemein → Linienbreite“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
MainWindowGeometry		Diese Eigenschaft speichert die Position und Darstellung des MERLIC Creator-Fensters in einem ByteArray.
MainWindowMaximized	false	Diese Eigenschaft legt fest, ob das MERLIC Creator-Fenster beim Öffnen maximiert wird. Sie können die folgenden Werte festlegen: true: Das Fenster wird maximiert. false: Das Fenster wird nicht maximiert.
MainWindowState		Diese Eigenschaft speichert die Darstellung und den Zustand der Komponenten im MERLIC Creator-Fenster in einem ByteArray. Weitere Informationen zum Anpassen der Benutzeroberfläche finden Sie unter MERLIC-Einstellungen.
OpenUpdateDialog	true	Diese Eigenschaft legt fest, ob der Dialog, der Benutzer über ein verfügbares Update für MERLIC benachrichtigt, beim Start angezeigt wird. Es ist möglich, die Benachrichtigungen zu deaktivieren, es ist jedoch nicht möglich, die Prüfung auf verfügbare Updates zu deaktivieren. Sie können die folgenden Werte festlegen: true: Wenn ein Update verfügbar ist, wird der Updatedialog beim Start angezeigt. false: Wenn ein Update verfügbar ist, wird der Updatedialog beim Start nicht angezeigt. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden. „Bearbeiten → Einstellungen → Allgemein → Dialog anzeigen, wenn ein neues Update vorliegt“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
ProceduresPath	<leer>	Mit dieser Eigenschaft kann der Speicherort von benutzerdefinierten MERLIC-Prozeduren (*.hdpl) festgelegt werden. Der Speicherort muss als absoluter Dateipfad zur HDevelop-Prozedur angegeben werden. Wenn Sie mehrere Prozedurpfade angeben möchten, können Sie die Pfade in einer Liste mit Semikolons als Trennzeichen angeben. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden. „Bearbeiten → Einstellungen → Benutzerdefinierte Tools → Zusätzlicher Prozedurenpfad“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
ShowStartupDialog	true	Diese Eigenschaft legt fest, ob der Startdialog im MERLIC Creator beim Start angezeigt wird. Es ist möglich, den Startdialog zu deaktivieren. Sie können die folgenden Werte festlegen: true: Der Startdialog wird beim Start angezeigt. false: Der Startdialog wird beim Start nicht angezeigt. Weitere Informationen zum Startdialog und zum Anpassen der Benutzeroberfläche finden Sie unter Startdialog und MERLIC-Einstellungen.
StartServer	true	Die folgende Eigenschaft legt fest, ob ein Server gestartet werden soll. Wenn MERLIC mit der Prozessintegration und einem Remote-Frontend verwendet werden soll, muss ein Server gestartet werden. Sie können die folgenden Werte festlegen: true: Der Server wird bei der Initialisierung von MERLIC aktiviert. Die jeweiligen Servereinstellungen müssen im Abschnitt [Server] definiert werden. false: Der Server wird bei der Initialisierung von MERLIC nicht aktiviert.
StartupDialogState		Diese Eigenschaft legt fest, ob die Abschnitte „Letzte MVApps“ und „Beispiele“ im Startdialog erweitert oder reduziert werden sollen und wo der Splitter zwischen den beiden Abschnitten positioniert werden soll.
ToolPath	<leer>	Mit dieser Eigenschaft kann der Speicherort von benutzerdefinierten MERLIC-Tools festgelegt werden. Der Speicherort muss als absoluter Dateipfad zur HDevelop-Prozedur, die das benutzerdefinierte Tool darstellt, angegeben werden. Wenn Sie mehrere Toolpfade angeben möchten, können Sie die Pfade in einer Liste mit Semikolons als Trennzeichen angeben. MERLIC sucht dann in den definierten Pfaden nach Dateien in den Formaten .mvtools, .hdpl und *.hdvp. Dateien dieser Formate werden in MERLIC geladen und integriert. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden. „Bearbeiten → Einstellungen → Benutzerdefinierte Tools → Toolpfade“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
VisualizeSkippedTools		Über diese Eigenschaft können Sie festlegen, ob MERLIC die Tools hervorhebt, die in der letzten Iteration nicht ausgeführt wurden. Sie können die folgenden Werte festlegen: true: Die Hervorhebung ist aktiviert. false: Die Hervorhebung ist nicht aktiviert. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden: „Bearbeiten → Einstellungen → Allgemein → Tools hervorheben, die nicht ausgeführt wurden“ Weitere Informationen finden Sie unter Tool-Flow.

[colors]

Die Eigenschaften in diesem Abschnitt definieren die Farben, die von MERLIC zum Visualisieren der verschiedenen Tools und Widgets in MERLIC verwendet werden.

Die Farbwerte werden entweder im Hexadezimalformat oder als benannte Farben gemäß dem HTML-Standard ausgedrückt. Benutzerdefinierte Farben sind möglich. In diesem Fall sind die Einstellungen für „Schlüssel“ und „Wert“ identisch.

Wert	Beschreibung
accepted	Diese Farbe wird für die easyTouch-Vorschau in MERLIC-Tools mit einem Trainingsmodus verwendet, z. B. in Matching-Tools oder Tools zum Lesen von Codes. Wenn easyTouch bei einem Trainingsbild verwendet wird, um ein geeignetes Objekt oder einen geeigneten Code für das Training zu finden, visualisiert easyTouch über eine entsprechende Färbung des Rahmens, ob der Bildteil im aktuell ausgewählten Bereich für das Training geeignet ist. Wenn der Bildteil geeignet ist, wird der Rahmen in der für „accepted“ definierten Farbe angezeigt. Diese Farbe wird auch in einigen MERLIC-Tools ohne Trainingsmodus verwendet, um Regionen oder Konturen hervorzuheben, die den aktuellen Parametereinstellungen des Tools entsprechen, z. B. für die akzeptierten Regionen im Tool Regionen bewerten.
easy_touch	Diese Farbe wird für easyTouch verwendet, um die vorläufigen Ergebnisse hervorzuheben, die in der Vorschau angezeigt werden können, bevor die Auswahl mit einem Mausklick bestätigt wird.
fail	Diese Farbe wird für easyTouch in MERLIC-Tools zum Lesen von Codes verwendet. Wenn Sie den Mauszeiger über einen Bereich bewegen, in dem die Decodierung fehlgeschlagen ist, wird der Rahmen dieses Bereichs in dieser Farbe hervorgehoben.
ok	Diese Farbe wird für easyTouch verwendet, um die Regionen oder Konturen hervorzuheben, die über easyTouch mit einem Mausklick ausgewählt wurden.
region_input	Diese Farbe wird zum Hervorheben des Rahmens von Eingaberegionen verwendet, die von einem vorherigen Tool übertragen werden.
rejected	Diese Farbe wird für die easyTouch-Vorschau in MERLIC-Tools mit einem Trainingsmodus verwendet, z. B. in Matching-Tools oder Tools zum Lesen von Codes. Wenn easyTouch bei einem Trainingsbild verwendet wird, um ein geeignetes Objekt oder einen geeigneten Code für das Training zu finden, visualisiert easyTouch über eine entsprechende Färbung des Rahmens, ob der Bildteil im aktuell ausgewählten Bereich für das Training geeignet ist. Wenn der Bildteil nicht geeignet ist, wird der Rahmen in der für „rejected“ definierten Farbe angezeigt. Diese Farbe wird auch in einigen MERLIC-Tools ohne Trainingsmodus verwendet, um Regionen oder Konturen hervorzuheben, die nicht den aktuellen Parametereinstellungen des Tools entsprechen, z. B. für die zurückgewiesenen Regionen im Tool Regionen bewerten.
roi_active	Diese Farbe wird für die derzeit ausgewählte ROI (Region of Interest) verwendet.
roi_inactive	Diese Farbe wird für die derzeit nicht ausgewählten ROIs (Regions of Interest) verwendet.
warning	Diese Farbe wird für die easyTouch-Vorschau in MERLIC-Tools mit einem Trainingsmodus verwendet, z. B. in Matching-Tools oder Tools zum Lesen von Codes. Wenn easyTouch bei einem Trainingsbild verwendet wird, um ein geeignetes Objekt oder einen geeigneten Code für das Training zu finden, visualisiert easyTouch über eine entsprechende Färbung des Rahmens, ob der Bildteil im aktuell ausgewählten Bereich für das Training geeignet ist. Wenn die Daten im Bildteil nicht für ein gutes Ergebnis ausreichen, wird der Rahmen in der für „warning“ definierten Farbe angezeigt.

GUI-Einstellungen

Die Farben können auch im MERLIC Creator konfiguriert werden: „Bearbeiten → Einstellungen → Farben“.

Weitere Informationen finden Sie unter MERLIC-Eigenschaften.

[Communicator]

Mit den Eigenschaften in diesem Abschnitt können bestimmte Einstellungen für Kommunikations-Plugins konfiguriert werden. Weitere Informationen finden Sie unter Zusätzliche Einstellungen für Kommunikations-Plugins.

Eigenschaft	Standardwert	Beschreibung
CommandTimeout	5000 [ms]	Diese Eigenschaft definiert das Timeout in Millisekunden für Befehle, die von Kommunikations-Plugins gesendet werden, falls MERLIC RTE nicht antwortet.
ConfigDir	Windows: %AppData%\MVTec\Communicator\conf\ Linux: „~/.config/MVTec/Communicator/conf“	Diese Eigenschaft definiert das Verzeichnis für die JSON-Konfigurationsdateien von Kommunikations-Plugins. Weitere Informationen finden Sie unter Zusätzliche Einstellungen für Kommunikations-Plugins.
PluginDir		Diese Eigenschaft definiert die Verzeichnisse, in denen Kommunikations-Plugins gesucht werden sollen. Die Verzeichnisse können in einer Liste mit Semikolons als Trennzeichen definiert werden. Diese Einstellung ist erforderlich, wenn Sie ein eigenes Kommunikations-Plugin implementiert und die zugehörige Plugin-Bibliothek an einem anderen Speicherort als dem Speicherort für die Kommunikations-Plugins im Lieferumfang von MERLIC gespeichert haben. Vergewissern Sie sich, dass Sie alle Verzeichnisse angegeben haben, in denen sich Kommunikations-Plugins befinden – auch den Standardspeicherort der MERLIC-Kommunikations-Plugins. Wenn derselbe Plugin-Name in mehreren Verzeichnissen vorkommt, bestimmt die Reihenfolge, in der die Verzeichnisse angegeben werden, den Vorrang. Die Kommunikations-Plugins werden standardmäßig in dem Verzeichnis gesucht, in dem sich die ausführbaren MERLIC-Dateien befinden: %PROGRAMFILES%\MVTec\MERLIC-26.10 (Windows-Installation mit Administratorrechten) %LOCALAPPDATA%\Programs\MVTec\MERLIC-26.10 (Windows-Installation ohne Administratorrechte) Weitere Informationen finden Sie unter Zusätzliche Einstellungen für Kommunikations-Plugins.

Eigenschaft

Standardwert

Beschreibung

CommandTimeout

5000 [ms]

Diese Eigenschaft definiert das Timeout in Millisekunden für Befehle, die von Kommunikations-Plugins gesendet werden, falls MERLIC RTE nicht antwortet.

ConfigDir

Windows:

%AppData%\MVTec\Communicator\conf\

Linux:

„~/.config/MVTec/Communicator/conf“

Diese Eigenschaft definiert das Verzeichnis für die JSON-Konfigurationsdateien von Kommunikations-Plugins.

Weitere Informationen finden Sie unter Zusätzliche Einstellungen für Kommunikations-Plugins.

PluginDir

Diese Eigenschaft definiert die Verzeichnisse, in denen Kommunikations-Plugins gesucht werden sollen. Die Verzeichnisse können in einer Liste mit Semikolons als Trennzeichen definiert werden.

Diese Einstellung ist erforderlich, wenn Sie ein eigenes Kommunikations-Plugin implementiert und die zugehörige Plugin-Bibliothek an einem anderen Speicherort als dem Speicherort für die Kommunikations-Plugins im Lieferumfang von MERLIC gespeichert haben.

Vergewissern Sie sich, dass Sie alle Verzeichnisse angegeben haben, in denen sich Kommunikations-Plugins befinden – auch den Standardspeicherort der MERLIC-Kommunikations-Plugins.

Wenn derselbe Plugin-Name in mehreren Verzeichnissen vorkommt, bestimmt die Reihenfolge, in der die Verzeichnisse angegeben werden, den Vorrang.

Die Kommunikations-Plugins werden standardmäßig in dem Verzeichnis gesucht, in dem sich die ausführbaren MERLIC-Dateien befinden:

%PROGRAMFILES%\MVTec\MERLIC-26.10 (Windows-Installation mit Administratorrechten)
%LOCALAPPDATA%\Programs\MVTec\MERLIC-26.10 (Windows-Installation ohne Administratorrechte)

Weitere Informationen finden Sie unter Zusätzliche Einstellungen für Kommunikations-Plugins.

[Designer]

Dieser Abschnitt enthält Eigenschaften für den Arbeitsbereich des MERLIC Designers. Diese Einstellungen können auch in der grafischen Benutzeroberfläche des MERLIC Designers angepasst werden.

Eigenschaft	Standardwert	Beschreibung
GridColor	#ffff00	Diese Eigenschaft legt die Farbe des Gitters fest. Wenn Sie die Farbe in der INI-Datei festlegen, müssen Sie den entsprechenden Hexadezimalwert verwenden. Die Farbe kann jedoch auch in der grafischen Benutzeroberfläche des MERLIC Designers über „Bearbeiten → Gittereigenschaften“ angepasst werden.
GridSize	20	Diese Eigenschaft legt die Größe des Gitters in Pixeln fest. Die Größe kann auch in der grafischen Benutzeroberfläche des MERLIC Designers über „Bearbeiten → Gittereigenschaften“ angepasst werden.
ShowGrid	true	Diese Eigenschaft legt fest, ob das Gitter im Arbeitsbereich angezeigt wird. Legen Sie die Eigenschaft auf „false“ fest, um das Gitter zu deaktivieren. Alternativ können Sie diese Eigenschaft über die grafische Benutzeroberfläche des MERLIC Designers über den Menüeintrag „Bearbeiten → Gitter anzeigen“ ändern.
SnapToGrid	true	Diese Eigenschaft legt fest, ob Widgets am Gitter einrasten, wenn sie an eine neue Position verschoben werden. Legen Sie die Eigenschaft auf „false“ fest, um diesen Modus zu deaktivieren. Alternativ können Sie diese Eigenschaft über die grafische Benutzeroberfläche des MERLIC Designers über den Menüeintrag „Bearbeiten → Am Gitter einrasten“ ändern.

GUI-Einstellungen

Die Raster können auch im Frontend Designer über die Menüleiste oder das Menü „Bearbeiten“ konfiguriert werden: „Bearbeiten → Gittereigenschaften“

Weitere Informationen finden Sie unter Benutzeroberfläche anpassen.

[Frontend]

Dieser Abschnitt enthält Eigenschaften für das MERLIC Frontend sowie für die Verbindungen zwischen dem MERLIC Frontend und dem MERLIC Creator bzw. dem MERLIC RTE. Das MERLIC Frontend ist über die MERLIC-Server-Komponente mit den MERLIC Creator- oder MERLIC RTE-Instanzen verbunden. MERLIC-Server und MERLIC Frontend kommunizieren via IPC (Inter Process Communication).

Verbindungseinstellungen

Sie können die folgenden Frontend-Eigenschaften konfigurieren. Jede dieser Eigenschaften verfügt über einen vordefinierten Standardwert, der verwendet wird, wenn weder in der INI-Datei noch im Kommandozeilenbefehl ein Wert dafür angegeben wird:

Eigenschaft	Standardwert	Beschreibung
CycleTime	50 [ms]	Das MERLIC Frontend fragt den MERLIC-Server kontinuierlich auf neue Daten ab. Die Eigenschaft „CycleTime“ legt das Mindestintervall zwischen zwei Abfrageanforderungen fest. Sie wird in Millisekunden angegeben. Damit kann das MERLIC Frontend gedrosselt und die Arbeitslast des MERLIC-Servers verringert werden.
GuiLanguage		Mit dieser Eigenschaft können Sie die Sprache festlegen, in der das MERLIC Frontend gestartet werden soll, z. B. „de_DE“.
ReconnectInterval	25 [s]	Diese Eigenschaft wird verwendet, wenn die Verbindung zum Frontend-Server getrennt wurde. Zunächst versucht das Frontend, einmal die Verbindung wiederherzustellen. Sollte dies fehlschlagen, wird in einem bestimmten Zeitintervall, das in „ReconnectInterval“ definiert ist, erneut versucht, eine Verbindung herzustellen. Hier ist der Zeitraum (in Sekunden) definiert, der vergeht, bis versucht wird, die Verbindung wiederherzustellen. Bei Einstellung auf 0 versucht das Frontend, die Verbindung so schnell wie möglich wiederherzustellen.
Url		Diese Eigenschaft kann verwendet werden, um das MERLIC Frontend direkt mit einer bestimmten MERLIC-Instanz auf einem bestimmten System zu verbinden. Beim Starten des MERLIC Frontends wird automatisch versucht, eine Verbindung zum entsprechenden System herzustellen, sodass Sie die MERLIC-Instanz nicht manuell über das Dialogfenster „Instanzen auswählen“ auswählen müssen. Sie können die URL für das gewünschte System und die MERLIC-Instanz in den folgenden unterstützten Formaten angeben: ws[s]://<HOST>[:<PORT>]/instances/<INSTANCE_NAME> unix:///<PATH_TO_INSTANCE>/me-<INSTANCE_NAME> tcp://<HOST>:<PORT> (veraltet) Die URL kann auch beim Starten des MERLIC Frontends über die Kommandozeile mithilfe der Kommandozeilenoption „‑‑url“ angegeben werden. In diesem Fall wird die URL-Einstellung in der INI-Datei ignoriert, und das MERLIC Frontend stellt eine Verbindung zu dem System und der MERLIC-Instanz her, die in der Kommandozeile definiert wurden. Weitere Informationen finden Sie unter MERLIC Frontend unter Windows starten und Verbindung des MERLIC Frontend mit einem Remote-Server. Das Format mit dem Schema „tcp“ ist veraltet und wird nur für die Verwendung mit der MERLIC-Version 26.03 oder älteren Versionen unterstützt. In zukünftigen MERLIC-Versionen wird es möglicherweise entfernt.

Anpassungseinstellungen und sonstige Einstellungen

Darüber hinaus können Sie die folgenden Eigenschaften für das Frontend konfigurieren:

Eigenschaft	Standardwert	Beschreibung
AlwaysShowROIHandles	false	Diese Eigenschaft ist insbesondere für Geräte mit einem Touchscreen vorgesehen, um die Verwendung von ROIs zu ermöglichen. Diese Eigenschaft ist nützlich, wenn das Widget „ Bildanzeige“ in Ihrem MERLIC Frontend ebenfalls eine ROI anzeigt. Diese Eigenschaft definiert, ob die Interaktionsziehpunkte der ROI immer angezeigt werden (true) oder nicht (false).
HideMVTecMerlicInFrontendWindow	false	Diese Eigenschaft legt fest, ob der Name von MVTec und MERLIC im Fenstertitel des Frontends und in der Statusmeldung angezeigt werden, die im Frontend beim Laden des Frontend-Designs angezeigt wird. Legen Sie die Eigenschaft auf „true“ fest, um Firmen- und Produktname nicht anzuzeigen. Sobald das Frontend geladen wurde, wird der in den „Frontend-Eigenschaften“ des MERLIC Designers definierte Fenstertitel angezeigt.
HideWindowTitleBar	false	Bei Einstellung auf „true“ wird das MERLIC Frontend ohne Anzeige der Titelleiste des Anwendungsfensters gestartet. Dies wirkt sich auch auf die Tastenkombinationen aus, die verwendet werden können, z. B. zum Schließen des Fensters.
IconFile		Über diese Eigenschaft kann ein benutzerdefiniertes Symbol für das Frontend definiert werden. Dieses wird in der Titelleiste des Fensters und in der Taskleiste anstelle des MERLIC-Standardsymbols angezeigt. Sie müssen den absoluten Pfad und den Dateinamen des Symbols angeben.
ROIHandleSize_mm	4 [mm]	Diese Eigenschaft ist insbesondere für Geräte mit einem Touchscreen vorgesehen, um die Verwendung von ROIs zu ermöglichen. Diese Eigenschaft ist nützlich, wenn das Widget „ Bildanzeige“ in Ihrem MERLIC Frontend ebenfalls eine ROI anzeigt. Sie definiert die Größe der Interaktionsziehpunkte der ROI. Die Angabe erfolgt in Millimeter.
StartInFullscreen	false	Diese Eigenschaft definiert, ob das MERLIC Frontend im Vollbildmodus gestartet wird. Wenn das Frontend bei jedem Start automatisch im Vollbildmodus angezeigt werden soll, können Sie diese Option auf „true“ festlegen. Wenn Sie diese Option nur für eine einzelne Sitzung verwenden möchten, können Sie das Frontend über die Kommandozeile mit der Option „‑‑fullscreen“ starten.
TmpPath	%AppData%\Local\Temp\<user_group>_<user_name>	Das MERLIC Frontend benötigt Schreibzugriff auf ein Verzeichnis auf der Festplatte des Computers, um temporäre Dateien zu speichern. Sie können den Pfad zu diesem Verzeichnis mit der „TmpPath“-Eigenschaft festlegen. Wenn das Verzeichnis nicht vorhanden ist, versucht MERLIC, das Verzeichnis zu erstellen. Sie können Schrägstriche (/), Backslashes (\) oder doppelte Backslashes (\\) für Dateipfade in MERLIC INI-Dateien verwenden. MERLIC speichert die Pfade intern jedoch mit Schrägstrichen (/).
WindowGeometry		Mit dieser Eigenschaft können Position und Größe des MERLIC Frontends wie folgt vorgegeben werden: @Rect(x y w h) Die Werte x und y definieren die Position der oberen linken Ecke des MERLIC Frontends. Die Werte w und h definieren die Breite und Höhe des MERLIC Frontends. Alle Werte müssen in Pixeln angegeben werden. Wenn die „StartInFullscreen“-Eigenschaft auf „true“ festgelegt ist, wird das MERLIC Frontend im Vollbildmodus geöffnet, und die Einstellung für „WindowGeometry“ wird ignoriert. Beispiel Kopieren `[Frontend] WindowGeometry=@Rect(10 20 750 500)` [Frontend] WindowGeometry=@Rect(10 20 750 500)

Weitere Informationen zu den Einstellungen für das Frontend bzw. den erforderlichen Einstellungen zum Starten eines Remote-Frontends finden Sie auf den folgenden Seiten:

Veraltete Einstellungen

Die folgenden INI-Eigenschaften für den [Frontend]-Abschnitt sind veraltet und werden nur aus Gründen der Kompatibilität mit früheren MERLIC-Versionen bereitgestellt.

Eigenschaft	Standardwert	Beschreibung
Host	127.0.0.1	Diese Eigenschaft wird verwendet, um einen Hostnamen oder eine IP-Adresse festzulegen. Sie können so festlegen, zu welchem Computer das Frontend eine Verbindung herstellen soll. Diese Option ist veraltet und wird nur für die Verwendung mit MERLIC-Version 26.03 oder älter bereitgestellt. In zukünftigen MERLIC-Versionen wird sie möglicherweise entfernt. Wir empfehlen, die Option „Url“ zu verwenden, um den gewünschten MERLIC-Server anzugeben, mit dem das MERLIC Frontend eine Verbindung herstellen soll.
Port	9090	Diese Eigenschaft definiert den TCP/IP-Port, der vom Server überwacht wird. Diese Option ist veraltet und wird nur für die Verwendung mit MERLIC-Version 26.03 oder älter bereitgestellt. In zukünftigen MERLIC-Versionen wird sie möglicherweise entfernt. Wir empfehlen, die Option „Url“ zu verwenden, um den gewünschten MERLIC-Server anzugeben, mit dem das MERLIC Frontend eine Verbindung herstellen soll.

[Logging]

Dieser Abschnitt enthält Eigenschaften für Pfad, Größe und Anzahl der Log-Dateien sowie den Schwellenwert für Meldungen. Weitere Informationen zur Konfiguration mit Protokollierungsinformationen für MERLIC mit Prozessintegration finden Sie unter Protokollieren.

Eigenschaft	Standardwert	Beschreibung
LogFilePath	%LOCALAPPDATA%\MVTec\MERLIC\ %LOCALAPPDATA%\MVTec\MERLIC\	Diese Eigenschaft definiert den Pfad zum Verzeichnis, in dem die Log-Datei gespeichert wird. Sie können Schrägstriche (/), Backslashes (\) oder doppelte Backslashes (\\) für Dateipfade in MERLIC INI-Dateien verwenden. MERLIC speichert die Pfade intern jedoch mit Schrägstrichen (/). GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden: „Bearbeiten → Einstellungen → Allgemein → Pfad der Log-Datei“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
LogFileSizeInBytes	10 485 760 (= 10 MB)	Diese Eigenschaft definiert die maximale Größe der Log-Datei in Bytes. Wird die maximale Größe der Log-Datei erreicht und ist die Eigenschaft „LogFilesCount“ > 1, protokolliert MERLIC die neuen Meldungen in einer neuen Datei. Wird die maximale Anzahl zulässiger Log-Dateien erreicht, überschreibt MERLIC die ältesten Meldungen. Minimaler Wert: 1 048 576 = 1 MB GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden: „Bearbeiten → Einstellungen → Allgemein → Maximale Größe von Log-Dateien“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
LogFilesCount	10	Diese Eigenschaft definiert die maximale Anzahl von Log-Dateien, die im Log-Dateiverzeichnis gespeichert werden. Wird die maximale Größe aller Log-Dateien erreicht, löscht MERLIC ältere Log-Dateien. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden: „Bearbeiten → Einstellungen → Allgemein → Maximale Anzahl von Log-Dateien“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
Threshold	info	Diese Eigenschaft definiert die verwendete Log-Ebene. Bei der Protokollierung von Meldungen einer bestimmten Ebene werden im Allgemeinen auch alle Meldungen von schwerwiegenderen Ebenen protokolliert. Die folgenden Log-Ebenen sind verfügbar: none: Es werden keine Meldungen protokolliert. critical: Meldungen des Schweregrads „critical“ enthalten Informationen zu Fehlern, die zu einem Absturz von MERLIC führen. error: Meldungen des Schweregrads „error“ enthalten Informationen zu Fehlern, z. B. für MERLIC-Tools. Bei Auswahl dieser Log-Ebene werden auch Meldungen des Schweregrads „critical“ protokolliert. warning: Meldungen des Schweregrads „warning“ enthalten Informationen, die auf ein Problem hinweisen, z. B. in einem MERLIC-Tool. Bei Auswahl dieser Log-Ebene werden auch Meldungen der Schweregrade „critical“ und „error“ protokolliert. info: Meldungen des Schweregrads „info“ enthalten allgemeine unkritische Informationen. Bei Auswahl dieser Log-Ebene werden auch Meldungen der Schweregrade „critical“, „error“ und „warning“ protokolliert. trace: Meldungen des Schweregrads „trace“ enthalten ausführliche Informationen, die u. U. für die Erkennung des Kontexts von Warn- oder Fehlermeldungen nützlich sind. Bei Auswahl dieser Log-Ebene werden auch Meldungen der Schweregrade „critical“, „error“, „warning“ und „info“ protokolliert. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden: „Bearbeiten → Einstellungen → Allgemein → Minimale Log-Ebene“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.

Beispiel

Kopieren

[Logging]
LogFilePath=C:/Users/Public/Documents/Log_Files/
LogFilesCount=5
LogFileSizeInBytes=2097152
Threshold=error

[ProcessIntegration]

Eigenschaft	Standardwert	Beschreibung
DefaultRecipe		Diese Eigenschaft definiert den Index der Rezeptdatei, die automatisch geladen wird, wenn MERLIC mit Prozessintegration, d. h. in der Kommandozeile mit „merlic_rte.exe“ gestartet wird. Ist diese Option nicht definiert, muss das Rezept von der SPS geladen werden. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC RTE Setup konfiguriert werden. Weitere Informationen finden Sie unter Standardrezept festlegen.
InstanceName		Mit dieser Eigenschaft kann der MERLIC RTE-Instanz ein Name zugewiesen werden. Auf diese Weise lässt sich eine MERLIC RTE-Instanz leicht identifizieren, insbesondere wenn mehrere MERLIC RTE-Instanzen ausgeführt werden. Der Instanzname wird außerdem benötigt, wenn ein MERLIC Frontend oder ein MERLIC RTE Setup mit der jeweiligen MERLIC RTE-Instanz verbunden wird. Der angegebene Name wird derzeit auch auf MERLIC Creator-Instanzen angewendet. Der Name kann auf eine beliebige Zeichenkette festgelegt werden. Wenn kein Instanzname festgelegt wird, wird eine UUID-Zeichenkette (Universally Unique Identifier), zum Beispiel 547d1842-3ab2-477f-a430-0b05fe3cb0dc, zufällig generiert, um sicherzustellen, dass die Kennung eindeutig ist. Der Instanzname wird als Teil der ersten Log-Zeile in die reguläre MERLIC-Logdatei geschrieben. Es ist nicht möglich, zwei MERLIC-Instanzen mit demselben Instanznamen unter demselben Benutzerkonto auszuführen. Wenn Sie Instanznamen über die INI-Dateien festlegen möchten, müssen Sie sicherstellen, dass jede MERLIC-Instanz mit einer eigenen INI-Datei gestartet wird und dass sich die in den INI-Dateien definierten Instanznamen unterscheiden. Andernfalls tritt beim Starten der zweiten MERLIC-Instanz ein Fehler auf.
LocalImageStorePath		Mit dieser Eigenschaft können Sie einen benutzerdefinierten Speicherort und Dateinamen für die Datenbank des erweiterten Bildspeichers angeben. Standardmäßig werden die Bilder in einem temporären Ordner auf dem lokalen Datenträger gespeichert. Wenn nicht genügend Speicher auf dem Datenträger vorhanden ist, können Sie mit dieser Eigenschaft einen anderen Speicherort mit genügend Speicher für den Bildspeicher festlegen. Dies gilt nur, wenn der erweiterte Bildspeicher über „UseLocalImageStore“ aktiviert ist. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden: „Bearbeiten → Einstellungen → Prozessintegration → Pfad der Bildspeicherung“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
LocalImageStoreSize	100	Diese Eigenschaft definiert die Anzahl der Bilder, die im erweiterten Bildspeicher zwischengespeichert werden. Dies gilt nur, wenn der erweiterte Bildspeicher über „UseLocalImageStore“ aktiviert ist. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden: „Bearbeiten → Einstellungen → Prozessintegration → Maximale Anzahl Bilder“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
ResultBufferSize	10	Diese Eigenschaft definiert die maximale Anzahl der Ergebnisse, die für die Prozessintegration gespeichert werden. Sie stellt somit die Anzahl der Iterationen dar, für die die Ergebnisse der Ausführung einer MERLIC-Vision-App gespeichert werden können. Wenn die Anzahl die Puffergröße übersteigt, werden die ältesten Ergebnisse verworfen. Das Gleiche gilt für Datenkomponenten, die zusammen mit den Ergebnissen gespeichert werden. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden: „Bearbeiten → Einstellungen → Prozessintegration → Maximale Anzahl an Ergebnissen“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.
RTEStartupISMConfiguration		Mit dieser Eigenschaft kann die ISM-Konfiguration definiert werden, die als RTE-Startkonfiguration verwendet werden soll. Die definierte ISM-Konfiguration wird beim Start des MERLIC RTE automatisch geladen und aktiviert. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Runtime Environment Setup konfiguriert werden: „Bildquellen → Als RTE-Startkonfiguration verwenden“ Weitere Informationen finden Sie unter Grundlegende Begriffe und Konzepte und Hinzufügen von neuen Konfigurationen und Bildquellen.
UseLocalImageStore	false	Diese Eigenschaft definiert, ob ein erweiterter Bildspeicher für MERLIC RTE verwendet wird. Damit kann sichergestellt werden, dass Ergebnisbilder auch dann noch verfügbar sind, wenn die Anzahl der Bilder die Kapazität des In-Memory-Speichers übersteigt, die in „ResultBufferSize“ festgelegt wurde, ab der MERLIC RTE damit beginnt, die ältesten Ergebnisse aus dem In-Memory-Speicher zu entfernen. Um den erweiterten Bildspeicher zu aktivieren, müssen Sie den Wert auf „true“ festlegen. GUI-Einstellung Diese Eigenschaft kann auch im MERLIC Creator konfiguriert werden: „Bearbeiten → Einstellungen → Prozessintegration → Erweitern der Speicherung von Bildern auf Festplatte“ Weitere Informationen finden Sie unter MERLIC-Eigenschaften.

Optionale Eigenschaften

Eigenschaft	Beschreibung
Device<n>	Diese Eigenschaft speichert das auf der Registerkarte „I/O“ des MERLIC RTE Setups festgelegte Gerät, das für die Kommunikation mit der SPS verwendet wird.
DeviceSettingsMetadata<n>	Diese Eigenschaft speichert weitere Informationen zur konfigurierten Hardware. Diese Informationen werden verwendet, damit das Gerät in der grafischen Benutzeroberfläche korrekt angezeigt wird, wenn die Hardware nicht angeschlossen ist.
Recipe<n>	Diese Eigenschaft speichert den Namen und den absoluten Pfad der MERLIC-Rezeptdateien Ein MERLIC-Rezept stellt eine Datei mit der Endung „.mrcp“ dar, die auf eine bestimmte MERLIC Vision App (MVApp) mit einer bestimmten MVApp-Konfiguration verweist. In MERLIC RTE, dem Prozessintegrationsmodus von MERLIC, werden Rezepte verwendet, um die referenzierte MVApp mit der im Rezept angegebenen Konfiguration zu laden. MERLIC-Rezepte sind nur erforderlich, wenn Sie mehrere vordefinierte MVApp-Parametrisierungen für dieselbe MVApp einrichten oder beim Laden einer MVApp in MERLIC RTE eine bestimmte Aufnahmesequenz aktivieren möchten. (.mrcp) oder der MVApp-Dateien (.mvapp), die für das MERLIC RTE verfügbar sind. Beim Importieren eines Rezepts oder einer MVApp auf der Registerkarte „Rezepte“ des MERLIC RTE Setups werden die entsprechenden Einträge automatisch in die INI-Datei aufgenommen. Hinter der Eigenschaftenkennung „Recipe“ muss eine Indexzahl beginnend bei 0 stehen: „Recipe<n>“. Die Indexzahl entspricht der jeweiligen Rezept-ID. Die Rezept-IDs können auch durch Sortieren der importierten Dateien auf der Registerkarte „Rezepte“ im MERLIC RTE Setup geändert werden. Beispiel Kopieren `[ProcessIntegration] Recipe0=C:/recipes/recipe0.mrcp Recipe1=C:/mvapps/application.mvapp` [ProcessIntegration] Recipe0=C:/recipes/recipe0.mrcp Recipe1=C:/mvapps/application.mvapp Weitere Informationen finden Sie unter MERLIC-Rezeptdateien und MVApps und Rezepte für MERLIC RTE importieren.

Eigenschaft

Beschreibung

Device<n>

Diese Eigenschaft speichert das auf der Registerkarte „I/O“ des MERLIC RTE Setups festgelegte Gerät, das für die Kommunikation mit der SPS verwendet wird.

DeviceSettingsMetadata<n>

Diese Eigenschaft speichert weitere Informationen zur konfigurierten Hardware. Diese Informationen werden verwendet, damit das Gerät in der grafischen Benutzeroberfläche korrekt angezeigt wird, wenn die Hardware nicht angeschlossen ist.

Recipe<n>

Diese Eigenschaft speichert den Namen und den absoluten Pfad der MERLIC-Rezeptdateien Ein MERLIC-Rezept stellt eine Datei mit der Endung „.mrcp“ dar, die auf eine bestimmte MERLIC Vision App (MVApp) mit einer bestimmten MVApp-Konfiguration verweist. In MERLIC RTE, dem Prozessintegrationsmodus von MERLIC, werden Rezepte verwendet, um die referenzierte MVApp mit der im Rezept angegebenen Konfiguration zu laden. MERLIC-Rezepte sind nur erforderlich, wenn Sie mehrere vordefinierte MVApp-Parametrisierungen für dieselbe MVApp einrichten oder beim Laden einer MVApp in MERLIC RTE eine bestimmte Aufnahmesequenz aktivieren möchten. (.mrcp) oder der MVApp-Dateien (.mvapp), die für das MERLIC RTE verfügbar sind. Beim Importieren eines Rezepts oder einer MVApp auf der Registerkarte „Rezepte“ des MERLIC RTE Setups werden die entsprechenden Einträge automatisch in die INI-Datei aufgenommen.

Hinter der Eigenschaftenkennung „Recipe“ muss eine Indexzahl beginnend bei 0 stehen: „Recipe<n>“. Die Indexzahl entspricht der jeweiligen Rezept-ID. Die Rezept-IDs können auch durch Sortieren der importierten Dateien auf der Registerkarte „Rezepte“ im MERLIC RTE Setup geändert werden.

Beispiel

Kopieren

[ProcessIntegration]
Recipe0=C:/recipes/recipe0.mrcp
Recipe1=C:/mvapps/application.mvapp

[ProcessIntegration]

Recipe0=C:/recipes/recipe0.mrcp

Recipe1=C:/mvapps/application.mvapp

Weitere Informationen finden Sie unter MERLIC-Rezeptdateien und MVApps und Rezepte für MERLIC RTE importieren.

[RecentlyWorkedOn]

Dieser Abschnitt enthält eine Liste mit bis zu 10 MVApps, die zuletzt geöffnet wurden. Sie können MVApps im MERLIC Creator über „Datei → Zuletzt geöffnet“ öffnen.

[RTESetup]

Dieser Abschnitt enthält die Einstellungen für das MERLIC Runtime Environment Setup (MERLIC RTE Setup).

Eigenschaft	Standardwert	Beschreibung
Url		Diese Eigenschaft kann verwendet werden, um das MERLIC RTE Setup direkt mit einer bestimmten MERLIC-Instanz auf einem bestimmten System zu verbinden. Beim Starten des MERLIC RTE Setups wird automatisch versucht, eine Verbindung zum entsprechenden System herzustellen, sodass Sie die MERLIC-Instanz nicht manuell über das Dialogfenster „Instanzen auswählen“ auswählen müssen. Sie können die URL für das gewünschte System und die MERLIC-Instanz in den folgenden unterstützten Formaten angeben: ws[s]://<HOST>[:<PORT>]/instances/<INSTANCE_NAME> unix:///<PATH_TO_INSTANCE>/me-<INSTANCE_NAME> Die URL kann auch beim Starten des MERLIC RTE Setups über die Kommandozeile mithilfe der Kommandozeilenoption „‑‑url“ angegeben werden. In diesem Fall wird die URL-Einstellung in der INI-Datei ignoriert, und das MERLIC RTE Setup stellt eine Verbindung zu dem System und der MERLIC-Instanz her, die in der Kommandozeile definiert wurden.
WindowGeometry		Mit dieser Eigenschaft können Position und Größe des MERLIC RTE Setups wie folgt vorgegeben werden: @Rect(x y w h) Die Werte x und y definieren die Position der oberen linken Ecke des MERLIC RTE Setups. Die Werte w und h definieren die Breite und Höhe des MERLIC RTE Setups. Alle Werte müssen in Pixeln angegeben werden. Wenn die „WindowMaximized“-Eigenschaft auf „true“ festgelegt ist, wird das MERLIC RTE Setup im Vollbildmodus geöffnet, und die Einstellung für „WindowGeometry“ wird ignoriert. Beispiel Kopieren `[RTESetup] WindowGeometry=@Rect(1138 224 1361 954)` [RTESetup] WindowGeometry=@Rect(1138 224 1361 954)
WindowMaximized	true	Diese Eigenschaft legt fest, ob das MERLIC RTE Setup-Fenster beim Öffnen maximiert wird. Sie können die folgenden Werte festlegen: true: Das Fenster wird maximiert. false: Das Fenster wird nicht maximiert.

Eigenschaft

Standardwert

Beschreibung

Url

Diese Eigenschaft kann verwendet werden, um das MERLIC RTE Setup direkt mit einer bestimmten MERLIC-Instanz auf einem bestimmten System zu verbinden. Beim Starten des MERLIC RTE Setups wird automatisch versucht, eine Verbindung zum entsprechenden System herzustellen, sodass Sie die MERLIC-Instanz nicht manuell über das Dialogfenster „Instanzen auswählen“ auswählen müssen.

Sie können die URL für das gewünschte System und die MERLIC-Instanz in den folgenden unterstützten Formaten angeben:

ws[s]://<HOST>[:<PORT>]/instances/<INSTANCE_NAME>
unix:///<PATH_TO_INSTANCE>/me-<INSTANCE_NAME>

Die URL kann auch beim Starten des MERLIC RTE Setups über die Kommandozeile mithilfe der Kommandozeilenoption „‑‑url“ angegeben werden. In diesem Fall wird die URL-Einstellung in der INI-Datei ignoriert, und das MERLIC RTE Setup stellt eine Verbindung zu dem System und der MERLIC-Instanz her, die in der Kommandozeile definiert wurden.

WindowGeometry

Mit dieser Eigenschaft können Position und Größe des MERLIC RTE Setups wie folgt vorgegeben werden: @Rect(x y w h)

Die Werte x und y definieren die Position der oberen linken Ecke des MERLIC RTE Setups. Die Werte w und h definieren die Breite und Höhe des MERLIC RTE Setups. Alle Werte müssen in Pixeln angegeben werden. Wenn die „WindowMaximized“-Eigenschaft auf „true“ festgelegt ist, wird das MERLIC RTE Setup im Vollbildmodus geöffnet, und die Einstellung für „WindowGeometry“ wird ignoriert.

Beispiel

Kopieren

[RTESetup]
WindowGeometry=@Rect(1138 224 1361 954)

[RTESetup]

WindowGeometry=@Rect(1138 224 1361 954)

WindowMaximized

true

Diese Eigenschaft legt fest, ob das MERLIC RTE Setup-Fenster beim Öffnen maximiert wird. Sie können die folgenden Werte festlegen:

true: Das Fenster wird maximiert.
false: Das Fenster wird nicht maximiert.

[Server]

Wenn der Server über die Eigenschaft „StartServer“ im Abschnitt [General] aktiviert wird, müssen die Einstellungen für den Server zum Abschnitt [Server] hinzugefügt werden. Die folgenden Einstellungen sind verfügbar:

Eigenschaft	Standardwert	Beschreibung
AnonymizeFrontendLog	false	Mit dieser Eigenschaft kann festgelegt werden, ob die protokollierten Daten zusammen mit den Informationen des Benutzers gespeichert werden, der die Änderungen vorgenommen hat. Bei Einstellung auf „false “ wird auch der Benutzername protokolliert. Bei Einstellung auf „true“ werden die Daten ohne Benutzerinformationen protokolliert.
MaxConnections	10	Diese Eigenschaft legt die maximal zulässige Anzahl gleichzeitig verbundener MERLIC Frontends fest.
WriteLockTimeout	10000 [ms]	Diese Eigenschaft legt die Dauer der Schreibsperre eines MERLIC Frontends fest, die aktiviert wird, wenn die Benutzerinteraktion in einem gleichzeitig verwendeten MERLIC Frontend beendet wurde. Werden mehrere MERLIC Frontends gleichzeitig verwendet und führt ein Benutzer eine Interaktion in einem MERLIC Frontend durch, werden alle anderen MERLIC Frontends gesperrt. Wenn der Benutzer die Interaktion im MERLIC Frontend beendet, wird der Zähler von „WriteLockTimeout“ gestartet. Bei einer weiteren Benutzerinteraktion wird die Schreibberechtigung automatisch erneuert. Wenn in dieser Zeit keine Benutzerinteraktion erfolgt, kann die Berechtigung zum Ändern von Parametern wieder von einem anderen verbundenen MERLIC Frontend angefordert werden.

Veraltete Einstellungen

Die folgenden INI-Eigenschaften für den Abschnitt [Server] sind veraltet und werden nur aus Gründen der Kompatibilität mit früheren MERLIC-Versionen bereitgestellt.

Eigenschaft	Standardwert	Beschreibung
TcpHost		Diese Eigenschaft definiert die lokale IP-Adresse, die der MERLICServer auf Verbindungen von Frontends überwacht. Standardmäßig ist kein Wert festgelegt, sodass der Server alle Netzwerkschnittstellen auf IPv4- und IPv6-Verbindungen überwacht. Bei Einstellung des Hosts auf 0.0.0.0 ist nur IPv4 verfügbar. Bei Einstellung auf localhost oder 127.0.0.1 überwacht der Server nur Verbindungen von lokal ausgeführten Frontends. Diese Option ist veraltet und wird nur für die Verwendung mit MERLIC-Version 26.03 oder älter bereitgestellt. In zukünftigen MERLIC-Versionen wird sie möglicherweise entfernt. Wir empfehlen, die Option „Url“ in der Kategorie „[Frontend]“ zu verwenden, um den gewünschten MERLIC-Server anzugeben, mit dem das MERLIC Frontend eine Verbindung herstellen soll.
TcpPortMax	9099	Diese Eigenschaft bestimmt den höchsten Port eines Portbereichs, den der Server auf Verbindungen von Frontends überwachen soll. Normalerweise überwacht der Server „TcpPortMin“. Falls dieser Port bereits von einer anderen Anwendung verwendet wird, verwendet der MERLIC-Server den nächsten verfügbaren Port im definierten Bereich bis „TcpPortMax“. Wenn Ports nicht automatisch angepasst werden sollen, kann „TcpPortMax“ auf „TcpPortMin“ festgelegt werden. Falls dieser eine Port nicht verfügbar ist, ist keine TCP-Verbindung möglich. Diese Option ist veraltet und wird nur für die Verwendung mit MERLIC-Version 26.03 oder älter bereitgestellt. In zukünftigen MERLIC-Versionen wird sie möglicherweise entfernt. Wir empfehlen, die Option „Url“ in der Kategorie „[Frontend]“ zu verwenden, um den gewünschten MERLIC-Server anzugeben, mit dem das MERLIC Frontend eine Verbindung herstellen soll.
TcpPortMin	9090	Diese Eigenschaft bestimmt den kleinsten Port eines Portbereichs, den der Server auf Verbindungen von Frontends überwachen soll. Normalerweise überwacht der Server „TcpPortMin“. Falls dieser Port bereits von einer anderen Anwendung verwendet wird, verwendet der MERLIC-Server den nächsten verfügbaren Port im definierten Bereich bis „TcpPortMax“. Diese Option ist veraltet und wird nur für die Verwendung mit MERLIC-Version 26.03 oder älter bereitgestellt. In zukünftigen MERLIC-Versionen wird sie möglicherweise entfernt. Wir empfehlen, die Option „Url“ in der Kategorie „[Frontend]“ zu verwenden, um den gewünschten MERLIC-Server anzugeben, mit dem das MERLIC Frontend eine Verbindung herstellen soll.

Eigenschaft

Standardwert

Beschreibung

TcpHost
                                                        

Diese Eigenschaft definiert die lokale IP-Adresse, die der MERLICServer auf Verbindungen von Frontends überwacht. Standardmäßig ist kein Wert festgelegt, sodass der Server alle Netzwerkschnittstellen auf IPv4- und IPv6-Verbindungen überwacht.

Bei Einstellung des Hosts auf 0.0.0.0 ist nur IPv4 verfügbar. Bei Einstellung auf localhost oder 127.0.0.1 überwacht der Server nur Verbindungen von lokal ausgeführten Frontends.

Diese Option ist veraltet und wird nur für die Verwendung mit MERLIC-Version 26.03 oder älter bereitgestellt. In zukünftigen MERLIC-Versionen wird sie möglicherweise entfernt. Wir empfehlen, die Option „Url“ in der Kategorie „[Frontend]“ zu verwenden, um den gewünschten MERLIC-Server anzugeben, mit dem das MERLIC Frontend eine Verbindung herstellen soll.

TcpPortMax
                                                        

9099

Diese Eigenschaft bestimmt den höchsten Port eines Portbereichs, den der Server auf Verbindungen von Frontends überwachen soll. Normalerweise überwacht der Server „TcpPortMin“. Falls dieser Port bereits von einer anderen Anwendung verwendet wird, verwendet der MERLIC-Server den nächsten verfügbaren Port im definierten Bereich bis „TcpPortMax“.
Wenn Ports nicht automatisch angepasst werden sollen, kann „TcpPortMax“ auf „TcpPortMin“ festgelegt werden. Falls dieser eine Port nicht verfügbar ist, ist keine TCP-Verbindung möglich.

TcpPortMin
                                                        

9090

Diese Eigenschaft bestimmt den kleinsten Port eines Portbereichs, den der Server auf Verbindungen von Frontends überwachen soll.

Normalerweise überwacht der Server „TcpPortMin“. Falls dieser Port bereits von einer anderen Anwendung verwendet wird, verwendet der MERLIC-Server den nächsten verfügbaren Port im definierten Bereich bis „TcpPortMax“.

[UserManagement]

Dieser Abschnitt definiert das Aussehen des Benutzerverwaltungsfensters im MERLIC Designer.

Eigenschaft	Standardwert	Beschreibung
SplitterPosition	280	Diese Eigenschaft definiert die Position des Splitter-Steuerelements, das die Listenansicht auf der linken Seite und die Eigenschaftsansicht auf der rechten Seite des MERLIC-Dialogfensters „Benutzerverwaltung“ trennt.
Window	Rect(100 100 1024 768)	Diese Eigenschaft definiert Position und Größe des MERLIC-Dialogfensters „Benutzerverwaltung“.

Weitere Informationen zur Benutzerverwaltung finden Sie unter Benutzerverwaltung einrichten.