globalmapper.SetRasterDisplayOptions
====================================

.. currentmodule:: globalmapper
.. py:function:: SetRasterDisplayOptions (GM_LayerHandle_t32 aLayer, GM_RasterDisplayOptions_t aOptions) -> GM_Error_t32

    Sets the options to use when displaying the given raster layer. This includes things like the translucency and
    transparency (if any) of the layer, the color intensity of the layer, and whether or not to crop the collar of the
    layer.

    Typically you will want to first call the :doc:`GetRasterDisplayOptions<globalmapper.GetRasterDisplayOptions>`
    function for a layer to retrieve the current display options, then modify the options that you want to change, then
    call :doc:`SetRasterDisplayOptions<globalmapper.SetRasterDisplayOptions>` to change the options. This will prevent
    you from inadvertently changing an option that you didn't mean to change.

    :param GM_LayerHandle_t32 aLayer: layer to set options for
    :param GM_RasterDisplayOptions_t aOptions: display options for raster layer
    :returns: Error Code
    :rtype: GM_Error_t32