PINE LIBRARY
تم تحديثه 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.
ملاحظات الأخبار
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)
ملاحظات الأخبار
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)
ملاحظات الأخبار
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)
ملاحظات الأخبار
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)
ملاحظات الأخبار
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)
ملاحظات الأخبار
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>)
ملاحظات الأخبار
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)
ملاحظات الأخبار
v9ملاحظات الأخبار
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)
مكتبة باين
كمثال للقيم التي تتبناها TradingView، نشر المؤلف شيفرة باين كمكتبة مفتوحة المصدر بحيث يمكن لمبرمجي باين الآخرين من مجتمعنا استخدامه بحرية. تحياتنا للمؤلف! يمكنك استخدام هذه المكتبة بشكل خاص أو في منشورات أخرى مفتوحة المصدر، ولكن إعادة استخدام هذا الرمز في المنشورات تخضع لقواعد الموقع.
إخلاء المسؤولية
لا يُقصد بالمعلومات والمنشورات أن تكون، أو تشكل، أي نصيحة مالية أو استثمارية أو تجارية أو أنواع أخرى من النصائح أو التوصيات المقدمة أو المعتمدة من TradingView. اقرأ المزيد في شروط الاستخدام.
مكتبة باين
كمثال للقيم التي تتبناها TradingView، نشر المؤلف شيفرة باين كمكتبة مفتوحة المصدر بحيث يمكن لمبرمجي باين الآخرين من مجتمعنا استخدامه بحرية. تحياتنا للمؤلف! يمكنك استخدام هذه المكتبة بشكل خاص أو في منشورات أخرى مفتوحة المصدر، ولكن إعادة استخدام هذا الرمز في المنشورات تخضع لقواعد الموقع.
إخلاء المسؤولية
لا يُقصد بالمعلومات والمنشورات أن تكون، أو تشكل، أي نصيحة مالية أو استثمارية أو تجارية أو أنواع أخرى من النصائح أو التوصيات المقدمة أو المعتمدة من TradingView. اقرأ المزيد في شروط الاستخدام.