> 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/hvac-library/functionblocks/setpoint/editrealvisu.md).

# EditRealVisu

## `EditRealVisu` (FB)

FUNCTION\_BLOCK EditRealVisu

### Kurzbeschreibung

> Eingabe eines numerischen Wertes mit Eingabegrenzen (Visualisierung)\
> \
> Typische Anwendung: Eingabe einer Solltemperatur in der Visualisierung\
> \
> Besonderheit: Min/Max Eingaben, Einheit, Nachkommastellen und weitere Parameter werden direkt im CFC Editor parametriert und nicht im Visualisierungsobjekt.\
> Dies ermöglicht, Änderungen und Grenzwerte online in der Applikation ohne Download zu ändern.

### Darstellung

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

### Schnittstellen

#### Ausgänge

| Name   | Datentyp | Wertebereich | Initialwert | Funktion                |
| ------ | -------- | ------------ | ----------- | ----------------------- |
| *rOut* | REAL     |              |             | Numerischer Ausgabewert |

#### Sollwerte / Parameter

| Name                  | Datentyp | Wertebereich | Initialwert | Funktion                                                                            |
| --------------------- | -------- | ------------ | ----------- | ----------------------------------------------------------------------------------- |
| **xDisableSeparator** | BOOL     |              | FALSE       | TRUE = Deaktiviert das tausender Trennzeichen bei der Anzeige in der Visualisierung |
| **bDecimals**         | BYTE     |              | 1           | Anzahl der Nachkommastellen                                                         |
| **sDialogTitle**      | STRING   |              |             | Dialogtitel des Eingabewerts                                                        |
| **sUnit**             | STRING   |              |             | Einheit des Eingabewerts                                                            |
| **rMaxInputVisu**     | REAL     |              | 100.0       | Obere Eingabegrenze des Eingabewerts                                                |
| **rMinInputVisu**     | REAL     |              | 0.0         | Untere Eingabegrenze des Eingabewerts                                               |
| **rSetPoint**         | REAL     |              | 0.0         | Numerischer Eingabewert                                                             |

### Funktionsbeschreibung

#### Allgemeines

Dieser Funktionsbaustein dient zur Übergabe eines numerischen Eingabewerts **rSetPoint** und die direkte Übertragung zum numerischen Ausgabewert *rOut*.\
Zusätzlich können hier weitere Eigenschaften des Eingabewerts definiert werden, die jedoch nicht im Funktionsbaustein, sondern zum Beispiel in einem geeigneten Visualisierungselement Verwendung finden.\
\
So können die Anzahl der Nachkommastellen **bDecimals**, der Titel des Eingabewerts **sDialogTitle**, die Einheit des Eingabewerts **sUnit** sowie die Eingabegrenzwerte **rMinInputVisu** und **rMaxInputVisu** an das Visualisierungselement übergeben werden und dort bei der Eingabe Berücksichtigung finden.\
Mit dem Parameter **xDisableSeparator** kann das Tausender-Trennzeichen in der Visualisierung deaktiviert werden.

{% hint style="warning" %}
**Verhalten bei Spannungsausfall**

Alle Sollwerte / Parameter werden spannungsausfallsicher gespeichert und automatisch wiederhergestellt.
{% endhint %}

### Visualisierung

Passendes Visualisierungselement aus der HVACV Visu Library: **EditRealVisu**

#### Darstellung

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

#### Schnittstellen Visu-Element

| Name            | Datentyp         | Typ          | Initialwert | Funktion                                                                                                                    |
| --------------- | ---------------- | ------------ | ----------- | --------------------------------------------------------------------------------------------------------------------------- |
| **rValue**      | FB\_EditRealVisu | VAR\_IN\_OUT |             | FB Instanz HVAC.EditRealVisu hier eintragen z.B. PRG.EditRealVisu                                                           |
| **iFieldSizeL** | INT              | VAR\_INPUT   | 0           | Feld vergrößert sich um Anzahl der eingegebenen Pixel nach links. Wird benötigt um lange Zahlen oder Einheiten anzuzeigen.  |
| **iFieldSizeR** | INT              | VAR\_INPUT   | 0           | Feld vergrößert sich um Anzahl der eingegebenen Pixel nach rechts. Wird benötigt um lange Zahlen oder Einheiten anzuzeigen. |

Folgende Eingabens des FB HVAC.EditRealVisu werden automatisch übernommen und können zur Laufzeit geändert werden: rMinInputVisu, rMaxInputVisu, sUnit, sDialogTitle, bDecimals, xDisableSeperator

{% hint style="info" %}
Hinweis: VAR\_IN\_OUT Schnittstellen müssen belegt werden, VAR\_INPUT sind 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 dynamically by asking a question.

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

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
