> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/german/function-blocks/detections-shapes/detectors/measure-object-distance.md).

# Measure Object Distance

Dieser Funktionsblock misst den Abstand zwischen zwei Objekten in einem gegebenen Bild. Mit diesem Block können Benutzer genaue Messwerte des Abstands zwischen bestimmten Vorlagen innerhalb eines Referenzbildes erhalten.

## 📥 Eingänge <a href="#inputs" id="inputs"></a>

`Main Image` Das Hauptbild, das die Objekte enthält, deren Abstand gemessen werden soll.

`1st Object Image` Das Vorlagenbild des ersten Objekts.

`2nd Object Image` Das Vorlagenbild des zweiten Objekts.

## 📤 Ausgänge <a href="#outputs" id="outputs"></a>

`Image Any` Die Ausgabe zeigt das Hauptbild mit den markierten Objekten zur Messung.

`Distance` Der berechnete Abstand zwischen den beiden Objekten in den angegebenen Einheiten.

`X Distance` Der horizontale Abstand zwischen den beiden Objekten.

`Y Distance` Der vertikale Abstand zwischen den beiden Objekten.

## 🕹️ Steuerungen <a href="#controls" id="controls"></a>

`Measure Factor` Ein Eingabefeld, in dem Sie einen Fließkomma-Messfaktor angeben können. Dieser bestimmt die Skalierung der Messungen.

`Measured Distance` Ein Label, das den berechneten Abstand zwischen den beiden angegebenen Objekten anzeigt.

`Image Holder` Dieser Bereich zeigt das modifizierte Hauptbild mit den hervorgehobenen gemessenen Objekten visuell an.

## 🎨 Funktionen <a href="#features" id="features"></a>

`Distance Measurement` Misst direkt die Abstände zwischen zwei Objekten innerhalb eines Bildes mithilfe von Vorlagen.

`Customizable Measure Factor` Benutzer können die Genauigkeit der Messungen über den Messfaktor anpassen, was Flexibilität je nach Anwendungsbedarf ermöglicht.

`Visual Feedback` Das Ausgabebild hilft, die Messung visuell zu validieren.

## 📝 Nutzungshinweise <a href="#usage" id="usage"></a>

1. **Input Images**: Verbinden Sie Ihr Hauptbild mit dem Eingangsbereich `Main Image` und verbinden Sie die Vorlagen für das erste und zweite Objekt mit ihren jeweiligen Eingängen.
2. **Set Measure Factor**: Geben Sie den gewünschten Messfaktor im Feld `Measure Factor` ein. Dieser Faktor wird verwendet, um den gemessenen Abstand zu skalieren.
3. **Calculate Distance**: Wenn der Block ausgewertet wird, werden die Abstände berechnet und die Ergebnisse werden in der Ausgabe angezeigt.

## 📊 Bewertung <a href="#evaluation" id="evaluation"></a>

Wenn der Block ausgeführt wird, gibt er das modifizierte Hauptbild zusammen mit den berechneten Abständen zwischen den beiden angegebenen Objekten aus.

## 💡 Tipps und Tricks <a href="#tips-and-tricks" id="tips-and-tricks"></a>

<details>

<summary>Genauigkeit verbessern</summary>

Stellen Sie sicher, dass beide Objektvorlagen so klar und deutlich wie möglich vom Hintergrund unterschieden werden, um die Erkennungsgenauigkeit zu verbessern.

</details>

<details>

<summary>Messfaktoreinstellungen</summary>

Passen Sie den `Measure Factor` anhand des Maßstabes des Bildes an. Ein näher an <mark style="color:yellow;">1.0</mark> gelegener Faktor eignet sich für tatsächliche Messungen, während niedrigere Werte für größere Bilder verwendet werden können.

</details>

<details>

<summary>Vorverarbeitungsblöcke verwenden</summary>

Bevor Sie Ihr Hauptbild in diesen Block einfüttern, ziehen Sie in Betracht, Vorverarbeitungsblöcke wie `Image Threshold` zu verwenden, um einen einheitlicheren Hintergrund für eine bessere Objekterkennung zu schaffen.

</details>

## 🛠️ Fehlersuche <a href="#troubleshooting" id="troubleshooting"></a>

<details>

<summary>Abstand wird nicht berechnet</summary>

Wenn Abstände nicht berechnet werden, überprüfen Sie, ob beide Objektvorlagen korrekt verbunden und im Hauptbild deutlich zu erkennen sind. Stellen Sie sicher, dass die Bilder korrekt formatiert sind, um die erwarteten Eingaben darzustellen.

</details>

<details>

<summary>Fehlerhafte Messungen</summary>

Wenn die Messungen falsch erscheinen, überprüfen Sie die Genauigkeit Ihres Messfaktors. Passen Sie ihn entsprechend dem spezifischen Maßstab Ihrer Bilder an, um korrekte Berechnungen zu gewährleisten.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.augelab.com/german/function-blocks/detections-shapes/detectors/measure-object-distance.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.