[[fr:pictural_gauge|{{:wiki:flag_fr.png?45 }}]]

====== Pictural Gauge ======

This is the N4V FOR WEBI Wiki page for the Pictural Gauge widget.

**Since Need4Viz 2024.2.0**

===== Render =====

{{url>https://www.need4viz.com/dataviz/pictgauge.html noborder height=250}}

===== Description =====

Gauge indicating the percentage value provided as a parameter in a customizable image. \\
Caution- the dimension indicates the title of the gauge, and it must contain only one value. In most cases this can be achieved by applying a filter to widget for the desired dimension value.

  * //Title// : Dimension unique value to display

  * //Percent// : Measure to display in the gauge
  * //[Value]// : [Optional] Measure, value to display in the tooltip

  * //[Min%/Max%]// : [Optional] Max or Min/Max in percentage for the scale of the gauge

===== How-to Video =====
{{youtube>Oq4kBXqsTxM}}


===== Animation =====

  * The filling level of the image progresses until it reaches the measurement value.

===== Parameters =====

You can find instructions for accessing settings for Need4viz graphics: [[Format Custom Element]].

For the Pictural Gauge , the available parameters are :

**Extended parameters**

  * **Global** -> See the user guide for the "Global" section [[global_extparam | here]]

  * **Options**
    * //Gauge orientation// : Choose here if the gauge filling is horizontal or vertical
    * //Min/Max Gauge// : This setting allows you to display the min and max values on the gauge.
    * //Colors// : This setting allows you to choose the colors of the empty part and the full part as well as their intensities. You can also set a gradient effect on the pictural.

  * **Label**
    * //Display and position// : Choose here whether or not to display the label and its position. Depending on the filling orientation of the gauge, the label can be placed above/below or to the left/right of the image. It can also be placed statically below or in a floating position, above the image (customized).
    * //Moving label// : Set here the behavior of the label positioned to the left/right or above/below the label when it moves with the filling.
    * //Custom position// : Adjust the floating positioning of the label here if its position is set to "Custom".
    * //Content// : Choose here the content to display for the label as well as the style.

  * **Picture**
    * //Picture type// : This setting allows you to choose the type of image you want (custom or not)
    * //Custom picture// : This setting allows you to use your SVG (Scalable Vector Graphics) format picture  

  * **Measure**
    * //Measure of the Gauge// : This setting allows you to define the precision of the desired measurement. The measurement display format (standard - e.g.: 2,345.67, compact - e.g.: 2.3K or compact long - e.g.: 2.3 thousand) can also be defined.

  * **Ranges**
    * //Range usage// : This settings enable the usage of ranges.
    * //Range 1, 2, 3// : Define here the min & max values for the range and the color to affect if the measure value is in this range

**Export Server** -> See the user guide for the "Export Server" section [[format_export_html | here]]

**Export FTP** -> See the user guide for the "Export FTP" section [[format_export_ftp | here]]

**Export SharePoint** -> See the user guide for the "Export SharePoint" section [[format_export_sharepoint | here]]

===== Related articles =====

KB articles to get more information :

  * How to add custom pictures in N4V FOR WEBI pictural components : [[https://www.need4viz.com/support/kb/faq.php?id=21|Here]]
  * How to use a custom SVG in Pictural Stack or Pictural Gauge : [[https://www.need4viz.com/support/kb/faq.php?id=20|Here]]
  * How to use a SVG with multi paths in a Pictural Stack or Pictural Gauge : [[https://www.need4viz.com/support/kb/faq.php?id=36|Here]]