Bild zuschneiden

Mit diesem Tool können Sie Bilder auf einen Bildbereich zuschneiden, der durch eine ROI festgelegt wird. Dazu benötigt das Tool eine rechteckige ROI, die den gewünschten Bildbereich definiert, der zugeschnitten werden soll.

Sie können die erforderliche rechteckige ROI mit einer beliebigen Orientierung im Bild speichern oder den Parameter „ROI“ mit einem entsprechenden ROI-Ergebnis eines vorherigen Tools verbinden und diese ROI für den Zuschnitt verwenden. Im Grafikfenster des Tools werden das Eingabebild und die mögliche ROI (sofern verwendet) angezeigt. Das zugeschnittene Bild wird automatisch in allen nachfolgenden Tools verwendet.

Parameter

Standardparameter

Bild:

Dieser Parameter stellt das Eingabebild dar, das zugeschnitten werden soll. Ist aus dem Ergebnis eines vorherigen Tools ein Bild vorhanden, wird dieses automatisch verbunden und als Eingabebild verwendet.

Bei der Verwendung eines Farbbilds als Eingabebild werden alle Kanäle des Farbbilds für die Verarbeitung verwendet.

Zusätzliche Parameter

ROI:

Dieser Parameter enthält die ROI, die den Bereich des Bildes definiert, der zugeschnitten werden soll. Standardmäßig ist keine ROI definiert und das Bild wird nicht zugeschnitten. Um den Teil des Bildes festzulegen, der zugeschnitten werden soll, müssen Sie den Parameter mit einem geeigneten ROI-Ergebnis eines vorherigen Tools verbinden, damit eine ROI an dieses Tool übergeben wird, oder mit den verfügbaren ROI-Schaltflächen eine ROI im Bild zeichnen.

Wird eine gedrehte ROI verwendet, um den Bildbereich zu definieren, der zugeschnitten werden soll, wird das resultierende Bild als achsparalleles Bild ausgegeben.

Mit diesem Tool kann nur eine einzige ROI verwendet werden. Enthält der Parameter mehrere ROIs, entweder durch eine Verbindung von einem vorherigen Tool oder durch das Zeichnen mehrerer ROIs mit den ROI-Schaltflächen, wird nur die zuletzt erstellte ROI für den Zuschnitt verwendet.

Ausrichtungsdaten:

Dieser Parameter stellt die Ausrichtungsdaten dar, die zum Ausrichten der ROI verwendet werden. Ausrichtungsdaten sind standardmäßig nicht verbunden, sodass keine Auswirkung sichtbar ist. Wenn Sie bestimmte Ausrichtungsdaten verwenden möchten, müssen Sie den Parameter mit einem geeigneten Ergebnis eines vorherigen Tools verbinden, z. B. Ausrichtungsdaten mit Matching bestimmen, Ausrichtungsdaten mittels geradem Rand bestimmen, Bild ausrichten oder Bild drehen.

Ergebnisse

Standardergebnisse

Bildausschnitt:

Dieses Ergebnis gibt den zugeschnittenen Bildbereich aus, der durch die ROI festgelegt wurde.

Toolstatus:

„Toolstatus“ gibt Informationen zum Status des Tools aus und kann daher für die Fehlerbehandlung verwendet werden. Weitere Informationen zu den verschiedenen Toolstatus-Ergebnissen finden Sie unter Toolstatus-Ergebnis.

Zusätzliche Ergebnisse

Verarbeitungszeit:

Dieses Ergebnis gibt die Dauer der letzten Ausführung des Tools in Millisekunden aus. Das Ergebnis wird als zusätzliches Ergebnis bereitgestellt. Es ist daher standardmäßig ausgeblendet, kann aber über die Schaltfläche neben den Toolergebnissen angezeigt werden. Weitere Informationen finden Sie im Abschnitt Verarbeitungszeit in der Tool-Referenz-Übersicht.

Anwendungsbeispiele

Dieses Tool wird in den folgenden MERLIC-Vision-App-Beispielen verwendet:

• check_correct_filling_on_3d_height_images.mvapp