LidarColorize
=============

.. currentmodule:: globalmapper
.. py:function:: LidarColorize (GM_LayerHandle_t32 aLidarLayer, [GM_LayerHandle_t32] aLayerList, GM_LidarColorizeSetup_t aSetup, uint32 aReserved=0) -> GM_Error_t32

    Adds/updates the color or intensity fields of Lidar data from loaded image data.

    :param GM_LayerHandle_t32 aLidarLayer: Lidar layer to apply color/intensity to.
    :param [GM_LayerHandle_t32] aLayerList: List of loaded image layers to get the color from.
    :param GM_LidarColorizeSetup_t aSetup: Setup options for colorizing operation.
    :param uint32 aReserved: Reserved for future use; defaults to 0
    :returns: Error Code
    :rtype: GM_Error_t32

|

.. note::
    "Color by RGB/Elev" must be selected from the Lidar Draw Mode dropdown list to see the 
    result in Global Mapper.

.. list-table::
    :width: 100%
    :class: borderless
    :header-rows: 1

    * - BEFORE
      - AFTER

    * - .. image:: ../images/BeforeAfter_Images/RGBLidar.png
            :width: 400px
            :height: 400px
            :align: center

      - .. image:: ../images/BeforeAfter_Images/ColorizeLidar.png
            :width: 400px
            :height: 400px
            :align: center

| 

Example
-------
The following is an example of LidarColorize.::

    gm.LidarColorize(layers_list[0], img_list, gm.GM_LidarColorizeSetup_t(), 0)

For more context refer to :doc:`the lidar sample scripts<../sampleCode/DemoLidar>`.