Drawing Tools

A drawing in TRScene is not an annotation you look at — it is an input a scenario can read. A trend line you draw on the chart becomes a price level the engine recalculates on every candle, so "enter when price crosses my trend line" is a condition you draw instead of a number you type.

This page follows one tool end to end: the trend line.

Where the tools are

The drawing toolbar runs down the left edge of the chart. Each slot is a group of related tools — the icon shows the last tool you used from that group, and the small chevron opens the full list.

Two buttons sit below the groups:

• Delete — removes the selected drawing. Shift + click clears every drawing on the chart.
• Lock — keeps the tool active after you finish a drawing, so you can draw several in a row.

Draw a trend line

1. Open the Trend Lines slot and pick Trend Line. The slot highlights while the tool is active.
2. Click the chart where the line should start — a swing low, for example.
3. Click again where it should end. The line is created between the two points.
4. The tool deactivates itself, unless Lock is on.

Style and move it

Click a finished drawing to select it. A small toolbar appears with everything you can change — colour, line style, thickness, layer order, and delete. Drag the grip on its left edge to move the toolbar out of your way; it remembers where you put it.

Drag either endpoint to reshape the line, or drag the line itself to move it. Delete or Backspace removes the selected drawing.

Where drawings are stored

Drawings are saved per symbol, not per timeframe. A trend line you draw on the 5m chart of BTC-USDT-SWAP is the same line you see on the 1D chart, anchored to the same timestamps and prices. The same symbol on a different exchange keeps its own separate set.

Nothing needs to be saved by hand — edits are persisted a moment after you finish them.

Use it as a scenario condition

In a Start or Condition node, set a target's type to Drawing → Trend Line, then pick the line from the selector. Each trend line gets a readable label generated from its shape, so a trend line appears as something like TrendLine ↗ 42.3K → 45.1K.

The other target is always price, and there are two operators: Price Above Line — true while price sits on or above the line — and Price Below Line, true while it is strictly below. Cross operators are not offered for drawings. The engine recalculates the line's price at the current candle on every tick.

For the MVP, the condition selector accepts exactly one drawing tool:

Everything else — including Horizontal Line, Horizontal Ray, Ray, Extended Line, Parallel Channel, Fibonacci, shapes, text, freehand, and arrows — remains a chart drawing only and is not exposed as a Start or Condition target yet.

Reference