home/ atoms/ punctual-output-routing-required

Every Punctual audio or video statement must end with an output operator or its result goes nowhere

Punctual separates definition from output routing. A statement like osc 440 defines a signal but, without a >> audio output operator, produces no sound — the computation is performed but the result is discarded. Similarly, visual expressions need >> rgb, >> add, or similar operators to reach the display. A bare definition with << or = is an intentional reuse pattern (named value, not output). Forgetting >> is the most common cause of silence or black canvas in Punctual.

Examples

osc 440; — silent (no output). osc 440 >> audio; — heard. osc 440 << freq; — named for later reuse, not output.

Assessment

A student writes osc 220 + osc 330; and hears nothing. Explain why and write the corrected statement. Then explain what freq << osc 220; does instead.

“A statement is silent/invisible unless it ends in `>> <output>`. A bare graph (`osc 440;`) is only a *definition/computation*. This is the #1 "why is it quiet/black?".”
context/ · L1-instruments/punctual/gotchas.md · chunk 1
“bare def is intentional reuse.”
context/ · L5-debug/punctual.md · chunk 1