fsMapViewSetWeatherRadarRainColors

This function can be used to set an array of colour structs which will then be used to draw the weather (when enabled). The colour struct at index 0 of the array will be used to colour rainfall from 0mm/h to the rate set for index 0, then the colour at index 1 will be used for rates between index 0 rate and index 1 rate, etc... up to a maximum rate of 100mm/h. 

 

 

Syntax
bool fsMapViewSetWeatherRadarRainColors(
    FsContext ctx,
    FsTextureId id,
    FsRainRateColor* colors,
    unsigned nColors
    )

 

 

Members
Parameters Description
ctx A value of type FsContext provided as an argument of the gauge callback.
id The MapView render ID as returned by the function fsMapViewCreate.
colors An array containing a minimum of 2 structs - comprised of an FsColor struct and a rate value (in mm/hour) - up to a maximum of 128 structs.
nColors The total size of the colour array.

 

 

Return Values

Returns false if:

  • nColors < 2 or if nColors > 128
  • no texture matches the given MapView ID
  • the ctx is invalid

Otherwise it will return true.

 

 

Remarks

The colors array is made up of at least 2 FsColor structs and would be created and used as shown in the following example:

const int size = 4;

FsRainRateColor colors[size] =

{

{{ 1.f, 0.7f, 0.25f, 0.1f }, 0.2f},

{{ 0.7f, 0.2f, 0.63f, 0.88f }, 10.f},

{{ 0.8f, 0.3f, 0.7f, 0.62f }, 50.f},

{{ 0.f, 0.9f, 1.f, 1.f } 100.f}

}  

fsMapViewSetWeatherRadarRainColors(ctx, mapID, colors, size);

 

 

See Also