Countdown

남은 시간을 문자열과 수치로 공급하는 노드입니다. 렌더링은 하지 않으므로, 표시는 Text Render 등으로 흘려보냅니다. 세는 방식은 Mode 드롭다운에서 2가지 중에 고릅니다.

Duration 모드(기본값)

Duration으로 지정한 초를 셉니다. 초는 노드의 칸이나 Duration 포트로 지정합니다(기본값 60초, 0~359999초＝99:59:59로 클램프, 연결은 1개까지).

• Start — 카운트 시작. Stop으로 멈춘 뒤의 Start만이 남은 시간부터 재개이고, 진행 중·Done 이후·남은 시간 0에서의 Start는 가득 찬 상태로 다시 시작됩니다
• Stop — 일시 정지
• Reset — 가득 찬 상태로 되돌리고 정지. Done의 재발화도 여기서 해금됩니다
• 정지 중에 초를 바꾸면 표시도 그 자리에서 따라옵니다. 진행 중에 바꾼 경우에는 현재의 카운트에는 영향을 주지 않고, 다음 Reset 또는 Start부터 적용됩니다
• 시간 측정은 프레임 시간의 누적이 아니라 실제 시간이므로, 무거운 패치로 프레임이 떨어져도 표시가 실제 시간에서 어긋나지 않습니다

노드에는 ▶(Start) / ⏸(Stop) / ⏮(Reset) 버튼도 있습니다.

Clock 모드

지정한 시각까지를 벽시계로 셉니다. Mode를 Clock으로 하면 Time 입력란이 나타납니다(Duration 모드에서는 표시되지 않습니다).

• 시각의 서식은 24시간제의 h:mm / h:mm:ss / hh:mm / hh:mm:ss(예 22:30, 9:05:00)입니다. Enter 또는 칸 밖을 클릭하면 확정
• 지정 시각이 오늘 이미 지났을 경우에는 다음 날의 같은 시각을 겨냥합니다
• Start / Stop은 동작하지 않고, 항상 계속 진행됩니다. Reset은 목표 시각을 다시 잡는 것으로, Done을 낸 뒤 다음 날의 같은 시각을 다시 겨냥할 때 사용합니다
• 시각으로 해석할 수 없는 문자열일 때는 남은 시간 0·Progress 1인 상태로 멈추고, Done도 나오지 않습니다
• 이 모드에서는 Duration이 사용되지 않습니다

Format 드롭다운

• Auto(기본값) — 남은 시간이 1시간 미만이면 분:초, 1시간 이상이면 시:분:초
• mm:ss — 항상 분:초
• hh:mm:ss — 항상 시:분:초
• Seconds — 남은 초만의 숫자

상위 자리는 0으로 채우지 않습니다(9:05, 1:02:03처럼 나옵니다). 표시는 올림이므로, 남은 0.3초는 0:01이고 0:00은 도달한 순간과 일치합니다.

출력 보충 설명

• Text — 표시용 문자열. 초가 바뀌는 순간에만 흘러갑니다
• Remaining — 남은 초. 0 미만이 되지는 않습니다
• Progress — 0이 시작 직후, 1이 도달(0→1로 증가합니다). 분모는 Duration 모드에서는 지정한 초, Clock 모드에서는 목표 시각을 다시 잡은 시점부터 목표까지의 초입니다. 즉 Clock 모드의 Progress는 ‘Reset한 순간부터의 진행 정도’가 됩니다
• Done — 남은 시간이 0에 도달한 순간에 한 번만. Reset(Clock 모드에서는 재무장)할 때까지 재발화하지 않습니다. 카운트가 움직이지 않는 동안(Duration 모드에서 정지 중, Clock 모드에서 시각이 올바르지 않을 때)에는 나오지 않습니다

사용처: Progress를 글자의 크기나 색에 꽂으면 ‘끝이 가까울수록 크게·붉게’를 만들 수 있습니다. Done은 씬 전환이나 본편의 재생 시작을 위한 계기로.

await synapse.modules.create({ type: "Countdown" })