Math Controller
Math Controller Addon
Overview
This addon adds the Math Controller, an advanced math node extension that performs numerical calculations based on formulas you enter.
The Math Controller is a custom group node that internally generates a network of math nodes.
You can use this node in the Shader Editor, Geometry Node Editor, Compositor and Texture Node Editor (Note: Input/Output sockets currently only appear within sub-node groups witch Math Controller can generates).
Usage
Location
5.0 <= blender
[ shader & geometry & compositor ]
Node editor > Add > Utilities > "Math Controller"
[ texture node editor ]
Node editor > Add > Converter > "Math Controller"
4.2 <= blender < 5.0
[ compositor & geometry ]
Node editor > Add > Utilities > "Math Controller"
[ texture & shader ]
Node editor > Add > Converter > "Math Controller"
+/- Buttons
Add or remove formula input fields.
Formula Input Fields
You can write formulas by combining real numbers, variables, functions from the list below, and outputs from other fields (e.g., f1, f2).
- Dynamic Variable Sockets: Variables used in your formula are automatically added as input sockets. If a variable is no longer used and has no incoming connection, its socket is automatically removed.
- Result Inheritance: Each input field is assigned a function name (e.g.,
f1,f2). You can use these as variables in other fields to inherit calculation results.
Advanced Formula Editor Button
Click the button next to the input field to open the Advanced Formula Editor.
- Features: Edit long formulas comfortably, visualize parenthesis
()nesting levels, and browse the function list. - Function Arguments: Function arguments correspond to the standard Blender Math node input sockets in ascending order.
Generate Node Group Button
The button at the bottom creates a standard Node Group that stays synchronized with the Math Controller.
- Internal Editing: You can access and edit the internal node network generated by the Math Controller through this Node Group.
- Caution: The Math Controller overwrites the internal structure of the group during updates. If you wish to maintain manual changes, we recommend deleting the Math Controller node or breaking the link. Additionally, modifying the internal network while the Math Controller is active may leave "orphaned" nodes.
Duplication
Like standard Blender nodes, the Math Controller can be duplicated using Shift + D or Ctrl + Shift + D.
Formula List
| Category | Function | Description |
|---|---|---|
| Functions | add(a, b) |
Addition |
sub(a, b) |
Subtraction | |
mul(a, b) |
Multiplication | |
div(a, b) |
Division | |
madd(a, b, c) |
Multiply Add | |
log(a, b) |
Logarithm | |
sqrt(a) |
Square Root | |
inv_sqrt(a) |
Inverse Square Root | |
abs(a) |
Absolute | |
exp(a) |
Exponent | |
| Comparison | min(a, b) |
Minimum |
max(a, b) |
Maximum | |
less(a, b) |
Less Than | |
greater(a, b) |
Greater Than | |
sign(a) |
Sign | |
compare(a, b, c) |
Compare / Epsilon | |
s_min(a, b, c) |
Smooth Minimum | |
s_max(a, b, c) |
Smooth Maximum | |
| Rounding | round(a) |
Round |
floor(a) |
Floor | |
ceil(a) |
Ceil | |
trunc(a) |
Truncate | |
fract(a) |
Fraction | |
mod_t(a, b) |
Truncated Modulo | |
mod_f(a, b) |
Floored Modulo | |
wrap(a, b, c) |
Wrap | |
snap(a, b) |
Snap | |
pingpong(a, b) |
Ping-Pong | |
| Trigonometric | sin(a) |
Sine |
cos(a) |
Cosine | |
tan(a) |
Tangent | |
asin(a) |
Arcsine | |
acos(a) |
Arccosine | |
atan(a) |
Arctangent | |
atan2(a, b) |
Arctan2 | |
sinh(a) |
Hyperbolic Sine | |
cosh(a) |
Hyperbolic Cosine | |
tanh(a) |
Hyperbolic Tangent | |
| Conversion | rad(a) |
To Radians |
deg(a) |
To Degrees |
License
This addon is licensed under the GNU General Public License v3.0 or later.
日本文
説明
このアドオンは、入力した数式の通りに数値計算を行う拡張ノード「Math Controller」を追加します。 Math Controllerは、内部に数式ノード群を自動生成するカスタムグループノードです。 シェーダーエディター、ジオメトリーノードエディター、コンポジターおよび※テクスチャノードで使用可能です。(注：※では本体に入出力ソケットが作れず、接続はグループノード(二次生産)に依存しています)
使い方
場所
基本的な場所
ノードエディター > 追加 (Add) > ユーティリティ> "Math Controller"
texture nodeまたはblender 5.0未満のshader
ノードエディター > 追加 (Add) > コンバーター > "Math Controller"
+/- ボタン
入力フォームを増減させます。
関数入力フォーム
実数、変数、関数、および他のフォームの出力（f1, f2 など）を組み合わせて数式を記述できます。
- 変数ソケットの自動追加: 数式内で使用した変数は、自動的に入力ソケットとして追加されます。使用されなくなり、接続もなくなったソケットは自動的に削除されます。
- 結果の継承: 各入力フォームには
f1,f2などの名前が割り当てられており、これを他の欄で変数として使うことで計算結果を再利用できます。
拡張数式エディタ (Advanced Formula Editor)
入力フォーム横のボタンから専用エディタが開きます。
- 長い数式の編集、括弧の階層構造の可視化、関数一覧の確認が可能です。
- 各関数の引数は、標準のMathノードの入力ソケットに準拠しています。
ノードグループの生成
フォーム下部のボタンから、Math Controllerと同期した通常のノードグループを作成できます。
- 内部編集: このグループから、生成されたノードネットワークに直接アクセスして編集できます。
- 注意: Math Controllerは更新時に内部構造を上書きします。手動編集を維持したい場合は、Math Controllerノードを削除するかリンクを切断してください。
複製
標準ノードと同様に Shift + D や Ctrl + Shift + D で複製可能です。
以下省略
What's New
0.4.8 April 6th, 2026
Math Controller 0.4.5 (Blender 4.2+)
Added
Initial support for Texture Node Editor (Note: Input/Output sockets currently only appear within sub-node groups witch Math Controller can generate).
Compatibility extended down to Blender 4.2.
Changed
- Updated node header colors to match the standard Math nodes.
Fixed
- Resolved an issue where output sockets with existing links were not correctly preserved when a formula/math expression was deleted.
This addon really helps a lot. Just a little advice. Can you make the internal group color tag be converter by default so that the math controller node will also show converter color tag? And is this possible to delete a arbitrary line instead of the last one(For example, i have f1,f2,f3,f4 and f5 now, but I want to delete f2 and f3)