1 # Copyright (c) 2018, NVIDIA CORPORATION. All rights reserved.
3 @page dwx_tools_extractlraw LRAW Preview Extraction Tool
6 This tool is available on the x86 Host System and NVIDIA DRIVE<sup>™</sup> OS Linux.
8 The NVIDIA<sup>®</sup> DriveWorks LRAW Preview Extract tool extracts the
9 encoded H.264 lossy preview data in lraw2.0 file and outputs to a file.
11 Every thirtieth frame (1 FPS) in an LRAW2.0 file contains
12 lossy encoded Preview data.
13 This data can be used for quick preview of contents.
14 LRAW2.0 file format defines these encoding types:
15 - Lossless compression of Raw RCCB camera input using h264 Lossless Hi444 Profile(244).
16 This is decompressed and played out by all sample applications like `sample_camera_replay`.
17 - Lossy compression of YUV420 preview frame provided by camera, downscaled to 720p and compressed in h264 lossy mode.
18 We encode 1 in 30 preview frames and embed it in .lraw file for quick preview.
19 This utility extractLRawPreview, parses the lraw file and extracts the embedded preview data in that and dumps it to a file,
20 so it can be decoded offline and seen through any h264 player.
22 @note SW Release Applicability: This tool is available in both <b>NVIDIA DriveWorks</b> and <b>NVIDIA DRIVE Software</b> releases.
24 @section dwx_tools_extractLRawPreview_arguments Input Arguments
26 This tool supports following arguments:
28 --inputfile=<input.lraw file> The fullpath of the input lraw recording in LRAW V2 format.
29 --outputfile=<outputfile.h264> The fullpath of the output preview data in h264 format.
31 @section dwx_tools_extractLRawPreview_running Running the Tool
33 The usage is `./extractLRawPreview`, for which the preview data is extracted from the provided LRAW input.
35 ./extractLRawPreview --inputfile=<input.lraw file> --outputfile=<outputfile.h264>