<!-- ##### SECTION Title ##### -->
toolShade

<!-- ##### SECTION Short_Description ##### -->
Shades are color gradients.

<!-- ##### SECTION Long_Description ##### -->
<para>
This module allow V_Sim to deal with color gradients. Such a gradient is defined by a linear transformation of color space. This space can be RBG or HSV (see the enum #ShadeColorMode). This linear transformation can be written [resulting color vector] = [vectB] + lambda.[vectA], where lambda denotes the input variable of the gradient (ranging from 0 to 1). Resulting color vector are clamped to [0;1] if needed. A boolean vector [vectX] can specify which color canal can be transformed.
</para>
<para>
Use shadeNew() to create a new shade, giving the arguments as defined above. A shade can be linked to an image to represent it, use shadeSet_pathToImage() to do it.
</para>
<!--<para>
In near future, the code that can discretize the resulting color gradient will be imported here from dataFile.c and could then be shared between other modules. At present time, each module needs to write it own transformation code after having retrieved the transformation coefficients with shadeGet_colorTransformation().
</para>-->
<para>
To share color gradients between modules in V_Sim, you can add new shade to the global list of stored shades using toolShadeListAppend() and get this list with a call to toolShadeListGet().
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### ENUM ShadeColorMode ##### -->
<para>

</para>

@shade_colorModeRGB: 
@shade_colorModeHSV: 
@shade_nb_colorMode: 

<!-- ##### STRUCT Shade_struct ##### -->
<para>

</para>


<!-- ##### TYPEDEF Shade ##### -->
<para>

</para>


<!-- ##### FUNCTION shadeNew ##### -->
<para>

</para>

@labelUTF8: 
@vectA: 
@vectB: 
@vectX: 
@colorMode: 
@Returns: 


<!-- ##### FUNCTION shadeGet_colorMode ##### -->
<para>

</para>

@shade: 
@Returns: 


<!-- ##### FUNCTION shadeGet_colorTransformation ##### -->
<para>

</para>

@shade: 
@vectA: 
@vectB: 
@vectX: 
@Returns: 


<!-- ##### FUNCTION shadeGet_label ##### -->
<para>

</para>

@shade: 
@Returns: 


<!-- ##### FUNCTION shadeGet_pathToImage ##### -->
<para>

</para>

@shade: 
@Returns: 


<!-- ##### FUNCTION shadeSet_pathToImage ##### -->
<para>

</para>

@shade: 
@path: 
@Returns: 


<!-- ##### FUNCTION toolShadeListAppend ##### -->
<para>

</para>

@shade: 
@Returns: 


<!-- ##### FUNCTION toolShadeListGet ##### -->
<para>

</para>

@Returns: 


