Object Detection
입력 영상에서 물체를 검출해서, 찾아낸 위치를 흰 사각형으로 칠한 마스크를 출력합니다. 사람・자동차・동물 등, Target 드롭다운에서 고른 종류의 물체를 찾습니다. 동시에 가장 확신도가 높은 검출의 중심 좌표(0~1)도 출력하므로, 검출 위치로 다른 노드를 움직이게 할 수도 있습니다.
- Target — 검출할 물체의 종류. 초깃값은 Person
- Enable — 초깃값 ON. OFF일 때는 입력이 그대로 통과합니다
- Confidence Threshold — 이 확신도를 넘은 검출만 채택합니다. 초깃값 0.25(0~1)
- Inference Every N Frames — 몇 프레임에 한 번 검출할지. 초깃값 2(숫자를 올릴수록 가벼워집니다)
- Max Detections — 그릴 검출 수의 상한. 확신도가 높은 순으로 채택합니다. 1~50, 초깃값 10
- detectedCenterX0 / detectedCenterY0 — 최상위 검출의 중심(0~1). 검출이 0건일 때는 둘 다 0.5를 출력합니다
마스크는 사각형으로 칠하는 방식입니다. 물체의 형태를 따라 오려내는 것이 아닙니다.
같은 물체에 여러 개의 프레임이 겹쳐서 나온 경우, 그것들은 모두 그대로 그려집니다.
검출할 수 있는 것은 Target에서 고른 한 종류뿐입니다. 여러 종류를 동시에 다루고 싶다면 노드를 나눠 주세요.
검출하지 않는 프레임에서는 직전의 마스크가 그대로 출력됩니다. 입력이 연결되지 않았을 때는 검은색이 나옵니다.
입력 포트
| Port ID | 타입 |
|---|---|
Input Texture | RenderTexture |
Enable | bool |
Confidence Threshold | float |
Inference Every N Frames | int |
Max Detections | int |
출력 포트
| Port ID | 타입 |
|---|---|
Mask Output | RenderTexture |
detectedCenterX0 | float |
detectedCenterY0 | float |
스크립트에서 설정할 수 있는 멤버
| 경로 | 타입 |
|---|---|
enableInput | bool |
confidenceInput | float |
skipFramesInput | int |
maxDetectionsInput | int |
isEnabled | bool |
confidenceThreshold | float |
inferenceEveryNFrames | int |
maxDetections | int |
Synapse Apps (스크립팅)
await synapse.modules.create({ type: "YoloDetection" }) 


