---
title: "Kameraeinstellungen"
description: "Kameraeinstellungen in LumiScan VGR - JSON-Abschnitt cameras mit Kamerakennung, Belichtungssteuerung, Tiefenschätzung und Korrekturen der Kameradaten."
product: "LumiScan VGR"
component: "lumiscan-vgr-de"
version: "1.8.4"
display_version: "1.8.4.8"
latest_version: true
language: "de"
url: "https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/json-settings/cameras.html"
---

# Kameraeinstellungen – LumiScan VGR

Der Abschnitt `cameras` definiert die physischen LumiScan-Kameras, die vom Projekt verwendet werden, sowie die Einstellungen, die zur Aufnahme kalibrierter Bild- und Tiefeninformationen erforderlich sind.

Zu diesen Einstellungen gehören die Kamerakennung, die Belichtungssteuerung, die Tiefenschätzung sowie Korrekturen, die auf die Kameradaten angewendet werden.

## Kameraparameter

- [CameraSettings](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/api/settings/camera-settings.html)
  - [AutoexposureSettings](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/api/settings/autoexposure-settings.html)
  - [DepthEstimationSettings](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/api/settings/depth-estimation-settings.html)
  - [CorrectionSettingsBase](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/api/settings/correction-settings-base.html)
    - [CorrectionSettings](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/api/settings/correction-settings.html)
    - [CorrectionFeature](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/api/settings/correction-feature.html)
    - [Cloud-Scale-Korrektur](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/api/settings/correction-settings-camera-correction-type-cloud-scale.html)
    - [Cloud-Z-Kalibrierung](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/api/settings/correction-settings-camera-correction-type-cloud-z-calibration.html)
      - [Bild-Distanz-Paar](https://docs.hdvisionsystems.com/de/lumiscan-vgr-de/api/settings/correction-settings-camera-correction-type-cloud-z-calibration-imagedistancepair.html)

## Einheit der Punktwolke {#point-cloud-unit}

*Ab v2.0.0.*

Die Koordinaten der Punktwolke einer Kamera tragen keine eigene Einheit. LumiScan VGR ermittelt die Einheit daher in dieser Reihenfolge; der erste Treffer gilt:

1. **Eine Aufnahme, die abgespielt wird** (eine dateibasierte Kamera, z. B. mit `--simulate-camera`), gibt ihre Einheit selbst in der Datei `dataset.unit.json` ihres Ordners an. Ein Ordner ohne diese Datei wird anhand seiner ersten Punktwolke beurteilt: Eine mittlere Tiefe (Median) unter 20 wird als Meter gelesen, darüber als Millimeter, mit einer Warnung, die die zu schreibende Datei nennt. Zentimeter lassen sich an der Tiefe nicht erkennen und benötigen daher die Datei. Die `distanceUnit` der Live-Kamera wird für eine abgespielte Kamera nicht verwendet.
2. `cameraParameters[].distanceUnit` in den Projekteinstellungen, nach `cameraId`: die Live-Kamera.
3. Das Feature `HDVPointcloudUnit` der Kamera: die Einheit der Punktwolke, die die Kamerabibliothek liefert. Die Kamera-Plugins für Ensenso, RealSense, Pepperl+Fuchs und LumiScan geben sie an, ebenso die Kamerabibliothek für die GenTL-Kameras, die sie nach Hersteller und Modell kennt (Teledyne e2v Camera5d: Zentimeter, Ensenso: Millimeter). Eine bekannte Kamera benötigt daher keine Einstellung.
4. Das GenICam-Feature `Scan3dDistanceUnit` der Kamera. Ihm wird nicht mehr vertraut als dem vorherigen: Eine Teledyne-Kamera gibt Millimeter an und liefert Zentimeter.
5. Meter, als letzte Möglichkeit, mit einer Warnung, die die Kamera nennt.

**LumiScan VGR speichert eine Punktwolke in der Einheit, die ihre Kamera liefert**, und rechnet nur intern in Meter um. Wenn es die erste Punktwolke in einen Ordner ohne `dataset.unit.json` speichert, schreibt es diese Datei und ändert sie danach nie; es warnt, wenn eine spätere Punktwolke eine andere Einheit hat. Eine Aufnahme ist daher das, was die Kamera geliefert hat, und eine Wiedergabe durchläuft denselben Weg wie eine Live-Aufnahme. Die Datei sieht so aus:

```json
{ "unit": "MILLIMETER" }
```

`unit` ist der einzige Pflichtschlüssel: `METER`, `CENTIMETER`, `MILLIMETER` oder `INCH`, in beliebiger Groß-/Kleinschreibung. Für einen Maßstab ohne Einheitenname kann stattdessen `metresPerUnit` angegeben werden.

Die Live-Einheit ist das Einzige, was ein Projekt angeben muss, und nur für eine Kamera, die sie nicht selbst angeben kann und die die Kamerabibliothek nicht kennt, z. B. eine einfache GenICam-Kamera eines anderen Herstellers. Ein Eintrag für eine bekannte Kamera ist nicht nötig. Weicht er von der Angabe der Kamera ab, wird der Eintrag verwendet, mit einer Warnung, denn so bemerkt ein in Betrieb genommenes System, dass sich sein Kamera-Plugin geändert hat:

```json
"cameraParameters": [
    { "cameraId": "camera-teledyne", "distanceUnit": "CENTIMETER" }
]
```

- Ein Ordner ist die Aufnahme einer Kamera, und seine `dataset.unit.json` gibt die Einheit des ganzen Ordners an. Bewahren Sie Aufnahmen in verschiedenen Einheiten in getrennten Ordnern auf.
- Für Aufnahmen, die nicht von LumiScan VGR stammen oder die eine ältere Version in Metern ohne Einheitendatei erstellt hat, legen Sie eine `dataset.unit.json` in ihren Ordner, z. B. `{"unit": "METER"}`.
- Ein Werkzeug, das die exportierten Punktwolken liest und Meter erwartet, muss `dataset.unit.json` lesen und mit den Metern pro Einheit multiplizieren (Millimeter 0,001, Zentimeter 0,01, Zoll 0,0254).
- Die Einheit einer Aufnahme ist nur so richtig wie die Einheit, die LumiScan VGR bei der Aufnahme ermittelt hat. Die Datei hält fest, was angewendet wurde, sodass eine Wiedergabe die Live-Aufnahme reproduziert, ob richtig oder falsch.

> [!TIP]
> Eine falsche Einheit erzeugt keine sichtbar falsche Punktwolke, sondern **keine** Punktwolke: Eine metrische Punktwolke, die wie Zentimeter skaliert wird, fällt in einem einzigen Kollisionsvoxel zusammen und verschwindet. In diesem Fall protokolliert LumiScan VGR die gemessene mittlere Tiefe und nennt die Einheit, die sie wieder in den gültigen Bereich bringt.