OPEN-SOURCE SCRIPT
تم تحديثه

CQ_(7)_[TACHIMETER] v2

265
================================================================================
CQ_(7)_[TACHIMETER] v2 — USER MANUAL
© CQuevedo345
Pine Script v6 | TradingView Indicator
================================================================================


────────────────────────────────────────────────────────────────────────────────
WHAT IT DOES
────────────────────────────────────────────────────────────────────────────────

The Tachimeter is a real-time momentum speed gauge displayed as a table overlay
on your TradingView chart. It measures how fast price is moving by comparing the
current close to the close of the previous 20-minute bar (RPM = price delta).

The result is visualized as two emoji-based bar gauges — similar to a rev counter
on a car dashboard — that fill up as momentum increases. A label describes the
strength of the move in plain English, and the current price is shown with a
colored background that reflects the current trend direction.

The indicator is LIVE-ONLY: it only renders during real-time bars and hides on
historical bars to avoid repainting.


────────────────────────────────────────────────────────────────────────────────
KEY CONCEPTS
────────────────────────────────────────────────────────────────────────────────

RPM (Rate of Price Movement)
RPM = Current Close minus Close of the previous 20-minute bar.
Positive RPM = bullish momentum. Negative RPM = bearish momentum.
The absolute value of RPM drives how many blocks fill up on the gauges.

Daily Tendency
Compares current close to the daily open.
Close >= Daily Open → Bullish (teal header/footer)
Close < Daily Open → Bearish (red header/footer)

Bull / Bear (RPM Tendency)
Determined by whether RPM is positive or negative.
Drives gauge square colors, overdrive colors, and price cell background.


────────────────────────────────────────────────────────────────────────────────
THE GAUGES
────────────────────────────────────────────────────────────────────────────────

Two 13-block bar gauges are shown stacked:

X10 Bar (top gauge)
One block lights up per 10 RPM, up to a maximum of 10 blocks (100 RPM).
If |RPM| reaches 101 or above, all 13 blocks fill instantly — indicating
the move has gone into overdrive range.

X100 Bar (bottom gauge)
Only activates when |RPM| >= 101.
Each block represents 100 RPM of additional momentum beyond the first 100.
Blocks 1–10 use the primary color. Blocks 11–13 use the overdrive color,
signaling extreme momentum.

X100 Block Mapping:
101–199 → 1 block
200–299 → 2 blocks
300–399 → 3 blocks
400–499 → 4 blocks
500–599 → 5 blocks
600–699 → 6 blocks
700–799 → 7 blocks
800–899 → 8 blocks
900–999 → 9 blocks
1000–1099 → 10 blocks
1100–1199 → 11 blocks (overdrive zone begins)
1200–1299 → 12 blocks
1300+ → 13 blocks


────────────────────────────────────────────────────────────────────────────────
ACCELERATION LABELS
────────────────────────────────────────────────────────────────────────────────

A text label below the title describes the strength of the current move.
The label applies to both bullish and bearish directions equally.

|RPM| 0 – 9 → S T O P P E D
|RPM| 10 – 100 → I D L I N G
|RPM| 101 – 199 → E X T R E M E L Y W E A K
|RPM| 200 – 299 → V E R Y W E A K
|RPM| 300 – 399 → W E A K
|RPM| 400 – 499 → M O S T L Y W E A K
|RPM| 500 – 599 → S O M E W H A T W E A K
|RPM| 600 – 699 → M O D E R A T E L Y W E A K
|RPM| 700 – 799 → M O D E R A T E
|RPM| 800 – 899 → M O D E R A T E L Y S T R O N G
|RPM| 900 – 999 → M O S T L Y S T R O N G
|RPM| 1000 – 1099 → S T R O N G
|RPM| 1100 – 1199 → V E R Y S T R O N G
|RPM| 1200 – 1299 → E X C E P T I O N A L L Y S T R O N G
|RPM| 1300+ → U L T R A S T R O N G


────────────────────────────────────────────────────────────────────────────────
TABLE LAYOUT
────────────────────────────────────────────────────────────────────────────────

The dashboard is a 5-column × 5-row table. Here is what each cell displays:

Row 0, Cols 0–2 (merged) → Title: "T A C H I M E T E R" in Rounded font
Background: teal (bullish) or red (bearish)
based on daily open vs. close.

Row 0, Col 3 → Acceleration label (strength of move in text).
Same background color as the title.

Row 1, Col 0 → Scale labels: "X10" and "X100"

Row 1, Col 1 → The gauge display:
Scale ruler (⏒ tick marks)
X10 bar (13 emoji blocks)
Number scale (₂ ₄ ₆ ₈ ₁₀ ₁₁ ₁₂ ₁₃)
X100 bar (13 emoji blocks)
Scale ruler (⏒ tick marks)

Row 1, Col 2 → Raw RPM value (formatted as a 2-digit number).

Row 1, Col 3 → Current price + tendency dot (🟢 or 🔴).
Background: teal (bull) or red (bear) at 50%
transparency, based on RPM tendency.


────────────────────────────────────────────────────────────────────────────────
COLOR GUIDE
────────────────────────────────────────────────────────────────────────────────

Gauge squares — Trend Color mode (default):
🟩 Bullish fill (X10 and X100 bars, blocks 1–10)
🟦 Bullish overdrive (X100 bar, blocks 11–13)
🟥 Bearish fill (X10 and X100 bars, blocks 1–10)
🟨 Bearish overdrive (X100 bar, blocks 11–13)
⬛ Empty block

Gauge squares — White mode:
⬜ All active blocks (both bars, all slots)
⬛ Empty block

Tendency dot (price cell):
🟢 RPM is positive (bullish)
🔴 RPM is negative (bearish)

Header / Acceleration cell background:
Teal → Close >= Daily Open
Red → Close < Daily Open

Price cell background:
Teal at 50% transparency → RPM bullish
Red at 50% transparency → RPM bearish


────────────────────────────────────────────────────────────────────────────────
SETTINGS & INPUTS
────────────────────────────────────────────────────────────────────────────────

Group: PRICE LABELS
Show Current Price and Tachimeter (toggle, default: ON)
Master on/off switch. When disabled, the entire table is hidden.

Group: EMA Dashboard
Dashboard Position (dropdown, default: Top Center)
Controls where the table is anchored on the chart.
Options: Bottom Left, Top Center, Middle Left, Middle Right,
Bottom Right, Top Right.

Dashboard Size (dropdown, default: Tiny)
Controls the text size of the gauge content.
Options: Auto, Tiny, Small, Normal, Large, Huge.
Recommendation: Tiny for mobile, Small for desktop browser.

Group: GAUGE STYLE
Gauge Square Color Mode (dropdown, default: Trend Color)
Trend Color (Green/Red): squares reflect bull/bear direction.
White: all active squares display as white (⬜) regardless of direction.
Useful for minimalist or light-theme charts.


────────────────────────────────────────────────────────────────────────────────
IMPORTANT NOTES
────────────────────────────────────────────────────────────────────────────────

- The indicator renders ONLY on real-time, unconfirmed bars. It will not
display on historical bars. This is by design to prevent repainting.

- RPM is measured against the 20-minute timeframe close[1], making it most
meaningful on intraday charts (1m, 3m, 5m, 15m, etc.).

- On slower timeframes (Daily, Weekly) the RPM values will be very large
and the X100 bar will almost always be fully lit. The indicator is
optimized for intraday use.

- The weekly_open and monthly_open security calls are fetched but currently
reserved for future use. They do not affect the current display.


────────────────────────────────────────────────────────────────────────────────
CREDITS
────────────────────────────────────────────────────────────────────────────────

Author : © CQuevedo345
Library : fikira/Text/1 (used for Rounded font rendering in title)
License : Mozilla Public License 2.0
mozilla.org/MPL/2.0/

================================================================================
ملاحظات الأخبار
New Bullish/Bearish based color highlights for easier interpretation.

إخلاء المسؤولية

لا يُقصد بالمعلومات والمنشورات أن تكون، أو تشكل، أي نصيحة مالية أو استثمارية أو تجارية أو أنواع أخرى من النصائح أو التوصيات المقدمة أو المعتمدة من TradingView. اقرأ المزيد في شروط الاستخدام.