Visualize Expression

How it fits

Typical backends

Caveats

• Hard constraintOutput must be a uint8 ndarray that matches output_color_model. There is no auto-conversion of dtype or channel count.
• CompatibilityThe asteval sandbox blocks lambdas, getattr, string-literal .format(...), and disk/network I/O from inside the expression.
• Hard constraintA throwing expression pauses the input stream until a fixed expression is pushed via mutable config update. Validate offline before deploying.
• LatencyPer-pixel Python loops are slow inside the sandbox. Prefer vectorised NumPy / OpenCV operations.
• State lifetimeThe icons file slot, when bound, is auto-scanned once at startup; adding new files at runtime requires a restart.
• State lifetimeexpression is hot-swappable and re-read every call. The icons bind and output_color_model are captured once at module import.