/dvs/git/dirty/gitlab-master_av/dw/sdk/tools/maps/maptool_dw_maps_to_kml/README-maptool_dw_maps_to_kml.md

Go to the documentation of this file.

# Copyright (c) 2019-2020, NVIDIA CORPORATION.  All rights reserved.

@page dwx_maptool_dw_maps_to_kml DriveWorks Maps to KML Converter Tool
@tableofcontents

@section dwx_map_klm_description Description

The NVIDIA<sup>&reg;</sup> DriveWorks Maps to KML Converter tool converts a DriveWorks Map file to a KML file.<br>
The KML file is suitable for viewing in applications such as Google Earth.

@note SW Release Applicability: This tool is available in <b>NVIDIA DRIVE Software</b> releases.

@section dwx_map_klm_prerequisites Prerequisites

This tool is available on the x86 Host System.

This tool creates output files that are placed into the current working directory by default. Please ensure the following for your convenience:
- Write permissions are enabled for the current working directory.
- Include the tools folder in the binary search path of the system.
- Execute from your home directory.

@section dwx_map_klm_usage Running the Tool

Run the tool by executing:

    ./maptool_dw_maps_to_kml --input_file=input.bin
                             --output_file=output.kml
                             [--absolute_height]
                             [--convert_unknown_colors]
                             [--ignore_hd_compliance]
                             [--low_alpha]

@subsection dwx_map_klm_params Parameters 

    --input_file=[path to input file]
            Description: The input DriveWorks Maps filename.
            Default value: input.bin

    --output_file=[path to output file]
            Description: The output KML filename.
            Default value: output.kml

    --absolute_height
            Description: If specified, uses absolute height instead of clamping to ground.
                         This parameter is optional.

    --convert_unknown_colors
            Description: If specified, converts unknown colored lane boundaries as white lane boundaries.
                         This parameter is optional.

    --ignore_hd_compliance
            Description: If specified, ignores HD compliance and white lane boundaries, using shades of green instead.
                         This parameter is optional.

    --low_alpha
            Description: If specified, displays dashed lane boundaries with more transparency.
                         This parameter is optional.

@section maps_to_kml_example Examples

@subsection maps_to_kml_example_ignoreHD Ignoring HD Compliance using Shades of Green

    ./maptool_dw_maps_to_kml --input_file=input.bin
                             --output_file=output.kml
                             --ignore_hd_compliance

@subsection maps_to_kml_example_white Converting Unknown Colored Lane Boundaries to White with more Transparency

    ./maptool_dw_maps_to_kml --input_file=input.bin
                             --output_file=output.kml
                             --convert_unknown_colors
                             --low_alpha