PivotStructureOutline_Utilities

This library contains reusable pivot structure outline helpers for Pine scripts that already work with confirmed pivot highs and lows. It is designed to provide the reusable outline and anchor-box layer for scripts that already have their own pivot-confirmation logic, so those scripts can keep their structure visuals consistent without repeatedly rebuilding the same framework.

It brings together the parts of the workflow that are often rewritten in structure-based scripts: resolving pivot-close anchors, selecting wick vs close anchor behavior, building live outline geometry, building pivot structure anchor-box geometry, and managing the line and box objects that render those visuals.

Everything on the example chart is materially driven by the library, whether through the selected outline anchor source, the outline geometry itself, the midpoint-start logic, the pivot structure anchor boxes, or the shared line/box lifecycle helpers used to keep those visuals updated cleanly on the chart.

How to use

Import the library near the top of your script in global scope, alongside any other imports, before you start calling its helpers. This mirrors the import-first usage pattern shown on your recent library page.

Typical placement:

//version=6
indicator(...) or strategy(...)
import MYNAMEISBRANDON/PivotStructureOutline_Utilities/1 as PSOutils

This library is engine-agnostic. It does not confirm pivots for you. Instead, it expects your script to already know its confirmed high/low pivot indexes and anchor values, then uses those resolved inputs to build the outline and anchor-box layer.

➖Outline Line Style Helpers➖
These helpers convert simple UI-facing style strings into Pine line style enums so scripts can keep one consistent style resolver across outline lines, midpoint lines, and connector lines.

outlineLineStyle(styleIn)
Resolves a Pine line style from a string input.

Parameters:
styleIn (simple string): Style string. Expected values: "Solid", "Dashed", or "Dotted"

Returns:
Pine line style enum

➖Pivot Structure Outline Helpers➖
These helpers build the actual pivot structure outline framework from already-confirmed high/low pivot anchors. They let a script resolve a pivot-close anchor, choose whether the outline should use wick or close anchors, and generate the live geometry needed for the top line, bottom line, midpoint, and left-side connectors.

outlinePivotCloseFromIdx(pivotIdx, closeValue)
Returns the close value belonging to a confirmed pivot index.

Parameters:
pivotIdx (int): Confirmed pivot bar_index
closeValue (float): Close series

Returns:
Confirmed pivot close value

outlineSelectedAnchors(anchorMode, highWickAnchor, lowWickAnchor, highCloseAnchor, lowCloseAnchor)
Selects the active outline anchors from Wick or Close mode.

Parameters:
anchorMode (simple string): Anchor mode. Expected values: "Wick" or "Close"
highWickAnchor (float): Confirmed high-side wick anchor
lowWickAnchor (float): Confirmed low-side wick anchor
highCloseAnchor (float): Confirmed high-side close anchor
lowCloseAnchor (float): Confirmed low-side close anchor

Returns:
Selected high anchor, selected low anchor, is outline-valid

outlineGeometry(highPivotIdx, lowPivotIdx, highAnchor, lowAnchor, connectorSourceMode, midlineStartMode, highValue, lowValue, closeValue)
Returns the live geometry for the pivot structure outline system.

Parameters:
highPivotIdx (int): Confirmed high pivot bar_index
lowPivotIdx (int): Confirmed low pivot bar_index
highAnchor (float): Selected top outline anchor
lowAnchor (float): Selected bottom outline anchor
connectorSourceMode (simple string): Connector source mode. Expected values: "Wick" or "Close"
midlineStartMode (simple string): Midline start mode. Expected values: "Most Recent Pivot" or "Left Outline"
highValue (float): High series
lowValue (float): Low series
closeValue (float): Close series

Returns:
ok, leftX, rightX, midX1, topY, bottomY, midY, leftTopConnectorY, leftBottomConnectorY

➖Pivot Structure Anchor Box Helpers➖
These helpers build directional top and bottom pivot structure anchor boxes from confirmed pivot bars. They let a script choose whether those boxes use wick-only extension from the candle body or the full candle body, then return the live coordinates needed to render those boxes forward to the current bar.

outlineAnchorBoxGeometry(highPivotIdx, lowPivotIdx, boxAreaMode, openValue, highValue, lowValue, closeValue)
Returns the live geometry for top and bottom pivot structure anchor boxes.

Parameters:
highPivotIdx (int): Confirmed high pivot bar_index
lowPivotIdx (int): Confirmed low pivot bar_index
boxAreaMode (simple string): Box area mode. Expected values: "Wick" or "Body"
openValue (float): Open series
highValue (float): High series
lowValue (float): Low series
closeValue (float): Close series

Returns:
showHighBox, showLowBox, highLeftX, lowLeftX, boxRightX, highTopY, highBottomY, lowTopY, lowBottomY

➖Line Object Helpers➖
These helpers manage the lifecycle of live line objects so scripts can create, update, or delete outline-related lines without rewriting that object-management logic each time.

outlineManageLine(enabled, ln, x1, y1, x2, y2, col, width, style)
Creates, updates, or deletes a line object.

Parameters:
enabled (bool): Whether the line should exist
ln (line): Existing line reference
x1 (int): Start x position
y1 (float): Start y position
x2 (int): End x position
y2 (float): End y position
col (color): Line color
width (int): Line width
style (string): Line style

Returns:
Updated line reference

➖Box Object Helpers➖
These helpers manage the lifecycle of live box objects so scripts can create, update, or delete pivot structure anchor boxes without repeating the same box-management code in every script.

outlineManageBox(enabled, bx, left, top, right, bottom, bgColor, borderColor, borderStyle, borderWidth)
Creates, updates, or deletes a box object.

Parameters:
enabled (bool): Whether the box should exist
bx (box): Existing box reference
left (int): Left x position
top (float): Top y position
right (int): Right x position
bottom (float): Bottom y position
bgColor (color): Box background color
borderColor (color): Box border color
borderStyle (string): Box border style
borderWidth (int): Box border width

Returns:
Updated box reference

Release Notes

v2

This update adds a new Pivot Structure Anchor Resolution helper section to the library.

The new helpers are designed for scripts that already maintain a small rolling memory of confirmed pivot highs and lows, but need a clean way to resolve which pivot should become the active structure anchor.

Instead of forcing every script to manually compare the most recent high, the prior high, and additional older highs, this update centralizes that selection logic into reusable high-side and low-side anchor resolvers.

The library remains engine-agnostic. It does not confirm pivots, store pivot memory, or decide what counts as a pivot. The calling script still supplies already-confirmed pivot records. These helpers simply choose the active structure anchor from those supplied records.

➖Pivot Structure Anchor Resolution Helpers➖

These helpers resolve the active structure anchor from up to four already-confirmed same-side pivot records.

They are useful when a script wants the active structure to reference either:

• the most recent confirmed pivot
• the highest high / lowest low from the last 2 confirmed same-side pivots
• the highest high / lowest low from the last 4 confirmed same-side pivots

This can give a structure framework more breathing room by allowing the active outline, anchor boxes, guide lines, AVWAPs, or other structure visuals to reference a wider recent pivot range instead of only the newest confirmed pivot.

structureResolveHighAnchorFrom4(lookback, p1, c1, aux1, i1, ci1, p2, c2, aux2, i2, ci2, p3, c3, aux3, i3, ci3, p4, c4, aux4, i4, ci4)

Resolves the highest high-side structure anchor from up to 4 supplied pivot records.

Parameters:

lookback (int): Number of recent same-side records to scan. Common values are 1, 2, or 4.

p1 (float): Most recent high-side pivot price
c1 (float): Close value attached to the most recent high-side pivot
aux1 (float): Auxiliary value attached to the most recent high-side pivot, such as RSI, oscillator value, score, or another script-specific metric
i1 (int): Most recent high-side pivot bar_index
ci1 (int): Confirmation bar_index for the most recent high-side pivot

p2, c2, aux2, i2, ci2:
Second most recent high-side pivot record

p3, c3, aux3, i3, ci3:
Third most recent high-side pivot record

p4, c4, aux4, i4, ci4:
Fourth most recent high-side pivot record

Returns:

Selected high-side anchor price, close, auxiliary value, pivot index, and confirmation index.

structureResolveLowAnchorFrom4(lookback, p1, c1, aux1, i1, ci1, p2, c2, aux2, i2, ci2, p3, c3, aux3, i3, ci3, p4, c4, aux4, i4, ci4)

Resolves the lowest low-side structure anchor from up to 4 supplied pivot records.

Parameters:

lookback (int): Number of recent same-side records to scan. Common values are 1, 2, or 4.

p1 (float): Most recent low-side pivot price
c1 (float): Close value attached to the most recent low-side pivot
aux1 (float): Auxiliary value attached to the most recent low-side pivot, such as RSI, oscillator value, score, or another script-specific metric
i1 (int): Most recent low-side pivot bar_index
ci1 (int): Confirmation bar_index for the most recent low-side pivot

p2, c2, aux2, i2, ci2:
Second most recent low-side pivot record

p3, c3, aux3, i3, ci3:
Third most recent low-side pivot record

p4, c4, aux4, i4, ci4:
Fourth most recent low-side pivot record

Returns:

Selected low-side anchor price, close, auxiliary value, pivot index, and confirmation index.

Example use case:

A script can maintain its own rolling confirmed-pivot memory, then pass the last 1, 2, or 4 same-side pivot records into these helpers. The returned anchor can then be reused by the script’s outline, anchor boxes, reference lines, AVWAPs, live stack labels, or other structure-based visual layers.

This keeps the pivot-confirmation logic in the calling script while moving the repeated anchor-selection logic into the shared library.

Release Notes

v3

v3

This update adds a new Pivot Structure Anchor Array Helpers section to the library.

The new helpers are designed for scripts that already maintain confirmed pivot highs and lows, but want a cleaner and more scalable way to store and resolve active structure anchors.

Previous fixed-record helpers remain available for scripts that only need to compare up to four supplied pivot records. This update adds an array-based workflow that can support user-defined lookbacks such as 1, 2, 4, 6, 8, 10, or higher, depending on the calling script’s design.

The library remains engine-agnostic. It does not confirm pivots, decide what qualifies as a pivot, or manage the script’s pivot engine. The calling script supplies already-confirmed pivot records, and these helpers store, trim, and resolve those records.

➖Pivot Structure Anchor Array Helpers➖

These helpers allow scripts to keep synchronized pivot-record arrays for high-side and low-side structure anchors.

Each confirmed pivot record can include:

• pivot price
• pivot close
• auxiliary value such as RSI, oscillator value, score, or another script-specific metric
• pivot bar_index
• confirmation bar_index

The array resolver can then scan the most recent N same-side records and return the active structure anchor.

For high-side arrays, the resolver selects the highest pivot price from the requested lookback.

For low-side arrays, the resolver selects the lowest pivot price from the requested lookback.

The selected anchor carries its matching close, auxiliary value, pivot index, and confirmation index forward with the selected price.

This is useful when a script wants its active Pivot Structure framework to reference either:

• the most recent confirmed high + low
• the highest high / lowest low from the last 2 confirmed same-side pivots
• the highest high / lowest low from the last 4 confirmed same-side pivots
• a wider user-controlled expanded structure range

structurePushAnchorRecord(prices, closes, auxValues, pivotIdxs, confirmIdxs, price, closeValue, auxValue, pivotIdx, confirmIdx, maxRecords)

Pushes one confirmed pivot record into synchronized arrays and trims those arrays to the requested maximum record count.

Parameters:

prices (array<float>): Array of pivot prices
closes (array<float>): Array of pivot-close values
auxValues (array<float>): Array of auxiliary values, such as RSI
pivotIdxs (array<int>): Array of pivot bar indexes
confirmIdxs (array<int>): Array of confirmation bar indexes
price (float): New pivot price
closeValue (float): New pivot-close value
auxValue (float): New auxiliary value
pivotIdx (int): New pivot bar_index
confirmIdx (int): New confirmation bar_index
maxRecords (int): Maximum number of records to keep

Returns:

Current number of stored price records after trimming.

structureResolveHighAnchorFromArrays(prices, closes, auxValues, pivotIdxs, confirmIdxs, lookback)

Resolves the highest high-side structure anchor from synchronized pivot-record arrays.

Parameters:

prices (array<float>): Array of high-side pivot prices
closes (array<float>): Array of high-side pivot-close values
auxValues (array<float>): Array of high-side auxiliary values, such as RSI
pivotIdxs (array<int>): Array of high-side pivot bar indexes
confirmIdxs (array<int>): Array of high-side confirmation bar indexes
lookback (int): Number of recent same-side records to scan

Returns:

Selected high-side anchor price, close, auxiliary value, pivot index, and confirmation index.

structureResolveLowAnchorFromArrays(prices, closes, auxValues, pivotIdxs, confirmIdxs, lookback)

Resolves the lowest low-side structure anchor from synchronized pivot-record arrays.

Parameters:

prices (array<float>): Array of low-side pivot prices
closes (array<float>): Array of low-side pivot-close values
auxValues (array<float>): Array of low-side auxiliary values, such as RSI
pivotIdxs (array<int>): Array of low-side pivot bar indexes
confirmIdxs (array<int>): Array of low-side confirmation bar indexes
lookback (int): Number of recent same-side records to scan

Returns:

Selected low-side anchor price, close, auxiliary value, pivot index, and confirmation index.

Notes:

• Arrays are expected to be synchronized.
• The newest record is expected to be stored at the end of each array.
• Ties keep the most recent matching record because the resolver initializes from the newest record and only replaces on a strictly higher or lower value.
• The calling script remains responsible for deciding what counts as a confirmed pivot.
• The fixed-record From4 helpers remain available for simpler use cases.
• The new array helpers are the preferred path when a script needs a dynamic or user-controlled expanded structure lookback.

Example use case:

A script can store each confirmed high and low pivot into separate synchronized arrays, then allow the user to choose how many recent same-side anchors should be scanned.

For example:

• 1 = most recent confirmed high + most recent confirmed low
• 2 = highest high from the last 2 highs and lowest low from the last 2 lows
• 4 = highest high from the last 4 highs and lowest low from the last 4 lows
• 6, 8, 10, or higher = wider expanded structure ranges

This makes it easier for scripts to support dynamic structure-anchor models without adding new fixed variables and resolver functions for every larger lookback size.

Release Notes

v4

This update adds a new Pivot Structure AVWAP Helpers section to the library.

The new helpers are designed for scripts that already resolve active pivot structure anchors and want a reusable way to draw anchored VWAP paths from those anchors.

This expands the library beyond outline lines, anchor boxes, and active anchor markers into a broader pivot-structure visual framework. A script can now use the same resolved high-side / low-side anchors that feed its outline or anchor boxes to also build pivot-anchored AVWAP paths.

The library remains engine-agnostic. It does not confirm pivots, choose active anchors, decide which side should display, or define a script’s AVWAP styling. The calling script still controls the pivot engine, anchor model, visibility logic, colors, line widths, and whether it wants to display pivot-bar AVWAPs, confirmation-bar AVWAPs, or both.

➖Pivot Structure AVWAP Helpers➖

These helpers let scripts build AVWAP polylines from already-resolved pivot structure anchors using cumulative price-volume and cumulative volume.

They are useful when a script wants to compare structure from:

• the actual pivot bar
• the pivot confirmation bar
• the active high-side structure anchor
• the active low-side structure anchor

This can help structure-based scripts show how price is behaving relative to volume-weighted levels that originate from the same anchors used by the outline, anchor boxes, active markers, or other pivot-structure visuals.

structureAvwapSafeAnchorIdx(enabled, anchorIdx)

Returns a last-bar-safe AVWAP anchor index.

This helper is designed to keep AVWAP point-builder calls in global scope while avoiding unnecessary point construction across historical bars.

Parameters:

enabled (bool): Whether this AVWAP path should be active
anchorIdx (int): True AVWAP anchor bar_index

Returns:

Safe anchor index or na.

Behavior:

• returns the supplied anchor index only when the AVWAP is enabled, the script is on the last bar, and the anchor index exists
• returns na otherwise
• helps prevent long point-array loops from running on every historical bar

structureAvwapDrawStartIdx(safeAnchorIdx, maxDrawBars)

Resolves a capped visible AVWAP draw-start index while preserving the true AVWAP anchor.

Parameters:

safeAnchorIdx (int): Last-bar-safe AVWAP anchor index
maxDrawBars (int): Maximum number of bars to draw backward from the current bar

Returns:

Visible AVWAP start index or na.

Behavior:

• keeps the true AVWAP anchor unchanged
• caps only the visible draw window
• allows long-running AVWAPs to remain mathematically anchored to the original pivot while limiting the number of polyline points that need to be drawn

structureAvwapPointsFromCum(cumPV, cumVol, anchorIdx, startIdx, endIdx)

Builds an array of chart points for AVWAP polyline rendering from cumulative price-volume and cumulative volume.

Parameters:

cumPV (float): Cumulative price-volume series, usually ta.cum(source * volume)
cumVol (float): Cumulative volume series, usually ta.cum(volume)
anchorIdx (int): True AVWAP anchor bar_index
startIdx (int): Visible draw-start bar_index
endIdx (int): Visible draw-end bar_index

Returns:

Array of chart points for polyline rendering.

Behavior:

• uses anchorIdx as the true AVWAP anchor
• uses startIdx and endIdx only as the visible draw window
• reconstructs each visible AVWAP point from cumulative PV / volume
• returns an empty point array when inputs are invalid
• works for both Pivot-Bar AVWAP and Confirmation-Bar AVWAP because the calling script decides which anchor index to pass

structureManageAvwapPolyline(pl, enabled, pts, lineColor, lineWidth, lineStyle)

Deletes and recreates an AVWAP polyline from the supplied chart-point array.

Parameters:

pl (polyline): Existing polyline reference
enabled (bool): Whether the polyline should exist
pts (array<chart.point>): Array of chart points to draw
lineColor (color): Polyline color
lineWidth (int): Polyline width
lineStyle (string): Pine line style enum

Returns:

Updated polyline reference.

Behavior:

• deletes the previous polyline when one exists
• creates a new polyline only when enabled and at least two points exist
• uses xloc.bar_index
• uses force_overlay=true so price-pane AVWAP paths render on the chart
• is intended for last-bar render workflows

Example use case:

A script can resolve its active high-side and low-side structure anchors, then build multiple AVWAP paths from those same anchors.

For example:

• Backfilled Pivot-Bar AVWAP:
Anchors from the actual pivot bar, but remains hidden until the pivot confirms.

• Confirmation-Bar AVWAP:
Anchors from the bar where the pivot confirmation occurs.

• High-side AVWAP:
Uses the active resolved high-side structure anchor.

• Low-side AVWAP:
Uses the active resolved low-side structure anchor.

This makes it easier for pivot-structure scripts to compare price against volume-weighted paths that originate from the same structural anchors already used by their outline, boxes, markers, guide lines, or other anchor-based visual layers.

Notes:

• The true AVWAP anchor remains the supplied anchor index.
• The draw-start index controls only how much of the AVWAP path is visible.
• The helper does not decide whether a script uses pivot-bar anchoring, confirmation-bar anchoring, or both.
• The helper does not choose colors, widths, line styles, or display modes.
• The calling script remains responsible for pivot confirmation, anchor selection, and all user-facing display decisions.

This update keeps the library focused on reusable pivot-structure mechanics while giving scripts a cleaner way to add anchor-based AVWAP visuals without rebuilding the same cumulative PV / volume point-builder and polyline lifecycle code each time.

Release Notes

v5

no changes to script, just adding new chart that shows new anchored vwap helpers..

Pine library

In true TradingView spirit, the author has published this Pine code as an open-source library so that other Pine programmers from our community can reuse it. Cheers to the author! You may use this library privately or in other open-source publications, but reuse of this code in publications is governed by House Rules.

MYNAMEISBRANDON

🆓 Free scripts:
⚡ Pro scripts: tradingview.com/script/hESCvPuH-Predictive-Volume-MTF-Pro/
🙋‍♂️ Get help with Pinescript: simplecrypto.life/get-help-with-pinescript

Also on:

Disclaimer

The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.

Pine library

MYNAMEISBRANDON

🆓 Free scripts:
⚡ Pro scripts: tradingview.com/script/hESCvPuH-Predictive-Volume-MTF-Pro/
🙋‍♂️ Get help with Pinescript: simplecrypto.life/get-help-with-pinescript

Also on: