# DisplayRealVisu

## `DisplayRealVisu` (FB)

FUNCTION\_BLOCK DisplayRealVisu

### Short description

> Display of a numerical value with correction value (visualization)\
> \
> Typical application: Adjustment of a temperature sensor in the visualization\
> \
> Special feature: Unit, decimal places and other parameters are parameterized directly in the CFC editor and not in the visualization object.\
> This allows changes and limits to be modified online in the application without a 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

#### Inputs

| Name     | Data type | Value range | Initial value | Function    |
| -------- | --------- | ----------- | ------------- | ----------- |
| *rInRaw* | REAL      |             |               | Input value |

#### 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 thousand separator when displayed in the visualization |
| **bDecimals**         | BYTE      |             | 1             | Number of decimal places                                                   |
| **sSymbol**           | STRING    |             |               | Symbol in the visualization                                                |
| **sUnit**             | STRING    |             |               | Unit of the input value                                                    |
| **rOffset**           | REAL      |             | 0.0           | Correction value                                                           |

### Function description

#### General

The output value *rOUT* is formed by the addition of the input value *rInRaw* with the correction value **rOffset** formed.\
Additionally, further properties of the output value can be defined here, which, however, are not used in the function block but for example in a suitable visualization element.\
\
With the parameter **xDisableSeparator** the thousand separator in the visualization can be disabled.\\

### Visualization

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

#### 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 visual 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 enlarges by the number of entered pixels to the left. Required to display long numbers or units.  |
| **iFieldSizeR** | INT              | VAR\_INPUT   | 0             | Field enlarges by the number of entered pixels to the right. Required to display long numbers or units. |

The following inputs of the FB HVAC.DisplayRealVisu are automatically adopted and can be changed at runtime: rOffset, sUnit, sSymbol, bDecimals, xDisableSeperator | | Note: VAR\_IN\_OUT interfaces must be assigned, VAR\_INPUT are optional. | |

### CODESYS

InOut:

| Scope       | Name                | Type     | Initial |
| ----------- | ------------------- | -------- | ------- |
| Input       | `rInRaw`            | `REAL`   |         |
| Input       | `xAlarm`            | `BOOL`   |         |
| Input Const | `xDisableSeparator` | `BOOL`   |         |
| Input Const | `bDecimals`         | `BYTE`   | 1       |
| Input Const | `sSymbol`           | `STRING` | 'A'     |
| Input Const | `sUnit`             | `STRING` |         |
| Input Const | `rOffset`           | `REAL`   | 0       |
| Output      | `rOut`              | `REAL`   |         |
