Drawings
Interactive chart annotations in AXIS—tools, persistence, and how they differ from Pine script drawings.
This page
AXIS supports user drawings (interactive tools on the chart) and script drawings (objects returned by the engine). They share a canvas layer but different lifecycles.
Abstract
| Class | Origin | Cleared when | Persisted |
|---|---|---|---|
| User drawings | Drawing toolbar | Explicit delete / clear | Yes (store.drawings in pynescript.axis.v1) |
| Script drawings | Engine drawings[] | Next Run (re-applied) | No (recomputed) |
Conceptual model
Rendering…
Tools
| Tool id | Kind | Geometry |
|---|---|---|
cursor | — | Select / pan mode (not a drawable) |
hline | hline | Horizontal price |
vline | vline | Vertical time |
trend | trend | Two points |
ray | ray | Two points (extends) |
extend | extend | Extended line |
rect | rect | Two corners |
ellipse | ellipse | Ellipse / oval |
arrow | arrow | Directional segment |
fib | fib | Two points; levels 0, 0.236, 0.382, 0.5, 0.618, 0.786, 1 |
measure | measure | Two points (delta readout) |
text | text | Anchor + label |
Colors: default accent #939fff, up/down/measure variants in DRAWING_COLORS.
Style bar and per-tool settings
The floating style bar (next to the rail) edits the selected drawing, or the defaults for the active tool when nothing is selected. Last-used extras are stored per tool (drawingPrefs.byKind).
| Control | Where | Tools |
|---|---|---|
| Color / width / dash | Style bar | All place tools |
| Custom color | Style bar native picker | All place tools |
| Fill | Style bar slider | Shapes, ranges, fib, highlighter, positions |
| Extend L / R | Style bar arrows | Trend, ray, extend, info line, channel, fib |
| Show price | Style bar $ | Horizontal/vertical lines, fib labels |
| Lock | Style bar (selection) | Selected drawing |
| Text / font size | Settings popover (gear); double-click on chart | Text, note, callout, flag, price label |
| Fib levels / reverse / % | Settings popover | Fibonacci family |
| Risk/reward | Settings popover | Long / short |
| Arrow caps | Settings popover | Trend, ray, arrow, forecast |
Gear button: axis-drawing-settings. Popover: axis-drawing-settings-popover.
Layers & templates
- Layers panel lists user drawings (select, hide, delete)
- Templates: save/load drawing packs (
axis.drawingTemplates.v1) - Duplicate / tag symbol helpers for multi-chart workflows
Interface surface
- Toolbar on chart host (
DrawingToolbar) - Active tool in store; layer sync via
createEffectonstore.drawingTool - Pane manager hosts price chart; drawings bind to time/price coordinates (not pixel-only)
Workflows
Annotate a level
- Select Horizontal line.
- Click price.
- Reload page—line remains (persisted drawings array).
Fibonacci between swing points
- Select Fib.
- Click swing low → swing high (or reverse).
- Levels render from
FIB_LEVELS.
After Run with Pine lines/labels
- Run script that emits drawings.
- Layer clears previous script drawings, then applies new set.
- User drawings remain.
Script drawings (engine → chart)
Engine drawings[] map through pyne-drawings.ts before paint:
| Engine surface | Chart behavior |
|---|---|
line / box / label / polyline | SVG geometry on the script’s pane scale |
linefill / line_fill | Filled quad between two line endpoints |
force_overlay (line/box/label) | Paint on the price pane even when the script is overlay=false |
barcolor series | Not SVG — per-bar candle body/wick tint via plot-visuals |
table.* | Chart overlay HUD by default, or the bottom Tables panel (see below) |
Non-overlay scripts place ordinary geometry on the indicator pane Y-scale; user toolbar drawings always stay on price.
Pine tables: chart HUD vs bottom Tables panel
Pine Script™ table.* drawings render as a chart overlay HUD (PyneTableHud) by default. Any script's tables can move off the chart into a bottom Tables tab — TradingView® September 2026 parity:
- Chart ⋯ menu (or the pane badge ⋯) → Move tables to bottom.
- Tables stack vertically in creation order, stretch to the pane width with proportional columns from
table.cell(width=…), keep tooltips and merged cells, never truncate text (scrollbars when needed), and allow text selection / copy — unlike chart overlay tables. - Move back via Move tables to chart (same menus).
Placement persists per script (store.pineTablesLocation[scriptId]: chart default / bottom). One tab per script; the chart HUD hides moved tables.
Internals
| Path | Role |
|---|---|
src/chart/drawing-types.ts | Tool ids, types, fib levels |
src/chart/drawing-layer.ts | Interaction + render |
src/chart/DrawingToolbar.tsx | UI |
src/chart/pyne-drawings.ts | Map engine drawings → layer |
src/chart/ChartHost.tsx | Mount / dispose |
Invariants
- User drawings ≠ strategy results; deleting drawings does not alter
lastRun. - Time base is bar time (unix-compatible chart times).
cursornever creates geometry.- Persistence omits bars/logs but includes drawings—large freehand-less sets only.
Failure modes
| Symptom | Fix |
|---|---|
| Clicks do nothing | Tool is cursor; chart empty (no bars/time scale) |
| Drawings vanish on Run | Those were script drawings—re-run or convert notes to user tools |
| Lost after wipe | Cleared site data / different browser profile |