Tornado3_2026Election/COUNTER_DEBUG.md

Counter Debug Notes

Date: 2026-04-14

Summary

• Scene: 1-2위_ani_광역단체장
• Counter objects: 득표율01, 득표율02
• API: IKACounter.SetCounterNumberKey(KeyIndex, Number)
• Key index used for this test: 1

Current test values

• 득표율01 -> 30
• 득표율02 -> 20

Verification

• tools/KarismaTcpProbe supports --test-counter.
• Verified against 127.0.0.1:30001.
• OnSetCounterNumberKey returned RESULT_SUCCESS for both 득표율01 and 득표율02.

Runtime Mapping Update

• KarismaTornado3Adapter now maps scene variables from ElectionDataSnapshot at send time.
• Candidate text keys such as 후보명NN, 정당명NN, 득표수NN, 득표율NN, 순위NN, 표차NN, 득표차NN are populated automatically.
• Common scene keys such as 선거구명01, 시도명01, 개표율01, 투표율01, 전국투표율01 are populated automatically.
• Animated templates with ani in the template id or name also send IKACounter.SetCounterNumberKey(1, voteRate) for each 득표율NN.
• 유확당NN resolves to 유력.vrv, 확정.vrv or 확실.vrv, and 당선.vrv.
• 후보사진NN falls back to Images/Photo/sampleNEW.png when a candidate-specific photo is not found.
• Party image keys such as 정당바NN, 정당판NN, 정당심볼NN, 그룹NN resolve from the Images/Dang asset folders when a matching party file exists.