# 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.
