Beispielinhalt einer Kameradatei

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 <extra file name>.json, hier als Beispiel benannt: camera_example.json.
Ein Beispiel für solche Einstellungen ist unten gezeigt.

{
    "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.

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/<id>/.... 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.
Nach dem Ändern der Parameter sollte die Anwendung LumiScan CamDriver neu gestartet werden.
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

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 <FEATURENAME> <FEATURE VALUE> 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).