Registratore di Azure Kinect DK
Questo articolo illustra come usare l'utilità della k4arecorder
riga di comando per registrare i flussi di dati da Sensor SDK in un file.
Nota
Il registratore di Azure Kinect non registra l'audio.
Opzioni di registrazione
Il k4arecorder
include vari argomenti della riga di comando per specificare il file di output e le modalità di registrazione.
Le registrazioni vengono archiviate nel formato Matroska .mkv. La registrazione usa più tracce video per colore e profondità, oltre a informazioni aggiuntive come la calibrazione e i metadati della fotocamera.
k4arecorder [options] output.mkv
Options:
-h, --help Prints this help
--list List the currently connected K4A devices
--device Specify the device index to use (default: 0)
-l, --record-length Limit the recording to N seconds (default: infinite)
-c, --color-mode Set the color sensor mode (default: 1080p), Available options:
3072p, 2160p, 1536p, 1440p, 1080p, 720p, 720p_NV12, 720p_YUY2, OFF
-d, --depth-mode Set the depth sensor mode (default: NFOV_UNBINNED), Available options:
NFOV_2X2BINNED, NFOV_UNBINNED, WFOV_2X2BINNED, WFOV_UNBINNED, PASSIVE_IR, OFF
--depth-delay Set the time offset between color and depth frames in microseconds (default: 0)
A negative value means depth frames will arrive before color frames.
The delay must be less than 1 frame period.
-r, --rate Set the camera frame rate in Frames per Second
Default is the maximum rate supported by the camera modes.
Available options: 30, 15, 5
--imu Set the IMU recording mode (ON, OFF, default: ON)
--external-sync Set the external sync mode (Master, Subordinate, Standalone default: Standalone)
--sync-delay Set the external sync delay off the master camera in microseconds (default: 0)
This setting is only valid if the camera is in Subordinate mode.
-e, --exposure-control Set manual exposure value (-11 to 1) for the RGB camera (default: auto exposure)
Registrare i file
Esempio 1. Registrare con fotocamera di profondità in modalità NFOV senza binning (640x576), RGB 1080p a 30 fps con IMU. Premere i tasti CTRL-C per arrestare la registrazione.
k4arecorder.exe output.mkv
Esempio 2. Registrare in modalità WFOV senza binning (1MP), RGB 3072p a 15 fps senza IMU, per 10 secondi.
k4arecorder.exe -d WFOV_UNBINNED -c 3072p -r 15 -l 10 --imu OFF output.mkv
Esempio 3. Registrare in modalità WFOV 2x2 con binning a 30 fps per 5 secondi e salvare come output.mkv.
k4arecorder.exe -d WFOV_2X2BINNED -c OFF --imu OFF -l 5 output.mkv
Suggerimento
È possibile usare Azure Kinect Viewer per configurare i controlli della fotocamera RGB prima della registrazione (ad esempio per impostare il bilanciamento del bianco manuale).
Verificare la registrazione
È possibile aprire il file di output con estensione .mkv con Azure Kinect Viewer.
Per estrarre tracce o visualizzare le informazioni sul file, sono disponibili strumenti come mkvinfo
inclusi nel kit di strumenti MKVToolNix .