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

image-20260519-134417.png

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.

1234.5 → 1,234.50

Percentage

Multiplies the value by 100 and appends %. Uses the same numeric formatting options.

0.75 → 75%

Currency

Prepends or appends a currency symbol with configurable negative notation.

-1234 → (EUR 1,234)

Date

Parses a date string and reassembles it using the chosen field order, separators, month/year/day styles, and optional weekday.

07.03.2025 → March 7, 2025

Parameters

General

Parameter

Default

Description

Text

empty

The input text to format. Typically bound to the container's text content.

Format

None

Formatting mode: None, Number, Percentage, Currency, Date.

Number / Percentage / Currency Options

Parameter

Default

Description

Negative numbers

-123

Display style for negative values: -123 or (123).

Negative currency

-EUR 123

Negative notation in Currency mode: -EUR 123, EUR -123, (EUR 123), or EUR (123).

Negative Color

White

Per-character color applied when the value is negative.

Fraction Type

Decimal

Decimal display or fractional notation: Decimal, 1/2, 2/4, 4/8, 8/16, 5/10, 50/100.

Decimal places

0

Number of decimal digits (0–6). Only visible in Decimal fraction type.

Decimal separator

Point

Character for the decimal point: . or ,.

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., 1,234,567).

Thousand separator

Comma

Character for thousand grouping: . or ,.

Currency

EUR

The currency symbol or text. Only visible in Currency mode.

Date Options

Parameter

Default

Description

Date Input

European

Input parsing order: European (dd.mm.yyyy) or American (mm/dd/yyyy).

Date

DD/MM

Output field arrangement: DD/MM, MM/DD, DD/MM/YY, MM/DD/YY, MM/YY, YY/MM, or User (custom format string).

Format

WW the DD on MM year YY

Custom format string (User mode). Tokens: W = weekday, D = day, M = month, Y = year.

Year

2009

Short (09) or full (2009) year.

Month

03

Month display: 03, 3, Mar, March, or M.

Day

07

Day display: zero-padded (07) or plain (7).

Day In Week

None

Optional weekday prefix: None, long (Tuesday), or short (Tue).

Month Separator

/

Separator between month and year: /, -, ,, ., or space.

Day Separator

/

Separator between day and month.

Week Day Separator

/

Separator after the weekday name.

Usage Example

Formatting election results

  1. Create a Text geometry container with the raw value (for example, 12345.678).

  2. Add the Format Number plug-in to the container's function stack.

  3. Set Format to Number.

  4. Set Decimal places to 1, enable Use Thousand separator.

  5. Result: 12,345.7.

Currency display with negative coloring

  1. Set Format to Currency, Currency to $.

  2. Set Negative currency to ($ 123).

  3. Set Negative Color to red.

  4. 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.