--- title: "Beispielinhalt einer Kameradatei" product: "LumiScan Cam Driver" component: "lumiscan-cam-driver-de" version: "2.2.1" display_version: "2.2.1.10" latest_version: true language: "de" url: "https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/camera-example-file-content-example.html" --- # Beispielinhalt einer Kameradatei – LumiScan Cam Driver > [!NOTE] > Die Kameraparameter können überschrieben werden, indem die entsprechenden Parameter im Pfad `…/input/` auf dem Data Layer gesetzt werden. Die Einstellungen für eine bestimmte Kamera befinden sich in der **`.json`**, hier als Beispiel benannt: **`camera_example.json`**.\ Ein Beispiel für solche Einstellungen ist unten gezeigt. ```json { "meta": { "inputFileType": "camera-configuration", "inputFileVersion": "0.0.1", "targetMachine": "CtrlX7", "programName": "lumiscan-cam-driver", "programVersion": "1.0.0" }, "id": "camera1", "serial": "LX123456", "exposureTimeUS": 4321, "pixelFormat": "RGB8" } ``` Die Beschreibung aller oben genannten Parameter finden Sie in der [Tabelle 7: Beschreibung der JSON-Einstellungen der Beispielkamera](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/camera-example-file-content-example.html#). **Tabelle 1. Tabelle 7: Beschreibung der JSON-Einstellungen der Beispielkamera** | Parameter | Beschreibung | | --- | --- | | meta | Ort für Metainformationen: inputFileType und inputFileVersion sind erforderlich. | | inputFileType | In diesem Fall muss er lauten: `camera-configuration` | | inputFileVersion | Derzeit wird nur Version 0.0.1 unterstützt. | | targetMachine | Optional. Tragen Sie hier den Namen der verwendeten Maschine ein, um anzuzeigen, dass die aktuelle Anwendungskonfiguration für diese Maschine verwendet wird. | | programName | Optional. Dieser Parameter gibt an, von welcher Anwendung die aktuelle Datei verwendet wird. In diesem Fall: `lumiscan-cam-driver` | | programVersion | Optional. Aktuell verwendete Programmversion. | | id | Dies ist die ID der aktuellen Kameraeinstellung.
Sie muss über alle Kameraeinstellungen hinweg **eindeutig** sein.

Sie ist der Name des Moduls auf dem Data Layer: `hdvisionsystems/lumiscan-cam-driver//...`. Erlaubt sind nur Kleinbuchstaben, Ziffern, `-` und `_`. Ein Modul, dessen ID einen Großbuchstaben oder ein anderes Zeichen enthält, wird nicht geladen; das Protokoll nennt die ID, die stattdessen zu schreiben ist (`Camera1` → `camera1`).

Ob die Kamera simuliert wird, hängt von ihrer Seriennummer ab (eine, die `simulation` enthält), nicht von dieser ID. | | serial | Seriennummer der Kamera. | | exposureTimeUS | Belichtungszeit in Mikrosekunden. | | pixelFormat | Pixelformat des Bildes; mögliche Werte sind: RGB8, Mono8. | | timestampSource | Quelle des Zeitstempels für jeden Frame. **Camera** verwendet den Zeitstempel der Kamera-Hardware, **System** die Systemuhr des Geräts, auf dem der Cam Driver läuft (ctrlX CORE oder PC). | | stream.tag | Optional, experimentell. Das Tag auf den Bildern des Bild-Streams des Moduls; leer oder weggelassen: die Modul-ID. `control/publish/execute` speichert es hier, wenn es sich ändert. Siehe [Das Tag](https://docs.hdvisionsystems.com/de/lumiscan-cam-driver-de/2.2.1/lumiscan-camdriver/streaming-images.html#tag). | > [!NOTE] > Nach dem Ändern der Parameter sollte die Anwendung LumiScan CamDriver neu gestartet werden. > [!NOTE] > Auf ctrlX OS können Sie die neue Datei auch später umbenennen, indem Sie auf die drei Punkte rechts neben dem Namen klicken und in der aufgeklappten Liste **Rename** wählen. ## Vollständige Referenz {#complete-reference} Alle Einstellungen dieser Datei, wie sie ihr JSON-Schema `lumiscan-cam-driver-module.schema.json` festlegt, erzeugt für Version 2.2.1 (Beschreibungen aus dem Schema, auf Englisch): | Einstellung | Typ | Standard | Zulässige Werte | Beschreibung | | --- | --- | --- | --- | --- | | `meta` | object | | | **Pflichtangabe.** | | `meta/inputFileType` | string | | nicht leer | **Pflichtangabe.** | | `meta/inputFileVersion` | string | | nicht leer | **Pflichtangabe.** | | `meta/targetMachine` | string | | nicht leer | **Pflichtangabe.** | | `meta/programName` | string | | nicht leer | **Pflichtangabe.** | | `meta/programVersion` | string | | nicht leer | **Pflichtangabe.** | | `id` | string | | Muster `^[a-zA-Z0-9_-]+$` | **Pflichtangabe.** only [a-Z], [0-9], '-' and '\_' are allowed. Unique ID of the camera configuration. This is used to identify different camera on datalayer. | | `serial` | string | `simulation` | nicht leer | **Pflichtangabe.** Serial number of the camera. Special serial 'simulation' is used for testing without camera. This is used as default value in setting. And storage setup is required to be able to load image for simulation. | | `exposureTimeUS` | number | `10000` | 500 … 2000000 | **Pflichtangabe.** Exposure time in microseconds. This is used as default value on datalayer and can be overwriten by the user. | | `pixelFormat` | string | | `Mono8`, `RGB8`, `BGR8`, `Mono12`, `RGB12`, `BGR12`, `BayerGR8`, `BayerRG8` | **Pflichtangabe.** Pixel format of the camera. Use bayer format if the camera support color and faster frame rate is required. This is used as default value on datalayer and can be overwriten by the user. | | `exportPixelFormat` | string | | `Mono8`, `RGB8`, `BGR8`, `Mono12`, `RGB12`, `BGR12` | Pixel format of the exported image. This is used as default value on datalayer and can be overwriten by the user. | | `packetSize` | number | `1496` | 576 … 9000 | Size of the packet in bytes, must be multiple of 8. Please confirm it matches the configured MTU of the network. Default is 1496 bytes. This is used as default value on datalayer and can be overwriten by the user. It is only writeable only before camera is connected. | | `packetDelay_us` | number | `0` | 0 … 12449 | Delay between packets in microseconds. Default is 0 microseconds. Increase it if image is corrupted or faild to capture image. This is used as default value on datalayer and can be overwriten by the user. | | `timeout_ms` | number | `2000` | 100 … 10000 | Timeout in milliseconds. Default is 2000 milliseconds. How long to wait for the image to be captured before giving up. This is used as default value on datalayer and can be overwriten by the user. | | `initialFeatureFile` | string | | | path to feature file with \ \ pairs. These values will be set after connect to camera. | | `timestampSource` | string | `Camera` | `Camera`, `System` | Source of the timestamp for each frame. 'Camera' uses the timestamp provided by the camera hardware, while 'System' uses the system clock of the ctrlX. | | `clearBufferBeforeCapture` | boolean | `false` | | If true, the buffer will be cleared before capture, this is useful when the camera is running in continuous mode and we want to get the latest image. | | `driverId` | string | `default` | nicht leer | Id of a GenTL driver defined in the app settings 'cameraDrivers' array. Defaults to 'default' (the built-in Baumer producer). |