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 mkvinfoinclusi nel kit di strumenti MKVToolNix .

Passaggi successivi

Uso del registratore con unità a sincronizzazione esterna