<!-- ##### SECTION Title ##### -->
dataFile

<!-- ##### SECTION Short_Description ##### -->
Adds a possibility to colorize nodes depending on data read in an input file.

<!-- ##### SECTION Long_Description ##### -->
<para>
With this module, it is possible to colorize nodes depending on data read in an input file. An input file can be associated to a #VisuData object using dataFileSet_file(). Doing this, the rendering is changed and nodes are colorized following a scheme describe later. To turn off colorization without removing the data file (for temporary turn off for instance), use dataFileSet_used().
</para>
<para>
The input file must have the same numbers of uncommented lines as there are nodes in the #VisuData associated with. If less data is given, missing data are treaded as min values data. The input data file can has as much column as desired. The colorization is based on a linear color transformation. This transformation is applied on color channel in RGB mode or in HSV mode. Resulting color is given by : [resulting color vect] = [vectB] + [input data][vectA], where [input data] are input data scaled to [0;1]. It is possible to choose which column multiplies which color channel.
</para>
<para>
Using dataFileApply_hideOnMinValue(), it is possible to hide some nodes depending on given input data. If the @column argument is -1, it unmask all nodes.
</para>
<para>
Using this module stores several #Shade that can be used by other modules after being initialized using dataFileBuild_presetShadeList().
</para>

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

</para>

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


<!-- ##### ENUM DataFileInputScaleId ##### -->
<para>

</para>

@dataFile_normalize: 
@dataFile_minMax: 

<!-- ##### ENUM DataFileColorModeId ##### -->
<para>

</para>

@dataFile_rgb: 
@dataFile_hsv: 

<!-- ##### FUNCTION initDataFileModule ##### -->
<para>

</para>

@Returns: 


<!-- ##### FUNCTION dataFileReDraw ##### -->
<para>

</para>

@data: 


<!-- ##### FUNCTION dataFileSet_used ##### -->
<para>

</para>

@data: 
@val: 
@Returns: 


<!-- ##### FUNCTION dataFileGet_used ##### -->
<para>

</para>

@data: 
@Returns: 


<!-- ##### FUNCTION dataFileSet_file ##### -->
<para>

</para>

@attachedVisuData: 
@filename: 
@message: 
@errors: 
@Returns: 


<!-- ##### FUNCTION dataFileGet_file ##### -->
<para>

</para>

@visuData: 
@Returns: 


<!-- ##### FUNCTION dataFileGet_fileMinMaxFromColumn ##### -->
<para>

</para>

@visuData: 
@minMax: 
@column: 
@Returns: 


<!-- ##### FUNCTION dataFileSet_scaleType ##### -->
<para>

</para>

@visuData: 
@scale: 
@Returns: 


<!-- ##### FUNCTION dataFileGet_scaleType ##### -->
<para>

</para>

@visuData: 
@Returns: 


<!-- ##### FUNCTION dataFileSet_min ##### -->
<para>

</para>

@visuData: 
@min: 
@Returns: 


<!-- ##### FUNCTION dataFileSet_max ##### -->
<para>

</para>

@visuData: 
@max: 
@Returns: 


<!-- ##### FUNCTION dataFileGet_min ##### -->
<para>

</para>

@visuData: 
@Returns: 


<!-- ##### FUNCTION dataFileGet_max ##### -->
<para>

</para>

@visuData: 
@Returns: 


<!-- ##### FUNCTION dataFileSet_vectA ##### -->
<para>

</para>

@visuData: 
@val: 
@pos: 
@Returns: 


<!-- ##### FUNCTION dataFileSet_vectB ##### -->
<para>

</para>

@visuData: 
@val: 
@pos: 
@Returns: 


<!-- ##### FUNCTION dataFileGet_vectA ##### -->
<para>

</para>

@visuData: 
@Returns: 


<!-- ##### FUNCTION dataFileGet_vectB ##### -->
<para>

</para>

@visuData: 
@Returns: 


<!-- ##### FUNCTION dataFileSet_colUsed ##### -->
<para>

</para>

@visuData: 
@val: 
@pos: 
@Returns: 


<!-- ##### FUNCTION dataFileGet_colUsed ##### -->
<para>

</para>

@visuData: 
@Returns: 


<!-- ##### FUNCTION dataFileGet_nbColumns ##### -->
<para>

</para>

@visuData: 
@Returns: 


<!-- ##### FUNCTION dataFileSet_colorType ##### -->
<para>

</para>

@visuData: 
@color: 
@Returns: 


<!-- ##### FUNCTION dataFileGet_colorType ##### -->
<para>

</para>

@visuData: 
@Returns: 


<!-- ##### FUNCTION dataFileGet_valuesTransformedInRGB ##### -->
<para>

</para>

@visuData: 
@valuesTransformed: 
@valuesFrom: 


<!-- ##### FUNCTION dataFileSet_shade ##### -->
<para>

</para>

@visuData: 
@shade: 
@Returns: 


<!-- ##### FUNCTION dataFileApply_hideOnMinValue ##### -->
<para>

</para>

@visuData: 
@column: 
@value: 
@Returns: 


