Location: Plugins → Container Plug-ins → Text Compatibility: V3 Classic, V4 PBR Category: Text
Note: This plugin is inactive by default and should only be used for compatibility reasons
Overview
The Format Number plug-in formats a numeric or date string displayed in a Text geometry container. It takes the raw text value, parses it as a number or date, and rewrites the text with the chosen formatting (including decimal places, thousand separators, currency symbols, percentage notation, and date layouts).
Negative values can optionally be displayed in a user-defined color for visual emphasis (for example, red for losses in financial graphics).
Format Modes
The plug-in provides four formatting modes, selectable via the Format parameter:
Mode | Description | Example |
|---|---|---|
Number | Plain numeric formatting with configurable decimal places, fraction types, and thousand separators. |
|
Percentage | Multiplies the value by 100 and appends |
|
Currency | Prepends or appends a currency symbol with configurable negative notation. |
|
Date | Parses a date string and reassembles it using the chosen field order, separators, month/year/day styles, and optional weekday. |
|
Parameters
General
Parameter | Default | Description |
|---|---|---|
Text | empty | The input text to format. Typically bound to the container's text content. |
Format | None | Formatting mode: |
Number / Percentage / Currency Options
Parameter | Default | Description |
|---|---|---|
Negative numbers |
| Display style for negative values: |
Negative currency |
| Negative notation in Currency mode: |
Negative Color | White | Per-character color applied when the value is negative. |
Fraction Type | Decimal | Decimal display or fractional notation: |
Decimal places | 0 | Number of decimal digits (0–6). Only visible in Decimal fraction type. |
Decimal separator | Point | Character for the decimal point: |
Replace Zero | Off | When enabled, replaces zero values with a custom string. |
Replace Zero by |
| The replacement string used when the value is zero. |
Use Thousand separator | Off | Enable thousand grouping (e.g., |
Thousand separator | Comma | Character for thousand grouping: |
Currency |
| The currency symbol or text. Only visible in Currency mode. |
Date Options
Parameter | Default | Description |
|---|---|---|
Date Input | European | Input parsing order: European ( |
Date | DD/MM | Output field arrangement: |
Format |
| Custom format string (User mode). Tokens: |
Year |
| Short ( |
Month |
| Month display: |
Day |
| Day display: zero-padded ( |
Day In Week | None | Optional weekday prefix: |
Month Separator |
| Separator between month and year: |
Day Separator |
| Separator between day and month. |
Week Day Separator |
| Separator after the weekday name. |
Usage Example
Formatting election results
Create a Text geometry container with the raw value (for example,
12345.678).Add the Format Number plug-in to the container's function stack.
Set Format to
Number.Set Decimal places to
1, enable Use Thousand separator.Result:
12,345.7.
Currency display with negative coloring
Set Format to
Currency, Currency to$.Set Negative currency to
($ 123).Set Negative Color to red.
Input
-500→ displays as($ 500)in red.
Technical Notes
The plug-in writes directly to the Text geometry on the same container. It overwrites the displayed text each frame when the input changes.
Parameters that are not relevant to the current format mode are automatically hidden in the GUI (for example, date options are hidden in Number mode).
Fractional display modes (½, ¼, etc.) use Unicode fraction characters when available.
