> For the complete documentation index, see [llms.txt](https://support.powerio.com/hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.powerio.com/hub/codesys-hvac/en/hvac-library/functionblocks/setpoint/editrealvisu.md).

# EditRealVisu

## `EditRealVisu` (FB)

FUNCTION\_BLOCK EditRealVisu

### Short description

> Input of a numerical value with input limits (visualization)\
> \
> Typical application: Input of a setpoint temperature in the visualization\
> \
> Special feature: Min/Max inputs, unit, decimal places, and other parameters are parameterized directly in the CFC editor and not in the visualization object.\
> This makes it possible to change settings and limit values 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.png?alt=media" alt=""><figcaption></figcaption></figure>

### Interfaces

#### Outputs

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

#### Setpoints / Parameters

| Name                  | Data type | Value range | Initial value | Function                                                                    |
| --------------------- | --------- | ----------- | ------------- | --------------------------------------------------------------------------- |
| **xDisableSeparator** | BOOL      |             | FALSE         | TRUE = Disables the thousands separator in the display in the visualization |
| **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           | Numerical input value                                                       |

### Functional description

#### General

This function block is used to transfer a numerical input value **rSetPoint** and directly transfer it to the numerical output value *rOut*.\
In addition, further properties of the input value can be defined here, which are not used in the function block, but for example in a suitable visualization element.\
\
This means 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 limits **rMinInputVisu** and **rMaxInputVisu** can be passed to the visualization element and taken into account there during input.\
With the parameter **xDisableSeparator** the thousands separator in the visualization can be disabled.

{% hint style="warning" %}
**Behavior in the event of power failure**

All setpoints / parameters are stored fail-safe in the event of power loss and automatically restored.
{% endhint %}

### Visualization

Suitable 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.png?alt=media" alt=""><figcaption></figcaption></figure>

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

The following inputs of 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 is 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
