MirPapa_Lib_Box

Library "MirPapa_Lib_Box"

GetHTFrevised(_tf, _case)
GetHTFrevised
description Retrieve a specific bar value from a Higher Time Frame (HTF) series.
Parameters:
_tf (string): string The target HTF string (examples: "60", "1D").
_case (string): string Case string determining which OHLC value to request.
return float Returns the requested HTF value or na if _case does not match.

GetHTFrevised(_tf)
Parameters:
_tf (string)

GetHTFoffsetToLTFoffset(_offset, _chartTf, _htfTf)
GetHTFoffsetToLTFoffset
description Adjust an HTF offset to an LTF offset by calculating the ratio of timeframes.
Parameters:
_offset (int): int The HTF bar offset (0 means current HTF bar).
_chartTf (string): string The current chart's timeframe (e.g., "5", "15", "1D").
_htfTf (string): string The High Time Frame string (e.g., "60", "1D").
return int The corresponding LTF bar index. Returns 0 if the result is negative.

GetHtfFromLabel(_label)
GetHtfFromLabel
description Convert a Korean HTF label into a Pine Script timeframe string.
Parameters:
_label (string): string The Korean label (e.g., "5분", "1시간").
return string Returns the corresponding Pine Script timeframe (e.g., "5", "60").

IsChartTFcomparisonHTF(_chartTf, _htfTf)
IsChartTFcomparisonHTF
description Determine whether a given HTF is greater than or equal to the current chart timeframe.
Parameters:
_chartTf (string): string Current chart timeframe (e.g., "5", "15", "1D").
_htfTf (string): string HTF timeframe (e.g., "60", "1D").
return bool True if HTF ≥ chartTF, false otherwise.

IsCondition(_boxType, _isBull, _pricePrev, _priceNow)
IsCondition
description FOB, FVG 조건 체크.\
_boxType: "fob"(Fair Order Block) 또는 "fvg"(Fair Value Gap).\
_isBull: true(상승 패턴), false(하락 패턴).\
상승 시 현재 가격이 이전 가격보다 높으면 true, 하락 시 이전 가격이 현재 가격보다 높으면 true 반환.
Parameters:
_boxType (string): 박스 타입 ("fob", "fvg")
_isBull (bool): 상승(true) 또는 하락(false)
_pricePrev (float): 이전 가격
_priceNow (float): 현재 가격
Returns: bool 조건 만족 여부

IsCondition(_boxType, _high2, _high1, _high0, _low2, _low1, _low0)
IsCondition
description Sweep 조건 체크 (Swing High/Low 동시 발생).\
_boxType: "sweep" 또는 "breachBoth".\
조건: high2 < high1 > high0 (Swing High) AND low2 > low1 < low0 (Swing Low).\
중간 캔들이 양쪽보다 높고 낮은 지점을 동시에 형성할 때 true 반환.
Parameters:
_boxType (string): 박스 타입 ("sweep", "breachBoth")
_high2 (float)
_high1 (float)
_high0 (float)
_low2 (float)
_low1 (float)
_low0 (float)
Returns: bool 조건 만족 여부

IsCondition(_boxType, _isBull, _open1, _close1, _high1, _low1, _open0, _close0, _low2, _low3, _high2, _high3)
IsCondition
description RB (Rejection Block) 조건 체크.\
_boxType: "rb" (Rejection Block).\
상승 RB: candle1=음봉, candle0=양봉, low3>low1 AND low2>low1, close1*1.001>open0, open1<close0.\
하락 RB: candle1=양봉, candle0=음봉, high3<high1 AND high2<high1, close1*0.999<open0, open1>close0.\
이전 캔들의 거부 후 현재 캔들이 반대 방향으로 전환될 때 true 반환.
Parameters:
_boxType (string): 박스 타입 ("rb")
_isBull (bool): 상승(true) 또는 하락(false)
_open1 (float)
_close1 (float)
_high1 (float)
_low1 (float)
_open0 (float)
_close0 (float)
_low2 (float)
_low3 (float)
_high2 (float)
_high3 (float)
Returns: bool 조건 만족 여부

IsCondition(_boxType, _isBull, _open2, _close1, _open1, _close0)
IsCondition
description SOB (Strong Order Block) 조건 체크.\
_boxType: "sob" (Strong Order Block).\
상승 SOB: 양봉2 => 음봉1 => 양봉0, open2 > close1 AND open1 < close0.\
하락 SOB: 음봉2 => 양봉1 => 음봉0, open2 < close1 AND open1 > close0.\
3개 캔들 패턴으로 강한 주문 블록 형성 시 true 반환.
Parameters:
_boxType (string): 박스 타입 ("sob")
_isBull (bool): 상승(true) 또는 하락(false)
_open2 (float): 2개 이전 캔들 open
_close1 (float): 1개 이전 캔들 close
_open1 (float): 1개 이전 캔들 open
_close0 (float): 현재 캔들 close
Returns: bool 조건 만족 여부

CreateBox(_boxType, _tf, _isBull, _useLine, _colorBG, _colorBD, _colorText, _cache)
CreateBox
description 박스 생성 (breachMode 자동 결정).\
_boxType: "fob", "rb", "custom" → directionalHighLow, 나머지 → both.\
_tf: 시간대 (timeframe.period 또는 HTF).\
_isBull: true(상승 박스), false(하락 박스).\
_cache: HTF 사용 시 필수, CurrentTF는 na.\
반환: [성공 여부(bool), 박스 데이터(BoxData)].
Parameters:
_boxType (string): 박스 타입
_tf (string): 시간대
_isBull (bool): 상승(true) 또는 하락(false)
_useLine (bool): 중간선 표시 여부
_colorBG (color): 박스 배경색
_colorBD (color): 박스 테두리색
_colorText (color): 텍스트 색상
_cache (HTFCache): HTF 캐시 데이터
Returns: [bool, BoxData] 성공 여부와 박스 데이터

CreateBox(_boxType, _tf, _isBull, _useLine, _colorBG, _colorBD, _colorText, _cache, _customText)
CreateBox
description 박스 생성 (커스텀 텍스트 지원, breachMode 자동 결정).\
_boxType: "fob", "rb", "custom" → directionalHighLow, 나머지 → both.\
_customText: 박스에 표시할 텍스트 (비어있으면 "시간대 박스타입" 형식으로 자동 생성).\
_isBull: true(상승 박스), false(하락 박스).\
반환: [성공 여부(bool), 박스 데이터(BoxData)].
Parameters:
_boxType (string): 박스 타입
_tf (string): 시간대
_isBull (bool): 상승(true) 또는 하락(false)
_useLine (bool): 중간선 표시 여부
_colorBG (color): 박스 배경색
_colorBD (color): 박스 테두리색
_colorText (color): 텍스트 색상
_cache (HTFCache): HTF 캐시 데이터
_customText (string): 커스텀 텍스트
Returns: [bool, BoxData] 성공 여부와 박스 데이터

CreateBox(_boxType, _breachMode, _tf, _isBull, _useLine, _colorBG, _colorBD, _colorText, _cache, _customText)
CreateBox
description 박스 생성 (breachMode 명시적 지정).\
_breachMode: "both"(양쪽 모두 돌파), "directionalHighLow"(방향성 high/low 돌파), "directionalClose"(방향성 close 돌파).\
_isBull: true(상승 박스), false(하락 박스).\
_customText: 박스에 표시할 텍스트 (비어있으면 "시간대 박스타입" 형식으로 자동 생성).\
반환: [성공 여부(bool), 박스 데이터(BoxData)].
Parameters:
_boxType (string): 박스 타입 (fob, fvg, sweep, rb, custom 등)
_breachMode (string): 돌파 처리 방식: "both" (양쪽 모두), "directionalHighLow" (방향성 high/low), "directionalClose" (방향성 close)
_tf (string): 시간대
_isBull (bool): 상승(true) 또는 하락(false) 방향
_useLine (bool): 중간선 표시 여부
_colorBG (color): 박스 배경색
_colorBD (color): 박스 테두리색
_colorText (color): 텍스트 색상
_cache (HTFCache): HTF 캐시 데이터 (CurrentTF는 na)
_customText (string): 커스텀 텍스트 (비어있으면 자동 생성)
Returns: [bool, BoxData] 성공 여부와 박스 데이터

CreateCustomBox(_boxType, _breachMode, _isBull, _top, _bottom, _left, _right, _useLine, _colorBG, _colorBD, _colorText, _text)
CreateCustomBox
description 완전히 유연한 커스텀 박스 생성.\
사용자가 박스 위치(top, bottom, left, right), breach mode, 모든 파라미터를 직접 지정.\
조건 체크는 사용자 스크립트에서 수행하고, 이 함수는 박스 생성만 담당.\
새로운 박스 타입 추가 시 라이브러리 수정 없이 사용 가능.
Parameters:
_boxType (string): 박스 타입 (사용자 정의 문자열)
_breachMode (string): 돌파 처리 방식: "both", "directionalHighLow", "directionalClose", "sobClose"
_isBull (bool): 상승(true) 또는 하락(false) 방향
_top (float): 박스 상단 가격
_bottom (float): 박스 하단 가격
_left (int): 박스 시작 시간 (xloc.bar_time 사용)
_right (int): 박스 종료 시간 (xloc.bar_time 사용)
_useLine (bool): 중간선 표시 여부
_colorBG (color): 박스 배경색
_colorBD (color): 박스 테두리색
_colorText (color): 텍스트 색상
_text (string): 박스에 표시할 텍스트
Returns: [bool, BoxData] 성공 여부와 박스 데이터

ProcessBoxDatas(_openBoxes, _closedBoxes, _useMidLine, _closeCount, _colorClose, _currentBarIndex, _currentLow, _currentHigh, _currentTime)
ProcessBoxDatas
description 박스 확장 및 돌파 처리.\
열린 박스들을 현재 bar까지 확장하고, 돌파 조건 체크.\
_closeCount: 돌파 횟수 (이 횟수만큼 돌파 시 박스 종료).\
breachMode에 따라 돌파 체크 방식 다름 (both/directionalHighLow/directionalClose).\
종료된 박스는 _closedBoxes로 이동하고 _colorClose 색상 적용.\
barstate.islast와 barstate.isconfirmed에서 호출 권장.
Parameters:
_openBoxes (array<BoxData>): 열린 박스 배열
_closedBoxes (array<BoxData>): 닫힌 박스 배열
_useMidLine (bool): 중간선 표시 여부
_closeCount (int): 돌파 카운트 (이 횟수만큼 돌파 시 종료)
_colorClose (color): 종료된 박스 색상
_currentBarIndex (int): 현재 bar_index
_currentLow (float): 현재 low
_currentHigh (float): 현재 high
_currentTime (int): 현재 time
Returns: bool 항상 true

UpdateHTFCache(_cache, _tf)
UpdateHTFCache
description HTF 데이터 캐싱 (성능 최적화).\
HTF의 OHLC 데이터를 캐싱하여 매 틱마다 request.security 호출 방지.\
_cache: 기존 캐시 (없으면 na, 첫 호출 시).\
_tf: 캐싱할 시간대 (예: "60", "1D").\
새 bar 또는 bar_index 변경 시에만 업데이트, 그 외에는 기존 캐시 반환.\
Parameters:
_cache (HTFCache): 기존 캐시 데이터 (없으면 na)
_tf (string): 시간대
Returns: HTFCache 업데이트된 캐시 데이터

GetTimeframeSettings(_currentTF, _midTF1m, _highTF1m, _midTF5m, _highTF5m, _midTF15m, _highTF15m, _midTF30m, _highTF30m, _midTF60m, _highTF60m, _midTF240m, _highTF240m, _midTF1D, _highTF1D, _midTF1W, _highTF1W, _midTF1M, _highTF1M)
GetTimeframeSettings
description 현재 차트 시간대에 맞는 중위/상위 시간대 자동 선택.\
_currentTF: 현재 차트 시간대 (timeframe.period).\
1분~1월 차트별로 적절한 중위/상위 시간대 매핑.\
예: 5분 차트 → 중위 15분, 상위 60분.\
반환: [중위 시간대(string), 상위 시간대(string)].\
Parameters:
_currentTF (string): 현재 차트 시간대
_midTF1m (string)
_highTF1m (string)
_midTF5m (string)
_highTF5m (string)
_midTF15m (string)
_highTF15m (string)
_midTF30m (string)
_highTF30m (string)
_midTF60m (string)
_highTF60m (string)
_midTF240m (string)
_highTF240m (string)
_midTF1D (string)
_highTF1D (string)
_midTF1W (string)
_highTF1W (string)
_midTF1M (string)
_highTF1M (string)
Returns: [string, string] [중위 시간대, 상위 시간대]

BoxData
BoxData
Fields:
_type (series string): 박스 타입 (fob, fvg, sweep, rb, custom 등)
_breachMode (series string): 돌파 처리 방식
_isBull (series bool): 상승(true) 또는 하락(false) 방향
_box (series box)
_line (series line)
_boxTop (series float)
_boxBot (series float)
_boxMid (series float)
_topBreached (series bool)
_bottomBreached (series bool)
_breakCount (series int)
_createdBar (series int)

HTFCache
Fields:
_timeframe (series string)
_lastBarIndex (series int)
_isNewBar (series bool)
_barIndex (series int)
_open (series float)
_high (series float)
_low (series float)
_close (series float)
_open1 (series float)
_close1 (series float)
_high1 (series float)
_low1 (series float)
_open2 (series float)
_close2 (series float)
_high2 (series float)
_low2 (series float)
_high3 (series float)
_low3 (series float)
_time1 (series int)
_time2 (series int)

Versionshinweise

v3

더해짐
BoxType
BoxType
Fields:
FOB (series string)
FVG (series string)
IFVG (series string)
SOB (series string)
RB (series string)
BB (series string)
MB (series string)
SWEEP (series string)
CUSTOM (series string)

BreachMode
BreachMode
Fields:
BOTH_HIGH_LOW (series string)
BOTH_CLOSE (series string)
DIRECTIONAL_HIGH_LOW (series string)
DIRECTIONAL_CLOSE (series string)
NEAR_HIGH (series string)
NEAR_CLOSE (series string)
NEAR_LOW (series string)
FAR_HIGH (series string)
FAR_CLOSE (series string)
FAR_LOW (series string)

업데이트됨
CreateBox(_boxType, _tf, _isBull, _useLine, _colorBG, _colorBD, _colorText, _cache)
CreateBox (자동 계산 방식)
description 박스 생성 (tf/cache 기반 자동 좌표 계산).\
라이브러리가 boxType에 따라 좌표를 자동 계산.\
breachMode는 boxType 기반 자동 결정.\
Parameters:
_boxType (string): 박스 타입
_tf (string): 시간대
_isBull (bool): 상승(true) 또는 하락(false)
_useLine (bool): 중간선 표시 여부
_colorBG (color): 박스 배경색
_colorBD (color): 박스 테두리색
_colorText (color): 텍스트 색상
_cache (HTFCache type from goodia/Mirpapa_Lib_HTF/1): HTF 캐시 데이터
Returns: [bool, BoxData] 성공 여부와 박스 데이터

BoxData
BoxData
Fields:
_type (series string): 박스 타입
_breachMode (series string): 돌파 처리 방식
_isBull (series bool): 상승(true) 또는 하락(false) 방향
_box (series box)
_line (series line)
_boxTop (series float)
_boxBot (series float)
_boxMid (series float)
_topBreached (series bool)
_bottomBreached (series bool)
_breakCount (series int)

없어짐
CreateCustomBox(_boxType, _breachMode, _isBull, _top, _bottom, _left, _right, _useLine, _colorBG, _colorBD, _colorText, _text)
CreateCustomBox
description 완전히 유연한 커스텀 박스 생성.\
사용자가 박스 위치(top, bottom, left, right), breach mode, 모든 파라미터를 직접 지정.\
조건 체크는 사용자 스크립트에서 수행하고, 이 함수는 박스 생성만 담당.\
새로운 박스 타입 추가 시 라이브러리 수정 없이 사용 가능.

UpdateHTFCache(_cache, _tf)
UpdateHTFCache
description HTF 데이터 캐싱 (성능 최적화).\
HTF의 OHLC 데이터를 캐싱하여 매 틱마다 request.security 호출 방지.\
_cache: 기존 캐시 (없으면 na, 첫 호출 시).\
_tf: 캐싱할 시간대 (예: "60", "1D").\
새 bar 또는 bar_index 변경 시에만 업데이트, 그 외에는 기존 캐시 반환.\

GetTimeframeSettings(_currentTF, _midTF1m, _highTF1m, _midTF5m, _highTF5m, _midTF15m, _highTF15m, _midTF30m, _highTF30m, _midTF60m, _highTF60m, _midTF240m, _highTF240m, _midTF1D, _highTF1D, _midTF1W, _highTF1W, _midTF1M, _highTF1M)
GetTimeframeSettings
description 현재 차트 시간대에 맞는 중위/상위 시간대 자동 선택.\
_currentTF: 현재 차트 시간대 (timeframe.period).\
1분~1월 차트별로 적절한 중위/상위 시간대 매핑.\
예: 5분 차트 → 중위 15분, 상위 60분.\
반환: [중위 시간대(string), 상위 시간대(string)].\

HTFCache

Versionshinweise

v4

더해짐
BoxState
BoxState
Fields:
PENDING (series string)
START (series string)
END (series string)
EXTENSION (series string)

HTFCache
Fields:
_timeframe (series string)
_lastBarIndex (series int)
_isNewBar (series bool)
_barIndex (series int)
_open (series float)
_high (series float)
_low (series float)
_close (series float)
_open1 (series float)
_close1 (series float)
_high1 (series float)
_low1 (series float)
_open2 (series float)
_close2 (series float)
_high2 (series float)
_low2 (series float)
_high3 (series float)
_low3 (series float)
_time1 (series int)
_time2 (series int)

업데이트됨
CreateBox(_boxType, _boxState, _tf, _isBull, _useLine, _colorBG, _colorBD, _colorText, _cache)
CreateBox (자동 계산 방식)
description 박스 생성 (tf/cache 기반 자동 좌표 계산).\
라이브러리가 boxType에 따라 좌표를 자동 계산.\
Parameters:
_boxType (string): 박스 타입
_boxState (string): 박스 상태 ("pending", "start", "extension")
_tf (string): 시간대
_isBull (bool): 상승(true) 또는 하락(false)
_useLine (bool): 중간선 표시 여부
_colorBG (color): 박스 배경색
_colorBD (color): 박스 테두리색
_colorText (color): 텍스트 색상
_cache (HTFCache): HTF 캐시 데이터
Returns: [bool, BoxData] 성공 여부와 박스 데이터

ProcessBoxDatas(_openBoxes, _closedBoxes, _useMidLine, _closeCount, _baseColor, _pendingTransparency, _startTransparency, _endTransparency, _currentBarIndex, _currentLow, _currentHigh, _currentClose, _currentTime)
ProcessBoxDatas
description 박스 확장 및 상태별 돌파 처리.\
열린 박스들을 현재 bar까지 확장하고, 상태별 돌파 조건 체크.\
PENDING: 시작 조건 체크 → START 전환\
START: 종료 조건 체크 → END 전환\
EXTENSION: 무한 확장\
종료된 박스는 _closedBoxes로 이동하고 _colorClose 색상 적용.\
Parameters:
_openBoxes (array<BoxData>): 열린 박스 배열
_closedBoxes (array<BoxData>): 닫힌 박스 배열
_useMidLine (bool): 중간선 표시 여부
_closeCount (int): 돌파 카운트 (이 횟수만큼 돌파 시 종료)
_baseColor (color): 기본 색상
_pendingTransparency (int): 대기 상태 불투명도
_startTransparency (int): 시작 상태 불투명도
_endTransparency (int): 종료 상태 불투명도
_currentBarIndex (int): 현재 bar_index
_currentLow (float): 현재 low
_currentHigh (float): 현재 high
_currentClose (float): 현재 close
_currentTime (int): 현재 time
Returns: bool 항상 true

BoxData
BoxData
Fields:
_type (series string): 박스 타입
_breachModeStart (series string): 시작 돌파 처리 방식
_breachModeEnd (series string): 종료 돌파 처리 방식
_boxState (series string): 박스 상태
_isBull (series bool): 상승(true) 또는 하락(false) 방향
_box (series box)
_line (series line)
_boxTop (series float)
_boxBot (series float)
_boxMid (series float)
_topBreached (series bool)
_bottomBreached (series bool)
_breakCount (series int)

Versionshinweise

Pine Bibliothek

Ganz im Sinne von TradingView hat dieser Autor seinen/ihren Pine Code als Open-Source-Bibliothek veröffentlicht. Auf diese Weise können nun auch andere Pine-Programmierer aus unserer Community den Code verwenden. Vielen Dank an den Autor! Sie können diese Bibliothek privat oder in anderen Open-Source-Veröffentlichungen verwenden. Die Nutzung dieses Codes in einer Veröffentlichung wird in unseren Hausregeln reguliert.

goodia

Haftungsausschluss

Die Informationen und Veröffentlichungen sind nicht als Finanz-, Anlage-, Handels- oder andere Arten von Ratschlägen oder Empfehlungen gedacht, die von TradingView bereitgestellt oder gebilligt werden, und stellen diese nicht dar. Lesen Sie mehr in den Nutzungsbedingungen.

Pine Bibliothek

goodia