PINE LIBRARY
Cập nhật 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.
Phát hành các Ghi chú
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)
Phát hành các Ghi chú
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)
Phát hành các Ghi chú
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)
Phát hành các Ghi chú
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)
Phát hành các Ghi chú
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)
Phát hành các Ghi chú
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>)
Phát hành các Ghi chú
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)
Phát hành các Ghi chú
v9Phát hành các Ghi chú
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)
Thư viện Pine
Theo đúng tinh thần TradingView, tác giả đã công bố mã Pine này như một thư viện mã nguồn mở để các lập trình viên Pine khác trong cộng đồng có thể tái sử dụng. Chúc mừng tác giả! Bạn có thể sử dụng thư viện này cho mục đích cá nhân hoặc trong các ấn phẩm mã nguồn mở khác, nhưng việc tái sử dụng mã này trong các ấn phẩm phải tuân theo Nội Quy.
Thông báo miễn trừ trách nhiệm
Thông tin và các ấn phẩm này không nhằm mục đích, và không cấu thành, lời khuyên hoặc khuyến nghị về tài chính, đầu tư, giao dịch hay các loại khác do TradingView cung cấp hoặc xác nhận. Đọc thêm tại Điều khoản Sử dụng.
Thư viện Pine
Theo đúng tinh thần TradingView, tác giả đã công bố mã Pine này như một thư viện mã nguồn mở để các lập trình viên Pine khác trong cộng đồng có thể tái sử dụng. Chúc mừng tác giả! Bạn có thể sử dụng thư viện này cho mục đích cá nhân hoặc trong các ấn phẩm mã nguồn mở khác, nhưng việc tái sử dụng mã này trong các ấn phẩm phải tuân theo Nội Quy.
Thông báo miễn trừ trách nhiệm
Thông tin và các ấn phẩm này không nhằm mục đích, và không cấu thành, lời khuyên hoặc khuyến nghị về tài chính, đầu tư, giao dịch hay các loại khác do TradingView cung cấp hoặc xác nhận. Đọc thêm tại Điều khoản Sử dụng.