# Number Input

This function block lets you type a numeric value that can be used elsewhere in your scenario. It is ideal for thresholds, indexes, counters or any parameter that needs a user-defined number.

## 📥 Inputs <a href="#inputs" id="inputs"></a>

This function block does not have any inputs.

## 📤 Outputs <a href="#outputs" id="outputs"></a>

`Number` The numeric value typed by the user. Can be integer or decimal (supports both dot and comma decimal separators).

## 🕹️ Controls <a href="#controls" id="controls"></a>

`Number` A single-line editable field where you enter the numeric value to be exported by the block.

* Accepts integers (e.g., 5) and decimal values (e.g., 3.14 or 3,14).
* Ignore spaces; avoid special characters or text.
* If the value cannot be parsed as a number, the block will show an error state and will not output a valid number.

## 🎯 Features <a href="#features" id="features"></a>

* Simple, focused numeric input for use as a parameter in your flow.
* Accepts both integer and floating-point formats with flexible decimal separators.
* Visual validation: the block indicates when the entered value is invalid.

## ⚙️ Running behavior <a href="#how-it-works" id="how-it-works"></a>

When the scenario runs, the block reads the content of the editable field and provides the parsed numeric value on the `Number` output. If parsing fails, the block reports an error and does not output a valid numeric value until corrected.

## 📝 Usage tips <a href="#usage" id="usage"></a>

* Use this block to set thresholds, sizes, counts, or any configurable numeric parameter in your scenario.
* Keep the field simple — don’t add units or extra text (for example write 100, not "100 px").

## 💡 Tips and Tricks <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Use with `Greater`, `Smaller`, or `Equals` to build comparison logic for decision making.
* Use with `Number Range` when you want a slider/value pair for dynamic range selection.
* Provide line locations or thresholds for analysis blocks like `Histogram On Line` or `Histogram On Curve` using this block.
* Feed width/height values into image transformation blocks such as `Image Resize` or `Image ROI Center`.
* Use together with export blocks such as `Image Write`, `Image Logger`, or `CSV Export` to control naming, limits or logging thresholds.

## 🛠️ Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

* If your value is rejected: remove extra characters (letters, symbols), replace commas with dots or vice versa if needed, and avoid spaces.
* If you see an error message after editing the field, correct the input and re-run; the block will return to normal when a valid number is entered.


---

# 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://docs.augelab.com/function-blocks/input-output/data-inputs/number-input.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.