# 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="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2Fgit-blob-c1b59da32cb29264e9aec56b5b12eee2938d347a%2Fimage%20(30).png?alt=media" 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="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2Fgit-blob-8ba1328f913c895253c041ba18583c2473ef3242%2Fimage%20(29).png?alt=media" 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`   |         |