PINE LIBRARY
Atualizado XZ_Table_Primitives
Library "XZ_Table_Primitives"
Generic Pine table construction and cell-rendering primitives for XZ scripts. Contains no trading methodology or analytical authority.
resolvePosition(key)
Resolves a normalized position key to a Pine table position.
Parameters:
key (string): Position key: top_left, top_center, top_right, middle_left, middle_center, middle_right, bottom_left, bottom_center or bottom_right.
Returns: Pine position constant.
resolveTextSize(key)
Resolves a normalized text-size key to a Pine size constant.
Parameters:
key (string): Text-size key: tiny, small, normal, large or huge.
Returns: Pine size constant.
create(positionKey, columns, rows, backgroundColor, frameColor, frameWidth)
Creates a table using caller-supplied presentation values.
Parameters:
positionKey (string): Normalized table position key.
columns (int): Number of columns.
rows (int): Number of rows.
backgroundColor (color): Table background color.
frameColor (color): Table frame color.
frameWidth (int): Table frame width.
Returns: New table handle.
clearRegion(id, firstColumn, firstRow, lastColumn, lastRow)
Clears a rectangular region of an existing table.
Parameters:
id (table): Table handle.
firstColumn (int): First column index.
firstRow (int): First row index.
lastColumn (int): Last column index.
lastRow (int): Last row index.
Returns: True after clearing.
cell(id, column, row, cellText, textColor, backgroundColor, textSize, horizontalAlign, tooltipText)
Writes one fully specified table cell.
Parameters:
id (table): Table handle.
column (int): Column index.
row (int): Row index.
cellText (string): Cell text.
textColor (color): Text color.
backgroundColor (color): Cell background color.
textSize (string): Pine text size constant.
horizontalAlign (string): Pine text alignment constant.
tooltipText (string): Cell tooltip text.
Returns: True after writing.
twoColumnRow(id, row, labelText, valueText, labelColor, valueColor, backgroundColor, textSize, labelTooltip, valueTooltip)
Writes one two-column label/value row.
Parameters:
id (table): Table handle.
row (int): Row index.
labelText (string): Left-cell text.
valueText (string): Right-cell text.
labelColor (color): Left text color.
valueColor (color): Right text color.
backgroundColor (color): Shared cell background color.
textSize (string): Shared Pine text size constant.
labelTooltip (string): Left-cell tooltip.
valueTooltip (string): Right-cell tooltip.
Returns: True after writing both cells.
twoColumnHeader(id, row, leftText, rightText, leftColor, rightColor, backgroundColor, textSize, leftTooltip, rightTooltip)
Writes one two-column header/decoder row.
Parameters:
id (table): Table handle.
row (int): Row index.
leftText (string): Left-cell text.
rightText (string): Right-cell text.
leftColor (color): Left text color.
rightColor (color): Right text color.
backgroundColor (color): Shared background color.
textSize (string): Shared Pine text size constant.
leftTooltip (string): Left-cell tooltip.
rightTooltip (string): Right-cell tooltip.
Returns: True after writing both cells.
mergedSection(id, row, firstColumn, lastColumn, sectionText, textColor, backgroundColor, textSize, tooltipText)
Writes one merged full-width section row.
Parameters:
id (table): Table handle.
row (int): Row index.
firstColumn (int): First column to merge.
lastColumn (int): Last column to merge.
sectionText (string): Section text.
textColor (color): Text color.
backgroundColor (color): Cell background color.
textSize (string): Pine text size constant.
tooltipText (string): Cell tooltip.
Returns: True after writing and merging.
Generic Pine table construction and cell-rendering primitives for XZ scripts. Contains no trading methodology or analytical authority.
resolvePosition(key)
Resolves a normalized position key to a Pine table position.
Parameters:
key (string): Position key: top_left, top_center, top_right, middle_left, middle_center, middle_right, bottom_left, bottom_center or bottom_right.
Returns: Pine position constant.
resolveTextSize(key)
Resolves a normalized text-size key to a Pine size constant.
Parameters:
key (string): Text-size key: tiny, small, normal, large or huge.
Returns: Pine size constant.
create(positionKey, columns, rows, backgroundColor, frameColor, frameWidth)
Creates a table using caller-supplied presentation values.
Parameters:
positionKey (string): Normalized table position key.
columns (int): Number of columns.
rows (int): Number of rows.
backgroundColor (color): Table background color.
frameColor (color): Table frame color.
frameWidth (int): Table frame width.
Returns: New table handle.
clearRegion(id, firstColumn, firstRow, lastColumn, lastRow)
Clears a rectangular region of an existing table.
Parameters:
id (table): Table handle.
firstColumn (int): First column index.
firstRow (int): First row index.
lastColumn (int): Last column index.
lastRow (int): Last row index.
Returns: True after clearing.
cell(id, column, row, cellText, textColor, backgroundColor, textSize, horizontalAlign, tooltipText)
Writes one fully specified table cell.
Parameters:
id (table): Table handle.
column (int): Column index.
row (int): Row index.
cellText (string): Cell text.
textColor (color): Text color.
backgroundColor (color): Cell background color.
textSize (string): Pine text size constant.
horizontalAlign (string): Pine text alignment constant.
tooltipText (string): Cell tooltip text.
Returns: True after writing.
twoColumnRow(id, row, labelText, valueText, labelColor, valueColor, backgroundColor, textSize, labelTooltip, valueTooltip)
Writes one two-column label/value row.
Parameters:
id (table): Table handle.
row (int): Row index.
labelText (string): Left-cell text.
valueText (string): Right-cell text.
labelColor (color): Left text color.
valueColor (color): Right text color.
backgroundColor (color): Shared cell background color.
textSize (string): Shared Pine text size constant.
labelTooltip (string): Left-cell tooltip.
valueTooltip (string): Right-cell tooltip.
Returns: True after writing both cells.
twoColumnHeader(id, row, leftText, rightText, leftColor, rightColor, backgroundColor, textSize, leftTooltip, rightTooltip)
Writes one two-column header/decoder row.
Parameters:
id (table): Table handle.
row (int): Row index.
leftText (string): Left-cell text.
rightText (string): Right-cell text.
leftColor (color): Left text color.
rightColor (color): Right text color.
backgroundColor (color): Shared background color.
textSize (string): Shared Pine text size constant.
leftTooltip (string): Left-cell tooltip.
rightTooltip (string): Right-cell tooltip.
Returns: True after writing both cells.
mergedSection(id, row, firstColumn, lastColumn, sectionText, textColor, backgroundColor, textSize, tooltipText)
Writes one merged full-width section row.
Parameters:
id (table): Table handle.
row (int): Row index.
firstColumn (int): First column to merge.
lastColumn (int): Last column to merge.
sectionText (string): Section text.
textColor (color): Text color.
backgroundColor (color): Cell background color.
textSize (string): Pine text size constant.
tooltipText (string): Cell tooltip.
Returns: True after writing and merging.
Notas de Lançamento
v2Added:
createStyled(positionKey, columns, rows, backgroundColor, lineColor, showLines)
Creates a table with matching frame and border styling.
Parameters:
positionKey (string)
columns (int)
rows (int)
backgroundColor (color)
lineColor (color)
showLines (bool)
deleteTable(id)
Deletes a table when present.
Parameters:
id (table)
decoderRows(id, startRow, codes, terms, tooltips, accentColor, textColor, backgroundColor, textSize)
Renders code/term decoder rows with tooltip only on the code cell.
Parameters:
id (table)
startRow (int)
codes (array<string>)
terms (array<string>)
tooltips (array<string>)
accentColor (color)
textColor (color)
backgroundColor (color)
textSize (string)
Notas de Lançamento
v3Added:
decoderRowsAt(id, startColumn, startRow, codes, terms, tooltips, accentColor, textColor, backgroundColor, textSize)
Parameters:
id (table)
startColumn (int)
startRow (int)
codes (array<string>)
terms (array<string>)
tooltips (array<string>)
accentColor (color)
textColor (color)
backgroundColor (color)
textSize (string)
Updated:
resolvePosition(key)
Parameters:
key (simple string)
resolveTextSize(key)
Parameters:
key (simple string)
create(positionKey, columns, rows, backgroundColor, frameColor, frameWidth)
Parameters:
positionKey (simple string)
columns (int)
rows (int)
backgroundColor (color)
frameColor (color)
frameWidth (int)
createStyled(positionKey, columns, rows, backgroundColor, lineColor, showLines)
Parameters:
positionKey (simple string)
columns (int)
rows (int)
backgroundColor (color)
lineColor (color)
showLines (bool)
deleteTable(id)
Parameters:
id (table)
clearRegion(id, firstColumn, firstRow, lastColumn, lastRow)
Parameters:
id (table)
firstColumn (int)
firstRow (int)
lastColumn (int)
lastRow (int)
cell(id, column, row, cellText, textColor, backgroundColor, textSize, horizontalAlign, tooltipText)
Parameters:
id (table)
column (int)
row (int)
cellText (string)
textColor (color)
backgroundColor (color)
textSize (string)
horizontalAlign (string)
tooltipText (string)
twoColumnRow(id, row, labelText, valueText, labelColor, valueColor, backgroundColor, textSize, labelTooltip, valueTooltip)
Parameters:
id (table)
row (int)
labelText (string)
valueText (string)
labelColor (color)
valueColor (color)
backgroundColor (color)
textSize (string)
labelTooltip (string)
valueTooltip (string)
twoColumnHeader(id, row, leftText, rightText, leftColor, rightColor, backgroundColor, textSize, leftTooltip, rightTooltip)
Parameters:
id (table)
row (int)
leftText (string)
rightText (string)
leftColor (color)
rightColor (color)
backgroundColor (color)
textSize (string)
leftTooltip (string)
rightTooltip (string)
mergedSection(id, row, firstColumn, lastColumn, sectionText, textColor, backgroundColor, textSize, tooltipText)
Parameters:
id (table)
row (int)
firstColumn (int)
lastColumn (int)
sectionText (string)
textColor (color)
backgroundColor (color)
textSize (string)
tooltipText (string)
decoderRows(id, startRow, codes, terms, tooltips, accentColor, textColor, backgroundColor, textSize)
Parameters:
id (table)
startRow (int)
codes (array<string>)
terms (array<string>)
tooltips (array<string>)
accentColor (color)
textColor (color)
backgroundColor (color)
textSize (string)
Notas de Lançamento
v4Added:
twoColumnRowRight(id, row, labelText, valueText, labelColor, valueColor, backgroundColor, textSize, labelTooltip, valueTooltip)
Parameters:
id (table)
row (int)
labelText (string)
valueText (string)
labelColor (color)
valueColor (color)
backgroundColor (color)
textSize (string)
labelTooltip (string)
valueTooltip (string)
twoColumnHeaderRight(id, row, leftText, rightText, leftColor, rightColor, backgroundColor, textSize, leftTooltip, rightTooltip)
Parameters:
id (table)
row (int)
leftText (string)
rightText (string)
leftColor (color)
rightColor (color)
backgroundColor (color)
textSize (string)
leftTooltip (string)
rightTooltip (string)
twoColumnRowsRight(id, startRow, labels, values, labelTooltips, valueTooltips, accents, textColor, accentColor, backgroundColor, textSize)
Parameters:
id (table)
startRow (int)
labels (array<string>)
values (array<string>)
labelTooltips (array<string>)
valueTooltips (array<string>)
accents (array<bool>)
textColor (color)
accentColor (color)
backgroundColor (color)
textSize (string)
Notas de Lançamento
v5Added:
mergeRow(id, row, firstColumn, lastColumn)
Merges one horizontal row across the supplied columns without assigning semantic content.
Parameters:
id (table)
row (int)
firstColumn (int)
lastColumn (int)
horizontalCells(id, row, texts, textColors, tooltips, backgroundColor, textSize, firstCellLeft)
Renders a one-row horizontal strip from caller-supplied text/color/tooltip arrays. The first cell can be left-aligned while the remaining cells are right-aligned.
Parameters:
id (table)
row (int)
texts (array<string>)
textColors (array<color>)
tooltips (array<string>)
backgroundColor (color)
textSize (string)
firstCellLeft (bool)
Notas de Lançamento
v6Added:
twoColumnRowRightAt(id, startColumn, row, labelText, valueText, labelColor, valueColor, backgroundColor, textSize, labelTooltip, valueTooltip)
Renders the same generic two-column row at an arbitrary starting column. Useful for side-by-side panes without embedding consumer semantics in the library.
Parameters:
id (table)
startColumn (int)
row (int)
labelText (string)
valueText (string)
labelColor (color)
valueColor (color)
backgroundColor (color)
textSize (string)
labelTooltip (string)
valueTooltip (string)
Notas de Lançamento
v7Added:
newPackedGridLayout(logicalStarts, physicalRows, physicalColumns)
Creates a generic packed-grid mapping. Arrays are caller supplied and carry no semantic meaning.
Parameters:
logicalStarts (array<int>)
physicalRows (array<int>)
physicalColumns (array<int>)
packedGridRow(layout, logicalRow)
Parameters:
layout (PackedGridLayout)
logicalRow (int)
packedGridColumn(layout, logicalRow)
Parameters:
layout (PackedGridLayout)
logicalRow (int)
twoColumnRowRightPacked(id, packed, layout, logicalRow, labelText, valueText, labelColor, valueColor, backgroundColor, textSize, labelTooltip, valueTooltip)
Renders a generic logical two-column row either normally or through a caller-defined packed-grid mapping.
Parameters:
id (table)
packed (bool)
layout (PackedGridLayout)
logicalRow (int)
labelText (string)
valueText (string)
labelColor (color)
valueColor (color)
backgroundColor (color)
textSize (string)
labelTooltip (string)
valueTooltip (string)
packedSection(id, packed, layout, logicalRow, sectionText, textColor, backgroundColor, textSize, tooltipText)
Renders a caller-supplied section title in one logical pane row.
Parameters:
id (table)
packed (bool)
layout (PackedGridLayout)
logicalRow (int)
sectionText (string)
textColor (color)
backgroundColor (color)
textSize (string)
tooltipText (string)
mergePackedGrid(id, layout, topFullWidthRows, totalColumns)
Merges generic packed-grid section header rows plus an optional number of full-width top rows.
Parameters:
id (table)
layout (PackedGridLayout)
topFullWidthRows (int)
totalColumns (int)
PackedGridLayout
Generic mapping from logical section starts to physical table row/column starts.
Fields:
logical_starts (array<int>)
physical_rows (array<int>)
physical_columns (array<int>)
Notas de Lançamento
v8Added:
deconflictFour(enabled0, requested0, enabled1, requested1, enabled2, requested2, enabled3, requested3)
Resolves up to four independently enabled table positions without allowing two enabled tables to occupy the same Pine anchor. Earlier arguments have priority for their requested anchor; later conflicts fall forward to the next unused canonical anchor. Disabled tables do not claim positions.
Parameters:
enabled0 (bool)
requested0 (string)
enabled1 (bool)
requested1 (string)
enabled2 (bool)
requested2 (string)
enabled3 (bool)
requested3 (string)
twoColumnRowAt(id, startColumn, row, labelText, valueText, labelColor, valueColor, backgroundColor, textSize, labelTooltip, valueTooltip)
Renders a generic two-column row with both cells left-aligned at an arbitrary starting column.
Parameters:
id (table)
startColumn (int)
row (int)
labelText (string)
valueText (string)
labelColor (color)
valueColor (color)
backgroundColor (color)
textSize (string)
labelTooltip (string)
valueTooltip (string)
twoColumnRowPacked(id, packed, layout, logicalRow, labelText, valueText, labelColor, valueColor, backgroundColor, textSize, labelTooltip, valueTooltip)
Renders a generic logical two-column row either normally or through a caller-defined packed-grid mapping, with both cells left-aligned.
Parameters:
id (table)
packed (bool)
layout (PackedGridLayout)
logicalRow (int)
labelText (string)
valueText (string)
labelColor (color)
valueColor (color)
backgroundColor (color)
textSize (string)
labelTooltip (string)
valueTooltip (string)
Updated:
resolvePosition(key)
Parameters:
key (string)
create(positionKey, columns, rows, backgroundColor, frameColor, frameWidth)
Parameters:
positionKey (string)
columns (int)
rows (int)
backgroundColor (color)
frameColor (color)
frameWidth (int)
createStyled(positionKey, columns, rows, backgroundColor, lineColor, showLines)
Parameters:
positionKey (string)
columns (int)
rows (int)
backgroundColor (color)
lineColor (color)
showLines (bool)
Notas de Lançamento
v9Notas de Lançamento
v10Added:
twoColumnRows(id, startRow, labels, values, labelTooltips, valueTooltips, accents, textColor, accentColor, backgroundColor, textSize)
Renders caller-supplied two-column rows with both label and value cells left-aligned. Meaning, ordering and accent decisions remain caller-owned.
Parameters:
id (table)
startRow (int)
labels (array<string>)
values (array<string>)
labelTooltips (array<string>)
valueTooltips (array<string>)
accents (array<bool>)
textColor (color)
accentColor (color)
backgroundColor (color)
textSize (string)
horizontalCellsLeft(id, row, texts, textColors, tooltips, backgroundColor, textSize)
Renders a caller-supplied horizontal strip with every cell left-aligned.
Parameters:
id (table)
row (int)
texts (array<string>)
textColors (array<color>)
tooltips (array<string>)
backgroundColor (color)
textSize (string)
twoPaneTopicRows(id, startRow, leftTopics, leftBodies, rightTopics, rightBodies, topicColor, bodyColor, backgroundColor, textSize)
Renders two independent caller-supplied topic/body panes side by side. The library assigns no meaning to topics or body text.
Parameters:
id (table)
startRow (int)
leftTopics (array<string>)
leftBodies (array<string>)
rightTopics (array<string>)
rightBodies (array<string>)
topicColor (color)
bodyColor (color)
backgroundColor (color)
textSize (string)
Biblioteca do Pine
Em verdadeiro espírito TradingView, o autor publicou este código Pine como uma biblioteca de código aberto para que outros programadores Pine da nossa comunidade possam reutilizá-lo. Parabéns ao autor! Você pode usar esta biblioteca de forma privada ou em outras publicações de código aberto, mas a reutilização deste código em publicações é regida pelas Regras da Casa.
Aviso legal
As informações e publicações não se destinam a ser, e não constituem, conselhos ou recomendações financeiras, de investimento, comerciais ou de outro tipo fornecidos ou endossados pela TradingView. Leia mais nos Termos de Uso.
Biblioteca do Pine
Em verdadeiro espírito TradingView, o autor publicou este código Pine como uma biblioteca de código aberto para que outros programadores Pine da nossa comunidade possam reutilizá-lo. Parabéns ao autor! Você pode usar esta biblioteca de forma privada ou em outras publicações de código aberto, mas a reutilização deste código em publicações é regida pelas Regras da Casa.
Aviso legal
As informações e publicações não se destinam a ser, e não constituem, conselhos ou recomendações financeiras, de investimento, comerciais ou de outro tipo fornecidos ou endossados pela TradingView. Leia mais nos Termos de Uso.