OPEN-SOURCE SCRIPT
Zaktualizowano PJ : Custom Horizontal Grid
Here is a comprehensive description of the **"PJ : Custom Horizontal Grid "** Pine Script that we built. You can use this as documentation or as notes for future reference.
### **Overview**
This Pine Script is a custom chart overlay indicator designed to draw a highly customizable grid of horizontal lines. It calculates a central base price, applies an offset (if desired), and generates a series of equidistant lines above and below the center. It also features clean, "floating" text labels that display both the base price and the offset price without obstructing the chart lines.
---
### **Key Features**
* **Dynamic Grid Generation:** Automatically draws a central line and a user-defined number of grid lines above and below it based on a specific point step (distance).
* **Price Offsetting (ทดราคา):** Allows the user to input a positive or negative offset. The script will calculate the "Actual Price" (Base Price + Offset) and draw the line at the actual price while still referencing the original base price.
* **Floating Text Labels:** Displays the price directly on the chart using the format `BasePrice (ActualPrice)`. The text is anchored using `style_label_lower_left`, allowing it to float neatly above the line to prevent visual overlap.
* **Independent Aesthetics:** Users can style the lines (color, thickness, solid/dashed/dotted) entirely independently from the text labels (color, size) via grouped settings.
* **Auto-Cleanup (Memory Management):** Uses Pine Script arrays (`array.new_line()` and `array.new_label()`) to track drawn objects. On every real-time tick (`barstate.islast`), it deletes the old lines and labels before drawing new ones, preventing chart clutter and memory issues.
---
### **Input Parameters (Settings)**
The script organizes its settings into three distinct groups for user convenience:
#### **1. Base Settings (No Group)**
* **Base Start (ราคาเริ่มต้น):** The central anchor price for the grid (e.g., 5000.0).
* **Offset +/- (ราคาที่ทด):** A fractional value added to or subtracted from the base price to shift the actual drawing location (e.g., -5.0).
* **Step Distance (ระยะห่างแต่ละเส้น):** The price distance between each subsequent grid line (e.g., 10.0).
* **Number of Lines +/- (จำนวนเส้นด้านบนและล่าง):** The quantity of lines to draw in *each* direction. (e.g., `5` means 5 above, 5 below, plus 1 center line = 11 lines total).
#### **2. Line Settings (--- ตั้งค่าเส้น ---)**
* **Line Color:** Color picker for the horizontal grid lines.
* **Line Width:** Thickness of the lines (1 to 4).
* **Line Style:** Dropdown to select Solid, Dotted, or Dashed lines.
#### **3. Text Settings (--- ตั้งค่าตัวหนังสือ ---)**
* **Text Color:** Color picker for the floating price labels.
* **Text Size:** Dropdown to adjust the font size (Tiny, Small, Normal, Large).
---
### **How the Logic Works (Under the Hood)**
1. **Helper Functions:**
* `getLineStyle()` and `getSize()` convert the user's string inputs from the dropdown menus into built-in Pine Script variables (e.g., `line.style_dashed`, `size.normal`).
2. **`drawLineAndLabel(basePrice)` Function:**
* Calculates `actualPrice = basePrice + offsetPrice`.
* Uses `line.new()` to draw the line extending infinitely to the left and right (`extend=extend.both`).
* Formats the text string to 4 decimal places: `strBase (strOffset)`.
* Uses `label.new()` at `bar_index + 2` (slightly to the right of the current candle) to render the floating text.
* Pushes the generated line and label IDs into their respective arrays.
3. **Execution Loop (`if barstate.islast`):**
* This ensures the script only updates on the most recent candle.
* It loops through the arrays, deletes the previous tick's drawings, and clears the arrays.
* It calls `drawLineAndLabel()` for the starting price.
* It runs a `for` loop to calculate and draw the required `numLines` above (`+ (stepDist * i)`) and below (`- (stepDist * i)`).
### **Overview**
This Pine Script is a custom chart overlay indicator designed to draw a highly customizable grid of horizontal lines. It calculates a central base price, applies an offset (if desired), and generates a series of equidistant lines above and below the center. It also features clean, "floating" text labels that display both the base price and the offset price without obstructing the chart lines.
---
### **Key Features**
* **Dynamic Grid Generation:** Automatically draws a central line and a user-defined number of grid lines above and below it based on a specific point step (distance).
* **Price Offsetting (ทดราคา):** Allows the user to input a positive or negative offset. The script will calculate the "Actual Price" (Base Price + Offset) and draw the line at the actual price while still referencing the original base price.
* **Floating Text Labels:** Displays the price directly on the chart using the format `BasePrice (ActualPrice)`. The text is anchored using `style_label_lower_left`, allowing it to float neatly above the line to prevent visual overlap.
* **Independent Aesthetics:** Users can style the lines (color, thickness, solid/dashed/dotted) entirely independently from the text labels (color, size) via grouped settings.
* **Auto-Cleanup (Memory Management):** Uses Pine Script arrays (`array.new_line()` and `array.new_label()`) to track drawn objects. On every real-time tick (`barstate.islast`), it deletes the old lines and labels before drawing new ones, preventing chart clutter and memory issues.
---
### **Input Parameters (Settings)**
The script organizes its settings into three distinct groups for user convenience:
#### **1. Base Settings (No Group)**
* **Base Start (ราคาเริ่มต้น):** The central anchor price for the grid (e.g., 5000.0).
* **Offset +/- (ราคาที่ทด):** A fractional value added to or subtracted from the base price to shift the actual drawing location (e.g., -5.0).
* **Step Distance (ระยะห่างแต่ละเส้น):** The price distance between each subsequent grid line (e.g., 10.0).
* **Number of Lines +/- (จำนวนเส้นด้านบนและล่าง):** The quantity of lines to draw in *each* direction. (e.g., `5` means 5 above, 5 below, plus 1 center line = 11 lines total).
#### **2. Line Settings (--- ตั้งค่าเส้น ---)**
* **Line Color:** Color picker for the horizontal grid lines.
* **Line Width:** Thickness of the lines (1 to 4).
* **Line Style:** Dropdown to select Solid, Dotted, or Dashed lines.
#### **3. Text Settings (--- ตั้งค่าตัวหนังสือ ---)**
* **Text Color:** Color picker for the floating price labels.
* **Text Size:** Dropdown to adjust the font size (Tiny, Small, Normal, Large).
---
### **How the Logic Works (Under the Hood)**
1. **Helper Functions:**
* `getLineStyle()` and `getSize()` convert the user's string inputs from the dropdown menus into built-in Pine Script variables (e.g., `line.style_dashed`, `size.normal`).
2. **`drawLineAndLabel(basePrice)` Function:**
* Calculates `actualPrice = basePrice + offsetPrice`.
* Uses `line.new()` to draw the line extending infinitely to the left and right (`extend=extend.both`).
* Formats the text string to 4 decimal places: `strBase (strOffset)`.
* Uses `label.new()` at `bar_index + 2` (slightly to the right of the current candle) to render the floating text.
* Pushes the generated line and label IDs into their respective arrays.
3. **Execution Loop (`if barstate.islast`):**
* This ensures the script only updates on the most recent candle.
* It loops through the arrays, deletes the previous tick's drawings, and clears the arrays.
* It calls `drawLineAndLabel()` for the starting price.
* It runs a `for` loop to calculate and draw the required `numLines` above (`+ (stepDist * i)`) and below (`- (stepDist * i)`).
Informacje o Wersji
PJ Grid — Change Description- Renamed indicator to "PJ Grid - OI/IV".
- Added Vol2Vol Expected Range layer (CME-style ±1σ / ±2σ / ±3σ)
with shaded gray bands and dashed sigma lines.
- Inputs: Implied Volatility (%) and Days to Expiry (DTE), entered
manually on the indicator settings panel.
- Settlement Price defaults to (today's daily open + offsetPrice),
computed via request.security on the "D" timeframe; user can
toggle off "Auto" and enter a manual value.
- Expected move = Settle × (IV/100) × √(DTE/365); bands plotted
as horizontal boxes extending in both directions.
- σ fill colors are dark/medium/light gray (CME look), with
per-band color and line-width inputs.
- Settlement line drawn solid red with a summary label
(Settle | IV | DTE | ±1σ).
- Added on-chart Info Table (Settle, IV, DTE, Offset, ±1σ) with
selectable position (6 corners) and text size; yellow values
on solid black for high contrast on any chart theme.
- Original horizontal grid (base ± step × N, with offset and
floating "Option → Spot" labels) preserved unchanged.
Skrypt open-source
W zgodzie z duchem TradingView twórca tego skryptu udostępnił go jako open-source, aby użytkownicy mogli przejrzeć i zweryfikować jego działanie. Ukłony dla autora. Korzystanie jest bezpłatne, jednak ponowna publikacja kodu podlega naszym Zasadom serwisu.
Wyłączenie odpowiedzialności
Informacje i publikacje nie stanowią i nie powinny być traktowane jako porady finansowe, inwestycyjne, tradingowe ani jakiekolwiek inne rekomendacje dostarczane lub zatwierdzone przez TradingView. Więcej informacji znajduje się w Warunkach użytkowania.
Skrypt open-source
W zgodzie z duchem TradingView twórca tego skryptu udostępnił go jako open-source, aby użytkownicy mogli przejrzeć i zweryfikować jego działanie. Ukłony dla autora. Korzystanie jest bezpłatne, jednak ponowna publikacja kodu podlega naszym Zasadom serwisu.
Wyłączenie odpowiedzialności
Informacje i publikacje nie stanowią i nie powinny być traktowane jako porady finansowe, inwestycyjne, tradingowe ani jakiekolwiek inne rekomendacje dostarczane lub zatwierdzone przez TradingView. Więcej informacji znajduje się w Warunkach użytkowania.