# EditRealVisu

## `EditRealVisu` (FB)

FUNCTION\_BLOCK EditRealVisu

### Short description

> Input of a numeric value with input limits (visualization)\
> \
> Typical application: Entering a target temperature in the visualization\
> \
> Special feature: Min/Max inputs, unit, decimal places and other parameters are configured directly in the CFC editor and not in the visualization object.\
> This allows changes and limits to be modified online in the application without download.

### Representation

<figure><img src="/files/ecd3a1140655ef7ceec941b9098681782450cd23" alt=""><figcaption></figcaption></figure>

### Interfaces

#### Outputs

| Name   | Data type | Value range | Initial value | Function             |
| ------ | --------- | ----------- | ------------- | -------------------- |
| *rOut* | REAL      |             |               | Numeric output value |

#### Setpoints / parameters

| Name                  | Data type | Value range | Initial value | Function                                                             |
| --------------------- | --------- | ----------- | ------------- | -------------------------------------------------------------------- |
| **xDisableSeparator** | BOOL      |             | FALSE         | TRUE = Disables the thousands separator in the visualization display |
| **bDecimals**         | BYTE      |             | 1             | Number of decimal places                                             |
| **sDialogTitle**      | STRING    |             |               | Dialog title of the input value                                      |
| **sUnit**             | STRING    |             |               | Unit of the input value                                              |
| **rMaxInputVisu**     | REAL      |             | 100.0         | Upper input limit of the input value                                 |
| **rMinInputVisu**     | REAL      |             | 0.0           | Lower input limit of the input value                                 |
| **rSetPoint**         | REAL      |             | 0.0           | Numeric input value                                                  |

### Function description

#### General

This function block is used to pass a numeric input value **rSetPoint** and to directly transfer it to the numeric output value *rOut*.\
Additionally, further properties of the input value can be defined here, which are not used in the function block itself but, for example, in a suitable visualization element.\
\
Thus the number of decimal places **bDecimals**, the title of the input value **sDialogTitle**, the unit of the input value **sUnit** as well as the input limit values **rMinInputVisu** and **rMaxInputVisu** can be passed to the visualization element and taken into account during input.\
With the parameter **xDisableSeparator** the thousands separator in the visualization can be disabled.

{% hint style="warning" %}
**Behavior on power failure**

All setpoints / parameters are stored fail-safe and automatically restored.
{% endhint %}

### Visualization

Matching visualization element from the HVACV Visu Library: **EditRealVisu**

#### Representation

<figure><img src="/files/224d5f0493cb2cdc7436cbd1139047b9752389b8" alt=""><figcaption></figcaption></figure>

#### Interfaces Visu-Element

| Name            | Data type        | Type         | Initial value | Function                                                                                               |
| --------------- | ---------------- | ------------ | ------------- | ------------------------------------------------------------------------------------------------------ |
| **rValue**      | FB\_EditRealVisu | VAR\_IN\_OUT |               | Enter FB instance HVAC.EditRealVisu here e.g. PRG.EditRealVisu                                         |
| **iFieldSizeL** | INT              | VAR\_INPUT   | 0             | Field expands by the number of entered pixels to the left. Required to display long numbers or units.  |
| **iFieldSizeR** | INT              | VAR\_INPUT   | 0             | Field expands by the number of entered pixels to the right. Required to display long numbers or units. |

The following inputs of the FB HVAC.EditRealVisu are automatically adopted and can be changed at runtime: rMinInputVisu, rMaxInputVisu, sUnit, sDialogTitle, bDecimals, xDisableSeperator

{% hint style="info" %}
Note: VAR\_IN\_OUT interfaces must be assigned, VAR\_INPUT are optional.
{% endhint %}

### CODESYS

InOut:

| Scope       | Name                | Type     | Initial |
| ----------- | ------------------- | -------- | ------- |
| Input Const | `xDisableSeparator` | `BOOL`   |         |
| Input Const | `bDecimals`         | `BYTE`   | 1       |
| Input Const | `sDialogTitle`      | `STRING` |         |
| Input Const | `sUnit`             | `STRING` |         |
| Input Const | `rMaxInputVisu`     | `REAL`   | 100     |
| Input Const | `rMinInputVisu`     | `REAL`   | 0       |
| Input Const | `rSetPoint`         | `REAL`   | 0       |
| Output      | `rOut`              | `REAL`   |         |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.powerio.com/hub/codesys-hvac/en/hvac-library/functionblocks/setpoint/editrealvisu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.